Registro de SMS
El registro de SMS, visible en la página Messages, es el historial de mensajes de tu espacio de trabajo. Los envíos salientes y las respuestas entrantes aparecen del más reciente al más antiguo. Úsalo para confirmar un envío, seguir su ciclo de vida de entrega e inspeccionar su cantidad de segmentos, costo y detalles del operador. La página agregada de Metrics muestra tasas entre mensajes; el registro de SMS te permite inspeccionar un mensaje individual. La página también incluye Send SMS para envíos puntuales desde el panel.
La lista de mensajes
Cada fila es un mensaje. Las columnas son:
| Columna | Qué muestra |
|---|---|
| Status | El estado de entrega actual del mensaje (consulta Estados) |
| From | El remitente: el número, el identificador de remitente o el código corto desde el que se envió el mensaje |
| To | El número del destinatario |
| Message | El inicio del cuerpo del mensaje (haz clic en él, o en cualquier parte de la fila, para abrir el mensaje) |
| Category | La categoría del mensaje, mostrada como una etiqueta corta (TXN, MKTG, AUTH, SVC) |
| Sent | Cuándo se aceptó el envío, como tiempo relativo (pasa el cursor para ver la marca de tiempo exacta) |
La lista está paginada, con 25 mensajes por página; usa Prev y Next para moverte entre páginas.
Búsqueda y filtros
Un registro de mensajes se llena rápido, por eso la página comienza con una búsqueda por destinatario y cuatro filtros. Se combinan entre sí: un filtro de estado más un rango de fechas reduce los resultados a los mensajes que coincidan con ambos.
Búsqueda por destinatario. El cuadro de búsqueda coincide con un número de destinatario exacto en formato E.164. Escribe el número completo, como +31612345678, para encontrar cada mensaje dirigido a él. La búsqueda no coincide con subcadenas.
Estado. Filtra por uno o más estados de entrega. El estado es de selección múltiple, así que puedes, por ejemplo, mostrar todo lo que no llegó seleccionando Undelivered, Failed y Expired juntos. Las opciones son los estados listados en Estados.
Categoría. Filtra por categoría de mensaje: Transactional, Marketing, Authentication o Service.
Dirección. Filtra por Outbound o Inbound. Las respuestas a tus números se almacenan junto con tus envíos, así que Inbound muestra lo que recibiste.
Fecha. Filtra por cuándo se envió el mensaje; elige un valor predefinido o selecciona un rango personalizado en el calendario.
Cuando una combinación de filtros no coincide con nada, la página muestra un estado sin resultados con una acción Clear filters para volver a la lista completa.
Estados
El estado de un mensaje indica en qué punto se encuentra dentro del ciclo de vida de entrega. Un mensaje avanza desde accepted hacia un acuse de recibo terminal.
| Estado | Significado |
|---|---|
| Accepted | Bird admitió el mensaje y se prepara para entregarlo a un operador |
| Sent | Entregado al operador; en espera de un acuse de recibo de entrega |
| Delivered | El operador confirmó la entrega al dispositivo |
| Undelivered | Un fallo no permanente: el dispositivo estaba apagado, fuera de alcance, o el contenido fue bloqueado |
| Failed | Un fallo permanente; el mensaje no puede ser entregado |
| Rejected | El mensaje fue rechazado (una verificación de política, un cobro fallido o un operador que lo rechazó) |
| Expired | El operador dejó de intentar y reportó el mensaje como expirado |
| Received | Un mensaje entrante |
La etiqueta de estado indica si un mensaje está en tránsito, entregado, recibido o sin éxito. No te bases solo en el color al revisar los resultados.
Inspeccionar un mensaje
Haz clic en cualquier fila para abrir el mensaje en un panel lateral. Tiene dos pestañas, Events y Details, y su encabezado muestra el cuerpo del mensaje, el estado actual, el destinatario y la categoría. Mientras un mensaje está en tránsito, el panel se actualiza automáticamente cada pocos segundos, así que un cambio de estado o un acuse de recibo de entrega aparece sin necesidad de recargar manualmente.
Events
La pestaña predeterminada es una línea de tiempo con marcas de tiempo para un mensaje. Representa el flujo descrito en eventos de SMS: Accepted, luego Sent, luego Delivered, o un evento de fallo (Undelivered, Failed, Rejected, Expired). Los eventos de entrega identifican al operador y el MCC/MNC (la red móvil). Los eventos de fallo muestran la descripción del error; la pestaña Details contiene el código de error.
Details
La pestaña Details contiene los metadatos del mensaje:
- Message ID, Direction, From, To y Category
- Segments: la cantidad facturable de segmentos, la codificación (GSM_7BIT o UCS2) y la cantidad de caracteres (consulta segmentos y codificación)
- Cost: el monto y la moneda, una vez que el mensaje ha sido tarifado
- Carrier y MCC/MNC: la red que realizó la entrega, cuando se conoce
- Marcas de tiempo de Sent, Handed to carrier y Delivered
- Error: la descripción y el código, en un mensaje que no llegó
- Cualquier Tags y Metadata que hayas establecido en el envío
La mayoría de los campos se pueden copiar con un solo clic.
Las lecturas públicas de mensajes y eventos cubren los 30 días más recientes. Un ID de mensaje más antiguo queda fuera de esa ventana de lectura; conserva los registros que tu aplicación necesite dentro de tu propia política de retención y consentimiento.
El mismo registro a través de la API
La lista detrás de esta página es GET /v1/sms/messages, cuyos filtros cubren estado, categoría, etiqueta, destinatario exacto y ventana de tiempo. Recupera la línea de tiempo de un mensaje con GET /v1/sms/messages/{message_id}/events. Lee su estado más reciente con GET /v1/sms/messages/{message_id}, o consume eventos de webhook a medida que ocurren.
Próximos pasos
Explora analíticas de SMS para el flujo de reportes más amplio y SMS bidireccional para gestionar mensajes entrantes.
- Métricas de SMS: monitorea la tasa de entrega agregada, la tasa de fallos y el volumen aceptado.
- Eventos de SMS: revisa el vocabulario de eventos detrás de la línea de tiempo.
- Envío de SMS: construye un payload de envío con categorías, etiquetas y metadatos.
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Comprender el conceptoWhat does a delivery receipt tell you?Seguir la ruta de aprendizajeOperate messaging reliably
Obtener un resumen de implementación