Como obter o registro da mensagem com o status de entrega mais recente

Existem muitas situações em que você pode querer armazenar dados da Reports API em seu próprio banco de dados. Este guia explica três métodos diferentes para recuperar o status de entrega mais recente (entregue ou não entregue) das mensagens enviadas por meio das APIs da Vonage.

É importante observar que o status final de entrega de uma determinada mensagem geralmente fica disponível em poucos minutos. No entanto, em casos raros, o prazo máximo varia de acordo com o canal:

  • SMS e MMS: até 72 horas
  • WhatsApp e RCS: até 30 dias
  • Viber: até 14 dias

Nota: Aproximadamente 0,1% das chamadas de retorno de status de entrega e 3% das chamadas de retorno de status de leitura ocorrem após 72 horas.

Existem três maneiras diferentes de obter o registro da mensagem com o status de entrega mais recente. O primeiro método é usar a Reports API, que recomendamos, e há também dois métodos alternativos que você pode considerar:

Usando a Reports API (recomendado)

Esse método é a maneira mais eficiente de obter o registro da mensagem com o status de entrega mais recente. Além de ser o mais simples, ele também não exige o armazenamento de dados ou IDs em seu sistema de armazenamento. Siga as etapas abaixo para executá-lo:

  1. Obtenha registros referentes a um determinado período de tempo usando o ponto final síncrono ou o ponto de extremidade assíncrono, e guarde-os no seu depósito (se necessário).
  2. Para registros que ainda não atingiram seu estado final, você pode verificar status por id.
  3. Atualize os registros que você armazenou na Etapa 1 usando o ponto final síncrono ou o ponto de extremidade assíncrono com o status atual.

Usando o ID da mensagem da loja

Esse método é uma alternativa que você pode utilizar. No entanto, esteja ciente de que talvez não seja a melhor opção para usuários com maior volume de tráfego. Siga as etapas abaixo para executá-lo:

  1. Armazene o ID da mensagem em seu banco de dados.
  2. Reports API de Chamadas por id para cada mensagem, a fim de verificar o status mais recente.

Como usar Webhooks e a Reports API

Este é o segundo método alternativo que você pode utilizar. Nesse caso, é importante saber que ele realiza o monitoramento da capacidade de entrega, mas não armazena os dados com o estado real no sistema de armazenamento. Siga as etapas abaixo para executá-lo:

  1. Use um callback/webhook para o SMS API ou para o Messages API ser notificado quando o status de cada mensagem for alterado.
  2. Use a Reports API para verificar e armazenar os dados com o status final.