Skip to main content

Registro de identificadores de remitente

Un identificador de remitente alfanumérico es un nombre de marca corto (por ejemplo MyBrand) que aparece como el “de” en un SMS en lugar de un número de teléfono. Muchos países exigen registrar un identificador de remitente ante el regulador local o los operadores antes de que el tráfico que lo use sea entregado — y algunos bloquean directamente a los remitentes alfanuméricos no registrados. Orbit le permite registrar sus identificadores de remitente por país, adjuntar los documentos KYC de respaldo y seguir el estado de aprobación de cada país. Las puertas en el momento del envío hacen cumplir luego que el tráfico solo fluya donde un identificador de remitente esté aprobado. Todos los endpoints a continuación están enraizados en https://api.orbit.devotel.io/api/v1/compliance.
Registrar un identificador de remitente en Orbit lo envía a nuestro flujo de trabajo de cumplimiento; la aprobación final la otorga el regulador/operador de cada país, no instantáneamente la plataforma. Planifique con antelación — algunos mercados tardan de días a semanas.

Reglas de formato del identificador de remitente

El techo de 11 caracteres es el límite estricto de GSM 7 bits; reguladores como ANATEL (Brasil), OFCOM (Reino Unido), AGCOM (Italia) y BTRC (Bangladés) rechazan identificadores de remitente de menos de 3 caracteres.

Registrar o actualizar un identificador de remitente

POST /compliance/sender-id-registrations (administrador/propietario) envía un identificador de remitente para uno o más países. Cada entrada de país hace referencia a documentos de cumplimiento previamente cargados mediante sus ID doc_… — no se cargan archivos aquí.
Devuelve la vista del registro con el status de cada país:
El envío es un upsert idempotente claveado en (organization, sender_id). Al reenviar:
  • agrega países nuevos con status: pending;
  • para un país ya approved, mantiene la aprobación mientras actualiza sus documentos, referencia de proveedor y notas;
  • para un país que estaba rejected o expired, lo restablece a pending para que se revise de nuevo.
Esto le permite agregar países a un identificador de remitente existente de forma segura sin perder las aprobaciones que ya tiene.

Listar sus registros

GET /compliance/sender-id-registrations devuelve cada identificador de remitente y su estado por país. Disponible para cualquier usuario autenticado.

Ciclo de vida del estado

Cuando una entrada de país está approved lleva registered_at y expires_at. Renueve antes de expires_at para evitar un lapso.
Las puertas en el momento del envío hacen cumplir el registro: el SMS A2P hacia un país que exige un identificador de remitente registrado se bloquea a menos que la entrada de ese país esté approved. Registre y obtenga la aprobación antes de lanzar tráfico hacia un mercado nuevo.
En inquilinos creados antes de la migración de identificadores de remitente, el endpoint de lista devuelve un conjunto vacío y POST devuelve 409 TENANT_NOT_MIGRATED — contacte a soporte para habilitar la función.

India es diferente

India no usa este flujo genérico de identificadores de remitente. Los identificadores de remitente de SMS indios (“Headers”) se registran a través del sistema DLT/TRAI — vea Onboarding de DLT-India.

Referencias relacionadas