Sender IDs de SMS

Un sender es el from que el destinatario ve en tu SMS. Tu espacio de trabajo contiene un sender por cada identidad desde la que puede enviar, y cada país de destino decide qué tipos de sender acepta y qué exige registrar primero. Tener un sender no es lo mismo que poder enviar desde él: son dos pasos separados, y esta guía cubre ambos.

Los senders están en la página Senders, una fila por sender, con su estado y cuántos destinos están activos, pendientes o requieren tu atención. La llamada de envío, incluido cómo se valida un valor from, está en Envío de SMS.

Tipos de sender

El sender_type de un sender es el tipo de identidad que representa, y determina lo que cada país le exige:

Sender ID alfanumérico: una cadena corta de marca como BIRD, de 3 a 11 letras ASCII, dígitos, espacios, guiones, guiones bajos o puntos, con al menos una letra. Los espacios, guiones, guiones bajos y puntos no pueden ser el primer ni el último carácter. Los destinatarios ven tu nombre en lugar de un número y no pueden responder. Muchos países exigen registrarlo antes de que lleve tráfico, y algunos, incluido Estados Unidos, no lo aceptan en absoluto. Tú mismo reclamas este tipo.
Código largo: un número ordinario que posees, que puede enviar y recibir. Un código largo de EE. UU. necesita una marca y una campaña registradas antes de llevar tráfico de aplicación a persona; consulta Registro 10DLC.
Número gratuito: un número que paga la parte llamada, que en Norteamérica también puede transportar mensajería. Enviar desde uno allí requiere completar primero la verificación de número gratuito.
Código corto: un número nacional corto para un programa de mensajería aprobado, con longitud y capacidad determinadas por el mercado y el programa del operador. Bird asigna códigos cortos en lugar de venderlos, así que este tipo no es autoservicio.

Un sender también reporta source_kind, que indica qué lo respalda: alpha para una cadena de sender que reclamaste, number para un número dedicado que posees, y shared_number para un número compartido gestionado por Bird desde el que envía tu espacio de trabajo. El dashboard los etiqueta como Alphanumeric, Dedicated number y Shared number. Tipos de número cubre cómo se elige el tipo del número, y Comprar y liberar un número cubre la asignación.

Qué tipos acepta un país, y si los revisa, cambia a medida que operadores y reguladores actualizan sus reglas. Destinos de SMS publica la posición actual por país; consúltalo ahí en lugar de suponer que un país se comporta como sus vecinos.

Reclamar un sender ID alfanumérico

Reclamar una cadena de sender no cuesta nada y surte efecto de inmediato. En la página Senders, abre Add sender y elige Add sender ID, luego introduce la cadena. A través de la API:

Ejemplo de código

bird sms senders create --type alpha --sender BIRD

La respuesta incluye el id del nuevo remitente, con prefijo snd_, y todas las demás operaciones de esta guía usan ese id. Un remitente reclamado con éxito puede enviar donde el registro esté ausente o sea opcional una vez que esos destinos estén habilitados. Si el registro es obligatorio, debe aprobarse primero.

Aquí aparecen dos rechazos. Un 412 significa que tu organización no ha completado la verificación de identidad que esta operación requiere: complétala en Identity Center y reintenta. Un 409 significa que la cadena de sender ya fue reclamada.

alpha es el único tipo que crea esta llamada. Un número dedicado se convierte en sender cuando lo asignas desde el inventario, así que comprar el número trae consigo su sender. Los códigos cortos y los números compartidos llegan a un espacio de trabajo por asignación desde Bird en lugar de por compra.

Consultar qué exige un país

Una sola lectura responde qué exige cada país de un sender. Devuelve una fila por país al que el sender puede llegar, y cada fila es completa por sí misma:

Ejemplo de código

bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL

Omite --country-code para obtener todos los países relevantes para el sender. Un resultado filtrado vacío significa que el sender no tiene ruta hacia ese país.

