Regjistroni një markë mesazhesh

Regjistroni biznesin që qëndron pas mesazheve tuaja

Një markë mesazhesh identifikon biznesin që dërgon mesazhe 10DLC në SHBA. Regjistroni markën përpara se të zgjidhni një rast përdorimi për fushatën. Përdorni të dhënat ligjore të biznesit dhe një kontakt që mund të përfundojë çdo validim të kërkuar. Një ID marke e kthyer nuk përbën, në vetvete, miratim për dërgimin e mesazheve.

Përdorni këtë rrugë aktuale në pronësi të llogarisë përmes HTTPS me një llogari API të aktivizuar dhe adresën e saj IP burimore të lejuar. Mos dërgoni user_id, username apo identifikuesin e pronarit të një klienti tjetër. MultiTEL e regjistron pronësinë nga llogaria e autentikuar.

Filloni me një kërkesë sandbox të qartë

Portali e vendos si parazgjedhje fushën mode të formularit të tij në sandbox; një kërkesë e drejtpërdrejtë API duhet të përfshijë shprehimisht vlerën booleane JSON mock: true kur synoni një markë mock. Mungesa e këtij flamuri nuk është garanci sandbox dhe mund të krijojë një regjistrim prodhimi të faturueshëm. Fusha mode e portalit nuk zëvendëson fushën mock të API-t.

Përgatitni një skedar lokal brand.json duke përdorur fushat më poshtë. Zëvendësoni vendmbajtësit me të dhëna testuese të përshtatshme dhe kode aktuale të katalogut. Ky shembull është një biznes privat fitimprurës; llojet e tjera të entiteteve kanë kërkesa të ndryshme.

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

Biznesi, adresa, telefoni dhe identifikuesi më sipër janë vendmbajtës, jo një identitet biznesi gati për regjistrim. Merrni vlerat aktuale për entityType, vertical, country, state, brandRelationship dhe enumerimet e tjera nga katalogët e mesazheve.

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'

Fushat e biznesit dhe të kontaktit

Sipërmarrësit individualë mbështeten për regjistrime në SHBA ose Kanada dhe kanë nevojë për verifikim OTP përpara pranueshmërisë së fushatës. Kompanitë e listuara në bursë mund të kërkojnë një hap validimi të kontaktit të biznesit. GOVERNMENT është për entitetet qeveritare me bazë në SHBA; konfirmoni kategorinë e saktë të entitetit për organizatat e tjera. Ndiqni kërkesat specifike për entitetin si dhe gabimet e validimit të kthyera.

Mbani një çelës idempotence të qëndrueshëm

Gjeneroni një Idempotency-Key të vetëm për këtë regjistrim të synuar. Ai duhet të përmbajë 1–128 karaktere ASCII të printueshme pa hapësira. Ripërdoreni të njëjtin çelës vetëm me të njëjtën metodë HTTP, shteg, varg pyetjeje dhe saktësisht të njëjtët bajte të trupit të kërkesës. Riformatimi i JSON-it, edhe pa i ndryshuar kuptimin, e ndryshon gjurmën e kërkesës.

Një kërkesë e përfunduar me çelës mund ta riluajë përgjigjen e saj të ruajtur pa një dorëzim tjetër regjistrimi. Një dublikatë që është ende në përpunim kthen HTTP 409 dhe mund të përfshijë Retry-After. Një kërkesë e ndryshuar me të njëjtin çelës bie në konflikt. Mos gjeneroni një çelës të ri thjesht sepse një kërkesë skadoi ose ktheu një gabim: biznesi mund të jetë regjistruar tashmë.

Mbajeni brand.json të pandryshuar ndërsa zgjidhni atë kërkesë. Një 500 ose 502 e ruajtur në cache mund të riluajë gabimin origjinal në vend që ta riprovojë regjistrimin. Ruani çdo brandId, requestId dhe header korrelacioni të kthyer; kontrolloni gjendjen reale të markës ekzistuese dhe zgjidhni çdo mospërputhje përpara se të filloni një kërkesë tjetër.

Lexoni markën dhe statusin e saj

Ky API përdor kodet e statusit HTTP dhe një trup JSON të drejtpërdrejtë, në vend të mbështjellësit status/response të v3. Regjistrimi i suksesshëm kthen një objekt marke që përfshin brandId. Ruani atë identifikues dhe shqyrtoni statusin e kthyer të validimit ose të identitetit. Fushat shtesë varen nga entiteti dhe gjendja e regjistrimit.

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

Lexoni vetëm një markë që i përket llogarisë suaj. Një 404 mund të nënkuptojë se marka nuk është e disponueshme për këtë llogari. Përfundoni çdo validim të kërkuar, pastaj përdorni kualifikimin e markës për të gjetur rastet e disponueshme të përdorimit të fushatës. Burimet mock nuk mund të konsiderohen të pranueshme për dërgim në prodhim.

Tarifat e prodhimit

Këto shuma me pakicë u kontrolluan kundrejt konfigurimit aktual të portalit më 24 tetor 2026. Konfirmoni tarifën aktuale në portal përpara regjistrimit në prodhim. Tarifat e fushatës, verifikimi shtesë dhe përdorimi i mesazheve janë të veçanta. Një regjistrim prodhimi kontrollon lejen e blerjes dhe fondet e disponueshme përpara dorëzimit; krijimi i suksesshëm në regjistër dhe faturimi lokal janë hapa përpunimi të veçantë, prandaj ruani ID-në e burimit dhe kontrolloni transaksionet dhe zgjidhni çdo mospërputhje nëse ndodh një gabim ose një problem faturimi.

Kalimi i një marke mock në prodhim është një rrjedhë pune e konfirmuar veçmas dhe mund të krijojë një identitet të ri prodhimi dhe një tarifim të ri. Mos supozoni se ndryshimi i mock në false në një kërkesë të mëvonshme e konverton markën ekzistuese.

Trajtoni gabimet pa e dublikuar markën