Otros recursos

Referencia rápida de recursos adicionales de la API. Salvo que se indique lo contrario, todos cuelgan de /workspaces/:workspaceId/ y aceptan JWT o API key.

Miembros e invitaciones

Estos endpoints solo aceptan la sesión del dashboard, no una API key — son administración de la cuenta, no integración (ver qué acepta API key).

Método	Ruta	Descripción
GET	/members	Listar miembros del workspace
POST	/members	Invitar a un miembro
PATCH	/members/:userId/role	Cambiar el rol de un miembro
DELETE	/members/:userId	Quitar un miembro

Búsqueda global

Busca en paralelo dentro de varios tipos de entidad a la vez. Cada tipo solo se consulta si el usuario (o la API key) tiene la capability de lectura correspondiente — si no la tiene, ese tipo ni siquiera llega a hacer la query, y la clave aparece en la respuesta con un arreglo vacío.

GET /workspaces/:workspaceId/search Copiar

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
q	string	Sí	Texto a buscar (1–120 caracteres).
types	string	No	Lista de tipos separados por coma. Por defecto busca en todos.

Tipos soportados: contacts, flows, pipelines, agents, voiceAgents, campaigns, emailTemplates, whatsappTemplates, conversations, calendarEvents, knowledgeDocs, callCampaigns, callerIds.

Consejo

Máximo 8 resultados por tipo. La respuesta es un objeto con una clave por tipo solicitado, cada una con su propio arreglo de resultados.

cURL

curl -G "https://api.waiify.com/workspaces/WORKSPACE_ID/search" \
  -H "Authorization: Bearer TU_API_KEY" \
  --data-urlencode "q=juan" \
  --data-urlencode "types=contacts,flows"

Node

