Registrer en meldingsmerkevare

Registrer virksomheten bak meldingene dine

En meldingsmerkevare identifiserer virksomheten som sender amerikanske 10DLC-meldinger. Registrer merkevaren før du velger et kampanjebrukstilfelle. Bruk virksomhetens juridiske opplysninger og en kontaktperson som kan fullføre eventuell nødvendig validering. En returnert merkevare-ID er ikke i seg selv en godkjenning til å sende meldinger.

Bruk denne gjeldende kontoeide ruten over HTTPS med en aktivert API-konto og dens tillatte kilde-IP-adresse. Ikke send inn user_id, username eller en annen kundes eieridentifikator. MultiTEL registrerer eierskap fra den autentiserte kontoen.

Start med en eksplisitt sandkasseforespørsel

Portalen setter som standard skjemaets mode til sandkasse; en direkte API-forespørsel må eksplisitt inneholde JSON-boolverdien mock: true når du har til hensikt å opprette en mock-merkevare. Å utelate dette flagget er ingen sandkassegaranti og kan opprette en fakturerbar produksjonsregistrering. Portalens mode-felt er ingen erstatning for API-ets mock-felt.

Forbered en lokal brand.json-fil med feltene nedenfor. Erstatt plassholderne med passende testopplysninger og gjeldende katalogkoder. Dette eksemplet er en privat virksomhet med fortjenesteformål; andre enhetstyper har andre krav.

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

Virksomheten, adressen, telefonnummeret og identifikatoren ovenfor er plassholdere, ikke en registreringsklar virksomhetsidentitet. Hent gjeldende verdier for entityType, vertical, country, state, brandRelationship og andre enumerasjoner fra meldingskatalogene.

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'

Virksomhets- og kontaktfelt

Enkeltpersonforetak støttes for amerikanske eller kanadiske registreringer og trenger OTP-verifisering før de blir kvalifisert for kampanjer. Børsnoterte selskaper kan kreve et valideringstrinn for forretningskontakt. GOVERNMENT er for amerikanske offentlige enheter; bekreft riktig enhetskategori for andre organisasjoner. Følg de enhetsspesifikke kravene i tillegg til de returnerte valideringsfeilene.

Behold en stabil idempotensnøkkel

Generer én Idempotency-Key for denne tilsiktede registreringen. Den må inneholde 1–128 skrivbare ASCII-tegn uten mellomrom. Gjenbruk den samme nøkkelen bare med samme HTTP-metode, sti, spørrestreng og nøyaktig samme byte i forespørselskroppen. Omformatering av JSON, selv uten å endre betydningen, endrer forespørselens fingeravtrykk.

En fullført nøklet forespørsel kan spille av det lagrede svaret på nytt uten en ny registreringsinnsending. Et duplikat som fortsatt behandles, returnerer HTTP 409 og kan inneholde Retry-After. En endret forespørsel med samme nøkkel gir konflikt. Ikke generer en ny nøkkel bare fordi en forespørsel fikk tidsavbrudd eller returnerte en feil: virksomheten kan allerede være registrert.

Hold brand.json uendret mens du løser den forespørselen. En hurtigbufret 500 eller 502 kan spille av den opprinnelige feilen på nytt i stedet for å prøve registreringen igjen. Ta vare på eventuell returnert brandId, requestId og korrelasjonshoder; avstem den eksisterende merkevaren før du starter en annen forespørsel.

Les merkevaren og statusen dens

Dette API-et bruker HTTP-statuskoder og en direkte JSON-kropp, i stedet for v3-konvolutten status/response. En vellykket registrering returnerer et merkevareobjekt som inneholder brandId. Lagre den identifikatoren og undersøk den returnerte validerings- eller identitetsstatusen. Ekstra felt avhenger av enheten og registreringstilstanden.

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

Les bare en merkevare som tilhører kontoen din. En 404 kan bety at merkevaren ikke er tilgjengelig for denne kontoen. Fullfør eventuell nødvendig validering, og bruk deretter merkevarekvalifisering for å finne de tilgjengelige kampanjebrukstilfellene. Mock-ressurser kan ikke antas å være kvalifisert for produksjonssending.

Produksjonsgebyrer

Disse utsalgsbeløpene ble kontrollert mot gjeldende portalkonfigurasjon 24. oktober 2026. Bekreft gjeldende gebyr i portalen før produksjonsregistrering. Kampanjeavgifter, ytterligere kontroll og meldingsbruk kommer i tillegg. En produksjonsregistrering kontrollerer kjøpstillatelse og tilgjengelig dekning før innsending; vellykket opprettelse i registeret og lokal fakturering er separate behandlingstrinn, så ta vare på ressurs-ID-en og avstem transaksjonene hvis det oppstår en feil eller et faktureringsproblem.

Å endre en mock-merkevare til produksjon er en separat bekreftet arbeidsflyt og kan opprette en ny produksjonsidentitet og belastning. Ikke anta at det å endre mock til false i en senere forespørsel konverterer den eksisterende merkevaren.

Håndter feil uten å duplisere merkevaren