API para agencias #

Como agencia, puede utilizar la misma API REST que utilizan sus clientes, pero dirigiendo las solicitudes individuales a una de sus subcuentas gestionadas en lugar de a su propia cuenta. Esto le permite crear herramientas que incorporen a un cliente de principio a fin: creando sus agentes de IA, entrenando a su IA en una base de conocimientos, importando sus contactos, conectando sus canales de mensajería y comprando números de teléfono, todo ello sin tener que iniciar sesión manualmente en cada subcuenta.

Esta página cubre únicamente el comportamiento específico de la agencia: cómo actuar en nombre de una subcuenta con el parámetro sub_account_id. Para conocer los aspectos básicos (generación de claves, autenticación, URL base, formato de error, límites de velocidad), comience con la guía de Acceso a la API. Todo lo que se indica allí también se aplica aquí: usted se autentica con la clave de API de su cuenta de agencia.

Cómo funciona “actuar en nombre de” #

De forma predeterminada, cada solicitud de API actúa sobre la cuenta propietaria de la clave de API: su cuenta de agencia. Para actuar en nombre de una cuenta de cliente gestionada, añada el parámetro opcional sub_account_id a la solicitud, configurado con el ID de cuenta de dicho cliente.

• Omitir sub_account_id → la solicitud actúa sobre su propia cuenta de agencia.
• Incluir sub_account_id → la solicitud actúa sobre esa subcuenta, pero solo después de que la plataforma confirme que la subcuenta es realmente suya.

Usted siempre se autentica con la clave de API de su cuenta de agencia. Nunca necesita la clave propia de la subcuenta y nunca maneja las credenciales de la subcuenta.

Dónde colocarlo #

• Endpoints GET / DELETE → páselo como un parámetro de consulta: ?sub_account_id=THE_SUB_ACCOUNT_ID (junto con su apiKey, si se autentica mediante consulta).
• Endpoints POST / PUT / PATCH → inclúyalo en el cuerpo de la solicitud JSON como "sub_account_id": "THE_SUB_ACCOUNT_ID".
• Asistentes de IA → no hay nada que configurar. El servidor MCP lleva la misma configuración en sus herramientas, por lo que una conexión con su clave de agencia puede informar sobre cada cliente: simplemente nombre al cliente en su solicitud (“¿cuántos contactos tiene Bella’s Bistro?”). Las acciones de escritura también están disponibles: cada endpoint que acepta sub_account_id se expone como una herramienta, por lo que puede crear, cambiar y enviar en nombre de un cliente desde la misma conexión.

Cómo encontrar el ID de una subcuenta #

El sub_account_id es el identificador único de la cuenta del cliente. Puede obtener la lista de sus subcuentas y sus identificadores desde los endpoints de la API de SubAccounts (consulte la guía de Sub-Accounts) o desde la página de Sub Accounts en la barra lateral.

La propiedad siempre se verifica #

Cuando usted pasa un sub_account_id, la plataforma comprueba que la cuenta sea una subcuenta real y que pertenezca a su agencia. Solo entonces se procesa la solicitud.

Si el ID es desconocido, no es una subcuenta o pertenece a una agencia diferente, la solicitud fallará con una respuesta 404:

{
  "success": false,
  "error_code": 404,
  "error": "Sub-account not found."
}

¿Por qué 404 y no 403? Una respuesta de “prohibido” le diría a un extraño que el id existe pero no le pertenece. Devolver el mismo 404 para “no existe” y “no es tuyo” significa que el endpoint no puede utilizarse para descubrir qué ids de cuenta pertenecen a otras agencias. Trata un 404 aquí como “esta no es una subcuenta que tú administras”.

Dónde se admite sub_account_id #

sub_account_id se acepta en prácticamente todos los endpoints de recursos: cualquier llamada que cree, lea, actualice o elimine los datos propios de una cuenta. En la práctica, puede aprovisionar y ejecutar toda la configuración de una subcuenta con su clave de agencia:

• Configuración de IA — campañas, agentes, preguntas frecuentes, fuentes de la base de conocimientos (rastreo de sitios web y carga de documentos), grupos de bases de conocimientos, difusiones, funciones personalizadas, servidores MCP
• Contactos y CRM — contactos (incluida la importación), listas, etiquetas, tareas, tratos, citas, eventos
• Canales y números — conectar WhatsApp / WhatsApp Web / Telegram / Instagram y Messenger / LINE, buscar / comprar / gestionar números de teléfono, plantillas de WhatsApp, enrutamiento de canales
• Mensajería y contenido — enviar mensajes, sesiones de chat, exportaciones de chat, resúmenes diarios
• Configuración e integraciones — webhooks, configuración del widget de chat, configuración de marca blanca (white-label), SMS BYOK y otros ajustes de cuenta, análisis, el registro de errores

En cada uno de estos casos, el parámetro es opcional: si lo omite, la llamada actúa sobre su propia cuenta de agencia, por lo que una única integración sirve para ambos. Los créditos y el uso siempre provienen de la cuenta a la que se dirige: los cargos por las respuestas de IA, mensajes, etiquetas y números de una subcuenta se aplican al saldo de la subcuenta.

Dónde NO se aplica #

Algunos endpoints son de nivel de agencia o se dirigen a sí mismos e ignoran sub_account_id:

• Gestión de las subcuentas en sí — los endpoints de SubAccounts (crear / listar / actualizar una subcuenta) y el endpoint de límite de gasto BYOK ya nombran la subcuenta en su propia ruta URL. Los endpoints de precios y políticas y los endpoints de monitoreo de chat siguen el mismo patrón.
• Copiar un agente entre cuentas — POST /v1/subaccounts/agents/copy nombra ambas cuentas por sí mismo, tomando el destino como targetUserId. Consulte el ejemplo práctico a continuación. (El POST /v1/subaccounts/campaigns/copy más antiguo funciona de la misma manera, pero está obsoleto junto con el resto de la API de campañas.)
• Ajuste de créditos y los dos resúmenes de toda la agencia — POST /v1/subaccounts/credits identifica la subcuenta mediante email en su lugar; GET /v1/subaccounts/credit-usage y GET /v1/subaccounts/campaign-status informan sobre cada subcuenta a la vez, por lo que no hay una cuenta única a la que dirigirse.
• La propia cuenta de su agencia — la gestión de claves API, los informes de uso de la agencia, la gestión de equipos y sus niveles de precios siempre actúan sobre su cuenta de agencia.
• Agregar contactos a una lista o eliminarlos de ella: POST / DELETE /v1/contacts/lists y POST /v1/contacts/lists/batch actúan sobre la cuenta que posee la clave. Crear, editar y eliminar las listas en sí (/v1/lists) sí requiere sub_account_id.
• Webhooks de mensajes entrantes — los endpoints en los que los sistemas externos publican información están vinculados a la cuenta cuyas credenciales los configuraron, por lo que no hay nada que redirigir.

La lista siempre actualizada y legible por máquina de los parámetros que acepta cada endpoint se encuentra en la referencia de la API de su panel de control (Settings → Integrations → API Key) y en la especificación OpenAPI en GET /v1/docs/openapi.yaml. Realizamos cambios en la API con frecuencia; considérelos como la fuente de información definitiva.

Enumere sus subcuentas o consulte un correo electrónico #

GET /v1/subaccounts

Si se llama sin parámetros, devuelve todas las subcuentas de su agencia en una matriz data. Añada el parámetro de consulta opcional email para buscar un cliente específico:

curl "https://api.dmchamp.com/v1/[email protected]&apiKey=YOUR_API_KEY"

• Ese correo electrónico pertenece a una de sus subcuentas activas → HTTP 200, con solo esa cuenta: { "success": true, "data": { ... } }.
• No pertenece → HTTP 404, Agency Sub Account not found.

No existe ningún parámetro que responda con un sí o un no, así que consulte el código de estado: 200 significa que el correo electrónico es uno de sus clientes, 404 significa que no lo es. Las subcuentas eliminadas se excluyen, por lo que una cuenta que usted eliminó también se lee como 404.

Cada cuenta se devuelve con su perfil, su configuración, sus límites de uso y las funciones que tiene activadas, que es todo lo que necesita para mostrar una fila de cliente en su propio panel de control.

La respuesta nunca contiene credenciales. Las claves de API, contraseñas, tokens de inicio de sesión y los detalles de los canales que un cliente ha conectado (Twilio, Google, Meta y bring-your-own-key) se eliminan antes de enviarse. No hay ningún parámetro para elegir qué campos recibe, así que lea los campos que necesite e ignore el resto.

Requiere acceso a la API y una cuenta de agencia.

Crear una cuenta de cliente #

POST /v1/subaccounts

La creación de la cuenta es una llamada con el correo electrónico, el nombre y el nombre comercial del cliente. Hay algunas cosas que vale la pena saber antes de crear su flujo de registro.