Lee seis campos de una fila antes de enviar:

registration_mode es none, optional o required. none no requiere registro de país. Cuando se combina con un identificador de remitente overwritten, el registro no está disponible. Los registros explícitos anteriores aún pueden registrarse para políticas none con comportamiento unknown o preserved, pero nunca bloquean el envío. optional permite que el remitente siga enviando mientras lo registras. required bloquea el envío hasta la aprobación.
program identifica el flujo de registro cuando el país nombra uno, como alpha o numeric. Puede ser null cuando no aplica ningún programa con nombre.
sender_id_behavior es unknown, preserved o overwritten. Es independiente de registration_mode: un registro obligatorio aún puede dejar el identificador de remitente sobrescrito tras la aprobación. El registro opcional indica overwritten antes de la aprobación y preserved después de la aprobación para las categorías de mensaje aprobadas.
status indica en qué punto se encuentra el remitente con el programa de registro del país. En modo required, el envío espera a approved. En modo optional, el estado registra el avance del registro pero no bloquea el envío. Estados de registro enumera cada valor.
destination_enabled indica si tu espacio de trabajo tiene ese país activado. Es una configuración del espacio de trabajo, no del remitente, y se comprueba primero, así que un registro completamente aprobado sigue rechazando mensajes mientras el destino esté desactivado. Activa países en Destinations; Envío de SMS cubre la lista de destinos permitidos.
next enumera lo que hace avanzar ese país, en orden. Una lista vacía significa que no hay nada pendiente. Cada entrada nombra una acción y explica por qué vale la pena realizarla, de modo que un país en revisión de operador nombra el recurso que consultar en lugar de repetir un veredicto que le pertenece a ese recurso.

Las filas también traen timeline_min_days y timeline_max_days, el tiempo más corto y más largo que suele tardar la aprobación de un país en días hábiles, y null cuando el país no publica una estimación. Cuando un registro fue rechazado, rejection_reason indica el motivo.

La misma información aparece en la página de detalle de cada sender en el dashboard, como una tabla Destinations con columnas Status, Country y Category. Un país que no has activado y para el que no te has registrado queda fuera de esa tabla, porque no hay nada pendiente allí.

Registrar un sender en un país

El registro es por país, y la llamada toma el sender y el país juntos:

Ejemplo de código

bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing

--category restringe el registro a una de transactional, marketing, authentication o service. Omítelo para registrar en todas las categorías. El dashboard ejecuta la misma llamada desde el botón Register en la fila del país del sender.

Lo que sucede después depende del país. Donde el país revisa registros, el registro vuelve como pending y no se cobra nada todavía. Donde el país no revisa nada, se aprueba en esta misma llamada. Registrar un número es gratuito; un sender alfanumérico con precio conlleva una tarifa de alta y un cargo mensual recurrente, facturados en el momento en que el registro se aprueba, así que un registro revisado se crea sin facturar. Ni esta llamada ni la lectura de requisitos muestran un precio, así que consulta con el responsable de la cuenta cuánto cuesta un registro antes de crearlo.

Donde un programa recoge tus respuestas como formulario, el registro permanece en pending hasta que lo completes. La fila del país del sender entonces ofrece Complete, que abre las preguntas que el programa hace sobre tu negocio y tu mensajería.

Cuatro rechazos a gestionar:

Respuesta	Qué significa
402	El saldo no alcanzó para cubrir lo adeudado cuando se ejecutó la facturación. Recarga y vuelve a intentar.
409	Ya existe un registro para este país en un estado distinto de rechazado o suspendido, incluido uno que aún está en pending revisión. El estado por sí solo no decide si el remitente puede enviar: comprueba registration_mode, destination_enabled y si el registro cubre la categoría del mensaje.
412	Tu organización tiene un requisito de verificación de identidad pendiente. Complétalo en Identity Center y vuelve a intentar.
422	El remitente está cubierto por un programa con su propia ruta, como US 10DLC, verificación de número gratuito o un código corto. Consulta Programas con su propia ruta.

