Logs da SMS API

A página “Logs da SMS API” permite pesquisar e solucionar problemas relacionados a mensagens de SMS enviadas por meio da SMS API. Use essa página para investigar problemas de entrega, verificar o status das mensagens e baixar logs para análise posterior.

Observação: Se você enviar mensagens SMS por meio do Messages API, use o Logs da Messages API em vez disso.

Antes de começar

  • Os registros de SMS estão disponíveis para Apenas 30 dias
  • Para registros com mais de 30 dias, use o Reports API
  • Há um atraso de alguns minutos antes que os registros apareçam
  • Configurar um Webhook de recibo de entrega para atualizações de status em tempo real

Acesso aos registros de SMS

  1. Faça login no Painel da API da Vonage
  2. Acesse Logs da SMS API
SMS Logs

Métodos de pesquisa

A página “Logs da SMS API” oferece cinco métodos de pesquisa:

Intervalo de tempo

Pesquise mensagens dentro de um período específico para analisar o desempenho ou monitorar o tráfego.

Filtros disponíveis:

  • Intervalo de tempo - Última hora, últimas 24 horas, últimos 7 dias, últimos 30 dias ou intervalo personalizado
  • Direção - Mensagens enviadas ou recebidas

Número de telefone

Pesquise mensagens enviadas para ou recebidas de números de telefone específicos para investigar problemas dos clientes ou Verify se a mensagem foi entregue a um destinatário específico.

Filtros disponíveis:

  • Número de “para” - O número de telefone de destino
  • De - O ID do remetente ou o número de telefone
  • Intervalo de tempo - Quando a mensagem foi enviada
  • Direção - De saída ou de entrada

Dica: Use o formato internacional (código do país + número) para números de telefone.

ID da mensagem

Pesquise uma ou mais mensagens específicas usando seus IDs exclusivos. Esse método é ideal quando você tem os IDs das mensagens provenientes de respostas de API ou webhooks.

Filtros disponíveis:

  • IDs de mensagens - Um ou mais IDs de mensagem separados por vírgulas
  • Direção - De saída ou de entrada

Webhook

Solucione problemas relacionados a callbacks de confirmação de entrega (DLR) e webhooks de mensagens recebidas para garantir que seu aplicativo esteja recebendo as atualizações de status corretamente.

Filtros disponíveis:

  • Direção - Retorno de chamada de saída (status DLR) ou retorno de chamada de entrada
  • Intervalo de tempo - Quando o webhook foi enviado
  • Número do destinatário - O número de telefone para o envio do webhook (por exemplo, 447777889900)

Importante: Os registros do webhook mostram se a Vonage enviou com sucesso a resposta de retorno ao seu servidor, e não se o seu servidor a processou corretamente.

Não enviado

Encontre as mensagens que foram rejeitadas pela plataforma da Vonage antes da entrega. Essas mensagens não foram agendadas para entrega, não têm o status DLR e não são cobradas.

Filtros disponíveis:

  • Número de “para” - O número de destino pretendido
  • De - O ID ou número do remetente
  • Intervalo de tempo - Quando a mensagem foi rejeitada

Trabalhando com resultados

SMS Logs

Visualizando detalhes do registro

Cada entrada do log exibe informações importantes sobre a mensagem:

  • ID da mensagem - Identificador único da mensagem
  • De - ID do remetente ou número de telefone
  • Para - Número de telefone de destino
  • Status - Status da entrega (enviado, entregue, falha, etc.)
  • Hora - Quando a mensagem foi enviada ou o status foi atualizado
  • Rede - Operadora de rede móvel
  • Preço - Custo da mensagem

Clique em uma entrada do log para visualizar todos os detalhes, incluindo códigos de erro e informações de rede.

Baixando registros

Exporte os resultados da pesquisa para um arquivo CSV para análise off-line ou manutenção de registros.

Para baixar os registros:

  1. Faça uma pesquisa usando qualquer método
  2. Clique Baixar CSV
  3. O arquivo CSV incluirá todos os campos dos resultados da pesquisa

Observação: Os downloads em formato CSV estão limitados aos resultados exibidos. Para exportações em massa ou acesso programático, use o Reports API.

Entendendo os atrasos nos registros

  • Registros regulares: Disponível em 2 a 5 minutos após o envio
  • Comprovantes de entrega: Depende do tempo de resposta da operadora de rede (de segundos a horas)
  • Atualizações em tempo real: Uso Webhooks de recebimento de entrega em vez disso

Leitura complementar