No puede elegir la contraseña. No hay campo de contraseña: se genera una para usted y se le entrega una vez, como temporary_password en la respuesta 201. Guárdela o transmítala de inmediato, porque no se le volverá a mostrar. El cliente puede cambiarla desde su perfil o restablecerla desde la pantalla de inicio de sesión.

curl -X POST "https://api.dmchamp.com/v1/subaccounts" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "first_name": "Alex",
    "last_name": "Client",
    "business_name": "Client Co",
    "send_account_info_to_sub_account": true
  }'

No se envía nada por correo electrónico al cliente a menos que usted lo solicite. Por defecto, la cuenta se crea de forma silenciosa y es su trabajo informar al cliente. Envíe send_account_info_to_sub_account: true y recibirán un correo electrónico de bienvenida con su dirección de correo electrónico, esa contraseña temporal y un enlace para iniciar sesión, todo en su propio dominio de marca blanca y bajo su marca.

La bandera solo cubre el correo electrónico del cliente. Su agencia siempre recibe un aviso de Nueva subcuenta creada, pero nunca contiene la contraseña: por seguridad, la respuesta 201 es el único lugar donde la obtendrá. Si se pierde, el cliente establece la suya propia con ¿Olvidó su contraseña? en la pantalla de inicio de sesión.

Los créditos iniciales dependen de usted. usage_limits.credits es el límite de gasto inicial del cliente y usage_limits.monthly_credits es la asignación mensual recurrente. Envíe "credits": 0 y la cuenta comenzará sin nada para gastar; omita credits y comenzará con un saldo único de 100 créditos para que la IA pueda responder de inmediato. Ninguna de las opciones retira nada de su fondo de agencia al momento de la creación: su fondo solo se carga a medida que el cliente utiliza los créditos realmente.

Los nombres comerciales deben ser únicos dentro de su agencia. Dos de sus clientes no pueden llamarse ambos “Client Co”, porque ese nombre es lo que identifica a la cuenta en su panel de control y en sus informes. Los nombres de otras agencias no influyen.

Cuando la llamada falla:

Eliminar una cuenta de cliente #

DELETE /v1/[email protected] (o ?uid=SUB_ACCOUNT_UID)

curl -X DELETE "https://api.dmchamp.com/v1/[email protected]" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY"

Esto es lo mismo que el botón de eliminar en la página de Subcuentas, y no se puede deshacer. El cliente queda bloqueado inmediatamente y ya no cuenta para el total de sus clientes; sus conversaciones, contactos, agentes y canales conectados se borran en segundo plano durante los siguientes minutos. Cualquier plan que el cliente haya comprado a través de su proceso de pago se cancela.

{
  "success": true,
  "message": "Sub-account deletion started",
  "data": { "uid": "SUB_ACCOUNT_UID", "email": "[email protected]", "status": "deletion_started" }
}

• Pase email o uid. Si pasa ambos, deben referirse al mismo cliente.
• Solo se pueden eliminar sus propios clientes. Cualquier otro correo electrónico o uid, o un cliente que ya haya sido eliminado, devolverá 404.
• Llamar a esta función de nuevo mientras la eliminación sigue en curso devolverá 200 con "status": "already_in_progress".
• Los asistentes de IA conectados a través del servidor MCP tienen esto como la herramienta delete_subaccount cuando están conectados a la dirección MCP estándar (las herramientas de agencia se excluyen de una dirección MCP de marca blanca).
• Para detener a un cliente por un tiempo sin perder nada, paúselo en su lugar: se les bloquea el acceso, se conserva todo y una sola llamada lo restaura.

Ejemplo práctico: conectar Instagram y Messenger para una subcuenta #

Conectar Instagram y Messenger es un flujo basado en navegador. Lo inicias con la API, entregas la URL de consentimiento devuelta al cliente (o la abres por él), esperas a que autorice en su navegador y luego eliges qué página conectar, todo ello mientras apuntas a su subcuenta con sub_account_id.

Paso 1 — Iniciar la conexión #

Llama al endpoint de conexión con el sub_account_id del cliente en el body. Aquí no se envían credenciales; la plataforma devuelve una URL de consentimiento que el cliente debe abrir en un navegador, además de un token de correlación de un solo uso.

cURL

curl -X POST "https://api.dmchamp.com/v1/channels/meta/connect?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sub_account_id": "abc123def456"
  }'

JavaScript

const res = await fetch("https://api.dmchamp.com/v1/channels/meta/connect", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    sub_account_id: "abc123def456",
  }),
});

const data = await res.json();
// data.oauth_url -> open this in the client's browser

Python

import requests

res = requests.post(
    "https://api.dmchamp.com/v1/channels/meta/connect",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "sub_account_id": "abc123def456",
    },
)

data = res.json()
# data["oauth_url"] -> open this in the client's browser

Respuesta:

{
  "success": true,
  "oauth_url": "https://www.facebook.com/v21.0/dialog/oauth?client_id=...&state=...",
  "state_token": "8sFq2yV0kQ7m4n1pZr3tWb6cXe9hJl2aD5gK7uN0oI",
  "expires_at": "2026-06-10T12:30:00.000Z"
}

Envía al cliente a oauth_url en un navegador para autorizar. El state_token correlaciona este intento y es un secreto de corta duración; no lo registres. El intento caduca en expires_at; si vence, comienza de nuevo.

Paso 2 — Realizar sondeos hasta que las páginas se carguen #

Después de que el cliente autorice, consulte el endpoint de estado (con el mismo sub_account_id, esta vez como parámetro de consulta) hasta que aparezcan las páginas conectables.

cURL

curl "https://api.dmchamp.com/v1/channels/meta/status?apiKey=YOUR_API_KEY&sub_account_id=abc123def456"

JavaScript

const res = await fetch(
  "https://api.dmchamp.com/v1/channels/meta/status?sub_account_id=abc123def456",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);

const data = await res.json();
// Wait until data.status === "pages_loaded", then read data.pages

Python

import requests

res = requests.get(
    "https://api.dmchamp.com/v1/channels/meta/status",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"sub_account_id": "abc123def456"},
)

data = res.json()
# Wait until data["status"] == "pages_loaded", then read data["pages"]

Respuesta:

{
  "success": true,
  "status": "pages_loaded",
  "pages": [
    {
      "id": "1098765432101234",
      "name": "Acme Studio",
      "category": "Hair Salon",
      "instagram_business_account": {
        "id": "17841400000000000",
        "username": "acme.studio"
      }
    }
  ],
  "selected_page": null
}

El campo status avanza a través de pending → token_received → pages_loaded → connected. Espere a pages_loaded antes de seleccionar una página. También pueden aparecer dos estados de error terminal en lugar de avanzar: failed y expired (el cliente rechazó el consentimiento o el periodo de ~30 minutos del token de estado ha caducado); se incluye un campo reason cuando ocurre cualquiera de ellos. Deje de realizar sondeos y reinicie en el Paso 1 si ve uno; no espere en pending indefinidamente. Los tokens de acceso a la página nunca se devuelven.

Paso 3 — Seleccionar la página para conectar #

Elija uno de los identificadores de página del Paso 2 y selecciónelo. Al seleccionar una página, se conectan tanto Instagram como Messenger para dicha página. Incluya sub_account_id en el cuerpo nuevamente.

cURL

curl -X POST "https://api.dmchamp.com/v1/channels/meta/select-page?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page_id": "1098765432101234",
    "sub_account_id": "abc123def456"
  }'

JavaScript

const res = await fetch("https://api.dmchamp.com/v1/channels/meta/select-page", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    page_id: "1098765432101234",
    sub_account_id: "abc123def456",
  }),
});

const data = await res.json();

Python

import requests

res = requests.post(
    "https://api.dmchamp.com/v1/channels/meta/select-page",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "page_id": "1098765432101234",
        "sub_account_id": "abc123def456",
    },
)

data = res.json()

Respuesta:

{
  "success": true,
  "page_id": "1098765432101234",
  "instagram_business_account_id": "17841400000000000"
}

Eso es todo: Instagram y Messenger ya están conectados en la subcuenta del cliente. Usted solo proporcionó el page_id; la credencial subyacente se resuelve en el servidor y nunca pasa a través de su integración.

Ejemplo práctico: comprar un número para una subcuenta #

La compra de un número funciona de la misma manera: busque con sub_account_id en la consulta y luego realice la compra incluyéndolo en el cuerpo. Los créditos se deducen del saldo de la subcuenta y el número se aprovisiona en la subcuenta.

Búsqueda (cURL):

curl "https://api.dmchamp.com/v1/phone-numbers/available?apiKey=YOUR_API_KEY&country_code=US&sub_account_id=abc123def456"

Compra (JavaScript):

const res = await fetch("https://api.dmchamp.com/v1/phone-numbers", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+14155551234",
    country_code: "US",
    display_name: "Support line",
    sub_account_id: "abc123def456",
  }),
});

