Registrar una marca de mensajería

Registre la empresa que está detrás de sus mensajes

Una marca de mensajería identifica a la empresa que envía mensajes 10DLC en Estados Unidos. Registre la marca antes de elegir un caso de uso de campaña. Utilice los datos legales de la empresa y un contacto que pueda completar cualquier validación requerida. Un ID de marca devuelto no constituye, por sí solo, una aprobación para enviar mensajes.

Utilice esta ruta actual propiedad de la cuenta a través de HTTPS con una cuenta de API habilitada y su dirección IP de origen permitida. No envíe user_id, username ni el identificador de propietario de otro cliente. MultiTEL registra la propiedad a partir de la cuenta autenticada.

Comience con una solicitud explícita de entorno de pruebas

El portal establece por defecto su formulario en el mode de entorno de pruebas; una solicitud directa a la API debe incluir explícitamente el booleano JSON mock: true cuando desee una marca simulada. Omitir ese indicador no garantiza el entorno de pruebas y puede crear un registro de producción facturable. El campo mode del portal no sustituye al campo mock de la API.

Prepare un archivo brand.json local con los campos que se indican a continuación. Sustituya los valores de ejemplo por datos de prueba adecuados y por los códigos actuales de los catálogos. Este ejemplo es una empresa privada con ánimo de lucro; otros tipos de entidad tienen requisitos diferentes.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

La empresa, la dirección, el teléfono y el identificador anteriores son valores de ejemplo, no una identidad empresarial lista para el registro. Obtenga los valores actuales de entityType, vertical, country, state, brandRelationship y otras enumeraciones en los catálogos de mensajería.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

Campos de empresa y de contacto

Los empresarios individuales se admiten para registros en Estados Unidos o Canadá y necesitan una verificación OTP antes de ser elegibles para campañas. Las empresas cotizadas pueden requerir un paso de validación del contacto empresarial. GOVERNMENT está reservado a entidades gubernamentales con sede en Estados Unidos; confirme la categoría de entidad correcta para otras organizaciones. Siga los requisitos específicos de cada tipo de entidad, así como los errores de validación devueltos.

Mantenga una clave de idempotencia estable

Genere una única Idempotency-Key para este registro previsto. Debe contener de 1 a 128 caracteres ASCII imprimibles sin espacios. Reutilice la misma clave solo con el mismo método HTTP, la misma ruta, la misma cadena de consulta y exactamente los mismos bytes del cuerpo de la solicitud. Reformatear el JSON, incluso sin cambiar su significado, modifica la huella de la solicitud.

Una solicitud con clave ya completada puede reproducir su respuesta almacenada sin un nuevo envío de registro. Un duplicado que todavía se está procesando devuelve HTTP 409 y puede incluir Retry-After. Una solicitud modificada con la misma clave entra en conflicto. No genere una clave nueva simplemente porque una solicitud haya agotado el tiempo de espera o haya devuelto un error: es posible que la empresa ya se haya registrado.

Mantenga brand.json sin cambios mientras resuelve esa solicitud. Un 500 o 502 almacenado en caché puede reproducir el error original en lugar de reintentar el registro. Conserve cualquier brandId, requestId y encabezado de correlación devueltos; concilie la marca existente antes de iniciar una solicitud diferente.

Lea la marca y su estado

Esta API utiliza códigos de estado HTTP y un cuerpo JSON directo, en lugar del sobre status/response de la v3. Un registro correcto devuelve un objeto de marca que incluye brandId. Guarde ese identificador e inspeccione el estado de validación o de identidad devuelto. Los campos adicionales dependen de la entidad y del estado del registro.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Lea únicamente una marca que pertenezca a su cuenta. Un 404 puede significar que la marca no está disponible para esta cuenta. Complete cualquier validación requerida y, a continuación, utilice la cualificación de marca para encontrar sus casos de uso de campaña disponibles. No se puede dar por hecho que los recursos simulados sean elegibles para envíos en producción.

Tarifas de producción

Estos importes minoristas se comprobaron frente a la configuración actual del portal el 24 de octubre de 2026. Confirme la tarifa actual en el portal antes de realizar un registro en producción. Los cargos de campaña, la verificación adicional y el uso de mensajería son independientes. Un registro en producción comprueba el permiso de compra y los fondos disponibles antes del envío; la creación correcta en el registro y la facturación local son pasos de procesamiento independientes, así que conserve el ID del recurso y concilie las transacciones si se produce un error o un problema de facturación.

Convertir una marca simulada en producción es un flujo de trabajo confirmado por separado y puede crear una nueva identidad de producción y un nuevo cargo. No dé por hecho que cambiar mock a false en una solicitud posterior convierte la marca existente.

Gestione los errores sin duplicar la marca