Sign inGet Started

10DLC-registratie

Amerikaanse providers leveren zakelijke sms-berichten vanaf een lokaal nummer (een 10-digit long code, of 10DLC) pas af als het bedrijf en zijn use case zijn geregistreerd bij The Campaign Registry (TCR). Je vult de registratie in het Bird-dashboard in, en wij dienen die in bij TCR en volgen de uitkomst op. Open SMS > 10DLC om te beginnen.

What is A2P 10DLC registration? legt uit waarom het programma bestaat. Wil je registreren vanuit een terminal of via een agent, zie dan Registreren vanuit de CLI of een agent.

Hoe registratie werkt

Je registreert drie records, in deze volgorde:

RecordWat het beschrijftWie het beoordeeltWijzigingen na goedkeuring
MerkJe bedrijf: juridische naam, belastingnummer, adres en websiteTCR, aan de hand van overheidsregistersSommige velden; zie Een geregistreerd merk of een geregistreerde campagne wijzigen
CampagneEén soort bericht dat je verstuurt, zoals accountmeldingen, en hoe mensen zich aanmeldenTCR en de providersGeen. Maak in plaats daarvan een nieuwe campagne aan.
NummerEen Amerikaans lang nummer waarvandaan je verstuurt, gekoppeld aan één campagneDe providers bevestigen elk gekoppeld nummerOntkoppel het en koppel het aan een andere campagne

Eén merk kan meerdere campagnes hebben. Je kunt een nummer koppelen terwijl de campagne nog in behandeling is, maar het nummer kan pas naar Amerikaanse ontvangers versturen als de campagne is goedgekeurd en de providers het nummer bevestigen.

Wat registratie kost

Het betaalvenster toont het exacte bedrag voordat je elke betaling bevestigt. De actuele prijzen staan op 10DLC-kosten.

KostenWanneer je het betaalt
Registratiekosten voor het merkTelkens wanneer je een merk indient, ook bij elke herindiening
Vettingkosten voor de campagneTelkens wanneer je een campagne indient, ook bij elke herindiening. Deze kosten worden niet terugbetaald als de campagne wordt afgewezen.
CampagneabonnementDe prijs geldt per maand. De facturering begint wanneer je de campagne indient, vóór de goedkeuring, en loopt door tot je de campagne verwijdert.
Vettingkosten voor het merkEenmaal per vettingaanvraag, met een prijs per vettingtype

Een nummer aan een campagne koppelen en een goedgekeurd merk bewerken is gratis.

Voordat je begint

Je identiteit verifiëren

Je organisatie moet haar identiteit verifiëren in Identity Center voordat ze een merk kan registreren of opnieuw kan indienen. Met deze controle stellen wij vast wie je bent, en die vindt plaats voordat TCR het merk beoordeelt.

Als de verificatie nog niet is afgerond, openen Register brand en Resubmit niet het formulier maar Verify your identity first, met de stappen die je nog moet doen. Staat er Your organization is under review of Not available for your organization, neem dan contact op met support.

Log in met een e-mailadres op het domein van je website

Het Contact email van het merk is het adres waarmee je inlogt bij Bird, en je kunt het in het formulier niet wijzigen. Dat adres moet op het hoofddomein van je website staan:

WebsiteE-mailadres om in te loggenGeaccepteerd
acme.comyou@acme.comJa
shop.acme.comyou@acme.comJa, acme.com is het hoofddomein
acme.comyou@mail.acme.comNee, het adres staat op een subdomein
acme.comyou@gmail.comNee, gratis e-mailproviders worden niet geaccepteerd

Komt je inlogadres niet overeen, dan kan een teamgenoot die inlogt met een adres op het domein van je website het merk registreren.

Je bedrijfsgegevens verzamelen

TCR controleert je juridische naam en belastingnummer aan de hand van overheidsregisters. Als die niet overeenkomen, is dat de meest voorkomende reden dat een merk wordt afgewezen, dus neem beide exact over uit je officiële documenten. Voor een Amerikaans bedrijf is dat je IRS-brief CP 575 of 147C.

Elk merk heeft deze gegevens nodig:

VeldWat je invult
Legal company nameDe naam in je belastinggegevens, precies zoals die daar staat
BelastingnummerVoor een Amerikaans bedrijf het Employer Identification Number (EIN) van negen cijfers, zoals 12-3456789. Voor een Canadees bedrijf de eerste negen cijfers van je Business Number (BN9).
Tax ID countryHet land dat het belastingnummer heeft uitgegeven
AdresJe geregistreerde straat, plaats, postcode, staat of regio en land. Een Amerikaans adres heeft een staatcode van twee letters en een ZIP-code nodig. Amerikaanse territoria kunnen niet worden geregistreerd.
Brand nameDe naam waaronder je klanten je kennen
WebsiteEen actieve website die begint met http:// of https:// en beschrijft wat je bedrijf doet
VerticalJe branche
Support phoneEen telefoonnummer waarop ontvangers en providers je kunnen bereiken

Een beursgenoteerde onderneming heeft ook een Stock symbol, Stock exchange en een Business contact email nodig. Ze moet ook slagen voor Auth+-vetting voordat ze een campagne kan aanmaken; zie Vetting aanvragen.

Je kunt ook een Alternative business ID (optional) invullen: een DUNS-nummer, GIIN of LEI.

Je kunt een private onderneming, beursgenoteerde onderneming, non-profit of overheidsentiteit registreren. Een eenmanszaak kun je niet als merk registreren.

Je merk registreren

  1. Open SMS > 10DLC en kies Register brand.

    De 10DLC-pagina in het Bird-dashboard met het tabblad Brands geselecteerd, met een goedgekeurd merk Goldcrest en een knop Register brand.

  2. Kies onder What kind of organization are you? de optie Private company, Public company, Non-profit of Government.

  3. Vul onder Your organization je juridische naam, belastingnummer, land van het belastingnummer en adres in, precies zoals ze in je belastingregisters staan. Vul voor een beursgenoteerde onderneming ook de aandelengegevens en het zakelijke contacte-mailadres in, en zet Request Auth+ vetting automatically aan. Wij bestellen Auth+ dan zodra TCR het merk goedkeurt.

    De stap Your organization van het merkformulier, ingevuld met een juridische bedrijfsnaam, een EIN, de Verenigde Staten als land van het belastingnummer en een adres in San Francisco.

  4. Vul onder Your public presence je merknaam, website en branche in.

  5. Vul onder Contact je supporttelefoonnummer in. Het contacte-mailadres is al ingevuld met het adres waarmee je inlogt.

  6. Controleer in Review registration je antwoorden en eventuele problemen die de automatische controle toont, en kies daarna Register brand.

  7. Bevestig de registratiekosten voor het merk in het betaalvenster.

Het merk verschijnt op het tabblad Brands als Pending.

Statussen van merken

StatusBetekenisWat je doet
PendingTCR beoordeelt het merkWacht op het resultaat. Onder een merk in behandeling kun je geen campagne aanmaken.
ApprovedTCR heeft het merk geverifieerdMaak een campagne aan. Een beursgenoteerde onderneming heeft eerst actieve Auth+-vetting nodig.
RejectedTCR kon het merk niet verifiërenOpen het merk om de reden te lezen en dien het daarna opnieuw in. Zie Een afgewezen merk of campagne corrigeren.

Een campagne aanmaken

Een campagne vertelt providers wat één soort verkeer bevat en hoe de ontvangers ermee hebben ingestemd om het te ontvangen. Je hebt eerst een goedgekeurd merk nodig.

  1. Open in SMS > 10DLC het tabblad Campaigns en kies Create campaign.

  2. Kies onder What are you messaging about? het merk en de use case. Je kunt de use case later niet wijzigen; zie Een use case kiezen.

    De use-casestap van het campagneformulier, met het merk Goldcrest geselecteerd en Customer Care gekozen als use case.

  3. Vul onder Campaign details een naam, een beschrijving en de berichtstroom in, kies waar ontvangers zich aanmelden (opt-in) en voeg voorbeeldberichten toe. Melden ontvangers zich aan op een plek die beoordelaars niet kunnen openen, voeg dan een screenshot of foto toe waarop te zien is hoe ze zich aanmelden.

  4. Selecteer onder What's in your messages? elke optie die van toepassing is: links, telefoonnummers, content met leeftijdsgrens of directe kredietverlening.

  5. Vul onder Opt-in, opt-out and help de trefwoorden in en het antwoord dat mensen krijgen wanneer ze zich aanmelden, STOP sms'en of HELP sms'en.

    De stap voor opt-in, opt-out en help van het campagneformulier, met alle drie de vakjes aangevinkt, START als opt-in-trefwoord en een antwoordbericht bij opt-in.

  6. Wacht in Review campaign tot de automatische controle klaar is. Elke fout of waarschuwing in de lijst beschrijft het probleem, en Fix brengt je naar het veld. Kies daarna Create campaign.

  7. Bevestig de vettingkosten voor de campagne en het campagneabonnement in het betaalvenster.