const data = await res.json();

Compra (Python):

import requests

res = requests.post(
    "https://api.dmchamp.com/v1/phone-numbers",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "phone_number": "+14155551234",
        "country_code": "US",
        "display_name": "Support line",
        "sub_account_id": "abc123def456",
    },
)

data = res.json()

Respuesta:

{
  "success": true,
  "phone_number": "+14155551234",
  "channel": "whatsapp",
  "whatsapp_status": "PURCHASED",
  "outgoing_status": "PURCHASED",
  "status": "PURCHASED",
  "purchase_credits": 11.5,
  "monthly_credits": 11.5
}

El número se aprovisiona en el estado PURCHASED y el registro del remitente de WhatsApp continúa en segundo plano. Realice sondeos en GET /v1/phone-numbers/{phoneNumber}/status?sub_account_id=abc123def456 hasta que el estado llegue a ONLINE antes de enviar.

Ejemplo práctico: enviar un Agente de plantilla a cada cliente nuevo #

El patrón habitual de las agencias es mantener un Agente maestro en su cuenta de agencia, configurado de la forma en que desea que cada cliente comience, y estampar una copia del mismo en cada subcuenta nueva en el momento del aprovisionamiento. Son tres llamadas y no es necesario repetir nada después: la copia conserva su configuración hasta que usted la cambie.

Paso 1 — Copiar el Agente #

POST /v1/subaccounts/agents/copy

curl -X POST "https://api.dmchamp.com/v1/subaccounts/agents/copy?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "YOUR_TEMPLATE_AGENT_ID",
    "targetUserId": "abc123def456",
    "newName": "Inbound Instagram Leads",
    "copyFaqs": true
  }'

La respuesta contiene el id del nuevo Agente en data.agent_id. Las preguntas frecuentes, la base de conocimientos y la biblioteca de medios se incluyen; las plantillas de WhatsApp, las publicaciones sociales conectadas y los contactos de la cuenta de origen deliberadamente no se incluyen. Lista completa de campos en la API de Agentes de IA.

Ten en cuenta que este endpoint utiliza targetUserId en lugar de sub_account_id; nombra ambas cuentas por sí mismo. Las dos llamadas siguientes utilizan el parámetro normal sub_account_id.

Paso 2 — Activarlo #

La copia siempre llega en pausa, por lo que no puede enviar mensajes a nadie hasta que usted lo indique. Este es también el momento de fijar el nivel de IA en el que desea que esté el cliente; permanece allí, por lo que no es necesario volver a aplicarlo según un cronograma.

curl -X PATCH "https://api.dmchamp.com/v1/agents/NEW_AGENT_ID/active?apiKey=YOUR_API_KEY&sub_account_id=abc123def456" \
  -H "Content-Type: application/json" \
  -d '{ "active": true }'

curl -X PUT "https://api.dmchamp.com/v1/agents/NEW_AGENT_ID?apiKey=YOUR_API_KEY&sub_account_id=abc123def456" \
  -H "Content-Type: application/json" \
  -d '{ "anthropic_model": "max" }'

Para evitar que el cliente cambie el nivel después, bloquee los niveles permitidos en la subcuenta en lugar de volver a enviar el valor.

Paso 3 — Dirigir los canales del cliente hacia ella #

La copia tampoco llega con enrutamiento, por lo que nada llega a ella hasta que usted la convierte en el respondedor en los canales que el cliente ha conectado. Una llamada por canal:

curl -X PUT "https://api.dmchamp.com/v1/entry-points/channel-defaults?apiKey=YOUR_API_KEY&sub_account_id=abc123def456" \
  -H "Content-Type: application/json" \
  -d '{ "channel": "instagram", "agent_id": "NEW_AGENT_ID" }'

A partir de aquí, un mensaje inicial de un contacto desconocido en ese canal es captado automáticamente por el Agente copiado. Consulte Apuntar un canal a un Agente para conocer los otros canales y el enrutamiento por número.

Establezca la zona horaria del cliente al crear la subcuenta. Pase time_zone_id en POST /v1/subaccounts. El horario de actividad de un agente se evalúa en la propia zona horaria de la subcuenta, por lo que si un cliente se crea sin una, su horario se lee en UTC, lo que cambia silenciosamente cuándo se le permite responder al asistente.

Omitir el asistente de configuración para un cliente que usted mismo configura #

POST /v1/subaccounts

De forma predeterminada, la primera vez que el propietario de una nueva subcuenta inicia sesión, se le guía a través del Asistente de configuración. Para clientes con servicio completo —donde usted crea el agente de IA y conecta los canales antes de que el cliente inicie sesión—, pase guided_onboarding: false al crear la cuenta. En su lugar, accederán a la pantalla de inicio normal (el panel de control en un ordenador, sus chats en un teléfono) y la entrada del Asistente de configuración estará oculta en su barra lateral.

curl -X POST "https://api.dmchamp.com/v1/subaccounts" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "first_name": "Alex",
    "last_name": "Client",
    "business_name": "Client Co",
    "guided_onboarding": false,
    "usage_limits": { "monthly_credits": 500 }
  }'

Omite el campo (o envía true) y el asistente se comportará exactamente como siempre lo ha hecho, por lo que las integraciones existentes no necesitan cambios. Para devolverle el asistente a un cliente más tarde, vuelve a mostrar el elemento guided_onboarding con PUT /v1/subaccounts/{subAccountUid}/menu-visibility (a continuación): la visibilidad del menú controla si el asistente es accesible, guided_onboarding controla solo la redirección del primer inicio de sesión.

Desactivar Tareas, Resúmenes diarios o la Biblioteca de medios para un cliente #

POST /v1/subaccounts

Estas tres funciones están activadas para cada cliente nuevo a menos que indique lo contrario, y se comportan de forma diferente a cualquier otra función de esta guía: son de exclusión voluntaria (opt-out), no de inclusión. Dejarlas fuera de features no es suficiente por sí solo, porque la lista features de una integración antigua simplemente no las mencionaba; no podemos distinguir entre “la agencia desactivó esto” y “esta lista se escribió antes de que existiera la opción”.

Por lo tanto, indíquelo explícitamente con feature_settings:

curl -X POST "https://api.dmchamp.com/v1/subaccounts" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "first_name": "Alex",
    "last_name": "Client",
    "business_name": "Client Co",
    "feature_settings": {
      "tasks": false,
      "daily_summaries": false,
      "ai_media_library": true
    }
  }'

Cada clave es opcional; todo lo que omita permanecerá activado. Con tasks: false, la IA deja de crear tareas para ese cliente y no se envían correos electrónicos de “Nueva tarea creada”; con daily_summaries: false, el resumen nocturno nunca se genera ni se envía por correo electrónico.

feature_settings es lo único que desactiva estas tres funciones en el momento de la creación. Dejarlas fuera de features no hace nada por sí solo, sin importar cómo se vea el resto de su lista; esto es deliberado, para que una integración antigua no pierda las tres funciones de forma silenciosa.

Para cambiar cualquiera de estos ajustes posteriormente, envíe la lista features completa a PUT /v1/subaccounts/{subAccountUid}/features; allí, la presencia en la lista activa una función y su ausencia la desactiva.

Inicie sesión automáticamente a sus clientes en su subcuenta (SSO) #

POST /v1/subaccounts/{subAccountUid}/sso-link

Una llamada con la clave API de su agencia devuelve una URL lista para abrir que inicia la sesión del cliente directamente en su propia subcuenta: sin pantalla de inicio de sesión, sin pasos de contraseña, nada que construir adicionalmente. Ábrala en una nueva pestaña, mediante una redirección o en un iframe dentro de su propio producto.

cURL

curl -X POST "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/sso-link" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "redirect": "/chats" }'

Respuesta

{
  "success": true,
  "url": "https://app.yourdomain.com/auth?redirect=%2Fchats#token=eyJhbGciOi…",
  "deep_link_url": "https://app.yourdomain.com/chats",
  "expires_at": "2026-07-22T15:04:05.000Z",
  "sub_account_uid": "SUB_ACCOUNT_UID"
}

Cómo utilizarlo correctamente:

