Een berichtenmerk registreren

Registreer het bedrijf achter uw berichten

Een berichtenmerk identificeert het bedrijf dat US 10DLC-berichten verzendt. Registreer het merk voordat u een campagnegebruikssituatie kiest. Gebruik de juridische gegevens van het bedrijf en een contactpersoon die een eventueel vereiste validatie kan voltooien. Een geretourneerde merk-ID is op zichzelf geen toestemming om berichten te verzenden.

Gebruik deze huidige route in eigendom van het account via HTTPS met een ingeschakeld API-account en het toegestane bron-IP-adres daarvan. Dien geen user_id, username of een eigenaarsidentificatie van een andere klant in. MultiTEL registreert het eigendom op basis van het geauthenticeerde account.

Begin met een expliciet sandboxverzoek

Het portaal stelt het veld mode van zijn formulier standaard in op sandbox; een direct API-verzoek moet expliciet de booleaanse JSON-waarde mock: true bevatten wanneer u een mockmerk bedoelt. Het weglaten van die vlag is geen sandboxgarantie en kan een factureerbare productieregistratie veroorzaken. Het veld mode van het portaal is geen vervanging voor het veld mock van de API.

Bereid een lokaal bestand brand.json voor met de onderstaande velden. Vervang de tijdelijke aanduidingen door passende testgegevens en actuele cataloguscodes. Dit voorbeeld betreft een particulier bedrijf met winstoogmerk; andere entiteitstypen hebben andere vereisten.

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

Het bedrijf, het adres, het telefoonnummer en de identificatie hierboven zijn tijdelijke aanduidingen, geen registreerbare bedrijfsidentiteit. Haal actuele waarden voor entityType, vertical, country, state, brandRelationship en andere opsommingen op uit de berichtencatalogi.

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'

Bedrijfs- en contactvelden

Eenmanszaken worden ondersteund voor US- of Canadese registraties en hebben OTP-verificatie nodig voordat zij voor campagnes in aanmerking komen. Beursgenoteerde bedrijven kunnen een validatiestap voor een zakelijk contact vereisen. GOVERNMENT is bestemd voor in de US gevestigde overheidsinstanties; bevestig de juiste entiteitscategorie voor andere organisaties. Volg de entiteitsspecifieke vereisten en de geretourneerde validatiefouten.

Behoud een stabiele idempotencysleutel

Genereer één Idempotency-Key voor deze beoogde registratie. Deze moet 1–128 afdrukbare ASCII-tekens zonder spaties bevatten. Hergebruik dezelfde sleutel alleen met dezelfde HTTP-methode, hetzelfde pad, dezelfde querystring en exact dezelfde hoofdtekstbytes van het verzoek. Het opnieuw formatteren van JSON, zelfs zonder de betekenis te wijzigen, verandert de vingerafdruk van het verzoek.

Een voltooid verzoek met sleutel kan het opgeslagen antwoord opnieuw afspelen zonder een nieuwe registratieaanvraag. Een duplicaat dat nog wordt verwerkt, retourneert HTTP 409 en kan Retry-After bevatten. Een gewijzigd verzoek met dezelfde sleutel conflicteert. Genereer niet louter een nieuwe sleutel omdat een verzoek een time-out heeft gehad of een fout heeft geretourneerd: het bedrijf is mogelijk al geregistreerd.

Houd brand.json ongewijzigd terwijl u dat verzoek oplost. Een gecachte 500 of 502 kan de oorspronkelijke fout opnieuw afspelen in plaats van de registratie opnieuw te proberen. Bewaar een eventueel geretourneerde brandId, requestId en correlatieheaders; controleer de feitelijke status van het bestaande merk en los eventuele verschillen op voordat u een ander verzoek start.

Lees het merk en de status ervan

Deze API gebruikt HTTP-statuscodes en een directe JSON-hoofdtekst, in plaats van de v3-envelop status/response. Een geslaagde registratie retourneert een merkobject met onder meer brandId. Bewaar die identificatie en controleer de geretourneerde validatie- of identiteitsstatus. Extra velden zijn afhankelijk van de entiteit en de registratiestatus.

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

Lees alleen een merk dat tot uw account behoort. Een 404 kan betekenen dat het merk niet beschikbaar is voor dit account. Voltooi een eventueel vereiste validatie en gebruik vervolgens merkkwalificatie om de beschikbare campagnegebruikssituaties ervan te vinden. Mockresources kunnen niet zonder meer als geschikt voor productieverzending worden beschouwd.

Productiekosten

Deze retailbedragen zijn op 24 oktober 2026 gecontroleerd aan de hand van de actuele portaalconfiguratie. Bevestig de actuele kosten in het portaal vóór productieregistratie. Campagnekosten, aanvullende controle en berichtengebruik zijn afzonderlijk. Een productieregistratie controleert vóór indiening de aankoopmachtiging en de beschikbare financiering; het succesvol aanmaken in het register en de lokale facturering zijn afzonderlijke verwerkingsstappen, dus bewaar de resource-ID en stem transacties af als er een fout of factureringsprobleem optreedt.

Het omzetten van een mockmerk naar productie is een afzonderlijk bevestigde workflow en kan een nieuwe productie-identiteit en nieuwe kosten veroorzaken. Ga er niet van uit dat het wijzigen van mock in false in een later verzoek het bestaande merk omzet.

Fouten afhandelen zonder het merk te dupliceren