Un registro rechazado se reenvía, y uno suspendido se reactiva, llamando a esta misma operación de nuevo en lugar de usar una separada.

Estados de registro

Un registro de país pasa por los estados siguientes. El dashboard muestra cada uno como una etiqueta en la fila del sender:

Estado	Qué significa y qué hacer
registration_required	El registration_mode del país es required y no se ha iniciado ningún registro. Registra el remitente para el país.
pending	El trabajo de registro ha comenzado. Si el programa pide un formulario, complétalo desde Complete en la fila del país.
under_review	La información enviada está en revisión o necesita cambios. El program_ref de la fila apunta al recurso propio del programa, el único lugar donde una revisión en curso se distingue de una que espera tu respuesta.
bird_approved	La revisión de Bird fue aprobada y la aprobación del operador está pendiente. No se requiere nada de tu parte.
carrier_pending	Enviado al operador o registro aprobador. No se requiere nada de tu parte.
approved	Registro aprobado.
rejected	El registro fue rechazado. Consulta rejection_reason, corrígelo y regístralo de nuevo desde Resubmit.
suspended	Un registro previamente activo está suspendido. Regístralo de nuevo desde Register again para reactivarlo.
not_required	Ningún registro activo bloquea el envío. Comprueba registration_mode y sender_id_behavior: none no requiere registro de país y lo hace no disponible cuando el identificador de remitente se sobrescribe; optional ofrece registro sin bloquear el tráfico.

Se añaden nuevos estados a medida que los programas de registro cambian, así que trata un valor desconocido como uno que tu código aún no gestiona en lugar de como un error, y lee el next de la fila para saber qué hacer con ese país.

Algunos programas abren varios países con un solo registro, así que una única verificación de número gratuito o registro de campaña puede ser lo que habilita varios destinos.

Estado del sender y próximas acciones

El status propio de un sender cubre lo que el sender posee, que es una pregunta diferente a si un país determinado aceptará un mensaje:

active: nada de lo que posee este sender está pendiente. Un sender que no se ha registrado en ningún lugar muestra active, incluso cuando todos los países a los que puede llegar exigen un registro primero.
pending_number_ownership: la documentación que prueba que eres propietario del número de este sender no está en orden, ya sea porque no se ha proporcionado o porque el país que emitió el número aún no la ha aceptado. Todo envío desde este sender se rechaza hasta que se resuelva. Descripción general de números cubre ese ciclo de vida.
pending_registrations: el sender tiene registros de país y ninguno ha sido aprobado todavía. Eso abarca un registro en revisión y uno rechazado, así que lee next para saber cuál es el caso.

Junto a él, destinations agrupa los países en los que el sender está configurado según quién tiene el siguiente paso, y la lista Senders muestra los tres grupos como columnas:

"Active": países a los que puedes enviar hoy, activados en tu configuración de destinos y que no exigen registro obligatorio o que ya tienen uno aprobado. Un registro opcional puede seguir pendiente mientras el envío permanece disponible con el identificador de remitente sobrescrito.
"Pending": países cuyo registro está en curso y esperando a Bird o a un operador. No se te pide nada; pasan a "Active" tras la aprobación.
"Needs attention": países en los que te has registrado que no funcionan y esperan tu acción, porque el registro fue rechazado o retirado, o porque está aprobado pero el destino está desactivado.

Estos tres grupos cubren solo países en los que tienes un registro, así que un país en el que podrías registrarte y no lo has hecho no aparece en ninguno de ellos. Para todo lo que el sender puede alcanzar y lo que cada país requeriría, lee qué exige un país.

Una lectura del sender que calcula las próximas acciones las devuelve en next, el mismo campo de enrutamiento que llevan las filas de requisitos. Un sender solo sabe de sí mismo, así que cuando el trabajo es por país nombra la lectura de requisitos en lugar de adivinar a qué país te referías.