• Un solo salto. Abrir url inicia la sesión del cliente y lo lleva directamente a la página redirect del panel de control; sin pantalla de inicio de sesión ni páginas intermedias. deep_link_url designa el mismo destino, para los integradores que prefieren navegar por un marco explícitamente después de iniciar sesión; una vez que existe la sesión, cualquier ruta del panel de control funciona en ese contexto del navegador.
• Crear bajo demanda, abrir inmediatamente. El enlace contiene una credencial de inicio de sesión y caduca después de aproximadamente una hora. Solicítelo en el lado del servidor en el momento en que el cliente haga clic, y nunca lo almacene ni lo envíe por correo electrónico.
• El token de inicio de sesión viaja en el fragmento de la URL (#…), que los navegadores nunca envían a los servidores, y se elimina de la barra de direcciones en el momento en que se consume.
• Solo sus propias subcuentas. El endpoint rechaza cualquier cuenta que su agencia no posea.
• Un enlace caducado muestra un error claro con una ruta de reintento: cree uno nuevo.

Ocultar elementos de navegación en una subcuenta #

PUT /v1/subaccounts/{subAccountUid}/menu-visibility

Controla qué elementos de la barra lateral y de configuración ve una subcuenta; es útil cuando integra el panel de control y solo desea las superficies que su producto aún no cubre. Todo lo que no esté en la lista permanece visible; envíe null como el valor completo de menuVisibility para restablecer todo a visible. Ocultar un elemento oculta la entrada del menú: combínelo con las funciones que otorga a la subcuenta para un control estricto.

cURL

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/menu-visibility" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "menuVisibility": {
      "side_nav": { "Dashboard": false, "Deals": false, "Automations": false },
      "settings_nav": { "team": false }
    }
  }'

Respuesta

{
  "success": true,
  "data": {
    "subAccountUid": "SUB_ACCOUNT_UID",
    "menuVisibility": {
      "side_nav": { "Dashboard": false, "Deals": false, "Automations": false },
      "settings_nav": { "team": false }
    }
  }
}

side_nav acepta estas 13 claves, que coinciden con los nombres de los elementos de la barra lateral: Dashboard, DailySummaries, Chats, Contacts, Deals, Tasks, Automations, Campaigns, Appointments, Settings, Help, CreditsCounter (el saldo de crédito que se muestra en la barra lateral) y guided_onboarding (el Asistente de configuración). Campaigns solo oculta la página de Campañas retirada; las páginas de Agentes de IA y Difusiones no tienen clave y no se pueden ocultar de esta manera. Se aceptan tres claves adicionales (AiInsights, Sub Accounts y Agency Reselling), pero no hacen nada: solo se aplicaban al panel de control clásico retirado, por lo que configurarlas no tiene ningún efecto en sus subcuentas. Las claves que faltan significan que están visibles; cuando usted mismo inicia sesión en la subcuenta, los elementos ocultos se muestran temporalmente para que siempre pueda volver a cambiarlos.

El mismo objeto menuVisibility también acepta dos campos opcionales para el panel principal del cliente. dashboard_widgets asigna un id de widget a true (mostrado) o false (oculto), y dashboard_order es una lista de ids de widgets en el orden en que deben aparecer. Los ids, en su orden predeterminado, son kpis, performance, credits (Uso de créditos), funnel, inbox, outcomes, channel_health, ai_cost, ai_human, heatmap (Horas de mayor actividad), top_campaigns (Agentes principales), contacts_by_country, activity y tasks_deals. Los ids que falten permanecerán visibles, y los ids omitidos en dashboard_order seguirán el orden predeterminado. Por ejemplo, "dashboard_widgets": { "credits": false } oculta el panel de créditos del cliente.

Ocultar una página del menú nunca otorga acceso a ella. Automations necesita que la función automations esté concedida en la subcuenta; si establece la clave en true sin ella, la página seguirá sin aparecer. Tasks y DailySummaries funcionan a la inversa: están activadas para todos los clientes a menos que las desactive (consulte Desactivar Tareas, Resúmenes diarios o la Biblioteca de medios para un cliente).

Elija qué tipos de canal puede conectar un cliente #

PUT /v1/subaccounts/{subAccountUid}/features

Los interruptores de Tipos de canal que ve en un nivel de plan son ID de funciones comunes, por lo que puede configurarlos por cliente desde la API en lugar del panel de control. Este es uno de los puntos finales que nombra a la subcuenta en su propia URL, por lo que no requiere sub_account_id.

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/features" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "features": [
      "channels_3",
      "channel_chat_widget",
      "channel_whatsapp_web",
      "channel_instagram",
      "image_understanding",
      "contact_tagging",
      "incoming_campaigns",
      "webhooks"
    ]
  }'

Qué hacer correctamente:

• La llamada reemplaza toda la lista de funciones. Envíe todas las funciones que el cliente debe conservar, no solo las que va a cambiar. Los mismos IDs funcionan como features en POST /v1/subaccounts cuando crea la cuenta.
• Los tipos de canal y el número de canales son puertas separadas, y ambas se aplican. channels_1 / channels_3 / channels_unlimited controlan cuántas conexiones; los IDs de channel_* controlan qué tipos. El ejemplo anterior significa “hasta 3 conexiones, y solo Chat Widget, WhatsApp Web o Instagram”.
• automations_edit, broadcasts_send y smart_lists_create permiten al cliente crear, editar y eliminar sus propias automatizaciones, difusiones y listas inteligentes. Una lista que no menciona ninguno de los tres los deja tal como están (en una subcuenta nueva: los tres activados), por lo que una integración antigua sigue funcionando. Nombre al menos uno y la lista establecerá los tres: los que omita se desactivarán. El cliente puede seguir usando lo que usted configuró para él de cualquier manera, y su clave de API de agencia y sus propias sesiones en la cuenta del cliente nunca se ven restringidas por estos tres.
• Cualquier otra función es exactamente lo que dice la lista, al crear y al actualizar. Un cliente creado o actualizado con una lista features obtiene esas funciones y nada más. Eso incluye crm_erp_integrations (la sección de integraciones de CRM y ERP, donde un cliente conecta Odoo): solo está activada cuando su lista la incluye, así que agréguela si el cliente debe conectar un CRM o ERP. Un cliente creado sin ninguna lista features obtiene el conjunto predeterminado, que la incluye.
• No enviar ningún ID de channel_* significa que no hay restricción de canal. Ese es el comportamiento original, que es la razón por la que los clientes existentes no se vieron afectados cuando esto se lanzó. Envíe uno o más y todo lo demás aparecerá como bloqueado en la página de Canales del cliente con una nota de actualización en lugar de un botón de Conectar. Los canales que el cliente ya conectó siguen funcionando.

La configuración de la lista de canales en un nivel de plan, para que cada cliente que compre ese nivel la herede, se realiza en el panel de control bajo la configuración de su plan de agencia. Este punto final la establece en una subcuenta específica.

Establecer un límite exacto de miembros del equipo para un cliente #

PUT /v1/subaccounts/{subAccountUid}/limits

Las funciones de team_seats_* solo ofrecen niveles preestablecidos (3 / 5 / 10 / ilimitado). Para asignar a un cliente un número exacto de puestos de equipo (2, 7, 15, o cualquier otro), configure usage_limits.team_seats_limit en su lugar. Esta opción prevalece sobre los valores preestablecidos y la plataforma la aplica en cada invitación, adición directa y aceptación de invitación: una vez alcanzado el límite, se rechazan las invitaciones adicionales desde el lado del servidor.

• Un número entero positivo es el límite exacto.
• 0 significa que los miembros del equipo no están incluidos: el cliente no puede invitar a nadie.
• -1 significa ilimitado.
• null borra el límite personalizado y vuelve al valor preestablecido de team_seats_* que esté en la lista de funciones.

Reducir el límite nunca elimina a los miembros del equipo existentes; solo impide que se añadan otros nuevos.

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/limits" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usageLimits": { "team_seats_limit": 7 }
  }'

También puede establecerlo en el momento de la creación: POST /v1/subaccounts acepta usage_limits.team_seats_limit con la misma semántica. Para leer el valor actual, obtenga la subcuenta con GET /v1/subaccounts?email=... y consulte usage_limits.team_seats_limit (ausente/null = los valores preestablecidos deciden). El mismo endpoint también actualiza credits, monthly_credits, roll_over_to_next_month, rollover_cap_months, rollover_expiry_days y byok_monthly_limit_usd; envíe solo las claves que desee cambiar. Un creditManagementMode de nivel superior ("manual" o "reselling") cambia el modo de crédito del cliente; una subcuenta creada a través de la API comienza en modo manual, así que cámbiela a "reselling" antes de que el cliente pague a través de su proceso de pago en Modo SaaS (consulte Subcuentas, Ejecución de una prueba gratuita).

Cómo interactúa esto con los límites de asientos de los planes SaaS. Sus planes SaaS pueden tener su propia asignación de asientos (configurada en el editor de planes; consulte Asientos de equipo en un plan), la cual se aplica automáticamente cuando un cliente se suscribe. Un límite que usted establezca a través de este endpoint cuenta como una concesión manual: comprar un plan lo reemplaza con la propia asignación de asientos del plan (esa compra es una elección explícita del plan), pero las renovaciones mensuales automáticas nunca sobrescriben un límite manual; por lo tanto, una excepción única que usted otorgue a un cliente persiste durante su ciclo de facturación. Borrar el límite manual con null devuelve el control del campo al plan en su próxima renovación.