const params = new URLSearchParams({ q: 'juan', types: 'contacts,flows' });
const res = await fetch(
  `https://api.waiify.com/workspaces/WORKSPACE_ID/search?${params}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/search",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={"q": "juan", "types": "contacts,flows"},
)

data = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "contacts": [
      {
        "id": "contact_ab12cd34ef",
        "type": "contacts",
        "title": "Juan Pérez",
        "subtitle": "juan@example.com"
      }
    ],
    "flows": [
      {
        "id": "flow_gh56ij78kl",
        "type": "flows",
        "title": "Bienvenida — Juan Manuel",
        "subtitle": "Onboarding de leads nuevos"
      }
    ]
  }
}

Contexto de la empresa

Perfil de la empresa (nombre, descripción, horarios, FAQs) que alimenta el prompt de los asistentes. Un workspace puede tener varios contextos; uno de ellos puede marcarse isDefault.

Precaución

Estos endpoints no envuelven la respuesta en { success, data } como el resto de la API: devuelven el objeto o el arreglo directo, y los errores llegan como { "error": "mensaje" } en vez de { "success": false, "message": "..." }. Es una diferencia real del código, no un error de esta página — ten en cuenta ambos formatos si integras contra este recurso.

Método	Ruta	Descripción
GET	/company-contexts	Listar contextos del workspace
GET	/company-contexts/default	Obtener el contexto marcado como predeterminado
GET	/company-contexts/:contextId	Obtener un contexto
POST	/company-contexts	Crear un contexto
PUT	/company-contexts/:contextId	Actualizar un contexto
DELETE	/company-contexts/:contextId	Eliminar un contexto
POST	/company-contexts/analyze-site	Analizar un sitio web (sin crear ni guardar nada)
POST	/company-contexts/:contextId/rescrape	Volver a analizar el sitio de un contexto existente
POST	/company-contexts/:contextId/generate-prompt	Generar el prompt de un asistente a partir del contexto

Ejemplo — crear un contexto

POST /workspaces/:workspaceId/company-contexts Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre/etiqueta del contexto guardado (máx. 200).
companyName	string	No	Nombre real de la empresa. Si se omite, se rellena con name.
websiteUrl	string	No	URL del sitio web (máx. 2000).
description	string	No	Descripción de la empresa (máx. 5000).
industry	string	No	Industria/rubro (máx. 200).
services	string[]	No	Lista de servicios (máx. 100 items).
businessHours	string	No	Horario de atención en texto libre (máx. 1000).
contactInfo	object	No	Datos de contacto libres (teléfono, dirección, etc.).
faqs	object[]	No	Preguntas frecuentes: { question, answer } (máx. 100).
isDefault	boolean	No	Marca este contexto como el predeterminado del workspace.
autoScrape	boolean	No	Si es true y hay websiteUrl, analiza el sitio al crear.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/company-contexts" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contexto principal",
    "companyName": "Waiify",
    "websiteUrl": "https://waiify.com",
    "isDefault": true
  }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/company-contexts',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Contexto principal',
      companyName: 'Waiify',
      websiteUrl: 'https://waiify.com',
      isDefault: true,
    }),
  }
);

const context = await res.json(); // objeto directo, sin envoltura

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/company-contexts",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "name": "Contexto principal",
        "companyName": "Waiify",
        "websiteUrl": "https://waiify.com",
        "isDefault": True,
    },
)

context = res.json()  # objeto directo, sin envoltura

Respuesta 201

{
  "id": "ctx_ab12cd34ef",
  "workspaceId": "ws_gh56ij78kl",
  "name": "Contexto principal",
  "companyName": "Waiify",
  "websiteUrl": "https://waiify.com",
  "isDefault": true,
  "createdAt": "2026-06-18T09:00:00.000Z"
}

Eventos CRM

Suscribe un flow del Flow Studio a eventos del CRM (contacto creado, oportunidad movida de etapa, etc.), como alternativa a configurarlo desde el editor visual.

GET /workspaces/:workspaceId/crm-events/types Copiar

Lista los tipos de evento disponibles, con su etiqueta y si admiten condiciones de filtro.

cURL

curl "https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/types" \
  -H "Authorization: Bearer TU_API_KEY"

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/types',
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data: types } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/types",
    headers={"Authorization": "Bearer TU_API_KEY"},
)

types = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": [
    {
      "type": "contact.created",
      "label": "Contacto creado",
      "description": "Se crea un nuevo contacto en el CRM",
      "supportsFilters": false
    },
    {
      "type": "opportunity.stage_changed",
      "label": "Oportunidad cambió de etapa",
      "description": "Una oportunidad se mueve de una etapa a otra dentro de un pipeline",
      "supportsFilters": true
    }
  ]
}

Método	Ruta	Descripción
GET	/crm-events/types	Listar tipos de evento disponibles
POST	/crm-events/flows/:flowId/subscribe	Suscribir un flow a un tipo de evento
DELETE	/crm-events/flows/:flowId/subscribe	Desuscribir un flow (vuelve a trigger manual)

Ejemplo — suscribir un flow

POST /workspaces/:workspaceId/crm-events/flows/:flowId/subscribe Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
eventType	string	Sí	Uno de los tipos listados en /crm-events/types.
pipelineId	string	Depende	Obligatorio para opportunity.created; opcional (filtra) para el resto de eventos de oportunidad.

Consejo

Eventos base (contact.created, contact.updated, opportunity.created, opportunity.updated) disparan ante cualquier cambio. Los eventos “atajo” (opportunity.stage_changed, opportunity.won, opportunity.lost) admiten condiciones adicionales, pero esas solo se configuran desde el editor visual del flow — este endpoint solo fija el eventType y el pipelineId.

Relacionado

• Flow Studio · Trigger — evento CRM

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/flows/FLOW_ID/subscribe" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "eventType": "opportunity.stage_changed", "pipelineId": "pipeline_ab12cd34ef" }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/flows/FLOW_ID/subscribe',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      eventType: 'opportunity.stage_changed',
      pipelineId: 'pipeline_ab12cd34ef',
    }),
  }
);

const { data: flow } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/crm-events/flows/FLOW_ID/subscribe",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={"eventType": "opportunity.stage_changed", "pipelineId": "pipeline_ab12cd34ef"},
)

flow = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "id": "flow_gh56ij78kl",
    "name": "Notificar cambio de etapa",
    "triggerType": "crm_event",
    "settings": {
      "eventGroups": [
        {
          "eventType": "opportunity.stage_changed",
          "pipelineId": "pipeline_ab12cd34ef",
          "conditions": []
        }
      ]
    },
    "isActive": true
  }
}

Secuencias de seguimiento

Secuencias de mensajes automáticos que se disparan cuando un contacto no responde a un asistente. Cada secuencia tiene una lista ordenada de pasos, con su propio retraso y tipo de contenido.

Método	Ruta	Descripción
GET	/follow-up/sequences	Listar secuencias (filtro opcional ?agentId=)
POST	/follow-up/sequences	Crear una secuencia (con pasos opcionales)
GET	/follow-up/sequences/:id	Obtener una secuencia con sus pasos
PATCH	/follow-up/sequences/:id	Actualizar una secuencia
DELETE	/follow-up/sequences/:id	Eliminar una secuencia
POST	/follow-up/default-sequence	Crear la secuencia por defecto del workspace
POST	/follow-up/sequences/:id/steps	Agregar un paso a una secuencia
PATCH	/follow-up/sequences/:id/steps/:stepId	Actualizar un paso
DELETE	/follow-up/sequences/:id/steps/:stepId	Eliminar un paso

Ejemplo — crear una secuencia

POST /workspaces/:workspaceId/follow-up/sequences Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre de la secuencia (máx. 120).
agentId	string	No	Asistente al que aplica. Sin valor, aplica a todos.
isActive	boolean	No	Por defecto true.
triggerOn	string	No	Condición de disparo. Por defecto NO_RESPONSE.
maxAttempts	number	No	Tope de intentos (1–20).
reactivateAgent	boolean	No	Si al responder el contacto se reactiva el asistente. Por defecto true.
steps	object[]	No	Pasos iniciales — ver tabla debajo.

Cada paso (steps[] al crear, o el cuerpo de POST .../steps):

Campo	Tipo	Requerido	Descripción
delayMinutes	number	Sí	Minutos de espera desde el paso anterior (mínimo 1).
stepType	string	No	TEXT | AI_GENERATED | PROMPT_TEMPLATE | WHATSAPP_TEMPLATE | FLOW. Por defecto TEXT.
message	string	Depende	Requerido si stepType es TEXT (máx. 4096).
promptTemplate	string	Depende	Requerido si stepType es PROMPT_TEMPLATE (máx. 4096).
templateId	string	Depende	Requerido si stepType es WHATSAPP_TEMPLATE; debe pertenecer al workspace.
flowId	string	Depende	Requerido si stepType es FLOW; debe pertenecer al workspace.
stepNumber	number	No	Orden del paso. Si se omite, se calcula automáticamente.

Consejo

AI_GENERATED no exige ningún campo adicional: el mensaje lo redacta el modelo en el momento según el contexto de la conversación.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/follow-up/sequences" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Seguimiento leads fríos",
    "triggerOn": "NO_RESPONSE",
    "maxAttempts": 3,
    "steps": [
      { "delayMinutes": 60, "stepType": "TEXT", "message": "¿Sigues ahí? Quedo atento." },
      { "delayMinutes": 1440, "stepType": "AI_GENERATED" }
    ]
  }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/follow-up/sequences',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Seguimiento leads fríos',
      triggerOn: 'NO_RESPONSE',
      maxAttempts: 3,
      steps: [
        { delayMinutes: 60, stepType: 'TEXT', message: '¿Sigues ahí? Quedo atento.' },
        { delayMinutes: 1440, stepType: 'AI_GENERATED' },
      ],
    }),
  }
);

const { data: sequence } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/follow-up/sequences",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "name": "Seguimiento leads fríos",
        "triggerOn": "NO_RESPONSE",
        "maxAttempts": 3,
        "steps": [
            {"delayMinutes": 60, "stepType": "TEXT", "message": "¿Sigues ahí? Quedo atento."},
            {"delayMinutes": 1440, "stepType": "AI_GENERATED"},
        ],
    },
)

sequence = res.json()["data"]

Respuesta 201

{
  "success": true,
  "message": "Secuencia creada",
  "data": {
    "id": "fseq_ab12cd34ef",
    "workspaceId": "ws_gh56ij78kl",
    "agentId": null,
    "name": "Seguimiento leads fríos",
    "isActive": true,
    "triggerOn": "NO_RESPONSE",
    "maxAttempts": 3,
    "reactivateAgent": true,
    "steps": [
      {
        "id": "fstep_mn12op34qr",
        "stepNumber": 1,
        "delayMinutes": 60,
        "stepType": "TEXT",
        "message": "¿Sigues ahí? Quedo atento."
      },
      {
        "id": "fstep_st56uv78wx",
        "stepNumber": 2,
        "delayMinutes": 1440,
        "stepType": "AI_GENERATED",
        "message": null
      }
    ]
  }
}

Agentes de voz y llamadas

Método	Ruta	Descripción
GET	/voice-agents	Listar agentes de voz
POST	/voice-agents	Crear agente de voz
GET	/voice-agents/:id	Obtener
PATCH	/voice-agents/:id	Actualizar
GET	/voice-calls	Historial de llamadas
GET	/voice-calls/:id	Detalle de una llamada

Ver Agentes de voz.

Uso y créditos

Consumo de créditos del workspace. El saldo (wallet) es siempre el del pool de la cuenta, compartido entre todos sus workspaces — por eso el resumen y el historial de eventos también se agregan a nivel de cuenta cuando aplica, no solo del workspace consultado.

Método	Ruta	Descripción
GET	/usage/summary	Resumen de consumo del período + estado del wallet
GET	/usage/wallet	Estado actual del saldo (lectura rápida)
GET	/usage/events	Historial paginado de eventos de consumo

Ejemplo — resumen de consumo

GET /workspaces/:workspaceId/usage/summary Copiar

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
from	string (ISO date)	No	Inicio del período. Por defecto, el 1º del mes calendario actual.
to	string (ISO date)	No	Fin del período. Por defecto, el último día del mes calendario actual.

cURL

curl -G "https://api.waiify.com/workspaces/WORKSPACE_ID/usage/summary" \
  -H "Authorization: Bearer TU_API_KEY" \
  --data-urlencode "from=2026-06-01" \
  --data-urlencode "to=2026-06-30"

Node

const params = new URLSearchParams({ from: '2026-06-01', to: '2026-06-30' });
const res = await fetch(
  `https://api.waiify.com/workspaces/WORKSPACE_ID/usage/summary?${params}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data: summary } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/usage/summary",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={"from": "2026-06-01", "to": "2026-06-30"},
)

