Региструјте 10DLC кампању

Квалификујте бренд пре регистрације његове кампање

Кампања 10DLC описује поруке које регистровано предузеће намерава да шаље, начин на који примаоци дају сагласност и како могу да добију помоћ или зауставе поруке. Овај API креира запис у регистру; довршавање активирања код оператора у продукцији је посебан корак подешавања налога. Користите бренд у свом власништву из регистрације бренда, затим учитајте његове доступне случајеве коришћења и, за изабрани случај коришћења, тренутне захтеве.

Користите тренутни резултат квалификације да изаберете под-случајеве коришћења, прихватљиве ИД-јеве мреже, узорке порука и декларације о пријави/одјави/помоћи. Захтеви се могу разликовати по бренду и мрежи. Немојте подносити идентификаторе из примера нити копирати опис сагласности за предузеће са другачијим процесом.

Држите тестно и продукционо окружење одвојено

За вежбу у тестном окружењу користите сопствени пробни бренд и тренутни случај коришћења за који се он квалификује. Користите TRIAL само када га та квалификација нуди. Портал проверава да ли се изабрани бренд и окружење кампање слажу. Директан API захтев не извршава за вас потпуну валидацију чаробњака портала, па сачувајте то раздвајање у својој интеграцији.

Креирање продукционе кампање се наплаћује и не чини аутоматски број спремним за слање. Одржавајте окружење кампање у складу са њеним брендом и прегледајте накнаду и важеће услове пре креирања кампање уживо.

Поднесите JSON кампање

Припремите campaign.json са својим квалификованим вредностима. R000000 значи без препродавца; користите га само када је то предвиђена конфигурација. За уобичајену MultiTEL конфигурацију препродавца, прибавите дозвољени идентификатор препродавца MultiTEL LLC из колекције препродаваца свог налога или из тока припреме портала, уместо да чврсто кодирате туђи идентификатор.

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

Следећи JSON илуструје пробну кампању за пробни бренд у власништву. Замените бренд, случај коришћења, препродавца и текст сагласности вредностима које се заиста квалификују за ваш тест.

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

Поставите termsAndConditions на true тек након што овлашћено лице прегледа и прихвати важеће услове. Пример није сагласност у ваше име. За заставице користите JSON логичке вредности, а не ниске под наводницима.

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'

Поља кампање и условни захтеви

Објављена шема садржи извесне недоследности у писању великих слова у описним табелама. Тренутни захтев портала користи subscriberOptin и subscriberOptout као што је горе приказано. Задржите тачно та слова. Ово упутство покрива 10DLC ток за закупце; немојте закључивати да су обавезна поља или кораци активирања другог канала исти.

Безбедно поновите исти предвиђени захтев

Користите један Idempotency-Key за ово предвиђено креирање. Кључ има 1–128 штампаних ASCII знакова без размака и везан је за налог власника. При понављању задржите непромењеним HTTP метод, путању, ниску упита и тачне бајте тела. Реформатирана JSON датотека је у сукобу чак и ако су јој вредности еквивалентне.

Дупликат у току може вратити HTTP 409 са Retry-After; довршени захтеви могу поново емитовати сачувани одговор. Кеширана грешка не доказује да регистар није ништа креирао. Сачувајте campaignId, requestId и сва заглавља корелације, прегледајте постојећу кампању и усагласите делимични неуспех пре него што размотрите нови кључ.

ИД кампање није коначно подешавање слања

Одговор користи HTTP статус и директан JSON. Након успешног креирања, сачувајте campaignId и прочитајте његово тренутно стање:

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

Тренутни продукциони ток портала такође дели кампању са оператором за слање порука и учитава бренд/кампању у налог за слање. То су одвојене операције од овог јавног позива за креирање. Кампања у регистру може постојати чак и ако каснији корак дељења или учитавања код оператора не успе.

Користите интегрисани продукциони ток креирања портала када вам треба комбинована секвенца регистрације, дељења и учитавања код оператора. За продукциону кампању коју је овај API већ директно креирао, задржите њен ИД кампање и усагласите подешавање оператора налога преко подршке. Тренутни кориснички интерфејс не нуди опште дугме за наставак за сваку директно креирану продукциону кампању. Немојте креирати другу регистрацију да бисте поново покушали њену активацију. Потврдите да је кампања активна и да је подешавање оператора завршено пре додељивања броја за слање. Број такође мора бити у власништву, активан и омогућен за SMS. Креирање кампање не шаље поруке.

Накнаде за продукционе кампање

Ови малопродајни износи проверени су према тренутној конфигурацији портала 24. октобра 2026. Потврдите тренутни квалификовани случај коришћења и приказану цену пре продукционог подношења. monthlyFee у одговору квалификације регистра није аутоматски ваша MultiTEL малопродајна цена.

Тренутни портал наводи тромесечну минималну обавезу за неполитичке продукционе кампање. Прегледајте важеће услове и избор обнављања пре потврде. Регистрација, закуп броја, додатна провера и коришћење порука су одвојене наплате. Успешан одговор о креирању не доказује самостално да је сваки корак наплате или активирања код оператора завршен.

Обрадите валидацију и делимичне неуспехе

Прочитајте HTTP status и враћени JSON. Неуспеси валидације могу бити низови објеката code/description; локални неуспеси могу уместо тога бити објекти са message, status и, за неке грешке обраде, requestId.