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 con más de 30 días de antigüedad, utiliza el Reports API
- Hay un retraso de unos minutos antes de que aparezcan los registros
- Establezca un Webhook de recepción de entrega para recibir actualizaciones de estado en tiempo real
Acceso a los registros de la Messages API
- Inicie sesión en Panel de control de la API de Vonage
- Vaya a Monitor → Registros
- Seleccionar Mensajes API Registros
Métodos de búsqueda
La página «Registros de la Messages API» ofrece tres métodos de búsqueda:
Intervalo de tiempo
Busca mensajes dentro de un periodo de tiempo concreto para supervisar el tráfico en todos los canales o filtrar por proveedores específicos.
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úmero de teléfono / DNI
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 - El número de teléfono del remitente o el ID de la cuenta
- A - Número de teléfono o ID de cuenta de destino
- Proveedor - Cualquiera, WhatsApp, SMS, MMS, RCS, Viber, Messenger o Instagram
- Dirección - Saliente o entrante
- 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, puedes buscar por número de teléfono o por el ID de la cuenta de WhatsApp Business (WABA ID).
ID del mensaje
Busca uno o varios mensajes concretos utilizando sus identificadores de mensaje únicos. Este método es ideal cuando dispones de los identificadores de mensaje procedentes de respuestas de la API o de webhooks.
Filtros disponibles:
- ID de los mensajes - Uno o varios UUID de mensaje separados por comas
- Dirección - Saliente o entrante
- Incluir el cuerpo del mensaje - Mostrar el contenido del mensaje en los resultados
Nota: La Messages API utiliza identificadores de mensaje en formato UUID, que difieren de los identificadores de mensaje de la 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 entrega (enviado, entregado, leído, rechazado, etc.)
- Tiempo - Cuándo se envió el mensaje o se actualizó el 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 |
Incluir 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 opción para ver el contenido del mensaje en los resultados.
Importante: El contenido del cuerpo del mensaje solo está disponible si se ha guardado. Es posible que algunos canales no conserven el contenido de los mensajes debido a sus 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:
- Realiza una búsqueda utilizando cualquier método
- Haz clic 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)
- Redes sociales: casi en tiempo real (segundos)
- Actualizaciones en tiempo real: Utilice Webhooks de acuse de recibo de entrega para notificaciones inmediatas