Actualizar el estado de entrega del mensaje

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á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.

🚧

Debes escribir el cuerpo en tu solicitud exactamente igual a como lo escribiste al calcular los encabezados.

Estado del mensaje

EstadoCuándo se debe utilizar este estadoValor enum de estado
EnviadoEl mensaje fue enviado desde Kommo.-
EntregadoEl mensaje fue entregado al destinatario.1
LeídoEl mensaje fue leído por el destinatario.2
ErrorEl mensaje no fue entregado.-1

Códigos de error

Código de error¿Cuándo se debe enviar el código?
901El usuario ha eliminado el mensaje.
902La integración está deshabilitada del lado del canal.
903Error interno del servidor.
904No se puede crear una conversación (por ejemplo, el usuario no está registrado en WhatsApp).
905Cualquier 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"
}

Language