get https://amojo.kommo.com/v2/origin/custom//chats//history
Este método permite obtener una lista de mensajes de un chat específico.
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.
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 “Thu, 01 Jan 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. Para las solicitudes GET, también se debe calcular MD5. Incluso si no se pasa nada en el cuerpo de la solicitud, MD5 se obtendrá de una cadena vacía. |
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. |
🛸
Calcular los encabezados para las solicitudes de la API de Chats
Open Recipe
Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error
Content-Type: application/json.
Parámetros de respuesta
Parámetro | Tipo de dato | Descripción |
---|---|---|
timestamp | int | Marca de tiempo cuando se envió el mensaje. |
msec_timestamp | int | Marca de tiempo cuando se envió el mensaje, en milisegundos. |
sender[id] | string | ID del remitente del mensaje en la API de Chats. |
sender[name] | string | Nombre del remitente del mensaje en la API de Chats. |
sender[client_id] | string | ID del remitente del mensaje en el lado de la integración. |
sender[avatar] | string | Avatar del remitente, si fue proporcionado durante la creación. |
sender[phone] | string | Número de teléfono del remitente, si fue proporcionado durante la creación. |
sender[email] | string | Remitente, si fue proporcionado durante la creación. |
receiver[id] | string | ID del destinatario del mensaje en la API de Chats. |
receiver[name] | string | Nombre del destinatario del mensaje en la API de Chats. |
receiver[client_id] | string | ID del destinatario del mensaje en el lado de la integración. |
receiver[avatar] | string | Enlace al avatar del destinatario, si fue proporcionado durante la creación. |
receiver[phone] | string | Número de teléfono del destinatario, si fue proporcionado durante la creación. |
receiver[email] | string | Correo del destinatario, si fue proporcionado durante la creación. |
message[id] | string | ID del chat en el lado de la API de Chats. |
message[client_id] | string | ID del chat en el lado de la integración. |
message[type] | string | Tipo de mensaje. |
message[text] | string | Tipo de texto. |
message[media] | string | Enlace al archivo multimedia. |
message[thumbnail] | string | Enlace a la miniatura del archivo multimedia. |
message[file_name] | string | Nombre del archivo del campo “media”. |
message[file_size] | string | Tamaño del archivo del campo “media”. |
message[media_group_id] | string | ID del grupo multimedia. Si el usuario envía un solo mensaje con varios adjuntos, lo dividiremos en varios mensajes, pero los archivos multimedia se combinarán en un solo grupo. |