Preguntas frecuentes sobre la API de SMS

Instala el SDK y envía al destinatario de prueba autorizado +15005550006 en unos cinco minutos. Puedes implementar una verificación de CI antes de aprovisionar un número.

Un endpoint de envío, recepción bidireccional, aprovisionamiento de números (códigos largos, códigos cortos, números gratuitos e identificadores de remitente alfanuméricos), cumplimiento de A2P 10DLC y cancelación de suscripción, enrutamiento directo al operador y analíticas de entrega, todo en una sola API.

Bird alcanza más de 150 países a través de más de 240 conexiones directas con operadores, con reselección de ruta de nivel operador cuando una ruta de operador se degrada.

Para enviar tráfico de aplicación a persona a números de EE. UU., sí. El registro de marca y campaña se gestiona en el panel de control, y el estado se puede consultar desde la API.

Por mensaje, a una tarifa que depende del país de destino y del tipo de remitente desde el que envía, por lo que un código largo de EE. UU. y un remitente alfanumérico del Reino Unido tienen precios diferentes. Las tarifas se publican por país en la página de precios de SMS.

Sí, la facturación es por segmento, no por mensaje. Un segmento contiene 160 caracteres GSM-7, o 70 cuando un solo emoji o carácter no latino obliga a que todo el mensaje use Unicode. Los textos más largos se dividen y cada segmento se factura, así que un carácter fuera de lugar puede duplicar el coste de una campaña grande.

Se aplican tarifas del operador por mensaje y varían según el destino y el operador. En EE. UU., 10DLC también conlleva tarifas de registro de marca y campaña. Ambas se detallan en la página de tarifas de operadores de SMS.

El registro de SMS muestra el número de segmentos y el coste de cada mensaje individual una vez tarificado; las métricas de SMS agregan el volumen aceptado, los segmentos y el gasto a lo largo del tiempo.

Un mensaje GSM-7 admite 160 caracteres por segmento; cambiar a Unicode (UCS-2) para emojis o alfabetos no latinos lo reduce a 70. Los mensajes más largos se concatenan en varios segmentos, y el SDK reporta el conteo antes de enviar.

Doce segmentos, lo que equivale aproximadamente a 1.836 caracteres GSM-7 o 804 Unicode. Bird nunca trunca: un cuerpo que exceda el límite devuelve un error 422. El límite cuenta segmentos en lugar de caracteres precisamente porque las dos codificaciones contienen cantidades diferentes.

Hasta 100 en una llamada por lotes, cada uno con su propio destinatario y texto. Un mensaje individual va a exactamente un destinatario, así que el lote es la forma de distribuir.

Una clave de nivel gratuito permite 10 envíos individuales y 5 llamadas por lotes por minuto, y los planes de pago aumentan ambos. Cada respuesta incluye un encabezado IETF RateLimit que indica lo que queda y cuándo se reinicia la ventana, así que ajusta tu ritmo en base a eso en lugar de un número fijo en el código.

Eso lo establecen los operadores, no Bird. Un código largo 10DLC registrado obtiene rendimiento basado en la puntuación de confianza de la marca y el tipo de campaña: más que un número no registrado, menos que un código corto. Los códigos cortos obtienen la tasa más alta y predecible.

Para tráfico de aplicaciones en EE. UU., un código largo 10DLC cubre la mayoría de los casos de uso bidireccionales y de OTP. Los programas de alto volumen de uno a muchos pasan a un código corto; el número gratuito (toll-free) es una opción para EE. UU./Canadá sin 10DLC.

Un código largo o un número gratuito está disponible de inmediato y comienza a enviar una vez que su registro o verificación se aprueba. Los códigos cortos son verificados por los operadores y suelen tardar semanas.

Sí. Los códigos largos, los códigos cortos y los números gratuitos son bidireccionales: dirija el tráfico entrante de un número a un webhook y las respuestas llegarán como eventos firmados. Los identificadores de remitente alfanuméricos son solo de salida.

Depende del tipo de remitente y del país. El tráfico de aplicaciones en EE. UU. requiere A2P 10DLC, los números gratuitos requieren verificación y muchos países exigen el prerregistro del identificador de remitente; todo se gestiona desde el panel de control.

Es una cadena de texto corta, normalmente el nombre de tu marca, que aparece en el campo "de" del destinatario en lugar de un número de teléfono. Es una etiqueta en el mensaje, no un número que te pertenezca.

Que sea breve: normalmente hasta 11 caracteres en redes GSM. La restricción exacta depende del país de destino y del operador, y de lo que cada uno acepte.

Un número gratuito (toll-free) es un número 8xx (800, 888, 877 y el resto de los prefijos gratuitos) que envía y recibe SMS en EE. UU. y Canadá. Transporta tráfico de aplicaciones sin A2P 10DLC, una vez que haya pasado la verificación toll-free.

