Crear conversación
Los desarrolladores pueden crear una conversación a través de la API y, a continuación, enviar mensajes a los clientes usando el Conversation ID.
Método de solicitud
POST
URL de la solicitud
https://livedesk-api.engagelab.com/api/v2/accounts/conversations
Autenticación
Para obtener más información, consulta las instrucciones de autenticación en Resumen de la API.
Solicitud
Ejemplo de solicitud
curl -X POST https://livedesk-api.engagelab.com/api/v2/accounts/conversations \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"inbox_id": 407,
"contact_id": 2219256,
"source_id": "123456789"
}'
curl -X POST https://livedesk-api.engagelab.com/api/v2/accounts/conversations \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"inbox_id": 407,
"contact_id": 2219256,
"source_id": "123456789"
}'
Este bloque de código se muestra en una ventana flotante
inbox_ides obligatorio. Puedes proporcionarcontact_idosource_id, pero debes proporcionar uno de ellos para identificar correctamente al remitente.
Parámetros de la cabecera de la solicitud
| Field | Type | Description |
|---|---|---|
| Authorization | string | Autentica mediante Authorization: Basic base64(API Key:API Secret). Ve a la página API Keys para obtener la API key y el API secret, únelos con dos puntos y codifica el resultado en Base64. |
| Content-Type | application/json | Tipo de datos. Usa application/json para mensajes de texto normales. |
Parámetros del cuerpo de la solicitud
| Field | Type | Required | Description |
|---|---|---|---|
| inbox_id | String | Yes | ID del canal. Debe coincidir con el ID usado por la API Create Contact. |
| contact_id | String | No | ID del contacto. Es el ID devuelto por la API Create Contact. |
| source_id | String | No | ID de origen. |
Respuesta
Ejemplo de respuesta
{
"meta": {
"sender": {
"additional_attributes": {},
"availability_status": "offline",
"email": null,
"id": 2219256,
"name": "wjTest",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"created_at": 1766571624
},
"channel": "Channel::Api",
"hmac_verified": false
},
"id": 40,
"messages": [],
"account_id": 17623000010928,
"uuid": "660ce36f-46bb-4153-948c-8a26e6dab634",
"inbox_id": 407,
"additional_attributes": {},
"agent_last_seen_at": 0,
"assignee_last_seen_at": 0,
"can_reply": true,
"contact_last_seen_at": 0,
"custom_attributes": {},
"labels": [],
"muted": false,
"snoozed_until": null,
"status": "open",
"priority": null,
"conversation_category": "chat",
"chat_mode": "private_chat",
"is_forum": false,
"created_at": 1766572062,
"updated_at": 1766572062.5803902,
"timestamp": 1766572062,
"first_reply_created_at": 0,
"unread_count": 0,
"last_non_activity_message": null,
"last_activity_at": 1766572062,
"waiting_since": 1766572062,
"sla_policy_id": null,
"ticket_id": null,
"over_limit": false,
"content_preview": {
"content": null,
"message_type": null,
"created_at": null
},
"platform": {
"channel_type": "Channel::Api",
"inbox_name": "JennyApi",
"inbox_id": 407
},
"account_info": {
"contact_name": "wjTest",
"contact_email": null,
"contact_phone": null,
"contact_id": 2219256,
"contact_avatar": ""
},
"assignment": {
"assignee_id": null,
"assignee_name": null,
"assignee_email": null,
"team_id": null,
"team_name": null
}
}
{
"meta": {
"sender": {
"additional_attributes": {},
"availability_status": "offline",
"email": null,
"id": 2219256,
"name": "wjTest",
"phone_number": null,
"blocked": false,
"identifier": null,
"thumbnail": "",
"custom_attributes": {},
"created_at": 1766571624
},
"channel": "Channel::Api",
"hmac_verified": false
},
"id": 40,
"messages": [],
"account_id": 17623000010928,
"uuid": "660ce36f-46bb-4153-948c-8a26e6dab634",
"inbox_id": 407,
"additional_attributes": {},
"agent_last_seen_at": 0,
"assignee_last_seen_at": 0,
"can_reply": true,
"contact_last_seen_at": 0,
"custom_attributes": {},
"labels": [],
"muted": false,
"snoozed_until": null,
"status": "open",
"priority": null,
"conversation_category": "chat",
"chat_mode": "private_chat",
"is_forum": false,
"created_at": 1766572062,
"updated_at": 1766572062.5803902,
"timestamp": 1766572062,
"first_reply_created_at": 0,
"unread_count": 0,
"last_non_activity_message": null,
"last_activity_at": 1766572062,
"waiting_since": 1766572062,
"sla_policy_id": null,
"ticket_id": null,
"over_limit": false,
"content_preview": {
"content": null,
"message_type": null,
"created_at": null
},
"platform": {
"channel_type": "Channel::Api",
"inbox_name": "JennyApi",
"inbox_id": 407
},
"account_info": {
"contact_name": "wjTest",
"contact_email": null,
"contact_phone": null,
"contact_id": 2219256,
"contact_avatar": ""
},
"assignment": {
"assignee_id": null,
"assignee_name": null,
"assignee_email": null,
"team_id": null,
"team_name": null
}
}
Este bloque de código se muestra en una ventana flotante
Parámetros de respuesta
| Field | Type | Required | Description |
|---|---|---|---|
| meta | Object | No | Objeto de metadatos. |
| sender | Object | No | Información del remitente. |
| additional_attributes | Object | No | Atributos adicionales. |
| availability_status | String | No | Estado de disponibilidad. |
| Null | No | Dirección de correo electrónico. | |
| id | Number | No | ID del contacto. |
| name | String | No | Nombre del remitente. |
| phone_number | Null | No | Número de teléfono. |
| blocked | Boolean | No | Indica si el remitente está bloqueado. |
| identifier | Null | No | Identificador del atributo de usuario. |
| thumbnail | String | No | Miniatura. |
| custom_attributes | Object | No | Atributos personalizados. |
| created_at | Number | No | Marca temporal de creación de la conversación. |
| channel | String | No | Tipo de canal. |
| hmac_verified | Boolean | No | Estado de verificación de HMAC. |
| id | Number | No | ID de la conversación. |
| messages | Array | No | Lista de mensajes. |
| account_id | Number | No | ID del proyecto. |
| uuid | String | No | Identificador único. |
| inbox_id | Number | No | ID del canal. |
| additional_attributes | Object | No | Atributos adicionales. |
| agent_last_seen_at | Number | No | Hora en la que el agente gestionó por última vez la conversación. |
| assignee_last_seen_at | Number | No | Hora en la que la persona asignada gestionó por última vez la conversación. |
| can_reply | Boolean | No | Indica si se puede enviar una respuesta. |
| contact_last_seen_at | Number | No | Última hora de visualización del contacto. |
| custom_attributes | Object | No | Atributos personalizados. |
| labels | Array | No | Lista de etiquetas. |
| muted | Boolean | No | Indica si la conversación está silenciada. |
| snoozed_until | Null | No | Hora hasta la que la conversación queda pospuesta. |
| status | String | No | Estado. |
| priority | Null | No | Prioridad. |
| conversation_category | String | No | Categoría de la conversación. |
| chat_mode | String | No | Modo de chat. |
| is_forum | Boolean | No | Indica si la conversación es un foro. |
| created_at | Number | No | Marca temporal de creación. |
| updated_at | Number | No | Marca temporal de actualización. |
| timestamp | Number | No | Marca temporal. |
| first_reply_created_at | Number | No | Hora en la que se creó la primera respuesta. |
| unread_count | Number | No | Número de mensajes no leídos. |
| last_non_activity_message | Null | No | Último mensaje que no es de actividad. |
| last_activity_at | Number | No | Hora de la última actividad. |
| waiting_since | Number | No | Hora en la que comenzó la espera. |
| sla_policy_id | Null | No | ID de la política de SLA. |
| ticket_id | Null | No | ID del ticket. |
| over_limit | Boolean | No | Indica si se ha superado el límite. |
| content_preview | Object | No | Vista previa del contenido. |
| content_preview.content | Null | No | Contenido de la vista previa. |
| content_preview.message_type | Null | No | Tipo de mensaje. |
| content_preview.created_at | Null | No | Hora de creación. |
| platform | Object | No | Información de la plataforma. |
| channel_type | String | No | Tipo de canal. |
| inbox_name | String | No | Nombre de la bandeja de entrada. |
| inbox_id | Number | No | ID de la bandeja de entrada. |
| account_info | Object | No | Información de la cuenta. |
| contact_name | String | No | Nombre del contacto. |
| contact_email | Null | No | Dirección de correo electrónico del contacto. |
| contact_phone | Null | No | Número de teléfono del contacto. |
| contact_id | Number | No | ID del contacto. |
| contact_avatar | String | No | Avatar del contacto. |
| assignment | Object | No | Información de la asignación. |
| assignee_id | Null | No | ID de la persona asignada. |
| assignee_name | Null | No | Nombre de la persona asignada. |
| assignee_email | Null | No | Dirección de correo electrónico de la persona asignada. |
| team_id | Null | No | ID del equipo. |
| team_name | Null | No | Nombre del equipo. |
