HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
El camino desde
el envío hasta el dispositivo.
Llega a tus clientes a través de una sola API de envío mientras Bird gestiona la conectividad con operadores. Elige destinos compatibles y el remitente adecuado, luego consulta el resultado de entrega reportado. Inspecciona los fallos por país u operador cuando una ruta, destinatario o registro necesite atención.
La ruta detrás de tu mensaje
Flujo de envío
01
Tu aplicación
Elige el destinatario, el remitente, la categoría y el mensaje.
02
Verificación de destino y remitente
Usa un mercado habilitado y el registro requerido.
03
Entrega al operador
Bird envía el mensaje a través de sus conexiones con operadores.
04
Un resultado reportado
Consulta el acuse de recibo en los registros de mensajes, webhooks y analíticas.
Un flujo conceptual. La aceptación, la entrega al operador y el acuse de recibo describen etapas distintas del ciclo de vida del mensaje.
La capa sobre la que viaja tu envío.
El enrutamiento se ubica bajo la Bird SMS API. Bird verifica el destino y el remitente antes de la aceptación, luego envía el mensaje preparado a su transporte de operador. Inspecciona el operador y el resultado reportados para decidir si investigar un problema de remitente, destino o destinatario.
Entiende las decisiones previas a la entrega al operador.
La elegibilidad, la preparación del mensaje y el envío al operador tienen funciones distintas.
- 01
Conectividad con operadores.
Bird gestiona las conexiones con operadores detrás de tu envío. Usa el catálogo de destinos para verificar los tipos de remitente compatibles y los requisitos de registro en los mercados que cubres.
- 02
Un remitente y un destino preparados.
El tipo de remitente, las reglas de destino y el registro determinan qué originador se puede usar. Se establece una configuración válida antes de encolar el mensaje para el transporte.
- 03
Información del operador cuando está disponible.
El procesamiento puede resolver el operador del destinatario para la tarificación. Si la consulta falta o falla, se aplica la tarificación por país. La información del operador en un acuse de recibo también puede estar ausente; evita inferir una red solo a partir del prefijo telefónico.
- 04
Acuses de recibo como evidencia del operador.
Un acuse de recibo del operador puede reportar la entrega o un resultado terminal de no entrega. Algunos mensajes permanecen a la espera de un acuse, y los campos ausentes del operador son desconocidos. Lee la línea de tiempo de eventos junto con el estado actual.
- 05
Consulta los requisitos de ruta para un lanzamiento.
La solicitud pública de SMS no ofrece un selector de ruta de menor costo frente a mayor calidad. Consulta la combinación de destinos, los requisitos de remitente y el rendimiento con un especialista en SMS al planificar tráfico mayor.
Un resultado de entrega que puedes investigar.
Un recorrido SMS exitoso depende del destino, el registro del remitente, el contenido del mensaje y la ruta del operador. Bird reúne esas decisiones en un solo flujo de envío. Empieza por los requisitos del destino, luego usa los registros de mensajes y los resultados del operador para identificar qué necesita cambiar.
El acuse de recibo, directo del operador.
Una solicitud exitosa devuelve 202 antes de la entrega del operador. Los eventos posteriores pueden incluir el operador reportado y el MCC/MNC. Trata los campos ausentes como desconocidos e inspecciona la línea de tiempo del mensaje en busca de la evidencia disponible.
POST /webhooks/bird
signed
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "+12025550188",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480",
"cost": {
"amount": "0.0079",
"currency_code": "USD",
"transaction_amount": "0.0079",
"passthrough_amount": null
}
}
}
Los campos de operador y MCC/MNC se reportan cuando están disponibles. Una diferencia respecto a las expectativas basadas en prefijo es motivo para investigar; por sí sola no prueba la portabilidad numérica.
sms.deliveredEl operador confirmó que el dispositivo recibió el mensaje (DLR).sms.failedEl operador rechazó o no pudo entregar el mensaje, con el motivo adjunto.
El enrutamiento se apoya en la inteligencia de números.
Usa Lookup cuando tu aplicación necesite inteligencia de números telefónicos compatible. Suscríbete a webhooks para resultados de SMS y usa la referencia de errores y la guía de entregabilidad para interpretar los fallos reportados. Un resultado de lookup no establece la elegibilidad del remitente ni garantiza la entrega.
Preguntas antes de construir
¿Cómo verifico la cobertura de destinos?
Abre el catálogo de destinos y revisa los tipos de remitente y los requisitos de registro de cada mercado. Tu espacio de trabajo también debe permitir el destino antes de que se acepte un envío.
¿Qué establece un acuse de recibo del operador?
Informa del resultado de entrega del operador. Los acuses pueden llegar después de la aceptación, y el registro del mensaje puede seguir pendiente. La entrega no mide si alguien leyó o actuó sobre el mensaje.
¿Cómo debo investigar una ruta fallida?
Empieza por el estado del mensaje y el motivo del fallo. Compara los informes por operador, país o remitente y luego revisa el registro y la configuración del destino. Una tasa de fallos agregada por sí sola no identifica la causa.
¿Puedo inspeccionar un número de teléfono por separado?
Usa Lookup cuando tu aplicación necesite inteligencia sobre el número de teléfono antes de enviar. Revisa las señales y la disponibilidad de esa consulta en lugar de tratar un informe de entrega de SMS como una comprobación completa del número.
El resto de la plataforma de SMS
Una API, un solo conjunto de claves. Explora las demás capacidades.
EnvíoLa API de envío: segmentos, seguridad Unicode, lotes e idempotencia.NúmerosLong codes, short codes, toll-free e IDs de remitente alfanuméricos.BidireccionalSMS entrantes y respuestas conversacionales como webhooks firmados con HMAC.CumplimientoRegistro A2P 10DLC, palabras clave de exclusión y reglas de sender-ID.AnalíticaResultados de entrega, razones de fallo y latencia a partir de acuses de recibo del operador.Visión general de la API de SMSLa API de SMS completa: envío, números, bidireccional, cumplimiento, enrutamiento y analítica.Biblioteca de recursos SMSEncuentra guías, respuestas explicadas y herramientas para tu siguiente paso.
Escala sin
perder el control.
Organiza equipos en espacios de trabajo, controla el acceso a la API y rastrea cambios en los registros de auditoría.
HarborOrganizationActive
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- ReadRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded