Registrera en 10DLC-kampanj

Kvalificera ett varumärke innan du registrerar dess kampanj

En 10DLC-kampanj beskriver meddelandena som ett registrerat företag avser att skicka, hur mottagarna samtycker och hur de kan få hjälp eller stoppa meddelanden. Detta API skapar registerposten; att slutföra operatörsaktivering i produktion är ett separat kontokonfigurationssteg. Använd ett ägt varumärke från varumärkesregistrering, läs sedan in tillgängliga användningsfall och det valda användningsfallets aktuella krav.

Använd det aktuella kvalificeringsresultatet för att välja underanvändningsfall, behöriga nätverks-ID:n, meddelandeexempel och opt-in-/opt-out-/help-deklarationer. Kraven kan skilja sig åt mellan varumärken och nätverk. Skicka inte in exemplets identifierare och kopiera inte dess samtyckesbeskrivning för ett företag med en annan process.

Håll sandlåda och produktion åtskilda

För en sandlådeövning använder du ditt eget testvarumärke och ett aktuellt användningsfall som det kvalificerar sig för. Använd TRIAL endast när kvalificeringen erbjuder det. Portalen kontrollerar att valt varumärke och kampanjmiljö överensstämmer. En direkt API-begäran kör inte portalens fullständiga guidevalidering åt dig, så bevara den separationen i din integration.

Skapande av kampanj i produktion är debiterbart och gör inte automatiskt ett nummer klart för sändning. Håll kampanjmiljön konsekvent med dess varumärke och granska avgiften och tillämpliga villkor innan du skapar en kampanj i produktion.

Skicka in kampanj-JSON:en

Förbered campaign.json med dina kvalificerade värden. R000000 betyder ingen återförsäljare; använd det endast när det är den avsedda konfigurationen. För den normala MultiTEL-återförsäljarkonfigurationen hämtar du den tillåtna MultiTEL LLC-återförsäljaridentifieraren från ditt kontos återförsäljarsamling eller portalens förberedelseflöde i stället för att hårdkoda någon annans identifierare.

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

Följande JSON illustrerar en testkampanj för ett ägt testvarumärke. Ersätt varumärket, användningsfallet, återförsäljaren och samtyckestexten med de värden som faktiskt kvalificerar sig för ditt test.

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

Ställ in termsAndConditions på true först efter att den behöriga personen har granskat och accepterat tillämpliga villkor. Exemplet är inte samtycke för din räkning. Använd JSON-booleska värden för flaggorna, inte citerade strängar.

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'

Kampanjfält och villkorliga krav

Det publicerade schemat innehåller viss inkonsekvent versalisering i beskrivande tabeller. Den aktuella portalbegäran använder subscriberOptin och subscriberOptout såsom visas ovan. Behåll exakt den bokstavsformen. Den här guiden täcker det kundvända 10DLC-arbetsflödet; anta inte att en annan kanals obligatoriska fält eller aktiveringssteg är desamma.

Försök samma avsedda begäran igen på ett säkert sätt

Använd en Idempotency-Key för denna avsedda skapelse. Nyckeln är 1–128 utskrivbara ASCII-tecken utan blanksteg och är avgränsad till ägarkontot. Behåll HTTP-metoden, sökvägen, frågesträngen och de exakta byten i kroppen oförändrade vid ett nytt försök. En omformaterad JSON-fil står i konflikt även om dess värden är likvärdiga.

En pågående dubblett kan returnera HTTP 409 med Retry-After; slutförda begäranden kan spela upp sitt lagrade svar igen. Ett cachat fel bevisar inte att registret inte skapade något. Spara campaignId, requestId och eventuella korrelationshuvuden, inspektera befintlig kampanj och stäm av ett partiellt fel innan du överväger en ny nyckel.

Ett kampanj-ID är inte den slutliga sändningskonfigurationen

Svaret använder HTTP-status och direkt JSON. Vid lyckad skapelse behåller du campaignId och läser dess aktuella tillstånd:

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

Portalens aktuella produktionsarbetsflöde delar också kampanjen med meddelandeoperatören och läser in varumärke/kampanj i sändningskontot. Dessa är separata åtgärder från detta offentliga skapelseanrop. En registerkampanj kan finnas även om ett senare delnings- eller operatörsinläsningssteg misslyckas.

Använd portalens integrerade arbetsflöde för skapelse i produktion när du behöver den kombinerade sekvensen för registrering, delning och operatörsinläsning. För en produktionskampanj som redan har skapats direkt med detta API behåller du dess kampanj-ID och får kontots operatörskonfiguration avstämd via kundstöd. Det aktuella kundgränssnittet exponerar inte en allmän återuppta-knapp för varje direkt skapad produktionskampanj. Skapa inte en ny registrering för att försöka aktivera igen. Bekräfta att kampanjen är aktiv och att operatörskonfigurationen har slutförts innan tilldelning av ett sändningsnummer. Numret måste också vara ägt, aktivt och SMS-aktiverat. Kampanjskapelse skickar inte meddelanden.

Avgifter för kampanjer i produktion

Dessa detaljbelopp kontrollerades mot den aktuella portalkonfigurationen den 24 oktober 2026. Bekräfta det aktuella kvalificerade användningsfallet och visat pris före en inlämning i produktion. En monthlyFee i ett kvalificeringssvar från registret är inte automatiskt ditt MultiTEL-detaljpris.

Den aktuella portalen anger ett minimiåtagande på tre månader för icke-politiska produktionskampanjer. Granska tillämpliga villkor och förnyelseval innan bekräftelse. Registrering, nummerhyra, ytterligare granskning och meddelandeanvändning är separata avgifter. Ett lyckat skapelsesvar bevisar inte i sig att varje fakturerings- eller operatörsaktiveringssteg har slutförts.

Hantera validering och partiella fel

Läs HTTP-status och returnerad JSON. Valideringsfel kan vara matriser med code/description-objekt; lokala fel kan i stället vara objekt med message, status och, för vissa bearbetningsfel, requestId.