Mensajes API Registros
La página Registros de la API de Messages le permite buscar y solucionar problemas de mensajes enviados a través de la API de Messages en todos los canales compatibles, incluidos WhatsApp, SMS, RCS, MMS, Viber, Messenger e Instagram. Utilice esta página para investigar problemas de entrega, verificar el estado de los mensajes en todos los canales y descargar registros para su análisis.
Nota: Si envía tráfico SMS a través del SMS APIutilice el botón Registros de la SMS API en su lugar.
Antes de empezar
- Los registros de la Messages API 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 la API de Messages
- Inicie sesión en Panel de API de Vonage
- Vaya a Monitor → Registros
- Seleccione Mensajes API Registros
Métodos de búsqueda
La página Messages API Logs ofrece tres métodos de búsqueda:
Intervalo de tiempo
Busque mensajes dentro de un periodo de tiempo específico para supervisar el tráfico en todos los canales o filtrar por proveedores concretos.
Filtros disponibles:
- Intervalo de tiempo - Última hora, Últimas 24 horas, Últimos 7 días, Últimos 30 días o Intervalo personalizado
- Proveedor - Cualquiera, WhatsApp, SMS, MMS, RCS, Viber, Messenger o Instagram
- Dirección - Mensajes salientes o entrantes
- Incluir el cuerpo del mensaje - Mostrar el contenido del mensaje en los resultados
Números de teléfono / ID
Busque mensajes enviados a o desde números de teléfono específicos o ID de cuentas externas para investigar problemas de los clientes o verificar la entrega.
Filtros disponibles:
- En - Número de teléfono o ID de cuenta del remitente
- A - Número de teléfono o ID de cuenta de destino
- Proveedor - Cualquiera, WhatsApp, SMS, MMS, RCS, Viber, Messenger o Instagram
- Dirección - Salida o entrada
- Intervalo de tiempo - Cuando se envió el mensaje
- Incluir el cuerpo del mensaje - Mostrar el contenido del mensaje en los resultados
Consejo: En el caso de WhatsApp, puede buscar por número de teléfono o por ID de cuenta de WhatsApp Business (WABA ID).
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 UUID de mensaje separados por comas
- Dirección - Salida o entrada
- Incluir el cuerpo del mensaje - Mostrar el contenido del mensaje en los resultados
Nota: Messages API utiliza identificadores de mensajes en formato UUID, que difieren de los identificadores de mensajes de SMS API.
Trabajar con resultados
Ver detalles del registro
Cada entrada de registro muestra información clave sobre el mensaje:
- ID del mensaje - UUID único para el mensaje
- Canal - El proveedor de mensajería (WhatsApp, SMS, RCS, etc.)
- En - Número de teléfono o ID de cuenta del remitente
- A - Número de teléfono de destino o ID de cuenta
- Estado - Estado de la entrega (enviado, entregado, leído, rechazado, etc.)
- Tiempo - Cuándo se envió el mensaje o se actualizó su estado
- Red - Operador de red móvil (sólo para SMS/MMS/RCS)
- Precio - Coste del mensaje
Comprender el estado de los mensajes
Los distintos canales admiten diferentes valores de estado:
| Estado | Descripción | Canales |
|---|---|---|
| enviado | Mensaje aceptado por Vonage | Todos los canales |
| entregado | Mensaje entregado al destinatario | Todos los canales |
| leer | Mensaje leído por el destinatario | WhatsApp, Viber, Messenger, Instagram |
| rechazado | Mensaje rechazado por el proveedor | Todos los canales |
| no se puede entregar | Mensaje no entregado | Todos los canales |
Incluido el cuerpo del mensaje
Por defecto, el contenido de los mensajes no se muestra por motivos de privacidad y rendimiento. Comprueba el Incluir el cuerpo del mensaje para ver el contenido de los mensajes en los resultados.
Importante: El contenido del cuerpo del mensaje sólo está disponible si se almacenó. Es posible que algunos canales no conserven el contenido de los mensajes debido a políticas de privacidad.
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:
- Realizar una búsqueda utilizando cualquier método
- Haga clic en Descargar CSV
- El archivo CSV incluirá todos los campos de los resultados de la búsqueda, incluido el cuerpo del mensaje si está activado
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: Varía según el canal:
- WhatsApp: Casi en tiempo real (segundos)
- SMS/MMS: Depende del operador de red (de segundos a horas)
- RCS: Casi en tiempo real (segundos)
- Canales sociales: Casi en tiempo real (segundos)
- Actualizaciones en tiempo real: Utilice Webhooks de recepción de entregas para notificaciones inmediatas