Registrirajte brend za razmjenu poruka

Registrirajte tvrtku koja stoji iza vaših poruka

Brend za razmjenu poruka identificira tvrtku koja šalje poruke putem US 10DLC mreže. Registrirajte brend prije odabira namjene kampanje. Upotrijebite zakonske podatke tvrtke i kontakt koji može dovršiti svaku potrebnu provjeru. Vraćeni ID brenda sam po sebi nije odobrenje za slanje poruka.

Upotrijebite ovu aktualnu rutu u vlasništvu računa putem HTTPS-a s omogućenim API računom i njegovom dopuštenom izvornom IP adresom. Nemojte slati user_id, username ni identifikator vlasnika drugog korisnika. MultiTEL bilježi vlasništvo na temelju autenticiranog računa.

Započnite s izričitim zahtjevom za testno okruženje

Polje mode obrasca na portalu zadano je postavljeno na testni način; izravni API zahtjev mora izričito sadržavati JSON logičku vrijednost mock: true kada namjeravate izraditi lažni brend. Izostavljanje te oznake nije jamstvo testnog načina i može stvoriti naplativu produkcijsku registraciju. Polje mode na portalu nije zamjena za polje mock u API-ju.

Pripremite lokalnu datoteku brand.json koristeći polja u nastavku. Zamijenite rezervirana mjesta odgovarajućim testnim podacima i aktualnim kodovima iz kataloga. Ovaj primjer odnosi se na privatno profitno poduzeće; druge vrste subjekata imaju drugačije zahtjeve.

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

Tvrtka, adresa, telefon i identifikator u gornjem primjeru rezervirana su mjesta, a ne poslovni identitet spreman za registraciju. Aktualne vrijednosti za entityType, vertical, country, state, brandRelationship i druge nabrojive vrijednosti preuzmite iz kataloga za razmjenu poruka.

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'

Poslovna i kontaktna polja

Samostalni poduzetnici podržani su za US ili kanadske registracije i trebaju OTP provjeru prije prihvatljivosti za kampanju. Tvrtke čijim se dionicama trguje na burzi mogu zahtijevati korak provjere poslovnog kontakta. GOVERNMENT je za vladine subjekte sa sjedištem u SAD-u; za druge organizacije potvrdite ispravnu kategoriju subjekta. Slijedite zahtjeve specifične za vrstu subjekta kao i vraćene pogreške provjere valjanosti.

Zadržite stabilan ključ idempotentnosti

Generirajte jedan Idempotency-Key za ovu namjeravanu registraciju. Mora sadržavati 1–128 ispisivih ASCII znakova bez razmaka. Isti ključ ponovno koristite samo s istom HTTP metodom, stazom, nizom upita i točnim bajtovima tijela zahtjeva. Preoblikovanje JSON-a, čak i bez promjene značenja, mijenja otisak zahtjeva.

Dovršeni zahtjev s ključem može ponovno reproducirati svoj pohranjeni odgovor bez nove registracije. Duplikat koji se još obrađuje vraća HTTP 409 i može uključivati Retry-After. Izmijenjeni zahtjev s istim ključem u sukobu je. Nemojte generirati novi ključ samo zato što je zahtjev istekao ili vratio pogrešku: tvrtka je možda već registrirana.

Ostavite brand.json nepromijenjenim dok rješavate taj zahtjev. Predmemorirana pogreška 500 ili 502 može ponovno reproducirati izvornu pogrešku umjesto ponovnog pokušaja registracije. Sačuvajte svaki vraćeni brandId, requestId i korelacijska zaglavlja; prije pokretanja drugog zahtjeva provjerite stvarno stanje postojećeg brenda i razriješite eventualna neslaganja.

Pročitajte brend i njegov status

Ovaj API koristi HTTP statusne kodove i izravno JSON tijelo, a ne omotnicu v3 status/response. Uspješna registracija vraća objekt brenda koji uključuje brandId. Pohranite taj identifikator i pregledajte vraćeni status provjere valjanosti ili identiteta. Dodatna polja ovise o subjektu i stanju registracije.

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

Čitajte samo brend koji pripada vašem računu. Pogreška 404 može značiti da brend nije dostupan ovom računu. Dovršite svaku potrebnu provjeru, a zatim upotrijebite kvalifikaciju brenda kako biste pronašli njegove dostupne namjene kampanje. Ne može se pretpostaviti da su lažni resursi prihvatljivi za produkcijsko slanje.

Produkcijske naknade

Ti maloprodajni iznosi provjereni su prema aktualnoj konfiguraciji portala na dan 24. listopada 2026. Prije produkcijske registracije potvrdite aktualnu naknadu na portalu. Troškovi kampanja, dodatne provjere i korištenje razmjene poruka zasebni su. Produkcijska registracija prije podnošenja provjerava dopuštenje za kupnju i dostupna sredstva; uspješna izrada u registru i lokalna naplata zasebni su koraci obrade, stoga sačuvajte ID resursa i uskladite transakcije ako dođe do pogreške ili problema s naplatom.

Promjena lažnog brenda u produkcijski zasebno je potvrđeni tijek i može stvoriti novi produkcijski identitet i naplatu. Nemojte pretpostaviti da uređivanje mock u false u kasnijem zahtjevu pretvara postojeći brend.

Obradite pogreške bez dupliciranja brenda