SMS

Short code, long code, toll-free o alfanumérico: ¿qué tipo de remitente de SMS debo usar?

Elige un tipo de remitente que el destino admita y usa un número cuando los destinatarios necesiten responder.

Un remitente que funciona en un destino puede no ser elegible en otro. La compatibilidad con respuestas también depende del número individual y de su ruta.

¿Cuáles son los cuatro tipos de remitente?

Bird admite long codes, short codes, números toll-free y sender IDs alfanuméricos. Sus valores de API son long_code, short_code, toll_free y alphanumeric.

La política de país puede permitir números toll-free y rechazar long codes. Los requisitos de registro también pueden diferir:

The toll_free value is distinct from long_code. A country can permit one and refuse the other, and the two usually demand different registration.

  • Long code. Un número de teléfono ordinario usado para mensajería. El envío y la recepción dependen de sus capacidades SMS y de la compatibilidad del destino.
  • Toll-free. Un número con capacidad SMS en un rango toll-free compatible, con sus propios requisitos de verificación y enrutamiento.
  • Short code. Una identidad numérica corta usada para programas de mensajería. La longitud, la disponibilidad, la velocidad de envío y el registro varían según el mercado.
  • Alfanumérico. Un nombre que se muestra como remitente, con un límite de 11 caracteres. Un nombre de marca más largo necesita una identidad de envío más corta. Los destinatarios no pueden dirigir una respuesta a él.

¿Qué tipos de remitente pueden recibir una respuesta?

Los long codes, números toll-free y short codes elegibles pueden admitir respuestas. Comprueba las capacidades SMS del número y la ruta de destino, porque su formato no garantiza la compatibilidad con respuestas.

Si tu programa necesita mensajes entrantes, elige un número que admita respuestas, porque los destinatarios no pueden responder a un nombre alfanumérico. Este requisito también aplica cuando un suscriptor debe enviar una palabra clave de cancelación de vuelta al remitente.

La política de país indica la compatibilidad con respuestas como un direction de one_way o two_way para cada tipo de remitente. Con un número y una ruta compatibles, los mensajes SMS entrantes pueden llegar a tu aplicación.

¿Cómo elijo sin conocer las reglas de cada país?

Consulta las políticas de tipo de remitente publicadas del destino y luego comprueba los requisitos del remitente que quieras usar. Un país publica entradas de política para sus tipos de remitente reportados. Un tipo ausente no está admitido allí. Un tipo listado sigue teniendo su propio estado de disponibilidad.

Cada entrada de política indica estos campos:

  • status, uno de available, restricted, coming_soon o unavailable.
  • registration_mode, uno de none, optional o required, y el program que ejecuta el registro cuando aplica.
  • sender_id_behavior: preserved conserva el identificador de remitente que envías, overwritten lo reemplaza antes de la entrega y unknown indica que el comportamiento no está confirmado. Esto es independiente del modo de registro, por lo que un registro obligatorio aún puede sobrescribir el identificador de remitente después de la aprobación. El registro opcional conserva el identificador de remitente aprobado y lo sobrescribe antes de la aprobación.
  • registration_timeline_min y registration_timeline_max, en días hábiles, cuando el país publica una estimación.
  • throughput_mps, la tasa máxima de envío publicada en mensajes por segundo para ese tipo de remitente y destino. Por ejemplo, un valor de 30 describe un tope de 30 mensajes por segundo. Un valor null no proporciona una tasa publicada. Confirma la capacidad disponible de cuenta, remitente y operador, ya que pueden limitar aún más tu tasa de envío real.
  • direction, unidireccional o bidireccional.
  • allowed_source_countries, los países desde los que el remitente puede originar. Una lista vacía no impone restricción de país de origen.

Puedes comparar las políticas de país publicadas en destinos de SMS. Consulta los requisitos de tu remitente por separado, porque la política de país no establece el estado de registro de ese remitente:

bird sms senders requirements <sender-id> --country-code NL

Una lista allowed_source_countries no vacía limita la elegibilidad a remitentes de esos países. Un remitente de otro país no tiene ruta bajo esa política. El registro no puede hacer elegible ese origen.

¿Qué decide qué remitente usa realmente Bird?

Para un envío de texto libre de API, proporciona el remitente elegible en from. La API no elige un pool de remitentes cuando omites este campo. Un envío con plantilla de sistema selecciona su remitente desde la plantilla. El valor from devuelto identifica el remitente usado para ese mensaje.

La prioridad de enrutamiento de la política de país no selecciona el remitente para una solicitud de texto libre. Tu aplicación lo proporciona.

El registro y el acceso al destino son independientes. Un remitente registrado puede seguir bloqueado cuando el espacio de trabajo no ha habilitado el destino, con E12020.

¿Qué debo hacer concretamente?

  1. Elige un tipo de remitente admitido por el destino, incluidas las restricciones de país de origen.
  2. Elige un número compatible cuando se requieran respuestas, incluidas las palabras clave de cancelación entrantes.
  3. Contempla el registro obligatorio y cualquier registro opcional que elijas, usando el plazo publicado para planificar el lanzamiento.
  4. Compara el tope de velocidad de envío publicado con tu tráfico pico y luego confirma la capacidad de cuenta, remitente y operador.
  5. Confirma el registro de remitente y el acceso al destino del espacio de trabajo antes de enviar.

En resumen

  1. Bird distingue cuatro tipos de remitente.

    La API enumera long_code, short_code, alphanumeric y toll_free. Un destino puede permitir un tipo y rechazar otro.

  2. Las respuestas requieren un número y una ruta compatibles.

    Un remitente alfanumérico es solo de envío. Un número necesita capacidad SMS y una ruta de entrada compatible para recibir respuestas.

  3. La política del país define los tipos de remitente elegibles.

    La política de destino indica la disponibilidad de tipos de remitente y cualquier país de origen permitido. El registro no crea una ruta inexistente.

  4. El registro y la capacidad dependen del tipo de remitente y del destino.

    Los tiempos de registro publicados son estimaciones. La velocidad máxima de envío se expresa en mensajes por segundo.

Ponlo en práctica.

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

Construye sobre la misma red.

Obtén una clave API de prueba de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

Tu próxima idea.
Lista para conectar.