# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/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](/docs/guides/numbers/number-types) cubre cómo se elige el tipo del número, y [Comprar y liberar un número](/docs/guides/numbers/buying-numbers) 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](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders), abre **Add sender** y elige **Add sender ID**, luego introduce la cadena. A través de la API: ```cli 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**](https://bird.com/dashboard/w/trust) 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: ```cli 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](#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**](https://bird.com/dashboard/w/sms/destinations); [Envío de SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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: ```cli 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**](https://bird.com/dashboard/w/trust) 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](#programas-con-su-propio-proceso). | 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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#consultar-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](#registrar-un-sender-en-un-país), más el formulario que el país solicita | | `numeric` | un código largo | [Registrar un remitente para un país](#registrar-un-sender-en-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](/docs/guides/sms/10dlc) | | `tfn` | un número gratuito de EE. UU. | Verificación de número gratuito, en la página [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers), o revisa el [registro de senders](/products/sms/compliance/sender-id-registration) para tu despliegue. | Página | Qué cubre | | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | [Envío de SMS](/docs/guides/sms/sending-sms) | La llamada de envío, los formatos de `from` que acepta y la lista de destinos permitidos | | [Registro 10DLC](/docs/guides/sms/10dlc) | El modelo de marca, campaña y número detrás del envío A2P en EE. UU. | | [Tipos de número](/docs/guides/numbers/number-types) | Cómo elegir entre números móviles, locales, nacionales, gratuitos y de código corto | | [Destinos de SMS](/products/sms/destinations) | Qué tipos de sender acepta cada país y cuáles necesitan registro | | [Opt-outs y palabras clave](/docs/guides/sms/opt-outs-and-keywords) | Las respuestas por palabra clave que un sender debe respetar y las supresiones que generan | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [SMS sender IDs](/sms-api/features/compliance/sender-id-registration) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)