Registros de la SMS API

La página de registros de la API de SMS te permite buscar y solucionar problemas de los mensajes SMS enviados a través de la API de SMS. Utilice esta página para investigar problemas de entrega, verificar el estado de los mensajes y descargar registros para su posterior análisis.

Nota: Si envía tráfico SMS a través del Messages APIutilice el botón Mensajes API Registros en su lugar.

Antes de empezar

  • Los registros de SMS están disponibles para Sólo 30 días
  • Para los registros de más de 30 días, utilice la función Reports API
  • Hay un retraso de unos minutos antes de que aparezcan los registros
  • Establezca un Webhook de recepción de entrega para actualizaciones de estado en tiempo real

Acceso a los registros de SMS

  1. Inicie sesión en Panel de API de Vonage
  2. Vaya a Registros de la SMS API
SMS Logs

Métodos de búsqueda

La página Registros de SMS API ofrece cinco métodos de búsqueda:

Intervalo de tiempo

Busque mensajes dentro de un periodo de tiempo específico para investigar el rendimiento o supervisar el tráfico.

Filtros disponibles:

  • Intervalo de tiempo - Última hora, Últimas 24 horas, Últimos 7 días, Últimos 30 días o Intervalo personalizado
  • Dirección - Mensajes salientes o entrantes

Numbers de téléphone

Busque mensajes enviados a o desde números de teléfono específicos para investigar problemas de los clientes o verificar la entrega a un destinatario concreto.

Filtros disponibles:

  • Número "A - El número de teléfono de destino
  • En - ID o número de teléfono del remitente
  • Intervalo de tiempo - Cuando se envió el mensaje
  • Dirección - Salida o entrada

Consejo: Utilice el formato internacional (prefijo del país + número) para los números de teléfono.

ID del mensaje

Busque uno o más mensajes específicos utilizando sus ID de mensaje únicos. Este método es ideal cuando tienes IDs de mensajes de respuestas API o webhooks.

Filtros disponibles:

  • ID de los mensajes - Uno o varios identificadores de mensaje separados por comas
  • Dirección - Salida o entrada

Gancho web

Solucione los problemas de las devoluciones de llamada de recepción de entrega (DLR) y los webhooks de mensajes entrantes para asegurarse de que su aplicación recibe correctamente las actualizaciones de estado.

Filtros disponibles:

  • Dirección - Retrollamada saliente (estado DLR) o Retrollamada entrante
  • Intervalo de tiempo - Cuándo se envió el webhook
  • Número de beneficiario - El número de teléfono para la entrega de webhooks (por ejemplo, 447777889900)

Importante: Los registros de Webhook muestran si Vonage entregó correctamente la devolución de llamada a tu servidor, no si tu servidor la procesó correctamente.

No enviado

Encuentra mensajes que fueron rechazados por la plataforma de Vonage antes de la entrega. Estos mensajes no han sido programados para su entrega, no tienen estado DLR y no se cobran.

Filtros disponibles:

  • Número "A - El número de destino previsto
  • En - ID o número del remitente
  • Intervalo de tiempo - Cuando se rechaza el mensaje

Trabajar con resultados

SMS Logs

Ver detalles del registro

Cada entrada de registro muestra información clave sobre el mensaje:

  • ID del mensaje - Identificador único del mensaje
  • En - ID o número de teléfono del remitente
  • A - Número de teléfono de destino
  • Estado - Estado de la entrega (enviada, entregada, fallida, etc.)
  • Tiempo - Cuándo se envió el mensaje o se actualizó su estado
  • Red - Operador de red móvil
  • Precio - Coste del mensaje

Haz clic en una entrada de registro para ver todos los detalles, incluidos los códigos de error y la información de red.

Descarga de registros

Exporte los resultados de la búsqueda a CSV para realizar análisis fuera de línea o llevar un registro.

Para descargar los registros:

  1. Realizar una búsqueda utilizando cualquier método
  2. Haga clic en Descargar CSV
  3. El archivo CSV incluirá todos los campos de los resultados de la búsqueda

Nota: Las descargas CSV se limitan a los resultados mostrados. Para exportaciones masivas o acceso programático, utilice la función Reports API.

Comprender los retrasos en los registros

  • Registros regulares: Disponible entre 2 y 5 minutos después del envío
  • Recibos de entrega: Depende del operador de red (de segundos a horas)
  • Actualizaciones en tiempo real: Utilice Webhooks de recepción de entregas en su lugar

Lecturas complementarias