summary = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "period": { "from": "2026-06-01T00:00:00.000Z", "to": "2026-06-30T23:59:59.000Z" },
    "wallet": {
      "balance": 8500,
      "monthlyQuota": 10000,
      "totalConsumed": 1500,
      "periodEnd": "2026-06-30T23:59:59.000Z",
      "percentage": 15,
      "isNearLimit": false,
      "isCritical": false,
      "isSufficient": true,
      "planBalance": 8000,
      "purchasedBalance": 500,
      "unlimited": false,
      "frozen": false,
      "scope": "account"
    },
    "byEvent": [
      { "eventType": "ai_call", "app": "assistants", "source": "waiify", "count": 340, "creditsCharged": 890 },
      { "eventType": "whatsapp_message", "app": "conversations", "source": "waiify", "count": 210, "creditsCharged": 210 }
    ],
    "totalCreditsCharged": 1500
  }
}

Ejemplo — historial de eventos

GET /workspaces/:workspaceId/usage/events Copiar

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
page	number	No	Página (por defecto 1).
limit	number	No	Tamaño de página, máx. 100 (por defecto 20).
eventType	string	No	Filtra por tipo (ai_call, voice_minute, whatsapp_message, sms_sent, email_sent, etc.).
source	string	No	waiify o byok.
from	string (ISO date)	No	Fecha inicial (createdAt >=).
to	string (ISO date)	No	Fecha final (createdAt <=).