Limite lo que un cliente transfiere entre renovaciones. Dos claves usage_limits adicionales se encuentran junto a roll_over_to_next_month. Ambas también son aceptadas por POST /v1/subaccounts en el momento de la creación, y null borra cualquiera de las dos.

Si no se establecen, ambos recurren al plan del cliente; un valor enviado aquí prevalece sobre el del plan. Solo los créditos recurrentes (la asignación mensual y los créditos del plan) están sujetos a ellos: las recargas, las recargas automáticas y las adiciones únicas nunca se limitan ni caducan. Cada recorte se registra en el historial de créditos del cliente como un Ajuste de crédito por límite de transferencia o un Ajuste de crédito por créditos caducados y nunca cuenta como uso. Los equivalentes a nivel de plan son rollover_cap_months y rollover_expiry_days en un nivel de precios: consulte Los campos en un nivel y Limitar lo que se transfiere.

Establecer precios y políticas de IA por cliente #

PUT /v1/subaccounts/{subAccountUid}/max-tier · /ai-tiers · /max-rate · /action-pricing · /insider-rate · /locked-bot-fields · /notifications · /zero-credit-reply

Ocho interruptores más por cliente, junto con /limits, /features y /menu-visibility anteriores. Cada uno toma el uid de la subcuenta en la URL (sin sub_account_id cuerpo/parámetro de consulta: el objetivo ya está nombrado en la ruta) y tiene el mismo alcance: su clave de agencia, y la subcuenta debe pertenecer a su agencia.

Qué modelos de IA puede usar un cliente

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/max-tier" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

{ "enabled": boolean } permite que el cliente se suscriba (o se dé de baja) al nivel Max AI, al precio de lista de la plataforma. Activar esto para un cliente con BYOK cambia su coste de IA de “0 créditos, pagados con mi propia clave” a “cargado contra mi fondo de créditos”, por lo que es una decisión deliberada por cliente en lugar de un valor predeterminado para toda la agencia.

Para restringir de QUÉ niveles pueden elegir los agentes de un cliente (en lugar de solo limitar el máximo), utilice ai-tiers:

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/ai-tiers" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "allowed_ai_tiers": ["standard", "economy"] }'

allowed_ai_tiers es una matriz extraída de standard, economy, max, mini — REEMPLAZA la lista de permitidos del cliente. Envía null (o []) para borrar la restricción y permitirles elegir cualquier nivel. Una lista establecida aquí cuenta como un bloqueo manual: el allowed_ai_tiers propio de un plan (consulta Gestiona tus niveles de precios a través de la API) ya no afecta a este cliente en la renovación. Esto es importante porque una subcuenta que elige su propio nivel de IA gasta de tu fondo de crédito, por lo que es la palanca para fijar qué modelos puede utilizar un cliente revendedor que aumenten tu factura.

Una respuesta de espera mientras el cliente no tiene créditos

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/zero-credit-reply" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "message": "Thanks for your message, we will get back to you shortly." }'

Cuando el saldo del cliente (o su grupo) está vacío, la IA no puede responder y el contacto no recibe nada. Con enabled: true, cada contacto que escribe durante la interrupción recibe message una vez (máximo 500 caracteres, enviado tal cual en cada canal), y la IA responde a esas conversaciones de verdad una vez que los créditos vuelven. enabled: false guarda el texto para más tarde; enabled: false sin message elimina la configuración. Es el mismo interruptor que Respuesta de espera cuando no hay créditos en el modal de edición de la subcuenta: consulte Una respuesta de espera mientras un cliente no tiene créditos.

Lo que paga un cliente por acción de IA y el margen de beneficio de la tarifa de WhatsApp

Dos formas de establecer su tarifa orientada al cliente, desde la más simple hasta la más granular:

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/max-rate" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rate": 0.35 }'

rate es el precio en créditos que consume el saldo PROPIO de la subcuenta por cada acción de IA del modelo Max: su margen de beneficio orientado al cliente sobre lo que realmente paga su fondo. null borra la anulación y vuelve al precio de lista de la plataforma. La tarifa debe ser al menos lo que cuesta una acción Max para su propio fondo (por lo que nunca puede cobrar a un cliente por debajo de su costo) y no más de 10 créditos; una solicitud fuera de ese rango se rechaza con el límite inferior calculado en el mensaje de error.

Para precios por tipo de acción en lugar de una tarifa Max plana, use action-pricing:

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/action-pricing" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionPricing": {
      "AI_MESSAGE": 0.6,
      "CHAT_SUMMARY": 0.15,
      "wa_carrier_multiplier": null
    }
  }'

actionPricing es una FUSIÓN en el mapa existente del cliente: una clave que no menciona se deja como estaba, y null restablece esa clave a su valor predeterminado. Las claves reconocidas:

Las tarifas por acción deben ser un número mayor que 0 y hasta 10; wa_carrier_multiplier debe ser al menos 1 (sin descuentos por debajo del costo) y hasta 10. Enviar una clave no reconocida, o un valor fuera de rango, rechaza TODA la solicitud y nombra cada clave infractora, por lo que un error tipográfico nunca puede guardar silenciosamente un precio que en realidad no se aplica.

Si eres miembro de Champions Circle, insider-rate transfiere tu Tarifa de Insider (20% de descuento en acciones Max y Mini, leads y automatizaciones de Lead Finder) a un solo cliente en lugar de aplicarla a toda la agencia:

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/insider-rate" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

Activarla requiere que tu propia cuenta de agencia tenga realmente una membresía Circle; desactivarla nunca lo requiere, por lo que un miembro cuya membresía haya caducado siempre puede revertir los cambios de un cliente.

Bloquear secciones del manual de estrategias de un cliente

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/locked-bot-fields" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "locked_bot_fields": ["instructions", "rules"] }'

locked_bot_fields es una lista de las secciones del playbook que se deben congelar, y REEMPLAZA la lista bloqueada del cliente. Envía null (o []) para desbloquear todo. Útil para clientes con servicio gestionado donde tú eres el dueño del playbook y se te evalúa por el resultado.

Los agentes creados en el editor actual mantienen su playbook en estas secciones, por lo que estas son las que se deben bloquear:

Los agentes actuales nunca leen instructions, por lo que bloquear solo eso no protege nada en ellos: bloquea conversation_flow, rules y las otras secciones que el cliente no debería tocar.

Una sección bloqueada no puede ser modificada por nadie que haya iniciado sesión como cliente: ni el propio inicio de sesión del cliente, ni los miembros de su equipo, ni su propia clave API, ni tú mismo cuando cambias al panel del cliente desde tu cuenta de agencia. El cambio es rechazado en el agente activo, en un borrador no publicado y cuando se publica un borrador. Para editar una sección bloqueada tú mismo, utiliza la API con tu clave de agencia y sub_account_id, o desbloquéala, realiza el cambio y vuelve a bloquearla. Las secciones que no bloqueaste permanecen totalmente editables.

Establecer las preferencias de notificación de un cliente en su nombre

curl -X PUT "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/notifications" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notifications": {
      "settings": {
        "credit_alerts": { "enabled": true, "channels": ["email", "in_app"] },
        "new_contacts": { "enabled": false }
      }
    }
  }'

Solo cambian las categorías que envíes: cada una se combina con la configuración actual del cliente, y todas las categorías que omitas conservan su valor. Cada categoría en settings acepta enabled (booleano) y hasta tres channels de email, in_app, webhook. Envía null para restablecer los valores predeterminados de la plataforma.

Los siete endpoints responden { "success": true, "data": { "subAccountUid": "...", ...the field(s) you set... } } y se registran en la auditoría con el valor antes/después. Errores comunes: 403 si tu cuenta no es de Agencia/Desarrollador o la subcuenta no es tuya para administrar, 400 si no es una subcuenta de agencia o un valor está fuera de rango.

Pausar a un cliente que ha suspendido su suscripción #

POST /v1/subaccounts/{subAccountUid}/pause · POST /v1/subaccounts/{subAccountUid}/unpause

Cuando un cliente suspenda su suscripción con usted, pause su cuenta en lugar de eliminarla: todo lo que envíen se detendrá inmediatamente (mensajes salientes, difusiones, respuestas de IA en todos los canales) y, cuando inicien sesión, verán un bloqueo de Cuenta pausada a pantalla completa (con su mensaje opcional) en lugar de la aplicación. Nada se elimina ni se desconecta: los agentes, las difusiones, los canales conectados, los contactos y el historial de chat permanecen exactamente como están, por lo que al reanudar la cuenta, el cliente vuelve exactamente donde lo dejó, sin necesidad de volver a realizar la configuración.

cURL

curl -X POST "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/pause" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Your account is on hold — contact us to reactivate it.", "reason": "Subscription suspended per client email" }'

Respuesta

