Înregistrarea unei mărci de mesagerie

Înregistrați afacerea din spatele mesajelor dvs.

O marcă de mesagerie identifică afacerea care trimite mesaje 10DLC în SUA. Înregistrați marca înainte de a alege un caz de utilizare pentru campanie. Folosiți datele legale ale afacerii și o persoană de contact care poate finaliza orice validare necesară. Un ID de marcă returnat nu reprezintă, în sine, aprobarea de a trimite mesaje.

Folosiți această rută curentă deținută de cont prin HTTPS cu un cont API activat și adresa IP sursă permisă a acestuia. Nu trimiteți user_id, username sau identificatorul de proprietar al unui alt client. MultiTEL înregistrează proprietatea pe baza contului autentificat.

Începeți cu o cerere sandbox explicită

Portalul setează implicit câmpul mode al formularului la modul sandbox; o cerere API directă trebuie să includă explicit valoarea booleană JSON mock: true atunci când intenționați o marcă simulată. Omiterea acestui indicator nu garantează modul sandbox și poate crea o înregistrare de producție facturabilă. Câmpul mode al portalului nu înlocuiește câmpul mock al API-ului.

Pregătiți un fișier local brand.json folosind câmpurile de mai jos. Înlocuiți substituenții cu detalii de test adecvate și coduri de catalog curente. Acest exemplu este o afacere privată cu scop lucrativ; alte tipuri de entități au cerințe diferite.

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

Afacerea, adresa, telefonul și identificatorul de mai sus sunt substituenți, nu o identitate de afacere pregătită pentru înregistrare. Obțineți valorile curente pentru entityType, vertical, country, state, brandRelationship și alte enumerări din cataloagele de mesagerie.

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'

Câmpuri pentru afacere și contact

Persoanele fizice autorizate sunt acceptate pentru înregistrări din SUA sau Canada și necesită verificare OTP înainte de eligibilitatea pentru campanii. Companiile cotate la bursă pot necesita o etapă de validare a contactului de afaceri. GOVERNMENT este destinat entităților guvernamentale cu sediul în SUA; confirmați categoria corectă de entitate pentru alte organizații. Respectați cerințele specifice entității, precum și erorile de validare returnate.

Păstrați o cheie de idempotență stabilă

Generați o singură cheie Idempotency-Key pentru această înregistrare intenționată. Trebuie să conțină 1–128 de caractere ASCII imprimabile, fără spații. Reutilizați aceeași cheie numai cu aceeași metodă HTTP, aceeași cale, același șir de interogare și exact aceiași octeți ai corpului cererii. Reformatarea JSON, chiar și fără a-i schimba sensul, modifică amprenta cererii.

O cerere cu cheie finalizată poate reda răspunsul stocat fără o nouă trimitere a înregistrării. Un duplicat aflat încă în procesare returnează HTTP 409 și poate include Retry-After. O cerere modificată cu aceeași cheie intră în conflict. Nu generați o cheie nouă doar pentru că o cerere a expirat sau a returnat o eroare: afacerea este posibil să fi fost deja înregistrată.

Păstrați brand.json neschimbat în timp ce rezolvați acea cerere. Un răspuns 500 sau 502 din cache poate reda eroarea inițială în loc să reîncerce înregistrarea. Păstrați orice brandId, requestId și anteturi de corelare returnate; reconciliați marca existentă înainte de a începe o cerere diferită.

Citiți marca și starea acesteia

Acest API folosește coduri de stare HTTP și un corp JSON direct, în locul anvelopei status/response din v3. O înregistrare reușită returnează un obiect de marcă ce include brandId. Stocați acest identificator și examinați starea de validare sau de identitate returnată. Câmpurile suplimentare depind de entitate și de starea înregistrării.

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

Citiți numai o marcă aparținând contului dvs. Un 404 poate însemna că marca nu este disponibilă pentru acest cont. Finalizați orice validare necesară, apoi folosiți calificarea mărcii pentru a găsi cazurile de utilizare de campanie disponibile pentru aceasta. Resursele simulate nu pot fi considerate eligibile pentru trimiterea în producție.

Taxe de producție

Aceste sume de vânzare cu amănuntul au fost verificate în raport cu configurația curentă a portalului la 24 octombrie 2026. Confirmați taxa curentă în portal înainte de înregistrarea în producție. Taxele de campanie, verificarea suplimentară și utilizarea mesageriei sunt separate. O înregistrare de producție verifică permisiunea de achiziție și fondurile disponibile înainte de trimitere; crearea reușită în registru și facturarea locală sunt etape de procesare separate, așa că păstrați ID-ul resursei și reconciliați tranzacțiile dacă apare o eroare sau o problemă de facturare.

Transformarea unei mărci simulate în marcă de producție este un flux confirmat separat și poate crea o nouă identitate de producție și o nouă debitare. Nu presupuneți că modificarea mock în false într-o cerere ulterioară convertește marca existentă.

Gestionați erorile fără a duplica marca