Paso 3: Crear un nuevo chat
Descripción
Ten en cuenta que no podrás ejecutar este paso descrito anteriormente directamente en la sección de Referencia de la API debido a limitaciones de la herramienta: no es posible calcular los encabezados requeridos y enviar una solicitud al mismo tiempo.
Este método te permite crear un chat antes de enviar el mensaje inicial. Puede ser útil cuando ya existe un lead con contacto y no es necesario crear un lead entrante. Los chats sin mensajes no serán visibles en la cuenta.
También puedes especificar la fuente del chat, y cuando se reciba el primer mensaje entrante del chat, se creará un lead entrante en el pipeline correspondiente según la fuente especificada.
Este método crea un chat para el ID proporcionado. Si ya existe un chat para el conversation_id proporcionado, se retornará su ID
Encabezados y tipo de autorización
Los encabezados de la solicitud son los mismos que los de todas las solicitudes de la API de Chat.
Puedes aprender cómo obtener los encabezados Content-MD5 y X-Signature con la ayuda de la receta.
- El
user[id]debe ser único. Si introduces unuser[id]existente, obtendrás la información existente relacionada con ese usuario.- El cuerpo de la solicitud debe ser exactamente el mismo al calcular el Content-MD5 y la X-Signature.
Parámetros de respuesta
| Parámetro | Descripción |
|---|---|
| id | ID del chat en la API de Chats de Kommo. |
| user[id] | ID del participante del chat en la API de Chats de Kommo. |
| user[client_id] | ID del participante del chat del lado de la integración. Este campo no está presente para los usuarios de Kommo (se pasa en la solicitud bajo la clave user[id]). |
| user[name] | Nombre del participante del chat. |
| user[avatar] | Enlace al avatar si fue enviado, o campo vacío. |
| user[phone] | Número de teléfono del participante del chat, si fue enviado. |
| user[email] | Correo del participante del chat, si fue enviado. |