Ejemplos de integración

curl https://api.nuvia.ai/v1/inboxes \
  -H "Authorization: Bearer $NUVIA_API_KEY"

const res = await fetch("https://api.nuvia.ai/v1/inboxes", {
  headers: { Authorization: `Bearer ${process.env.NUVIA_API_KEY}` },
});
const { data } = await res.json();

import os, requests
res = requests.get(
    "https://api.nuvia.ai/v1/inboxes",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
)
data = res.json()["data"]

curl -X POST https://api.nuvia.ai/v1/messages/send \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "conversationId": "ID_DE_LA_CONVERSACION",
    "message": { "content": "¡Hola! Enviado vía API.", "contentType": "TEXT" }
  }'

await fetch("https://api.nuvia.ai/v1/messages/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    conversationId: "ID_DE_LA_CONVERSACION",
    message: { content: "¡Hola! Enviado vía API.", contentType: "TEXT" },
  }),
});

import os, requests
requests.post(
    "https://api.nuvia.ai/v1/messages/send",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
    json={
        "conversationId": "ID_DE_LA_CONVERSACION",
        "message": {"content": "¡Hola! Enviado vía API.", "contentType": "TEXT"},
    },
)

curl -X POST https://api.nuvia.ai/v1/webhooks \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-servidor.com/nuvia/webhook",
    "events": ["MESSAGE_RECEIVED", "CONVERSATION_CREATED"],
    "status": "ACTIVE"
  }'

await fetch("https://api.nuvia.ai/v1/webhooks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://tu-servidor.com/nuvia/webhook",
    events: ["MESSAGE_RECEIVED", "CONVERSATION_CREATED"],
    status: "ACTIVE",
  }),
});

import os, requests
requests.post(
    "https://api.nuvia.ai/v1/webhooks",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
    json={
        "url": "https://tu-servidor.com/nuvia/webhook",
        "events": ["MESSAGE_RECEIVED", "CONVERSATION_CREATED"],
        "status": "ACTIVE",
    },
)

curl -X POST https://api.nuvia.ai/v1/campaigns/ID_DE_LA_CAMPANA/enrollments/from-contact \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contact": {
      "phone": "+5511999998888",
      "name": "Maria Souza",
      "email": "maria.souza@ejemplo.com",
      "external_id": "ID_DEL_CONTACTO_EN_EL_CRM"
    },
    "fields": { "origen": "crm" }
  }'

const res = await fetch(
  "https://api.nuvia.ai/v1/campaigns/ID_DE_LA_CAMPANA/enrollments/from-contact",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      contact: {
        phone: "+5511999998888",
        name: "Maria Souza",
        email: "maria.souza@ejemplo.com",
        external_id: "ID_DEL_CONTACTO_EN_EL_CRM",
      },
      fields: { origen: "crm" },
    }),
  },
);
const resultado = await res.json();

import os, requests
res = requests.post(
    "https://api.nuvia.ai/v1/campaigns/ID_DE_LA_CAMPANA/enrollments/from-contact",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
    json={
        "contact": {
            "phone": "+5511999998888",
            "name": "Maria Souza",
            "email": "maria.souza@ejemplo.com",
            "external_id": "ID_DEL_CONTACTO_EN_EL_CRM",
        },
        "fields": {"origen": "crm"},
    },
)
resultado = res.json()

curl -X POST https://api.nuvia.ai/v1/contacts/find-by-phones \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phones": ["+5511999999999", "+5511888888888"] }'

const res = await fetch("https://api.nuvia.ai/v1/contacts/find-by-phones", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ phones: ["+5511999999999", "+5511888888888"] }),
});

import os, requests
res = requests.post(
    "https://api.nuvia.ai/v1/contacts/find-by-phones",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
    json={"phones": ["+5511999999999", "+5511888888888"]},
)

curl -X POST https://api.nuvia.ai/v1/contacts \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "María Silva",
    "country_code": "55",
    "phone_number": "11999999999",
    "email": "maria@empresa.com"
  }'

await fetch("https://api.nuvia.ai/v1/contacts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "María Silva",
    country_code: "55",
    phone_number: "11999999999",
    email: "maria@empresa.com",
  }),
});

import os, requests
requests.post(
    "https://api.nuvia.ai/v1/contacts",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
    json={
        "name": "María Silva",
        "country_code": "55",
        "phone_number": "11999999999",
        "email": "maria@empresa.com",
    },
)

curl https://api.nuvia.ai/v1/hubspot/owner-mappings \
  -H "Authorization: Bearer $NUVIA_API_KEY"

const res = await fetch("https://api.nuvia.ai/v1/hubspot/owner-mappings", {
  headers: { Authorization: `Bearer ${process.env.NUVIA_API_KEY}` },
});
const { owner_mappings } = await res.json();

import os, requests
res = requests.get(
    "https://api.nuvia.ai/v1/hubspot/owner-mappings",
    headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
)
owner_mappings = res.json()["owner_mappings"]

const TTL_MS = 5 * 60 * 1000;
let cache = { at: 0, byOwner: new Map() };

async function nuviaUserFor(hubspotOwnerId) {
  if (Date.now() - cache.at > TTL_MS) {
    const res = await fetch("https://api.nuvia.ai/v1/hubspot/owner-mappings", {
      headers: { Authorization: `Bearer ${process.env.NUVIA_API_KEY}` },
    });
    const { owner_mappings } = await res.json();
    cache = {
      at: Date.now(),
      byOwner: new Map(owner_mappings.map((m) => [m.hubspot_owner_id, m.nuvia_user_id])),
    };
  }
  return cache.byOwner.get(hubspotOwnerId) ?? null;
}

import os, time, requests

TTL_S = 5 * 60
_cache = {"at": 0.0, "by_owner": {}}

def nuvia_user_for(hubspot_owner_id):
    if time.time() - _cache["at"] > TTL_S:
        res = requests.get(
            "https://api.nuvia.ai/v1/hubspot/owner-mappings",
            headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
        )
        mappings = res.json()["owner_mappings"]
        _cache["at"] = time.time()
        _cache["by_owner"] = {m["hubspot_owner_id"]: m["nuvia_user_id"] for m in mappings}
    return _cache["by_owner"].get(hubspot_owner_id)

curl -X PUT https://api.nuvia.ai/v1/conversations/$CONVERSATION_ID/assign-owner \
  -H "Authorization: Bearer $NUVIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "6650f1c2a1b2c3d4e5f60789" }'

const userId = await nuviaUserFor(hubspotOwnerId);
if (userId) {
  await fetch(`https://api.nuvia.ai/v1/conversations/${conversationId}/assign-owner`, {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${process.env.NUVIA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ userId }),
  });
}

user_id = nuvia_user_for(hubspot_owner_id)
if user_id:
    requests.put(
        f"https://api.nuvia.ai/v1/conversations/{conversation_id}/assign-owner",
        headers={"Authorization": f"Bearer {os.environ['NUVIA_API_KEY']}"},
        json={"userId": user_id},
    )