Skip to main content
Crea una conversación en el inbox indicado. Es obligatorio enviar source_id (identificador de origen) e inbox_id. Opcionalmente puedes asignar a agente o equipo, enviar un mensaje inicial y atributos personalizados.

Autenticación

string
required
Token de usuario (userApiKey) o de bot (agentBotApiKey).

Parámetros de ruta

integer
required
ID de la cuenta.

Cuerpo de la solicitud

string
required
Identificador de origen de la conversación. Ejemplo: 1234567890.
integer
required
ID del inbox donde se crea la conversación. Tipos permitidos: Website, Phone, Api, Email.
integer
ID del contacto asociado (opcional).
string
Estado inicial: open, resolved, pending. Por defecto suele ser open.
integer
ID del agente al que se asigna la conversación.
integer
ID del equipo al que se asigna la conversación.
object
Mensaje inicial. Requiere content (string). Para WhatsApp puede incluir template_params.
object
Atributos adicionales (ej. browser, os) para contexto.
object
Atributos personalizados (clave-valor) definidos en la cuenta.
string
Fecha/hora ISO hasta la cual la conversación queda en snooze.

Ejemplo de solicitud

Respuesta exitosa

number
required
ID de la conversación creada.
number
ID de la cuenta.
number
ID del inbox.

Errores

  • 403: Access denied — sin permiso o inbox/contacto inválido.
  • 401: No autenticado.