Registrare un brand di messaggistica

Registra l'azienda dietro i tuoi messaggi

Un brand di messaggistica identifica l'azienda che invia messaggi 10DLC negli Stati Uniti. Registra il brand prima di scegliere un caso d'uso per la campagna. Usa i dati legali dell'azienda e un contatto in grado di completare qualsiasi validazione richiesta. Un ID brand restituito non costituisce, di per sé, l'approvazione a inviare messaggi.

Usa questa route attuale di proprietà dell'account tramite HTTPS con un account API abilitato e il relativo indirizzo IP di origine consentito. Non inviare user_id, username né l'identificatore proprietario di un altro cliente. MultiTEL registra la proprietà a partire dall'account autenticato.

Inizia con una richiesta sandbox esplicita

Il portale imposta per impostazione predefinita il campo mode del proprio modulo su sandbox; una richiesta diretta all'API deve includere esplicitamente il booleano JSON mock: true quando intendi creare un brand fittizio. Omettere quel flag non garantisce la sandbox e può creare una registrazione di produzione addebitabile. Il campo mode del portale non sostituisce il campo mock dell'API.

Prepara un file brand.json locale usando i campi seguenti. Sostituisci i segnaposto con dati di test appropriati e codici di catalogo attuali. Questo esempio è un'azienda privata a scopo di lucro; altri tipi di entità hanno requisiti diversi.

{
  "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'azienda, l'indirizzo, il telefono e l'identificatore riportati sopra sono segnaposto, non un'identità aziendale pronta per la registrazione. Ottieni i valori attuali di entityType, vertical, country, state, brandRelationship e delle altre enumerazioni dai cataloghi di messaggistica.

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'

Campi aziendali e di contatto

Le ditte individuali sono supportate per registrazioni negli Stati Uniti o in Canada e richiedono la verifica OTP prima dell'idoneità alle campagne. Le società quotate possono richiedere un passaggio di validazione del contatto aziendale. GOVERNMENT è riservato alle entità governative con sede negli Stati Uniti; verifica la categoria di entità corretta per le altre organizzazioni. Segui i requisiti specifici dell'entità oltre agli errori di validazione restituiti.

Mantieni una chiave di idempotenza stabile

Genera una sola Idempotency-Key per questa registrazione prevista. Deve contenere 1–128 caratteri ASCII stampabili senza spazi. Riutilizza la stessa chiave solo con lo stesso metodo HTTP, lo stesso percorso, la stessa query string e gli stessi identici byte del corpo della richiesta. Riformattare il JSON, anche senza cambiarne il significato, cambia l'impronta della richiesta.

Una richiesta con chiave già completata può riprodurre la risposta memorizzata senza un nuovo invio della registrazione. Un duplicato ancora in elaborazione restituisce HTTP 409 e può includere Retry-After. Una richiesta modificata con la stessa chiave genera un conflitto. Non generare una nuova chiave solo perché una richiesta è scaduta o ha restituito un errore: l'azienda potrebbe essere già stata registrata.

Mantieni brand.json invariato mentre risolvi quella richiesta. Un 500 o 502 memorizzato nella cache può riprodurre l'errore originale anziché ripetere la registrazione. Conserva qualsiasi brandId, requestId e intestazione di correlazione restituiti; riconcilia il brand esistente prima di avviare una richiesta diversa.

Leggi il brand e il suo stato

Questa API usa i codici di stato HTTP e un corpo JSON diretto, anziché l'envelope status/response della v3. Una registrazione riuscita restituisce un oggetto brand che include brandId. Conserva quell'identificatore e controlla lo stato di validazione o di identità restituito. I campi aggiuntivi dipendono dall'entità e dallo stato della registrazione.

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

Leggi solo un brand appartenente al tuo account. Un 404 può significare che il brand non è disponibile per questo account. Completa qualsiasi validazione richiesta, poi usa la qualificazione del brand per trovare i suoi casi d'uso di campagna disponibili. Non si può presumere che le risorse fittizie siano idonee all'invio in produzione.

Costi di produzione

Questi importi al dettaglio sono stati verificati rispetto alla configurazione attuale del portale il 24 ottobre 2026. Conferma il costo attuale nel portale prima della registrazione di produzione. Gli addebiti per le campagne, la verifica aggiuntiva e l'utilizzo della messaggistica sono separati. Una registrazione di produzione controlla il permesso di acquisto e i fondi disponibili prima dell'invio; la creazione riuscita nel registro e la fatturazione locale sono passaggi di elaborazione separati, quindi conserva l'ID della risorsa e riconcilia le transazioni se si verifica un errore o un problema di fatturazione.

Trasformare un brand fittizio in produzione è un flusso di lavoro confermato separatamente e può creare una nuova identità di produzione e un nuovo addebito. Non presumere che modificare mock in false in una richiesta successiva converta il brand esistente.

Gestisci gli errori senza duplicare il brand