{
  "success": true,
  "data": {
    "subAccountUid": "SUB_ACCOUNT_UID",
    "paused": true,
    "level": "hard_blocked"
  }
}

Cuando el cliente regresa, POST /v1/subaccounts/SUB_ACCOUNT_UID/unpause (sin cuerpo) elimina el bloqueo, lo que permite que el envío de mensajes y las respuestas de la IA se reanuden de inmediato.

Información útil:

• Es el mismo estado que el interruptor de Bloqueo estricto del panel de control (Bloqueo / Pausa de una subcuenta): un cliente pausado a través de la API aparece como bloqueado en el panel de control y viceversa, y reanudar elimina un bloqueo colocado desde cualquier lado. El estado actual se puede leer desde el campo agency_block en GET /v1/subaccounts (level de "none", "soft_blocked" o "hard_blocked").
• Ambas llamadas son idempotentes. Pausar a un cliente que ya está pausado solo actualiza el mensaje, el motivo y la marca de tiempo; reanudar a un cliente activo no cambia nada.
• No se envía un correo electrónico automático al cliente: muchas agencias utilizan marca blanca, por lo que informar al cliente queda a su discreción.
• Su propia facturación de DM Champ no se ve afectada. Pausar a un cliente solo afecta su relación con él.
• Los asistentes de IA también pueden hacer esto: el servidor MCP expone estos puntos finales como las herramientas pause_subaccount y unpause_subaccount en la dirección MCP estándar (las herramientas de agencia se excluyen de una dirección MCP de marca blanca).

Otorgar o deducir créditos directamente #

POST /v1/subaccounts/credits

Añade o elimina una cantidad exacta de créditos del saldo de una subcuenta: el equivalente en la API al ajuste manual de crédito del panel de control. Este es un cambio de saldo único, distinto de las configuraciones recurrentes monthly_credits, roll_over_to_next_month, rollover_cap_months y rollover_expiry_days en PUT /v1/subaccounts/{subAccountUid}/limits.

Este es el único endpoint en esta página que identifica la subcuenta por correo electrónico en lugar de sub_account_id.

Reintento seguro. Envíe la misma clave de idempotencia cuando vuelva a intentar una llamada, por ejemplo después de un tiempo de espera, y los créditos solo se añadirán o eliminarán una vez. Durante 24 horas, una repetición con la misma clave y los mismos detalles devuelve la primera respuesta de nuevo (con un encabezado Idempotent-Replayed: true) en lugar de cambiar el saldo por segunda vez. La misma clave con un correo electrónico, cantidad o descripción diferente es rechazada (422), y una repetición que llega mientras la primera llamada aún se está ejecutando recibe un 409: espere un momento y vuelva a intentarlo. Las llamadas sin clave funcionan como antes.

cURL

curl -X POST "https://api.dmchamp.com/v1/subaccounts/credits" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: q3-bonus-client-example-com" \
  -d '{ "email": "[email protected]", "amount": 500, "description": "Q3 bonus credits" }'

Respuesta

{
  "success": true,
  "data": {
    "email": "[email protected]",
    "previous_balance": 1200,
    "adjustment": 500,
    "new_balance": 1700
  }
}

Un amount negativo que llevaría el saldo por debajo de cero se rechaza con 400, indicándole el saldo disponible y la cantidad que intentó deducir. Si el cliente está en modo de reventa, una cantidad añadida cuenta como créditos que ellos compraron: se toma de su fondo de créditos de agencia en ese momento, exactamente igual que una compra a través de su proceso de pago, y permanece tras su próximo reinicio mensual de la misma forma que lo haría una recarga real. Cuando su fondo no puede cubrir la cantidad, la llamada se rechaza con 402 y nada cambia, así que recargue primero su saldo de agencia. Una deducción a un cliente de reventa elimina los créditos solo del cliente; no se devuelve nada a su fondo. En un cliente con asignación estándar, una adición se trata como parte de su asignación recurrente y no toma nada de su fondo hasta que el cliente los gaste. De cualquier manera, son una adición única, por lo que un límite de transferencia o una fecha de caducidad establecida en la cuenta (o su plan) nunca los recortará; solo la asignación recurrente y los créditos del plan están sujetos a ellos.

Leer las conversaciones de una subcuenta #

GET /v1/subaccounts/{subAccountUid}/chats · GET /v1/subaccounts/{subAccountUid}/chats/{contactId}/messages

Le permite crear una vista de supervisión o soporte de las conversaciones de un cliente sin tener que iniciar sesión en su cuenta. Primero, enumere sus contactos con una vista previa del último mensaje y, a continuación, lea el historial completo de mensajes de un contacto.

Listar contactos

curl "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/chats?apiKey=YOUR_AGENCY_API_KEY&pageSize=25"

Respuesta

{
  "success": true,
  "data": {
    "contacts": [
      {
        "contactId": "contact456",
        "firstName": "Jamie",
        "lastName": "Lee",
        "phoneNumber": "+14155551234",
        "email": "[email protected]",
        "channel": "whatsapp",
        "lastActivityAt": "2026-08-30T14:22:00.000Z",
        "lastMessage": { "body": "Thanks, that fixed it!", "direction": "inbound", "timestamp": "2026-08-30T14:22:00.000Z" },
        "isBotActive": true,
        "markChatClosed": false
      }
    ],
    "subAccountName": "Client Co",
    "subAccountEmail": "[email protected]",
    "hasMore": true,
    "lastActivityAt": "2026-08-30T14:22:00.000Z"
  }
}

Los contactos se ordenan por actividad más reciente primero. Siga paginando con lastActivityAt mientras hasMore sea true.

Leer los mensajes de un contacto

curl "https://api.dmchamp.com/v1/subaccounts/SUB_ACCOUNT_UID/chats/contact456/messages?apiKey=YOUR_AGENCY_API_KEY&pageSize=30"

Respuesta

{
  "success": true,
  "data": {
    "messages": [
      {
        "messageId": "msg789",
        "body": "Thanks, that fixed it!",
        "direction": "inbound",
        "timestamp": "2026-08-30T14:22:00.000Z",
        "status": "received",
        "channel": "whatsapp",
        "botReply": false,
        "mediaUrl": null,
        "mediaContentType": null,
        "name": "Jamie Lee",
        "role": null
      }
    ],
    "contactInfo": { "firstName": "Jamie", "lastName": "Lee", "phoneNumber": "+14155551234", "channel": "whatsapp" },
    "hasMore": false,
    "oldestTimestamp": "2026-08-30T14:22:00.000Z"
  }
}

Los mensajes se devuelven del más reciente al más antiguo; navegue hacia atrás por el historial con beforeTimestamp.

Leer el uso de créditos y el estado de las campañas en toda su cartera #

GET /v1/subaccounts/credit-usage · GET /v1/subaccounts/campaign-status

Dos resúmenes estilo panel sobre todas las subcuentas que gestiona, para crear sus propios informes de agencia en lugar de hacer clic en cada cliente uno por uno.

Uso de créditos

curl "https://api.dmchamp.com/v1/subaccounts/credit-usage?apiKey=YOUR_AGENCY_API_KEY&from=2026-08-01&to=2026-08-31"

{
  "success": true,
  "data": {
    "subAccounts": [
      {
        "subAccountId": "abc123def456",
        "subAccountName": "Client Co",
        "subAccountEmail": "[email protected]",
        "totalCreditsUsed": 842,
        "totalCostUsd": 3.15,
        "byReason": { "AI reply": 620, "Chat summary": 80 },
        "topCampaigns": [{ "campaignName": "Inbound Leads", "creditsUsed": 500 }]
      }
    ],
    "totals": { "totalCreditsUsed": 842, "totalCostUsd": 3.15, "totalRecords": 214 },
    "dateRange": { "from": "2026-08-01", "to": "2026-08-31" },
    "hasMore": false,
    "lastTimestamp": null
  }
}

Pase subAccountId y la misma respuesta también incluirá records: cargos individuales con amount, reason, campaignName, contactName y timestamp. Un cliente que gasta con su propia clave BYOK en lugar de con sus créditos tendrá las cifras de coste/token ocultas (costsRedacted: true); eso es telemetría de costes de la plataforma, no algo que deba mostrarse a un revendedor.

Estado de la campaña

curl "https://api.dmchamp.com/v1/subaccounts/campaign-status?apiKey=YOUR_AGENCY_API_KEY&pageSize=20"

{
  "success": true,
  "data": {
    "totalSubAccounts": 34,
    "subAccountsWithIssues": 3,
    "totalLiveCampaigns": 51,
    "totalPausedCampaigns": 6,
    "subAccounts": [
      {
        "userId": "abc123def456",
        "email": "[email protected]",
        "displayName": "Jamie Lee",
        "businessName": "Client Co",
        "totalCampaigns": 2,
        "liveCampaigns": 1,
        "pausedCampaigns": 1,
        "hasIssues": true,
        "issueDetails": ["1 campaign paused"],
        "lastCampaignActivity": "2026-08-29T09:00:00.000Z"
      }
    ],
    "hasMore": true,
    "lastDocumentId": "abc123def456",
    "pageSize": 20
  }
}

