Transferir información de escritura

l método permite transferir información de que el cliente está escribiendo algo en el mensajero. Esta información se mostrará en la interfaz de Kommo.

🚧

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.

Debes enviar la solicitud dos veces:

  • la primera vez verás que el cliente está en el perfil.


  • la segunda vez verás que el cliente está escribiendo.


Encabezados y tipo de autorización

ParámetroTipo de datoDescripción
DatestringFecha 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-typestringTipo de datos de la solicitud. Actualmente, solo se admite application/json.
Content-MD5stringPara 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-SignaturestringFirma 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.

Respuesta

El método no retorna un cuerpo en caso de solicitud exitosa, pero aparece en la interfaz de Kommo que el cliente está escribiendo.

Language