Registreer een 10DLC-campagne

Kwalificeer een merk voordat u de campagne registreert

Een 10DLC-campagne beschrijft de berichten die een geregistreerd bedrijf wil verzenden, hoe ontvangers toestemming geven en hoe zij hulp kunnen krijgen of berichten kunnen stoppen. Deze API creëert het registerrecord; het voltooien van productiecarrieractivering is een aparte accountconfiguratiestap. Gebruik een eigen merk uit merkregistratie, laad vervolgens de beschikbare usecases en de bij de geselecteerde usecase behorende actuele vereisten.

Gebruik het huidige kwalificatieresultaat om subusecases, in aanmerking komende netwerk-ID’s, berichtvoorbeelden en opt-in/opt-out/helpverklaringen te kiezen. Vereisten kunnen per merk en netwerk verschillen. Dien niet de ID’s uit het voorbeeld in en kopieer de toestemmingsbeschrijving niet voor een bedrijf met een ander proces.

Houd sandbox en productie gescheiden

Gebruik voor een sandboxoefening uw eigen mockmerk en een actuele usecase waarvoor het in aanmerking komt. Gebruik TRIAL alleen wanneer die kwalificatie dit aanbiedt. De portal controleert of het geselecteerde merk en de campagneomgeving overeenkomen. Een direct API-verzoek voert de volledige wizardvalidatie van de portal niet voor u uit, dus behoud die scheiding in uw integratie.

Het aanmaken van een productiecampagne is factureerbaar en maakt een nummer niet automatisch verzendklaar. Houd de campagneomgeving consistent met het merk en controleer de kosten en de toepasselijke voorwaarden voordat u een livecampagne aanmaakt.

Dien de campagne-JSON in

Bereid campaign.json voor met uw gekwalificeerde waarden. R000000 betekent geen reseller; gebruik dit alleen wanneer dat de bedoelde configuratie is. Vraag voor de normale MultiTEL-resellerconfiguratie de toegestane reseller-ID van MultiTEL LLC op via de resellerverzameling van uw account of de voorbereidingsflow van de portal, in plaats van de ID van iemand anders hard te coderen.

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

De volgende JSON illustreert een proefcampagne voor een eigen mockmerk. Vervang het merk, de usecase, de reseller en de toestemmingstekst door de waarden die daadwerkelijk voor uw test in aanmerking komen.

{
  "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 alleen in op true nadat de bevoegde persoon de toepasselijke voorwaarden heeft beoordeeld en geaccepteerd. Het voorbeeld is geen toestemming namens u. Gebruik JSON-booleans voor de vlaggen, geen tekenreeksen tussen aanhalingstekens.

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'

Campagnevelden en voorwaardelijke vereisten

Het gepubliceerde schema bevat inconsistent hoofdlettergebruik in beschrijvende tabellen. Het huidige portalverzoek gebruikt subscriberOptin en subscriberOptout zoals hierboven weergegeven. Behoud exact die schrijfwijze. Deze handleiding behandelt de tenantgerichte 10DLC-workflow; leid hieruit niet af dat de vereiste velden of activeringsstappen van een ander kanaal hetzelfde zijn.

Probeer dezelfde beoogde aanvraag veilig opnieuw

Gebruik één Idempotency-Key voor deze beoogde aanmaak. De sleutel is 1–128 afdrukbare ASCII-tekens zonder spaties en is gekoppeld aan het eigenaarsaccount. Houd de HTTP-methode, het pad, de querystring en de exacte bodybytes ongewijzigd bij een nieuwe poging. Een opnieuw geformatteerd JSON-bestand conflicteert, zelfs als de waarden gelijkwaardig zijn.

Een in behandeling zijnd duplicaat kan HTTP 409 met Retry-After retourneren; voltooide aanvragen kunnen hun opgeslagen antwoord opnieuw afspelen. Een gecachte fout bewijst niet dat het register niets heeft aangemaakt. Bewaar campaignId, requestId en eventuele correlatieheaders, inspecteer de bestaande campagne en controleer de werkelijke toestand en verhelp de verschillen die door een gedeeltelijke fout zijn ontstaan voordat u een nieuwe sleutel overweegt.

Een campagne-ID is niet de definitieve verzendconfiguratie

Het antwoord gebruikt HTTP-status en directe JSON. Bewaar bij een geslaagde aanmaak campaignId en lees de huidige status:

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

De huidige productieworkflow van de portal deelt de campagne ook met de berichtencarrier en laadt het merk/de campagne in het verzendaccount. Dat zijn aparte bewerkingen naast deze openbare aanmaakaanroep. Een registercampagne kan bestaan, zelfs als een latere deel- of carrierlaadstap mislukt.

Gebruik de geïntegreerde productieaanmaakworkflow van de portal wanneer u de gecombineerde registratie-, deel- en carrierlaadvolgorde nodig heeft. Bewaar voor een productiecampagne die al direct via deze API is aangemaakt de campagne-ID en laat de carrierconfiguratie van het account via support afstemmen. De huidige klant-UI biedt geen algemene hervatknop voor elke direct aangemaakte productiecampagne. Maak geen nieuwe registratie aan om de activering opnieuw te proberen. Bevestig dat de campagne actief is en dat de carrierconfiguratie is voltooid voordat u een verzendnummer toewijst. Het nummer moet ook in eigendom, actief en SMS-ingeschakeld zijn. Het aanmaken van een campagne verzendt geen berichten.

Kosten van productiecampagnes

Deze retailbedragen zijn op 24 oktober 2026 gecontroleerd aan de hand van de huidige portalconfiguratie. Bevestig de huidige gekwalificeerde usecase en de weergegeven prijs vóór een productie-inzending. Een monthlyFee in een registerkwalificatieantwoord is niet automatisch uw MultiTEL-retailprijs.

De huidige portal vermeldt een minimumverplichting van drie maanden voor niet-politieke productiecampagnes. Controleer de toepasselijke voorwaarden en de verlengingskeuze vóór bevestiging. Registratie, nummerhuur, aanvullende vetting en berichtgebruik zijn aparte kosten. Een geslaagd aanmaakantwoord bewijst niet zelfstandig dat elke facturerings- of carrieractiveringsstap is voltooid.

Validatie- en gedeeltelijke fouten afhandelen

Lees HTTP-status en de geretourneerde JSON. Validatiefouten kunnen arrays van code/description-objecten zijn; lokale fouten kunnen in plaats daarvan objecten zijn met message, status en, voor sommige verwerkingsfouten, requestId.