Registreer 'n 10DLC-veldtog

Kwalifiseer 'n handelsmerk voordat sy veldtog geregistreer word

'n 10DLC-veldtog beskryf die boodskappe wat 'n geregistreerde besigheid beplan om te stuur, hoe ontvangers toestem, en hoe hulle hulp kan kry of boodskappe kan staak. Hierdie API skep die registerrekord; die voltooiing van produksie-diensverskafferaktivering is 'n afsonderlike rekeningopstellingstap. Gebruik 'n handelsmerk in jou besit uit handelsmerkregistrasie, laai dan sy beskikbare gebruiksgevalle en die gekose gebruiksgeval se huidige vereistes.

Gebruik die huidige kwalifikasieresultaat om subgebruiksgevalle, kwalifiserende netwerk-ID's, boodskapvoorbeelde en inteken-/uitskryf-/hulpverklarings te kies. Vereistes kan per handelsmerk en netwerk verskil. Moenie die voorbeeld se identifiseerders indien of sy toestemmingsbeskrywing kopieer vir 'n besigheid met 'n ander proses nie.

Hou toets- en produksie-omgewings geskei

Vir 'n toetsoefening, gebruik jou eie toets-handelsmerk en 'n huidige gebruiksgeval waarvoor dit kwalifiseer. Gebruik TRIAL slegs wanneer daardie kwalifikasie dit aanbied. Die portaal kontroleer dat die gekose handelsmerk en veldtogomgewing ooreenstem. 'n Direkte API-versoek loop nie die portaal se volledige towenaarvalidering vir jou nie, behou dus daardie skeiding in jou integrasie.

Produksieveldtogskepping is betaalbaar en maak nie outomaties 'n nommer versendgereed nie. Hou die veldtogomgewing konsekwent met sy handelsmerk, en hersien die fooi en toepaslike bepalings voordat jy 'n produksieveldtog skep.

Dien die veldtog-JSON in

Berei campaign.json voor met jou gekwalifiseerde waardes. R000000 beteken geen herverkoper nie; gebruik dit slegs wanneer dit die beoogde konfigurasie is. Vir die normale MultiTEL-herverkoperkonfigurasie, verkry die toegelate MultiTEL LLC-herverkoperidentifiseerder uit jou rekening se herverkoper-versameling of die portaalvoorbereidingsvloei eerder as om iemand anders se identifiseerder hard te kodeer.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  'https://api.multitel.net/tcr/v2/reseller?companyName=MultiTEL%20LLC&recordsPerPage=500'

Die volgende JSON illustreer 'n proefveldtog vir 'n toetshandelsmerk in jou besit. Vervang die handelsmerk, gebruiksgeval, herverkoper en toestemmingsteks met die waardes wat werklik vir jou toets kwalifiseer.

{
  "brandId": "B123ABC",
  "channelId": "10DLC",
  "usecase": "TRIAL",
  "subUsecases": [],
  "resellerId": "R000000",
  "description": "Trial account notices requested by users of the example application.",
  "messageFlow": "Test users explicitly select an unchecked consent box before requesting these trial notices.",
  "sample1": "Example application: your requested account notice is available. Reply STOP to stop notices.",
  "subscriberOptin": true,
  "optinKeywords": "START",
  "optinMessage": "You are subscribed to the example application's requested account notices.",
  "subscriberOptout": true,
  "optoutKeywords": "STOP",
  "optoutMessage": "You will no longer receive the example application's account notices.",
  "subscriberHelp": true,
  "helpKeywords": "HELP",
  "helpMessage": "For help with example account notices, contact support@example.invalid.",
  "embeddedLink": false,
  "embeddedPhone": false,
  "numberPool": false,
  "ageGated": false,
  "directLending": false,
  "termsAndConditions": true,
  "autoRenewal": false,
  "mnoIds": [],
  "referenceId": "your-trial-reference"
}

Stel termsAndConditions op true slegs nadat die gemagtigde persoon die toepaslike bepalings nagegaan en aanvaar het. Die voorbeeld is nie toestemming namens jou nie. Gebruik JSON-boolewaardes vir die vlae, nie aangehaalde stringe nie.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @campaign.json \
  'https://api.multitel.net/tcr/v2/campaignBuilder'

