Ir para o conteúdo

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.