Descripción general de SMS

Bird SMS envía mensajes de texto a través de la misma plataforma y claves API que Bird Email. Llama a Bird con una clave bk_{region}_… contra tu host regional (https://us1.platform.bird.com o https://eu1.platform.bird.com). Bird elige una ruta hacia el operador del destinatario, divide tu texto en segmentos facturables y reporta cada mensaje a través de su acuse de recibo de entrega. Los endpoints de SMS comienzan con /v1/sms/.

Puedes enviar texto libre con un remitente y una categoría que elijas, o usar una de las plantillas integradas de Bird, que proporciona el cuerpo, la categoría y el remitente. Bird también recibe respuestas a tus números. Almacena cada mensaje entrante junto con tus envíos y emite sms.received. Cuando una respuesta coincide con una palabra clave de exclusión admitida como STOP, Bird también registra una supresión de remitente y suscriptor. Consulta Exclusiones y palabras clave para la cobertura y configuración.

Cómo funciona el envío

Envía un SMS con POST /v1/sms/messages: un destinatario y un mensaje, que lleva tu propio text con un remitente y una categoría, o una referencia de template con sus valores de variables. Bird valida la solicitud y el destino, resuelve el remitente y devuelve 202 Accepted con un ID de mensaje. La entrega ocurre de forma asíncrona. Sigue el resultado a través de eventos y webhooks o los endpoints de lectura de mensajes. Para enviar muchos mensajes independientes en una sola llamada, usa el endpoint de lote.

Tres ideas dan forma a toda la API:

El envío y la entrega son etapas separadas. Un 202 significa que Bird aceptó el mensaje. El operador lo procesa después de la aceptación y puede devolver un acuse de recibo de entrega más tarde. Un acuse de fallo también es un resultado terminal; inspecciona el estado reportado antes de tratar el envío como entregado.
El texto se factura en segmentos. Un mensaje más largo que un segmento se divide y factura por segmento, y la capacidad por segmento depende de los caracteres que uses. Límites de caracteres tiene las reglas de codificación, el conjunto completo de caracteres y cómo mantener los mensajes en un solo segmento.
El motivo del envío importa. Cada mensaje lleva una categoría: transactional, marketing, authentication o service. Bird y los operadores la usan para entender el propósito del mensaje. En un envío con plantilla, la categoría proviene de la plantilla.

Antes de tu primer envío, habilita los países de destino a los que das servicio en SMS > Destinations. La lista de permitidos por defecto denegado comienza solo con el país de origen de tu organización habilitado. Bird rechaza un envío a cualquier otro país. Envío de SMS cubre este requisito previo.

Para códigos de verificación de un solo uso, considera Bird Verify en lugar de componer el mensaje tú mismo. Verify genera y entrega el código por SMS o correo electrónico, verifica la respuesta y aplica la expiración, los límites de intentos y los tiempos de espera entre reenvíos.

La aplicación SMS en el panel de control

En el panel de control, SMS es uno de los productos en la barra lateral. Sus páginas y dónde se encuentra la guía de cada una:

Página	Para qué sirve
Messages	Cada mensaje enviado, con su cronología de eventos por mensaje y detalle de entrega. Guía: registro de SMS
Templates	Las plantillas integradas que puedes enviar: nombre, categoría, idiomas y variables. Guía: plantillas de SMS
Metrics	Tasa de entrega, tasa de fallos y volumen aceptado a lo largo del tiempo. Guía: métricas de SMS
Senders	Los ID de remitente y números desde los que puedes enviar, y dónde está registrado cada uno. Guía: ID de remitente de SMS
Destinations	Los países a los que tu espacio de trabajo puede enviar; habilita un destino antes de enviar allí. Guía: Envío de SMS

Visibilidad

Usa los registros de mensajes y la cronología de eventos disponible para investigar la aceptación, la transferencia al operador y los resultados de entrega. Los detalles del mensaje incluyen segmentos y cualquier componente de coste con precio. Las lecturas públicas de mensajes cubren la ventana de retención descrita en el registro de SMS.

Registro de SMS: la vista por mensaje en el panel de control. Cada envío, su cronología de eventos, segmentos, coste y detalle de operador.
Métricas de SMS: la tasa de entrega agregada, tasa de fallos, volumen aceptado y latencia de entrega de todo lo que envías.
Events: el vocabulario de eventos de SMS, el ciclo de vida del mensaje y la entrega de webhooks a tus propios endpoints.

Próximos pasos

Explora la plataforma SMS para campañas, mensajes de aplicación y respuestas, o usa la biblioteca de recursos de SMS para elegir un flujo de trabajo.

Página	Qué cubre
Envío de SMS	El envío de API: destinos, remitentes, cuerpo, segmentos, categorías, etiquetas
Límites de caracteres	Codificación GSM-7 y UCS-2, límites por segmento y el tope de 12 segmentos
Plantillas de SMS	El catálogo de plantillas integradas y el envío por referencia de plantilla
ID de remitente de SMS	Elegir un tipo de remitente y registrarlo por país de destino
Registro 10DLC	Registrar una marca, campaña y número para envío A2P en EE. UU.
Registro de SMS	Cada mensaje, su cronología de eventos, segmentos y coste
Métricas de SMS	Tasa de entrega, tasa de fallos y latencia
Events	Los tipos de evento de SMS y la entrega de webhooks
Webhooks y eventos	Configuración de endpoints, verificación de firma, reintentos y reproducción
Descripción general de Verify	Códigos de verificación de un solo uso por SMS y correo electrónico, enviados y verificados por Bird
Controla a dónde puede enviar tu cuenta	Un vídeo: muestra lo que devuelve un envío a un destino deshabilitado

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaSMS pumping explained Comprender el conceptoWhat is SMS pumping, and how do I stop it?Explorar la funcionalidadSMS destinations Seguir la ruta de aprendizajeBuild your first integration

Obtener un resumen de implementación