Consejo

El campo data viene anidado: data.data es el arreglo de eventos y data.total/data.page/data.limit son la paginación.

cURL

curl -G "https://api.waiify.com/workspaces/WORKSPACE_ID/usage/events" \
  -H "Authorization: Bearer TU_API_KEY" \
  --data-urlencode "eventType=ai_call" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=20"

Node

const params = new URLSearchParams({ eventType: 'ai_call', page: '1', limit: '20' });
const res = await fetch(
  `https://api.waiify.com/workspaces/WORKSPACE_ID/usage/events?${params}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/usage/events",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={"eventType": "ai_call", "page": 1, "limit": 20},
)

data = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "data": [
      {
        "id": "usage_ab12cd34ef",
        "source": "waiify",
        "eventType": "ai_call",
        "app": "assistants",
        "model": "claude-sonnet",
        "tokensIn": 512,
        "tokensOut": 128,
        "creditsCharged": 3,
        "flowId": null,
        "nodeId": null,
        "campaignId": null,
        "createdAt": "2026-06-18T09:00:00.000Z"
      }
    ],
    "total": 340,
    "page": 1,
    "limit": 20
  }
}

Tarifas de créditos (pública)

Tarifas vigentes de consumo de créditos por tipo de evento, app y país. Es la única ruta pública sin autenticación de esta página — ni JWT ni API key: la consume el propio sitio de documentación en tiempo de build para que la tabla de precios nunca quede desactualizada. Nunca expone tarifas negociadas por cuenta, solo las tarifas base activas.

GET /credit-rates Copiar

Sin parámetros ni autenticación. Solo lectura, con rate limit de 30 solicitudes por minuto.

Consejo

app y country pueden venir null: una tarifa sin app aplica a cualquier app, y sin country aplica a cualquier país. Ver la tabla de precios ya formateada en Créditos.

cURL

curl "https://api.waiify.com/credit-rates"

Node

const res = await fetch('https://api.waiify.com/credit-rates');
const { data: rates } = await res.json();

Python

import requests

res = requests.get("https://api.waiify.com/credit-rates")
rates = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": [
    {
      "eventType": "ai_call",
      "app": "openai",
      "country": null,
      "rate": 50,
      "note": "Llamada a OpenAI usando Plan Waiify",
      "updatedAt": "2026-05-01T00:00:00.000Z"
    },
    {
      "eventType": "voice_minute",
      "app": "voice",
      "country": null,
      "rate": 150,
      "note": "Por minuto de llamada con agente de voz IA",
      "updatedAt": "2026-05-01T00:00:00.000Z"
    },
    {
      "eventType": "sms_sent",
      "app": "labsmobile",
      "country": "MX",
      "rate": 45,
      "note": "SMS a México vía LabsMobile (costo 15 créditos, margen 3×)",
      "updatedAt": "2026-05-01T00:00:00.000Z"
    },
    {
      "eventType": "sms_sent",
      "app": "labsmobile",
      "country": "CO",
      "rate": 7,
      "note": "SMS a Colombia vía LabsMobile (costo 2,3 créditos, margen 3×)",
      "updatedAt": "2026-05-01T00:00:00.000Z"
    }
  ]
}

Nota

Este es un extracto de ejemplo — la respuesta real trae todas las tarifas activas (IA por proveedor, embeddings, voz, WhatsApp, SMS por proveedor/país y email). Ver el listado completo vigente en Créditos, que consume este mismo endpoint.

Analítica

Métricas agregadas del workspace para dashboards. Todos los endpoints aceptan ?period= con 7d, 30d o 90d (por defecto 30d; cualquier otro valor cae también a 30d).

Método	Ruta	Descripción
GET	/analytics/overview	KPIs principales: contactos, conversaciones, mensajes, flows, agentes, citas
GET	/analytics/conversations	Conversaciones por estado/canal, timeline y tiempo de resolución
GET	/analytics/leads	Funnel de contactos por estado, fuentes y timeline
GET	/analytics/flows	Ejecuciones de flows, tasa de éxito, top flows y duración
GET	/analytics/agents	Sesiones de asistentes, tool calls y top agentes
GET	/analytics/sms	Campañas de SMS: entregas, tasa de error, motivos de fallo
GET	/analytics/dashboard	overview + conversations + leads + flows + agents en una sola llamada (no incluye sms)

Ejemplo — overview

GET /workspaces/:workspaceId/analytics/overview Copiar

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
period	string	No	7d | 30d | 90d. Por defecto 30d.

Relacionado

• Créditos · Paginación

cURL

curl -G "https://api.waiify.com/workspaces/WORKSPACE_ID/analytics/overview" \
  -H "Authorization: Bearer TU_API_KEY" \
  --data-urlencode "period=30d"

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/analytics/overview?period=30d',
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/analytics/overview",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={"period": "30d"},
)

data = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "period": "30d",
    "contacts": { "total": 1204, "new": 86, "today": 5 },
    "conversations": { "total": 940, "open": 32, "resolved": 780 },
    "messages": { "today": 210, "period": 5400 },
    "flows": { "active": 12, "executions": 340, "failed": 6, "successRate": 98 },
    "agents": { "active": 4, "sessions": 512 },
    "appointments": { "upcoming": 18, "period": 64 }
  }
}

Databases (Waiify DB)

Bases de datos propias, con tablas, columnas tipadas y filas — CRUD completo. Ver la referencia dedicada en Bases de datos.

Widget de chat (público, sin API key)

El chat embebible tiene su propia autenticación por widgetToken — no cuelga de /workspaces/:workspaceId/ ni acepta tu API key. Ver Chat público (widget) para la referencia completa.

Relacionado

• Autenticación · Paginación