Cada fila también incluye los recuentos de Agentes de IA del cliente (totalAgents, activeAgents, pausedAgents, draftAgents), y el nivel superior añade totalActiveAgents y totalPausedAgents para la página. Los campos de campaña cubren solo las campañas clásicas. hasIssues / issueDetails marcan subcuentas que vale la pena revisar. En una cuenta con agentes, provienen de la puntuación de preparación de los agentes activados (por ejemplo, "WhatsApp Web is disconnected" o "Agent \"Front desk\": Routed on a channel that is not connected"); los agentes desactivados nunca se marcan. En una cuenta sin agentes, marcan las campañas clásicas, como una pausada. Utilice esto para crear un panel de control de estado para toda la cartera en lugar de abrir cada cliente para ver qué agentes están desactivados.

Para ver la mensajería de series temporales y la actividad de créditos de todos los clientes (una serie lista para gráficos en lugar de una instantánea puntual), consulte GET /analytics/agency-rollup en la guía de la API de Analytics.

Entregar una cuenta de cliente que ya esté configurada #

PUT /v1/snapshots/default · POST /v1/snapshots/{snapshotId}/apply

Una instantánea es una plantilla reutilizable: uno o más agentes de IA junto con su base de conocimientos, herramientas y medios, capturados desde su propia cuenta. Dos endpoints la integran en su flujo de aprovisionamiento.

Automático: cada cliente nuevo la recibe al crearse. Marque una instantánea como predeterminada una vez y cada cuenta que cree a partir de entonces llegará con ella instalada. Esto cubre las cuentas creadas a través de POST /v1/subaccounts, las cuentas que cree en el panel de control y las cuentas creadas automáticamente cuando un cliente paga a través de su enlace de pago.

Primero, busque el id de la instantánea:

curl "https://api.dmchamp.com/v1/snapshots" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY"

Luego, establézcala como predeterminada:

curl -X PUT "https://api.dmchamp.com/v1/snapshots/default" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "snapshot_id": "SNAPSHOT_ID" }'

Esa es toda la integración. Envíe {"snapshot_id": null} para desactivarla de nuevo. Puede hacer lo mismo desde el panel de control haciendo clic en la estrella en la página de Instantáneas.

Para leer lo que está marcado actualmente (por ejemplo, antes de que un script de aprovisionamiento decida si establecer uno), GET /v1/snapshots/default devuelve { "success": true, "data": { "default_snapshot_id": "SNAPSHOT_ID" } } — null cuando no hay nada marcado. GET /v1/snapshots (utilizado para encontrar el id anterior) devuelve el mismo default_snapshot_id junto con la matriz completa snapshots, por lo que la mayoría de las integraciones solo necesitan esa llamada. Los campos completos del objeto de instantánea se encuentran en la guía de Instantáneas.

Bajo demanda: instalar en una cuenta. Útil para la incorporación de un cliente existente o para proporcionar a un cliente una segunda plantilla más adelante.

curl -X POST "https://api.dmchamp.com/v1/snapshots/SNAPSHOT_ID/apply" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sub_account_id": "SUB_ACCOUNT_UID" }'

Omita sub_account_id y se instalará en su propia cuenta de agencia. Al igual que los endpoints /subaccounts, estos nombran la cuenta de destino en la ruta o el cuerpo en lugar de a través del parámetro sub_account_id ambiental.

Vale la pena saberlo antes de trabajar con esto:

• Los agentes instalados comienzan en pausa. Conecte primero los canales del cliente y luego active el agente. Esto es válido tanto para la ruta automática como para la ruta bajo demanda.
• El aprovisionamiento nunca falla debido a una instantánea. Si la instalación no puede completarse, la cuenta del cliente se crea y es utilizable de todos modos; simplemente llega vacía y puede aplicar la instantánea después.
• Los canales, calendarios y conexiones OAuth nunca se copian. Cada cuenta conecta los suyos propios. Las herramientas que utilizan una clave API simple siguen funcionando de inmediato.
• Aplicarla dos veces crea una segunda copia. No se sobrescribe nada.

Crea la plantilla directamente a través de la API #

POST /v1/snapshots · agentes, funciones personalizadas y medios a través de la API

La sección anterior distribuye una instantánea creada por alguien en el panel de control. La parte de creación también está expuesta, por lo que todo el ciclo —ensamblar la configuración maestra una vez, capturarla y entregarla a cada cliente— puede ejecutarse desde el código.

Las piezas, en el orden en que las utiliza un script de aprovisionamiento:

1. Crea tus funciones personalizadas. POST /v1/custom-functions crea una; GET /v1/custom-functions enumera las que tienes, y GET, PUT y DELETE en /v1/custom-functions/{customFunctionId} leen, actualizan y eliminan una. POST /v1/custom-functions/test realiza una prueba de ejecución de una definición antes de guardarla.
2. Crea y configura el agente. POST /v1/agents lo crea, PUT /v1/agents/{agentId} lo actualiza, y PATCH /v1/agents/{agentId}/active con { "active": false } lo mantiene en pausa mientras trabajas (la misma llamada con true lo pone en funcionamiento). GET /v1/agents los enumera.
3. Dale habilidades al agente. POST /v1/agents/{agentId}/custom-functions con { "custom_function_id": "..." } adjunta una función al agente; el DELETE /v1/agents/{agentId}/custom-functions/{customFunctionId} correspondiente la desvincula.
4. Completa la biblioteca de medios. POST /v1/agents/{agentId}/media-library sube un elemento (JSON con base64Data, mimeType, title, description); GET enumera los elementos del agente, y PATCH/DELETE en /{itemId} actualizan o eliminan uno.
5. Captúralo como una instantánea.

curl -X POST "https://api.dmchamp.com/v1/snapshots" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Master setup v1",
    "agent_ids": ["AGENT_ID"],
    "include_knowledge": true,
    "include_tools": true,
    "include_media": true
  }'

A partir de ahí, se aplica la sección anterior: márcala como predeterminada para que cada cliente nuevo nazca con ella, o aplícala bajo demanda. Las tareas de mantenimiento se encuentran junto a esto: PATCH /v1/snapshots/{snapshotId} con { "name": "..." } cambia el nombre de una, DELETE /v1/snapshots/{snapshotId} elimina una (y le quita la marca de predeterminada si lo era), y GET /v1/snapshots/apply-targets enumera todas las cuentas en las que podrías realizar una instalación.

Los endpoints de agente, función personalizada y medios aceptan sub_account_id, por lo que las mismas llamadas también pueden mantener un agente directamente dentro de la cuenta de un cliente. Las llamadas de instantánea siempre actúan sobre tu cuenta de agencia: la plantilla reside contigo. Los esquemas completos de solicitud y respuesta para todos estos se encuentran en la Referencia de la API.

Gestiona tus niveles de precios a través de la API #

GET /v1/agency/pricing-tiers · POST /v1/agency/pricing-tiers · PATCH /v1/agency/pricing-tiers/{tierIndex} · DELETE /v1/agency/pricing-tiers/{tierIndex}

Los planes que vendes en Modo SaaS → Niveles de precios se pueden leer y cambiar desde el código, de modo que tu propio panel de administración o script de aprovisionamiento puede añadir un plan, ajustar un precio o proporcionar un enlace de pago sin que nadie tenga que abrir el panel de control. Autentícate con tu clave API de agencia como en cualquier otra llamada de esta página; estos endpoints son de nivel de agencia, por lo que no requieren sub_account_id. Cada escritura ejecuta la misma validación y la misma sincronización de producto y precio de Stripe que al guardar en el panel de control, por lo que un plan creado aquí es indistinguible de uno configurado manualmente.

Lista tus niveles #

curl "https://api.dmchamp.com/v1/agency/pricing-tiers" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY"

Respuesta

{
  "success": true,
  "data": {
    "tiers": [
      {
        "tierIndex": 0,
        "credits": 1000,
        "price_cents": 2900,
        "currency": "usd",
        "label": "Starter",
        "billing_interval": "month",
        "trial_days": 14,
        "trial_credits": 250,
        "trial_card_required": false,
        "trial_hard_expiry": true,
        "stripe_price_id": "price_1PxAbC…",
        "stripe_product_id": "prod_QxAbC…",
        "checkout_url": "https://app.yourdomain.com/v1/checkout?id=YOUR_AGENCY_UID&tierIndex=0"
      }
    ],
    "count": 1,
    "max_tiers": 20
  }
}

Cada nivel devuelve su tierIndex — su posición en tu lista de Planes, que es cómo lo direccionan las otras tres llamadas — y un checkout_url listo para compartir, el mismo enlace que te proporciona la pestaña Pagos, que ya apunta al dominio de marca blanca en el que se vende ese plan.

