Enregistrer une marque de messagerie

Enregistrez l’entreprise à l’origine de vos messages

Une marque de messagerie identifie l’entreprise qui envoie des messages 10DLC aux États-Unis. Enregistrez la marque avant de choisir un cas d’usage de campagne. Utilisez les informations légales de l’entreprise et un contact capable d’effectuer toute validation requise. Un identifiant de marque renvoyé ne constitue pas, à lui seul, une autorisation d’envoyer des messages.

Utilisez cette route actuelle appartenant au compte via HTTPS avec un compte API activé et son adresse IP source autorisée. Ne transmettez pas user_id, username ni l’identifiant de propriétaire d’un autre client. MultiTEL enregistre la propriété à partir du compte authentifié.

Commencez par une requête explicite en bac à sable

Le portail règle par défaut son formulaire sur le mode bac à sable ; une requête API directe doit inclure explicitement le booléen JSON mock: true lorsque vous souhaitez une marque fictive. Omettre cet indicateur ne garantit pas le bac à sable et peut créer un enregistrement de production facturable. Le champ mode du portail ne remplace pas le champ mock de l’API.

Préparez un fichier brand.json local à l’aide des champs ci-dessous. Remplacez les valeurs d’exemple par des données de test appropriées et par les codes actuels des catalogues. Cet exemple est une entreprise privée à but lucratif ; les autres types d’entité ont des exigences différentes.

{
  "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
}

L’entreprise, l’adresse, le téléphone et l’identifiant ci-dessus sont des valeurs d’exemple, et non une identité d’entreprise prête à l’enregistrement. Obtenez les valeurs actuelles de entityType, vertical, country, state, brandRelationship et des autres énumérations à partir des catalogues de messagerie.

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'

Champs d’entreprise et de contact

Les entrepreneurs individuels sont pris en charge pour les enregistrements aux États-Unis ou au Canada et doivent passer une vérification OTP avant d’être éligibles aux campagnes. Les sociétés cotées peuvent nécessiter une étape de validation du contact professionnel. GOVERNMENT est réservé aux entités gouvernementales établies aux États-Unis ; confirmez la catégorie d’entité correcte pour les autres organisations. Respectez les exigences propres à chaque type d’entité ainsi que les erreurs de validation renvoyées.

Conservez une clé d’idempotence stable

Générez une seule Idempotency-Key pour cet enregistrement prévu. Elle doit contenir de 1 à 128 caractères ASCII imprimables, sans espaces. Réutilisez la même clé uniquement avec la même méthode HTTP, le même chemin, la même chaîne de requête et exactement les mêmes octets du corps de la requête. Reformater le JSON, même sans en changer le sens, modifie l’empreinte de la requête.

Une requête avec clé déjà terminée peut rejouer sa réponse stockée sans nouvelle soumission d’enregistrement. Un doublon encore en cours de traitement renvoie HTTP 409 et peut inclure Retry-After. Une requête modifiée avec la même clé entre en conflit. Ne générez pas une nouvelle clé simplement parce qu’une requête a expiré ou renvoyé une erreur : l’entreprise a peut-être déjà été enregistrée.

Laissez brand.json inchangé pendant la résolution de cette requête. Une réponse 500 ou 502 mise en cache peut rejouer l’erreur d’origine au lieu de réessayer l’enregistrement. Conservez tout brandId, requestId et en-tête de corrélation renvoyés ; rapprochez la marque existante avant de lancer une requête différente.

Lisez la marque et son statut

Cette API utilise les codes de statut HTTP et un corps JSON direct, plutôt que l’enveloppe status/response de la v3. Un enregistrement réussi renvoie un objet marque incluant brandId. Stockez cet identifiant et examinez le statut de validation ou d’identité renvoyé. Les champs supplémentaires dépendent de l’entité et de l’état de l’enregistrement.

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

Lisez uniquement une marque appartenant à votre compte. Un 404 peut signifier que la marque n’est pas disponible pour ce compte. Effectuez toute validation requise, puis utilisez la qualification de marque pour trouver ses cas d’usage de campagne disponibles. Les ressources fictives ne peuvent pas être présumées éligibles à l’envoi en production.

Frais de production

Ces montants de détail ont été vérifiés par rapport à la configuration actuelle du portail le 24 octobre 2026. Confirmez les frais actuels dans le portail avant tout enregistrement en production. Les frais de campagne, la vérification supplémentaire et l’utilisation de la messagerie sont distincts. Un enregistrement en production vérifie l’autorisation d’achat et les fonds disponibles avant la soumission ; la création réussie dans le registre et la facturation locale sont des étapes de traitement distinctes, conservez donc l’identifiant de la ressource et rapprochez les transactions en cas d’erreur ou de problème de facturation.

Le passage d’une marque fictive en production est un flux de travail confirmé séparément et peut créer une nouvelle identité de production et un nouveau débit. Ne supposez pas que modifier mock en false dans une requête ultérieure convertit la marque existante.

Gérez les erreurs sans dupliquer la marque