Veldtogvelde en voorwaardelike vereistes

Die gepubliseerde skema bevat sekere inkonsekwente hooflettergebruik in beskrywende tabelle. Die huidige portaalversoek gebruik subscriberOptin en subscriberOptout soos hierbo getoon. Behou daardie presiese hoofletters. Hierdie gids dek die huurdergerigte 10DLC-werkvloei; moenie aflei dat 'n ander kanaal se vereiste velde of aktiveringstappe dieselfde is nie.

Probeer dieselfde beoogde versoek veilig weer

Gebruik een Idempotency-Key vir hierdie beoogde skepping. Die sleutel is 1–128 drukbare ASCII-karakters sonder spasies en is tot die eienaarsrekening beperk. Hou die HTTP-metode, pad, navraagstring en presiese liggaamsgrepe onveranderd by 'n herpoging. 'n Herformateerde JSON-leer veroorsaak 'n konflik selfs al is sy waardes ekwivalent.

'n Aan-die-gang-duplikaat kan HTTP 409 met Retry-After teruggee; voltooide versoeke kan hulle gestoorde antwoord herspeel. 'n Gekaste fout bewys nie dat die register niks geskep het nie. Stoor campaignId, requestId en enige korrelasie-opskrifte, inspekteer die bestaande veldtog en rekonsilieer 'n gedeeltelike mislukking voordat jy 'n nuwe sleutel oorweeg.

'n Veldtog-ID is nie die finale versendopstelling nie

Die antwoord gebruik HTTP-status en direkte JSON. By suksesvolle skepping, behou campaignId en lees sy huidige toestand:

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

Die huidige portaal se produksiewerkvloei deel ook die veldtog met die boodskapdiensverskaffer en laai die handelsmerk/veldtog in die versendrekening. Dit is afsonderlike bewerkings van hierdie publieke skeppingsoproep. 'n Registerveldtog kan bestaan selfs al misluk 'n latere deel- of diensverskafferlaaistap.

Gebruik die portaal se geintegreerde produksieskeppingswerkvloei wanneer jy die gekombineerde registrasie-, deel- en diensverskafferlaaivolgorde nodig het. Vir 'n produksieveldtog wat reeds direk deur hierdie API geskep is, behou sy veldtog-ID en laat die rekening se diensverskafferopstelling deur ondersteuning rekonsilieer. Die huidige klantkoppelvlak stel nie 'n algemene hervatknoppie vir elke direk geskepte produksieveldtog beskikbaar nie. Moenie nog 'n registrasie skep om sy aktivering weer te probeer nie. Bevestig dat die veldtog aktief is en die diensverskafferopstelling voltooi is voor die toewysing van 'n versendnommer. Die nommer moet ook in jou besit, aktief en SMS-geaktiveer wees. Veldtogskepping stuur nie boodskappe nie.

Produksieveldtoggelde

Hierdie kleinhandelbedrae is op 24 Oktober 2026 teen die huidige portaalopstelling gekontroleer. Bevestig die huidige gekwalifiseerde gebruiksgeval en vertoonde prys voor 'n produksie-indiening. 'n monthlyFee in 'n registerkwalifikasieantwoord is nie outomaties jou MultiTEL-kleinhandelprys nie.

Die huidige portaal meld 'n minimumverbintenis van drie maande vir nie-politieke produksieveldtogte. Hersien die toepaslike bepalings en hernuwingskeuse voor bevestiging. Registrasie, nommerhuur, bykomende keuring en boodskapgebruik is afsonderlike heffings. 'n Suksesvolle skeppingsantwoord bewys nie onafhanklik dat elke fakturering- of diensverskafferaktiveringstap voltooi is nie.

Hanteer validering en gedeeltelike mislukkings

Lees HTTP-status en die teruggegewe JSON. Valideringsmislukkings kan skikkings van code/description-objekte wees; plaaslike mislukkings kan in plaas daarvan objekte met message, status en, vir sommige verwerkingsfoute, requestId wees.