Staan er bij het indienen nog fouten in de lijst, dan vraagt het dashboard je te bevestigen met Submit anyway. Elke indiening wordt in rekening gebracht, dus los de fouten eerst op.

De campagne verschijnt op het tabblad Campaigns als Pending.

Een use case kiezen

De use case vertelt providers wat voor berichten de campagne verstuurt, zoals Two Factor Authentication, Account Notification, Customer Care of Marketing. Kies de use case die bij je echte berichten past. Je kunt deze niet meer wijzigen nadat je de campagne hebt aangemaakt. Veranderen je berichten, maak dan een nieuwe campagne aan.

Voor sommige use cases gelden extra vereisten:

  • Mixed en Low Volume hebben twee tot vijf sub-use-cases nodig.
  • Political vereist een merk dat een non-profit is.
  • M2M (machine-to-machine) hoeft geen opt-in, opt-out of help te ondersteunen.

Een campagne schrijven die providers goedkeuren

Providers wijzen campagnes af die vaag zijn of niet overeenkomen met de berichten die je verstuurt. Zo geef je een campagne de beste kans op goedkeuring:

  • Schrijf een beschrijving en een berichtstroom van elk minstens 40 tekens. De berichtstroom vermeldt waar en hoe mensen instemmen met het ontvangen van je berichten, zoals een selectievakje op je aanmeldformulier.
  • Voeg één tot vijf voorbeeldberichten toe die op de echte berichten lijken, elk 20 tot 1.024 tekens lang. K12 Education, Marketing, Mixed, Agents Franchises, Charity, Political, Proxy en Sweepstake hebben er minstens twee nodig.
  • Ondersteun opt-in, opt-out en help, met voor elk een antwoord. De opt-out-trefwoorden moeten STOP bevatten en de help-trefwoorden moeten HELP bevatten.
  • Gebruik geen openbare linkverkorters zoals bit.ly in je berichten. Providers staan ze niet toe.
  • Melden mensen zich aan op een plek die beoordelaars niet kunnen openen, zoals in een app, achter een login, persoonlijk, telefonisch of per sms, voeg dan een screenshot of foto toe waarop te zien is hoe ze zich aanmelden. Bij een opt-in op een openbare webpagina zijn bijlagen optioneel, maar je kunt een screenshot van het formulier of een pdf van je voorwaarden toevoegen. Je kunt maximaal vijf PNG-, JPEG- of PDF-bestanden van elk maximaal 10 MB bijvoegen.

Campagnestatussen

StatusBetekenisWat je doet
PendingTCR en de providers beoordelen de campagneKoppel je nummers nu. Ze beginnen met versturen na goedkeuring.
ApprovedDe campagne kan verkeer verwerkenKoppel de nummers die je nog niet hebt gekoppeld.
RejectedDe campagne is niet door de beoordeling gekomenOpen de campagne om de reden te lezen en dien haar daarna opnieuw in. Zie Een afgewezen merk of afgewezen campagne corrigeren.
ExpiredDe registratie van de campagne is verlopen en de nummers ervan versturen niet meerMaak een nieuwe campagne aan en koppel de nummers daaraan. Een verlopen campagne kan niet opnieuw worden ingediend.
SuspendedEen provider heeft de campagne opgeschort en de nummers ervan versturen niet meerDe nummers versturen weer zodra de campagne opnieuw wordt toegelaten. Een opgeschorte campagne kan niet opnieuw worden ingediend.

Je nummers koppelen