Programas con su propio proceso

El program de un país nombra el esquema de registro que aplica a un tipo de sender. Dos de ellos se resuelven con la llamada de registro de esta guía, y tres tienen su propio proceso:

Programa	A qué aplica	Dónde se hace
alpha	un sender ID alfanumérico	Registrar un remitente para un país, más el formulario que el país solicita
numeric	un código largo	Registrar un remitente para un país, más el formulario que el país solicita
10dlc	un código largo de EE. UU.	Registra una marca y una campaña, luego vincula el número: Registro 10DLC
tfn	un número gratuito de EE. UU.	Verificación de número gratuito, en la página Toll-free verifications
short_code	un código corto	Bird gestiona la solicitud; no se te pide nada a menos que sea rechazada, en cuyo caso el next de la fila te dirige a soporte

Llamar a la operación de registro para un remitente cubierto por 10dlc, tfn o short_code devuelve 422. Usa el programa correspondiente.

La verificación de número gratuito comienza como un borrador que completas en una o más actualizaciones y luego envías para que el operador lo revise. Pasa por draft, submitted, under_review, info_requested, approved y rejected. Una verificación en info_requested se puede editar y reenviar; una rechazada se puede reenviar mientras su ventana de reenvío esté abierta. Enviar entrega el expediente al operador para revisión, así que una persona autoriza ese paso: CLI y el servidor MCP de Bird pueden redactar y corregir una verificación, y el envío en sí ocurre en el dashboard.

Dejar de enviar desde un sender

Tres formas de desactivación difieren en lo que conservan, y las tres son acciones del dashboard en la página de detalle del sender. Las tarifas de alta ya cobradas no se reembolsan con ninguna de ellas:

Acción	Qué hace
Deregister un país	Cancela el cargo recurrente y conserva el registro. Registrar ese país de nuevo reanuda el mismo registro sin pagar la tarifa de alta dos veces. Donde el país exige un registro, los envíos allí se detienen; donde el registro es opcional, los envíos continúan, porque el registro nunca los condicionaba.
Remove un registro	Elimina el registro del país por completo, cancela el cargo recurrente y deja de mostrar el destino para el sender. Registrar el país de nuevo es un registro nuevo y paga la tarifa de alta otra vez.
Eliminar el sender	Libera un sender alfanumérico. Todos los registros de país asociados se eliminan, su cargo recurrente se cancela y deja de ser utilizable. Reclamar la misma cadena después crea un sender nuevo con registros nuevos y paga las tarifas de alta por segunda vez.

Un sender respaldado por un número no se elimina aquí: libera el número dedicado en su lugar, lo cual destruye su sender con él. Un sender en un número compartido gestionado por Bird no se puede eliminar.

Una fila 10DLC o de número gratuito se deshace a través de su propio programa, desvinculando la campaña o cancelando la verificación, en lugar de cancelando el registro.

Próximos pasos

Compara números y sender IDs de SMS, o revisa el registro de senders para tu despliegue.

Página	Qué cubre
Envío de SMS	La llamada de envío, los formatos de from que acepta y la lista de destinos permitidos
Registro 10DLC	El modelo de marca, campaña y número detrás del envío A2P en EE. UU.
Tipos de número	Cómo elegir entre números móviles, locales, nacionales, gratuitos y de código corto
Destinos de SMS	Qué tipos de sender acepta cada país y cuáles necesitan registro
Opt-outs y palabras clave	Las respuestas por palabra clave que un sender debe respetar y las supresiones que generan

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íaRegistering your SMS sender ID Comprender el conceptoWhat is sender ID registration, and why do some countries require it?Explorar la funcionalidadSMS sender IDs Seguir la ruta de aprendizajeBuild your first integration

Obtener un resumen de implementación