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.