Koppel elk Amerikaans lang nummer waarvandaan je verstuurt aan een campagne. De campagne mag de status Pending of Approved hebben.

  1. Open SMS > Senders en selecteer het nummer.
  2. Kies in het gedeelte 10DLC registration de optie Link to campaign.
  3. Kies de campagne en kies daarna Link.

Het dialoogvenster Link to a 10DLC campaign bij een Amerikaans nummer, met de campagne Account support geselecteerd en een knop Link.

Een nummer hoort steeds bij één campagne, en een campagne bevat maximaal 49 nummers. Openstaande en mislukte koppelingen tellen mee voor die 49 totdat je ze ontkoppelt, dus maak een tweede campagne aan voor meer nummers.

De tabel SMS senders van de campagne toont de status van elke koppeling:

StatusBetekenis
PendingWacht op goedkeuring van de campagne of op bevestiging door de providers. Het nummer kan nog niet naar Amerikaanse ontvangers versturen, en Senders toont het als Carrier pending.
ActiveDe providers hebben het nummer bevestigd. Het kan onder deze campagne naar Amerikaanse ontvangers versturen.
FailedDe providers hebben het nummer niet geaccepteerd voor deze campagne. Ontkoppel het en probeer het opnieuw, of koppel het aan een andere campagne.
UnlinkedHet nummer is uit de campagne verwijderd en kan aan een andere campagne worden gekoppeld.

Kies in het gedeelte 10DLC registration van het nummer de optie Unlink en bevestig met Yes, unlink om het nummer te ontkoppelen. Het nummer stopt direct met versturen naar Amerikaanse ontvangers.

Zet voordat je verstuurt ook de Verenigde Staten aan als bestemmingsland. Zie SMS versturen.

Vetting aanvragen

Vetting is een extra beoordeling van een goedgekeurd merk door een externe partij. Er zijn twee typen vetting:

  • Auth+ is verplicht voor een beursgenoteerde onderneming voordat die een campagne kan aanmaken. De partij stuurt een e-mail naar het zakelijke contacte-mailadres van het merk, en de vetting blijft in behandeling tot die persoon bevestigt. Dit duurt meestal een paar werkdagen.
  • Standard levert een score op die je doorvoer bij providers kan verhogen, dus het aantal berichten dat providers van je accepteren.

Zo vraag je vetting aan:

  1. Open een goedgekeurd merk en kies Request vetting.
  2. Kies het Vetting type en kies daarna Continue.
  3. Bevestig de vettingkosten in het betaalvenster.

Elke aanvraag verschijnt bij het merk als een eigen tabblad, zoals Standard vetting, met een tijdlijn en een Score. Eindigt een vetting op Failed of Expired, dan heb je een nieuwe aanvraag nodig.

Heb je bij het registreren Request Auth+ vetting automatically aangezet, dan verschijnt de Auth+-aanvraag zodra TCR het merk goedkeurt. De kosten worden in rekening gebracht wanneer wij de aanvraag plaatsen.

Een afgewezen merk of campagne herstellen

Open het afgewezen merk of de afgewezen campagne om te zien waarom TCR het heeft afgewezen. Bij elke reden staan de betrokken velden.

  1. Corrigeer de velden die in de redenen worden genoemd. Gaat een reden over je juridische naam of belastingnummer, vergelijk ze dan teken voor teken met je belastingdocumenten.
  2. Kies Resubmit. Het formulier opent met je eerdere antwoorden al ingevuld.
  3. Dien het formulier in en bevestig de kosten. Elke herindiening wordt in rekening gebracht als een nieuwe indiening.

Wanneer je een campagne opnieuw indient, kun je het merk, de use case, de sub-use-cases en de instellingen voor opt-in, opt-out en help niet wijzigen. Maak een nieuwe campagne aan om een van deze te wijzigen.

Wijst TCR een merk af waarvan de juridische naam, het belastingnummer en het entiteitstype al overeenkomen met je officiële registers? Neem dan contact op met de support van Bird voordat je betaalt om dezelfde gegevens opnieuw in te dienen. Vermeld de merk-ID en de reden van afwijzing. Houd je IRS-brief CP 575 of 147C bij de hand, en wacht tot support je laat weten of en hoe je die moet sturen.

Een geregistreerd merk of geregistreerde campagne wijzigen

