Descripción
Ten en cuenta que no podrás ejecutar este paso 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 permite enviar mensajes entrantes y salientes, o importar mensajes que fueron enviados desde una aplicación de terceros.
Ejemplo de un mensaje
El método generará un mensaje y, si es necesario, también creará el chat correspondiente para el msgid y conversation_id especificados.
| Tipo de mensaje | Caso de uso | Parámetros que deben pasarse |
|---|---|---|
| Entrante de: cliente | Un cliente envía un mensaje al canal conectado. | Solo se completa el campo payload[sender], no se envía el campo payload[receiver]. |
| Saliente de: usuario de Kommo to: cliente | Un asesor escribe un mensaje al cliente y podemos identificar quién lo envía. | Se completan los campos payload[sender](información del asesor) y payload[receiver](información del cliente).Se pasa el ID del usuario de Kommo en payload[sender][ref_id]. |
| Saliente de: bot de la integración a: cliente | Un asesor escribe un mensaje al cliente pero no podemos identificar al remitente. | Se completan los campos payload[sender] (información del bot) y payload[receiver] información del cliente).El ID del bot de la integración, que se obtuvo al registrar el canal en la API de Chat, se pasa en el campo payload[sender][ref_id]. |
Utilizando este método de la API, puedes importar en masa mensajes antiguos a un chat.
Recomendamos realizar la importación sin enviar notificaciones a los asesores ni crear un lead entrante para los mensajes, excepto para el último (el más reciente).
Para hacer esto, debes pasar el parámetro en el cuerpo payload[silent] con el valor true para todos los mensajes, excepto para el último, al cual se le pasa el valor false en payload[silent]. De esta forma, se creará un lead entrante solo para el último mensaje, y solo se enviará una notificación. Así evitaremos generar una interrupción innecesaria para el usuario.
Cuando se importan mensajes desde el bot de integración, no se envían hooks.
Encabezados y tipo de autorización
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| Date | string | Fecha y hora en que se generó la solicitud. La firma será válida durante 15 minutos a partir de esta fecha. La fecha debe estar en el formato “Jue, 01 ene 2023 12:00:00 +0000” (RFC2822). |
| Content-type | string | Tipo de datos de la solicitud. Actualmente, solo se admite application/json. |
| Content-MD5 | string | Para el cuerpo de la solicitud, es necesario calcular el hash MD5 e indicarlo en el encabezado en minúsculas. Al mismo tiempo, es importante tener en cuenta que el cuerpo de la solicitud se calcula como un flujo de bytes sin considerar el final de la marca de JSON, y si hay \n o espacios al final, también se tomarán en cuenta. |
| X-Signature | string | Firma de la solicitud como una cadena. Se forma a partir del nombre del método (GET/POST) en mayúsculas, con los valores de los encabezados concatenados por \n. Los valores de los encabezados deben seguir un orden específico. Si no hay encabezado, se debe especificar una cadena vacía en su lugar. Luego, añade el camino solicitado de la URL sin el protocolo y dominio (sin los parámetros GET) a la línea. La cadena resultante se calcula utilizando HMAC-SHA1, y como secreto, se utiliza el secreto del canal obtenido durante el registro. El hash resultante en minúsculas se indica en el encabezado X-Signature. |
Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error
Content-Type: application/json.
Parámetros de respuesta
El método retorna el amojo_id del mensaje que aparecerá en el feed del chat cuando sea procesado.
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| new_message[msgid] | string | ID del mensaje en la API de Chats. |
| new_message[ref_id] | string | ID del chat en el lado de la integración. |