Añadir un nivel #

El cuerpo es un objeto de nivel; se añade al final de tu lista.

curl -X POST "https://api.dmchamp.com/v1/agency/pricing-tiers" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Starter",
    "credits": 1000,
    "price_cents": 2900,
    "currency": "usd",
    "billing_interval": "month",
    "trial_days": 14,
    "trial_credits": 250,
    "trial_card_required": false,
    "trial_hard_expiry": true,
    "features": ["channels_3", "channel_whatsapp_web", "webhooks"]
  }'

La respuesta contiene el nivel creado, incluyendo el tierIndex en el que se ubicó y su checkout_url.

Editar un nivel #

Envía solo los campos que deseas cambiar; todo lo demás en el plan se deja como estaba.

curl -X PATCH "https://api.dmchamp.com/v1/agency/pricing-tiers/0" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "price_cents": 3900, "trial_hard_expiry": true }'

Un campo que la API no reconoce es rechazado en lugar de ignorado, y el error lo identifica; así, un error tipográfico nunca puede escribir silenciosamente una configuración que parezca activa pero no haga nada. Cambiar el precio, los créditos, la moneda o la frecuencia de facturación crea un nuevo precio en tu Stripe; los clientes que ya se suscribieron permanecen en lo que contrataron.

Eliminar un nivel #

curl -X DELETE "https://api.dmchamp.com/v1/agency/pricing-tiers/2" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY"

La misma regla que en el panel de control: un plan que todavía tiene suscriptores activos no puede ser eliminado. La solicitud es rechazada, indicándote cuántos suscriptores tiene; cancélalos o migralos primero. Una eliminación exitosa responde con tus niveles restantes, ya renumerados.

Los campos de un nivel #

Los campos de prueba solo tienen significado en un plan que tiene una prueba: guarde un nivel con trial_days: 0 y se eliminarán. Los ID de producto y precio de Stripe del plan se administran por usted y no se pueden configurar manualmente.

Tres cosas que debe tener en cuenta:

• Los índices de nivel son posiciones, no identificadores permanentes. Eliminar un plan desplaza todos los planes posteriores una posición, por lo que debe volver a obtener la lista después de cualquier cambio, y volver a copiar los enlaces de pago que haya publicado, exactamente como lo haría después de eliminar un plan en el panel de control.
• El modo SaaS debe configurarse primero. Estos puntos finales requieren una cuenta de agencia con marca blanca y una clave de Stripe ya guardada; sin ella, no hay ninguna cuenta de Stripe en la que puedan residir el producto y el precio del plan.
• El límite es de veinte planes, igual que en el panel de control. El campo max_tiers en la respuesta de la lista le indica el límite actual.

Los esquemas completos de solicitud y respuesta se encuentran en la Referencia de la API, en Agencia.

Establezca su precio por crédito a través de la API #

GET /v1/agency/credit-price · PATCH /v1/agency/credit-price

El precio que pagan los clientes por las recargas ad-hoc (Modo SaaS → Precios por crédito) también se puede leer y modificar mediante código. Esto está diseñado para casos en los que el precio debe ajustarse automáticamente: una agencia que vende créditos en una moneda pero cobra en otra puede permitir que una tarea programada revise el precio a medida que cambia el tipo de cambio, en lugar de que alguien lo edite manualmente cada semana.

Leer el precio actual #

curl "https://api.dmchamp.com/v1/agency/credit-price" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY"

Respuesta

{
  "success": true,
  "data": {
    "price_per_credit_cents": 125,
    "price_per_credit_currency": "brl",
    "note": "USD 0.25 per credit at our reference rate",
    "minimum_cents": 60
  }
}

minimum_cents es el precio más bajo que permite la plataforma en esa moneda, por lo que una tarea puede verificar un nuevo precio antes de enviarlo. Los tres valores son null hasta que se haya establecido un precio.

Cambiarlo #

curl -X PATCH "https://api.dmchamp.com/v1/agency/credit-price" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "price_per_credit_cents": 130, "currency": "brl" }'

Envíe solo lo que desea cambiar. price_per_credit_cents es el precio en la unidad monetaria más pequeña (130 = R$1.30); currency es un código ISO en minúsculas; note es una línea opcional de hasta 200 caracteres que se muestra a los clientes directamente debajo del precio por crédito en su página de Facturación; es útil para un precio de referencia en otra moneda, como “USD 0.25 por crédito a nuestra tasa de referencia”. Envíe "note": "" para eliminarlo. La respuesta tiene la misma forma que la lectura anterior, por lo que una tarea puede comparar y omitir la escritura cuando nada ha cambiado.

Se aplican las mismas reglas que en el panel de control: el precio no puede ser inferior al mínimo de la plataforma para esa moneda y la cuenta necesita marca blanca (white labeling). A diferencia de los endpoints de niveles de precios, no se requiere una clave de Stripe para leer o cambiar este valor.

Asigne a una tarea una clave que no pueda hacer nada más #

Poner la clave completa de su agencia en un programador otorga más acceso del que necesita una actualización de precios. En su lugar, cree una clave con alcance limitado (scoped key) para el área de Precio de crédito de agencia: esa clave puede leer y cambiar el precio por crédito y nada más; no puede tocar subcuentas, planes, créditos ni su conexión con Stripe.

curl -X POST "https://api.dmchamp.com/v1/api-keys" \
  -H "X-API-Key: YOUR_AGENCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "label": "FX price updater", "scopes": { "read_only": false, "tags": ["Agency Credit Price"] } }'

La respuesta contiene la nueva clave en api_key una sola vez; nunca se vuelve a mostrar, así que guárdela de inmediato. Establezca "read_only": true para una clave que solo necesite leer el precio, y añada "expires_at" (una fecha ISO) si desea que deje de funcionar por sí sola. Solo la clave del propietario de la cuenta puede crear claves con alcance limitado; enumérelas o revóquelas con GET /v1/api-keys y DELETE /v1/api-keys/{id}.

Permita que una subcuenta lea sus precios #

GET /v1/subaccounts/agency-pricing

Todos los demás endpoints de esta página se llaman con su clave de agencia, apuntando opcionalmente a un cliente a través de sub_account_id. Este es lo opuesto: se llama con la propia clave de API de la subcuenta, sin sub_account_id, de modo que la propia página de recarga de un cliente (o una integración que usted cree para ellos) pueda mostrar lo que usted les cobra sin ver nunca su cuenta de agencia.

curl "https://api.dmchamp.com/v1/subaccounts/agency-pricing" \
  -H "X-API-Key: THE_SUB_ACCOUNTS_OWN_API_KEY"

Respuesta

{
  "success": true,
  "data": {
    "tiers": [{ "credits": 1000, "price_cents": 2900, "currency": "usd" }],
    "price_per_credit_cents": 125,
    "price_per_credit_currency": "brl",
    "price_per_credit_note": "USD 0.25 per credit at our reference rate",
    "agency_display_name": "Client Co's Growth Partner"
  }
}

Esto refleja exactamente lo que GET /v1/agency/pricing-tiers y GET /v1/agency/credit-price le devuelven a usted como agencia, menos todo lo que el cliente no necesita ver (ids de Stripe, max_tiers, etc.). Solo funciona para una cuenta que sea realmente una subcuenta con una agencia vinculada; llamarlo desde su propia cuenta de agencia devuelve un error de permiso.

Aspectos a tener en cuenta #

• Utilice su clave de agencia. Autentique cada llamada con la clave de API de su cuenta de agencia, no la de la subcuenta. El parámetro sub_account_id es el que redirige la acción.
• Los créditos provienen de la subcuenta. Las compras y los cargos recurrentes afectan al saldo de crédito de la subcuenta objetivo, no al suyo.
• Un 404 significa “no es su subcuenta”. Verifique dos veces el id y que la cuenta sea una que usted gestione.
• El parámetro es opcional en todos los lugares donde se acepta. Omítalo y el mismo endpoint actuará sobre su cuenta de agencia, por lo que puede reutilizar una integración para ambos casos.

Relacionado #

• Acceso a la API: autenticación, URL base, errores, límites de frecuencia.
• Subcuentas: enumere y gestione las cuentas a las que puede dirigirse.
• Recarga automática de subcuentas: otorgue créditos a una subcuenta mediante webhook + API.
• API de agentes de IA: cree y configure agentes de IA.
• API de campañas: el recurso de campañas clásicas en desuso, incluida la referencia completa de campos.
• API de conexión de canales: conecte los canales de un cliente.
• API de puntos de entrada: decida qué agente atiende una nueva conversación.
• Guía de la API de análisis (en la sección de API): el resumen de subcuentas de agencia y cualquier otro punto final de informes.
• Instantáneas: qué captura una instantánea y cómo crear una en el panel de control.