Rekisteröi viestintäbrändi

Rekisteröi viestiesi taustalla oleva yritys

Viestintäbrändi tunnistaa yrityksen, joka lähettää US 10DLC -viestejä. Rekisteröi brändi ennen kampanjan käyttötarkoituksen valintaa. Käytä yrityksen virallisia tietoja ja yhteyshenkilöä, joka voi suorittaa mahdollisesti vaadittavan validoinnin. Palautettu bränditunnus ei yksinään ole lupa lähettää viestejä.

Käytä tätä nykyistä tiliomisteista reittiä HTTPS-yhteydellä käytössä olevalla API-tilillä ja sen sallitulla lähde-IP-osoitteella. Älä lähetä user_id- tai username-kenttää tai toisen asiakkaan omistajatunnistetta. MultiTEL kirjaa omistajuuden todennetulta tililtä.

Aloita nimenomaisella hiekkalaatikkapyynnöllä

Portaali asettaa lomakkeensa mode-kentän oletuksena hiekkalaatikkotilaan; suoran API-pyynnön on sisällettävä nimenomaisesti JSON-totuusarvo mock: true, kun tarkoitat testibrändiä. Tunnisteen pois jättäminen ei takaa hiekkalaatikkaa ja voi luoda laskutettavan tuotantorekisteröinnin. Portaalin mode-kenttä ei korvaa API:n mock-kenttää.

Valmistele paikallinen brand.json-tiedosto alla olevien kenttien avulla. Korvaa paikkamerkit sopivilla testitiedoilla ja ajantasaisilla luettelokoodeilla. Tämä esimerkki on yksityinen voittoa tavoitteleva yritys; muilla yhteisötyypeillä on erilaiset vaatimukset.

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

Edellä oleva yritys, osoite, puhelin ja tunniste ovat paikkamerkkejä, eivät rekisteröintikelpoinen yritysidentiteetti. Hae ajantasaiset arvot kentille entityType, vertical, country, state, brandRelationship ja muille luetteloarvoille kohdasta viestintäluettelot.

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'

Yritys- ja yhteystietokentät

Yksityiset elinkeinonharjoittajat ovat tuettuja US- tai Kanadan rekisteröinneissä ja tarvitsevat OTP-vahvistuksen ennen kampanjakelpoisuutta. Pörssiyhtiöt voivat vaatia yritys-yhteystietojen validointivaiheen. GOVERNMENT on tarkoitettu US-pohjaisille julkishallinnon yhteisöille; vahvista oikea yhteisöluokka muille organisaatioille. Noudata yhteisökohtaisia vaatimuksia sekä palautettuja validointivirheitä.

Pidä idempotenssiavain vakaana

Luo yksi Idempotency-Key tätä tarkoitettua rekisteröintiä varten. Sen on sisällettävä 1–128 tulostettavaa ASCII-merkkiä ilman välilyöntejä. Käytä samaa avainta uudelleen vain saman HTTP-menetelmän, polun, kyselymerkkijonon ja tarkkojen pyynnön runkotavujen kanssa. JSON-muotoilun muuttaminen, vaikka sen merkitys ei muuttuisi, muuttaa pyynnön sormenjälkeä.

Valmis avaimellinen pyyntö voi toistaa tallennetun vastauksensa ilman uutta rekisteröintilähetystä. Yhä käsiteltävä kaksoiskappale palauttaa HTTP 409 -tilan ja voi sisältää Retry-After-otsikon. Muutettu pyyntö samalla avaimella aiheuttaa ristiriidan. Älä luo uutta avainta vain siksi, että pyyntö aikakatkaistiin tai palautti virheen: yritys on ehkä jo rekisteröity.

Pidä brand.json muuttumattomana selvittäessäsi kyseistä pyyntöä. Välimuistiin tallennettu 500- tai 502-virhe voi toistaa alkuperäisen virheen rekisteröinnin uudelleenyrityksen sijaan. Säilytä mahdolliset palautetut brandId-, requestId- ja korrelaatio-otsikot; täsmäytä olemassa oleva brändi ennen eri pyynnön aloittamista.

Lue brändi ja sen tila

Tämä API käyttää HTTP-tilakoodeja ja suoraa JSON-runkoa v3 status/response -kääreen sijaan. Onnistunut rekisteröinti palauttaa brändiobjektin, joka sisältää brandId-tunnisteen. Tallenna kyseinen tunniste ja tarkista palautettu validointi- tai henkilöllisyystila. Lisäkentät riippuvat yhteisöstä ja rekisteröinnin tilasta.

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

Lue vain tilillesi kuuluva brändi. 404-koodi voi tarkoittaa, että brändi ei ole tämän tilin käytettävissä. Suorita mahdollinen vaadittava validointi ja käytä sitten brändin kelpoisuutta löytääksesi sen käytettävissä olevat kampanjan käyttötarkoitukset. Testiresursseja ei voida olettaa kelvollisiksi tuotantolähetykseen.

Tuotantomaksut

Nämä vähittäishinnat tarkistettiin nykyistä portaalin määritystä vasten 24. lokakuuta 2026. Vahvista ajantasainen maksu portaalissa ennen tuotantorekisteröintiä. Kampanjamaksut, lisäselvitykset ja viestinkäyttö ovat erillisiä. Tuotantorekisteröinti tarkistaa ostoluvan ja käytettävissä olevan rahoituksen ennen lähetystä; onnistunut brändin kirjaus rekisteriin ja paikallinen laskutus ovat erillisiä käsittelyvaiheita, joten säilytä resurssitunnus ja täsmäytä tapahtumat, jos ilmenee virhe tai laskutusongelma.

Testibrändin muuttaminen tuotantoon on erikseen vahvistettava työnkulku ja voi luoda uuden tuotanto-identiteetin ja veloituksen. Älä oleta, että mock-arvon muokkaaminen arvoksi false myöhemmässä pyynnössä muuntaa olemassa olevan brändin.

Käsittele virheet ilman brändin monistamista