Om een goedgekeurd merk bij te werken, open je het, kies je Edit details, breng je je wijzigingen aan en kies je Save changes. Een merk bijwerken is gratis. Het merk blijft Approved terwijl TCR de update beoordeelt, dus de campagnes ervan blijven versturen. Je kunt pas een nieuwe update starten als TCR de huidige heeft beoordeeld. Accepteert TCR de update maar kan TCR het merk niet meer verifiëren, dan wordt het merk Rejected.

De bewerkpagina toont onder Locked after approval de velden die je niet kunt wijzigen: entiteitstype, juridische naam, belastingnummer, land van het belastingnummer en, voor een beursgenoteerde onderneming, aandelensymbool, beurs en zakelijk verificatie-e-mailadres. Registreer een nieuw merk om een van deze te wijzigen.

Je kunt een campagne niet bewerken nadat je die hebt aangemaakt. Maak een nieuwe campagne aan om te wijzigen wat een campagne opgeeft. Een nummer hoort bij één campagne tegelijk en stopt met versturen naar Amerikaanse ontvangers zodra je het ontkoppelt. Wacht daarom tot de nieuwe campagne Approved is voordat je nummers ernaartoe verplaatst.

Registreren via de CLI of een agent

De bird sms 10dlc-opdrachten in de Bird CLI en de bijbehorende sms_10dlc_*-tools op de MCP-server registreren dezelfde merken, campagnes en nummerkoppelingen als het dashboard. Voor 10DLC bestaat geen openbare REST API-bewerking.

Opdrachten

  1. Lees wat de registratie nodig heeft: bird sms 10dlc brands requirements <business-entity-type> voor een merk of bird sms 10dlc campaigns requirements <use-case-category> voor een campagne.
  2. Registreer het merk met bird sms 10dlc brands create. Hiermee dien je het merk in bij TCR en worden de registratiekosten voor het merk in rekening gebracht.
  3. Maak de campagne aan met bird sms 10dlc campaigns create. Hiermee dien je de campagne in en worden de vettingkosten voor de campagne en de eerste termijn van het campagneabonnement in rekening gebracht.
  4. Koppel nummers met bird sms 10dlc campaigns numbers assign <campaign-id>.

Voeg --dry-run toe om een create-verzoek af te drukken zonder het te versturen.

Aanmelden met OAuth-inloggegevens

De opdrachten die registreren, opnieuw indienen of vetting bestellen, vereisen een OAuth-aanmelding met de scope sms_management:write. De CLI accepteert hiervoor geen API-sleutel.

  • De inloggegevens die bird auth create-org heeft opgeslagen, bevatten deze scope. Voer na een aanmelding via de terminal voor 10DLC geen bird auth login uit: een nieuwe login vervangt de inloggegevens van de aanmelding door inloggegevens met alleen de scopes waar de login om vraagt.
  • Een bestaande bird auth login of een gekoppelde MCP-client werkt als de bijbehorende toekenning de scope bevat.
  • Verwijder BIRD_API_KEY voordat je deze opdrachten uitvoert. Zolang die een API-sleutel bevat, gebruikt de CLI de sleutel in plaats van je aanmelding, en mislukt de opdracht.

Elke registratie bevestigen in een browser

Een persoon bevestigt elke merkregistratie, herindiening van een merk, vettingaanvraag, aangemaakte campagne en herindiening van een campagne in een browser voordat wij die indienen en in rekening brengen:

  • De CLI toont een reviewlink en wacht tot de persoon bevestigt.
  • Via MCP vraagt de server de client om de reviewlink voor de persoon te openen, of geeft de server direct een openstaand resultaat terug met de reviewlink en een confirmation_id. Het resultaat is beschikbaar nadat de persoon heeft bevestigd.

Agent controls beschrijft de andere grenzen aan wat een agent kan doen en uitgeven: sleutels met beperkte rechten, de SMS-landenlijst die standaard alles weigert, dagelijkse SMS-uitgavelimieten en de prepaid wallet.

Volgende stappen

  • SMS versturen: bestemmingslanden inschakelen en berichten versturen
  • SMS-afzenders: de nummers en afzender-ID's waarvandaan je verstuurt
  • 10DLC-kosten: prijzen voor merken, campagnes en vetting

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.