No. Los números toll-free están fuera del sistema A2P 10DLC. En su lugar, pasan por una verificación toll-free, donde los operadores revisan el caso de uso y el contenido de los mensajes antes de que el número pueda enviar a volumen completo.

Un código largo de 10 dígitos (10DLC) es un número de teléfono local estándar autorizado para SMS de aplicación a persona en EE. UU. una vez que su marca y campaña están registradas con los operadores.

Los códigos largos 10DLC registrados obtienen un rendimiento verificado que depende de la puntuación de confianza de la marca y el tipo de campaña: más que un número no registrado, menos que un código corto.

Un código corto es un número de 5–6 dígitos que los operadores aprueban para SMS de alto volumen de uno a muchos: campañas de marketing, alertas y OTP de alta frecuencia. Es el tipo de remitente con mayor rendimiento y pasa por una revisión del operador antes de poder enviar.

Planifica en semanas, no en minutos. Los operadores revisan cada programa de código corto antes de activarlo, así que un código corto implica un tiempo de espera real, a diferencia de un número largo, que puedes comprar y empezar a usar en cuanto se apruebe el registro.

Un código corto dedicado es exclusivamente tuyo, así que su reputación de envío es enteramente la tuya. Un código corto compartido divide un número entre varios remitentes mediante palabras clave: más barato y más rápido para empezar, pero heredas la reputación de todos los demás que lo usan.

Tú lo eliges en un envío de texto libre: pasa un número que posea tu workspace, un código corto o un identificador de remitente alfanumérico donde el país de destino lo permita. Si lo omites, el envío se rechaza en lugar de adivinarse. Los envíos con plantilla son la excepción, ya que seleccionan su propio remitente.

Indica a Bird y a los operadores por qué estás enviando, y las reglas de cumplimiento por país —como la política de cancelación de suscripción y las horas de silencio— dependen de ella. Es obligatoria en un envío de texto libre; un envío con plantilla hereda la clasificación propia de la plantilla.

Pasa una clave de idempotencia y una solicitud reintentada devolverá el resultado original en lugar de enviar dos veces. Sin ella, un reintento se trata como un mensaje nuevo.

Cada cambio de estado dispara un webhook firmado con HMAC (en cola, enviado, entregado o fallido), que incluye el acuse de recibo del operador y el conteo de segmentos.

Cada mensaje enviado a tu número aprovisionado llega como un webhook sms.received firmado con HMAC. Verificas una firma, lees los campos from, to y text, y lo diriges a tu propia lógica: el mismo formato que ya manejas para los acuses de recibo de entrega.

Sí. Responde enviando desde el mismo número al que llegó el mensaje. Establece from con tu número y to con el remitente original, y el hilo se mantiene en un solo número de extremo a extremo.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

Necesitas un número compatible con comunicación bidireccional. Los números largos, los códigos cortos y los números gratuitos admiten mensajes entrantes; los identificadores de remitente alfanuméricos solo permiten enviar y no pueden recibir respuestas.

Su mensaje se entrega directamente al operador móvil a través de una de nuestras 240 conexiones directas, sin pasar por una cadena de revendedores. Menos saltos significa menos puntos donde un mensaje puede atascarse o donde un acuse de recibo puede perderse.

Bird reselecciona la ruta en tiempo real. Si un camino empieza a perder acuses de recibo o a ralentizarse, el siguiente mensaje toma una conexión más sana hacia el mismo operador, y el envío que usted programó no cambia.

Cada mensaje devuelve un acuse de recibo del operador como un webhook sms.delivered o sms.failed, con el mcc_mnc, el país y la latency_ms. Es la confirmación del propio operador, no una inferencia de nuestra parte.

Sí. Realizamos una consulta MNP en cada envío para determinar el operador actual del destinatario, de modo que un número portado se enruta al operador que realmente lo gestiona. Para inteligencia de números independiente, consulte Lookup.

El enrutamiento equilibra coste y calidad de entrega por destino. El tráfico transaccional, como los códigos de un solo uso, favorece la ruta de mayor calidad; el tráfico masivo puede inclinarse hacia el menor coste. La selección se realiza por mensaje, detrás de la misma llamada a la API.

Del acuse de recibo de entrega del operador (DLR) de cada envío. Bird registra el acuse contra el mensaje y luego consolida esos acuses en cifras de entrega, fallos y latencia. Un conteo de entregados es la confirmación de recepción del operador, no una estimación de Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Ambas opciones. Cada estado de entrega ya llega como webhook, así que puedes construir tu propio almacén a partir del flujo de eventos. La API de estadísticas está disponible cuando prefieras que Bird haga la agregación en lugar de mantener un contador tú mismo.

