post https://amojo.kommo.com/v2/origin/custom///delivery_status
El método permite actualizar el estado de entrega de un mensaje 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. |
Debes escribir el cuerpo en tu solicitud exactamente igual a como lo escribiste al calcular los encabezados.
Estado del mensaje
Estado | Cuándo se debe utilizar este estado | Valor enum de estado |
---|---|---|
Enviado | El mensaje fue enviado desde Kommo. | - |
Entregado | El mensaje fue entregado al destinatario. | 1 |
Leído | El mensaje fue leído por el destinatario. | 2 |
Error | El mensaje no fue entregado. | -1 |
Códigos de error
Código de error | ¿Cuándo se debe enviar el código? |
---|---|
901 | El usuario ha eliminado el mensaje. |
902 | La integración está deshabilitada del lado del canal. |
903 | Error interno del servidor. |
904 | No se puede crear una conversación (por ejemplo, el usuario no está registrado en WhatsApp). |
905 | Cualquier otro error (debes enviar el texto del error). |
Encabezado de tipo de datos cuando la solicitud es exitosa/en caso de un error
Content-Type: application/json.
Ejemplos del cuerpo de la solicitud:
Cambiar el estado de entrega del mensaje a Leído.
{
"msgid": "XXXXXX-2aa3-464c-b6e4-4386d0f8f3ca",
"delivery_status": 2
}
Cambiar el estado de entrega del mensaje a Error.
{
"msgid": "3419eef6-2aa3-464c-b6e4-4386d0f8f3ca",
"delivery_status": -1,
"error_code": 902,
"error": "Fuente de lead inhabilitado"
}