Status recebidos no Webhook
A Plataforma do WhatsApp Business envia mensagens para informar o status das mensagens trocadas entre você e os usuários. Quando a mensagem é enviada com sucesso, você recebe uma mensagem de confirmação no webhook para cada evento (enviada, entregue e lida).
A ordem dessas mensagens no seu app pode não refletir o momento real do status da mensagem. Veja o registro de data e hora para determinar o momento, se for necessário.
WHATSAPP_MESSAGE_ID" X "ID_REQUISICAO
WHATSAPP_MESSAGE_ID corresponde ao id da Meta (idMeta).
ID_REQUISICAO corresponde ao id do Serpro.
Status: Mensagem enviada
A mensagem a seguir será recebida quando a empresa enviar uma mensagem como parte de uma conversa iniciada pelo usuário.
{
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
"phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
},
"contacts": [],
"messages": [],
"errors": [],
"statuses": [
{
"id": "WHATSAPP_MESSAGE_ID",
"status": "sent",
"timestamp": "TIMESTAMP",
"recipient_id": "CUSTOMER_PHONE_NUMBER",
"conversation": {
"id": "CONVERSATION_ID",
"expiration_timestamp": "CONVERSATION_EXPIRATION_TIMESTAMP",
"origin": {
"type": "service"
}
},
"pricing": {
"billable": true,
"pricing_model": "CBP",
"category": "service"
}
}
],
"delay": 0,
"idRequisicao": "ID_REQUISICAO"
}
Status: Mensagem entregue
A mensagem a seguir será recebida quando a mensagem da empresa for entregue como parte de uma conversa iniciada pelo usuário.
{
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
"phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
},
"contacts": [],
"messages": [],
"errors": [],
"statuses": [
{
"id": "WHATSAPP_MESSAGE_ID",
"status": "delivered",
"timestamp": "TIMESTAMP",
"recipient_id": "CUSTOMER_PHONE_NUMBER",
"conversation": {
"id": "CONVERSATION_ID",
"origin": {
"type": "service"
}
},
"pricing": {
"billable": true,
"pricing_model": "CBP",
"category": "service"
}
}
],
"delay": 0,
"idRequisicao": "ID_REQUISICAO"
}
Status: Mensagem lida
A mensagem a seguir será recebida quando a mensagem de uma empresa for lida pelo usuário. Caso a opção de aviso de leitura esteja desabilitada no WhatsApp do usuário, o aviso de leitura não será entregue.
{
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "BUSINESS_DISPLAY_PHONE_NUMBER",
"phone_number_id": "BUSINESS_PHONE_NUMBER_ID"
},
"contacts": [],
"messages": [],
"errors": [],
"statuses": [
{
"id": "WHATSAPP_MESSAGE_ID",
"status": "read",
"timestamp": "TIMESTAMP",
"recipient_id": "CUSTOMER_PHONE_NUMBER"
}
],
"delay": 0,
"idRequisicao": "ID_REQUISICAO"
}
Importante!
- Failed pode estar preenchido e o delivered também, ou seja, uma mensagem pode dar erro mas ser enviada mesmo assim.
- Se o aplicativo whatsapp estiver aberto, o status read é preenchido e o delivered não.