Pasa el ID del mensaje al endpoint de eventos y obtendrás su línea de tiempo completa: en cola, enviado, entregado o fallido, cada uno con marca de tiempo y, en caso de fallo, el código de motivo del operador. Ese es el informe que realmente necesitas cuando un cliente dice que nunca le llegó un mensaje.

Sí. La cancelación de suscripción es reversible. Un destinatario que envíe START se elimina de la lista de supresión y puede recibir mensajes de nuevo. La decisión queda en manos del destinatario.

La lista de supresión es un recurso de la API que se puede consultar. Busca un número antes de crear una audiencia para que un destinatario que canceló su suscripción nunca vuelva a entrar en un envío.

Depende de adónde envíes y qué envíes. El tráfico de aplicaciones en EE. UU. requiere registro de marca y campaña A2P 10DLC. Muchos países exigen el prerregistro del identificador de remitente para remitentes alfanuméricos. La gestión de cancelación de suscripción aplica en todas partes y no requiere configuración.

Bird presenta cada registro ante los operadores o registros y reporta su estado a través de la API. Tu código puede consultar el estado del registro y esperar la aprobación en lugar de enviar a una campaña que aún no está activa.

No. Usa el mismo cliente y las mismas claves que el envío, los números y la comunicación bidireccional. El estado de registro y la lista de supresión son recursos de la API junto con la llamada de envío, así que una sola integración cubre tanto el envío como las reglas asociadas.

Para frenar la suplantación de identidad, muchos países solo entregan identificadores de remitente alfanuméricos que se hayan prerregistrado con los operadores locales o el regulador. Donde aplica esa regla, un remitente de marca no registrado se rechaza o se reescribe.

Bird lo hace. Tú envías el identificador de remitente y el destino desde el panel de control, Bird lo lleva al registro local y la API informa su estado para que sepas cuándo el remitente está activo.

La aprobación pasa por operadores y registros externos y varía según el país; normalmente de días a semanas. Consulta el estado del registro a través de la API y espera a que se apruebe antes de enviar desde ese identificador de remitente.

A2P 10DLC es el marco de los operadores de EE. UU. para SMS de aplicación a persona enviados a través de números largos estándar de 10 dígitos. Una empresa registra la marca detrás de su tráfico y una campaña que describe los mensajes, y los operadores revisan ambos antes de otorgar capacidad de envío.

La marca es la entidad legal que envía el tráfico. Una campaña describe un caso de uso de mensajería específico bajo esa marca. Una marca puede tener varias campañas, y los números se asocian a una campaña en lugar de a la marca.

La revisión de marca y campaña pasa por los operadores y el registro, y normalmente tarda de días a semanas. Consulta el estado de la campaña a través de la API para que tu código espere la aprobación antes de enviar.

No. 10DLC es un marco de EE. UU. Otros países tienen sus propias reglas, muchos requieren prerregistro de identificador de remitente, y el manejo de palabras clave de cancelación de suscripción aplica dondequiera que envíes.

Su llamada a Bird sí lo está, a través de HTTPS, y también el webhook entrante que le enviamos. El último salto no nos corresponde cifrarlo: SMS es un protocolo de operador sin cifrado de extremo a extremo, y el mensaje es legible en el dispositivo y para el operador. Por eso conviene no incluir información sensible en el cuerpo y preferir WhatsApp o el correo electrónico para contenido confidencial.

Cada evento está firmado con HMAC. Verifique la firma con el secreto de su endpoint antes de actuar sobre el payload, y rote ese secreto desde el panel de control cuando lo necesite.

En la región donde está alojada su organización, ya sea us1 o eu1. Su clave API lo lleva en su prefijo (bk_us1_…, bk_eu1_…), que es como los SDK y la CLI seleccionan el endpoint correcto sin que usted tenga que configurarlo.

Solo lo que usted le permita. Una clave lleva una lista de permisos (scopes), cada uno de lectura o escritura, de modo que una clave que envía SMS no puede gestionar sus números ni leer otro canal. Las acciones del plano de control, como gestionar miembros y emitir claves, son exclusivas del panel de control y ninguna clave puede acceder a ellas.

Ambas cosas. Una clave acepta una lista de rangos CIDR permitidos y rechaza solicitudes de cualquier otra dirección, y al rotarla la clave anterior sigue funcionando durante un período de gracia (24 horas por defecto, o cero para revocarla de inmediato), así que la transición no requiere tiempo de inactividad.

Sí. El registro de auditoría es un registro de solo lectura a nivel de toda la organización de cada acción de gestión, con el actor, el workspace, la hora y el resultado, y se exporta en formato OCSF para su propio SIEM.

Las certificaciones y la documentación de seguridad están en el Trust Center en trust.bird.com. El acuerdo de procesamiento de datos, la declaración de privacidad y la política de uso aceptable se publican en bird.com/legal. Para cuestionarios de proveedores, su equipo de cuenta de Bird se encarga.