Después de enviar mensajes mediante la API de Chat App Message Service, puede utilizar el modo de consumo de Simple Message Queue (anteriormente MNS) (SMQ) o el modo de envío por lotes HTTP para recibir actualizaciones sobre el estado de entrega de los mensajes y las respuestas de los usuarios.
Notas de uso
Los problemas de red, como una conectividad deficiente o tiempos de espera agotados, pueden provocar acuses de recibo duplicados o impedir su recuperación.
Modos de acuse de recibo de mensajes
Puede recibir los acuses de recibo de mensajes en dos modos: modo de consumo SMQ y modo de envío por lotes HTTP. Elija el modo que mejor se adapte a sus necesidades.
Los acuses de recibo de mensajes no garantizan la idempotencia. Usted es responsable de gestionar los posibles duplicados para asegurar la integridad y consistencia de los datos. Se recomienda diseñar la lógica de procesamiento de acuses de recibo para que sea idempotente.
-
Modo de consumo SMQ
En el modo de consumo SMQ, se utiliza una cola SMQ para recibir los acuses de recibo de mensajes correspondientes a una región específica. Todos los mensajes empresariales admiten la entrega saliente a través de SMQ. Cuando habilita SMQ y se suscribe a un tipo de mensaje específico (MessageType) en la Chat App Message Service console, el sistema crea automáticamente una cola de mensajes dedicada y genera un nombre de cola (QueueName). Posteriormente, puede usar este QueueName y MessageType para invocar el SDK desde su backend y recuperar los acuses de recibo de la cola.
-
Modo de envío por lotes HTTP
En el modo de envío por lotes HTTP, el sistema envía datos a una URL especificada mediante solicitudes HTTP POST. Una vez que configure una URL de callback (callback_url) en la Chat App Message Service console, el sistema envía automáticamente los acuses de recibo de mensajes, como mensajes MO e informes de estado, a dicha URL.
Tipos de acuse de recibo de mensajes
Después de seleccionar un modo de acuse de recibo, debe suscribirse a los tipos de mensaje correspondientes a los eventos sobre los que desea recibir notificaciones. A continuación se muestran los tipos de mensaje disponibles.
|
Tipo |
Descripción |
Modo de consumo SMQ |
Modo de envío por lotes HTTP |
|
ChatAppInbound (mensaje MO) |
Recupera los mensajes enviados por los usuarios finales a su número empresarial. |
||
|
ChatAppStatus (informe de estado de mensaje MT) |
Rastrea el estado de entrega de los mensajes salientes que usted envía a los usuarios finales (mensajes MT). |
||
|
ChatAppAudit (estado de revisión de plantilla) |
Recibe notificaciones sobre el estado de revisión de las plantillas creadas mediante la API CreateChatappTemplate. |
Configurar los modos de acuse de recibo de mensajes
Configurar informes de estado y mensajes MO
Para recibir acuses de recibo de mensajes, primero debe habilitarlos en la consola de Chat App Message Service.
Inicie sesión en la Chat App Message Service console.
En el panel de navegación izquierdo, haga clic en Channel Management. Busque su canal y haga clic en Manage en la columna Actions.
-
En la página Data Panel del canal, vaya a la configuración de webhook según el tipo de canal:
Para canales de WhatsApp, haga clic en .
Para canales de Viber, haga clic en .
Para canales de Messenger, haga clic en .
Para canales de Instagram, haga clic en .
-
Configure sus suscripciones de mensajes.
-
Una vez que su página, cuenta o número de servicio esté conectado, haga clic en Configure Webhook y seleccione los tipos de mensaje a los que desea suscribirse.
NotaURL de callback de informe de estado: Corresponde a ChatAppStatus (informe de estado de mensaje MT).
URL de callback de mensaje MO: Corresponde a ChatAppInbound (mensaje MO).
El cuadro de diálogo también contiene los interruptores HTTP Protocol y Message Queue Monitoring, así como los campos Message Receipt Queue y MO Message Queue. Después de completar la configuración, haga clic en OK.
-
-
Habilite HTTP Protocol e introduzca las URL de callback para los informes de estado y los mensajes MO.
NotaMejor práctica: Utilice rutas de URL distintas en su servidor (por ejemplo,
https://xxxx.com) para cada tipo de mensaje y así simplificar su diferenciación. No recomendado: Evite dirigir todos los tipos de mensaje a una sola URL y analizar posteriormente el cuerpo de la solicitud para identificar el tipo.En el campo Status Report Callback URL, introduzca una URL, como https://xxxx.com/appstatus.
En el campo MO Message Callback URL, introduzca una URL, como https://xxxx.com/inbound.
Habilite Message Queue Monitoring y haga clic en OK.
Haga clic nuevamente en Configure Webhook. En el cuadro de diálogo que aparece, copie los nombres de Message Receipt Queue y MO Message Queue.
Configurar mensajes de estado de revisión de plantillas
Actualmente, solo los canales de WhatsApp son compatibles con esta función.
Inicie sesión en la Chat App Message Service console.
En el panel de navegación izquierdo, haga clic en Channel Management. Busque su canal y haga clic en Manage en la columna Actions.
En la página Data Panel del canal, dentro del panel de navegación izquierdo, haga clic en .
-
Habilite HTTP Protocol e introduzca la URL de callback de notificación.
En el campo Notification Callback URL, introduzca una URL. Por ejemplo: https://xxxx.com/appaudit
Habilite Message Queue Monitoring y haga clic en OK.
En el cuadro de diálogo Channel Webhook Settings, al habilitar Message Queue Monitoring se muestra el campo Notification Queue, donde puede copiar el nombre de la cola. También puede seleccionar una API version según sea necesario.
Haga clic nuevamente en Channel Webhook Settings. En el cuadro de diálogo que aparece, copie el nombre de Notification Queue.
Descarga del SDK de SMQ
Puede descargar el SDK de Java de SMQ para extraer mensajes de su cola SMQ.
Descarga del SDK: SDK de Java de SMQ