SMS sender-ID's

Een sender is de from die een ontvanger op je SMS ziet. Je werkruimte bevat één sender per identiteit waarmee je kunt versturen, en elk bestemmingsland bepaalt welke soorten sender het accepteert en wat het eerst geregistreerd wil hebben. Een sender bezitten is niet hetzelfde als er vanaf mogen versturen: het zijn twee aparte stappen, en deze gids behandelt beide.

Senders staan op de Senders-pagina, één rij per sender, met de status en hoeveel bestemmingen actief, in behandeling of aandacht nodig zijn. De verstuuroproep zelf, inclusief hoe een from-waarde wordt gevalideerd, staat in SMS versturen.

Sendertypen

Het sender_type van een sender is het soort identiteit dat het vertegenwoordigt, en het bepaalt wat elk land ervan vraagt:

Alfanumeriek sender-ID: een korte merkstring zoals BIRD, 3 tot 11 ASCII-letters, cijfers, spaties, koppeltekens, underscores of punten, met ten minste één letter. Spaties, koppeltekens, underscores en punten mogen niet het eerste of laatste teken zijn. Ontvangers zien je naam in plaats van een nummer en kunnen er niet op antwoorden. Veel landen willen dat het geregistreerd is voordat er verkeer over gaat, en sommige, waaronder de Verenigde Staten, accepteren er helemaal geen. Je claimt dit type zelf.
Long code: een gewoon nummer dat je bezit en waarmee je kunt versturen en ontvangen. Een Amerikaans long code heeft een geregistreerd merk en een campagne nodig voordat het application-to-person-verkeer mag dragen; zie 10DLC-registratie.
Gratis nummer: een nummer waarvoor de gebelde partij betaalt en dat in Noord-Amerika ook berichten kan dragen. Versturen vanaf zo'n nummer vereist dat je eerst de toll-free-verificatie afrondt.
Short code: een kort nationaal nummer voor een goedgekeurd berichtenprogramma, waarvan de lengte en doorvoer worden bepaald door de markt en het carrierprogramma. Bird wijst short codes toe in plaats van ze te verkopen, dus dit type is niet self-serve.

Een sender meldt ook source_kind, dat aangeeft wat erachter zit: alpha voor een senderstring die je hebt geclaimd, number voor een dedicated nummer dat je bezit, en shared_number voor een door Bird beheerd nummer waarmee je werkruimte verstuurt. Het dashboard labelt deze als Alphanumeric, Dedicated number en Shared number. Nummertypen behandelt hoe het eigen type van een nummer wordt gekozen, en Een nummer kopen en vrijgeven behandelt het toewijzen ervan.

Welke soorten een land accepteert en of het ze beoordeelt, verandert naarmate carriers en toezichthouders hun regels herzien. SMS-bestemmingen publiceert de actuele stand per land; lees het daar in plaats van aan te nemen dat een land zich gedraagt als zijn buren.

Een alfanumeriek sender-ID claimen

Een senderstring claimen kost niets en gaat direct in. Open op de Senders-pagina Add sender en kies Add sender ID, voer vervolgens de string in. Via de API:

Codevoorbeeld

bird sms senders create --type alpha --sender BIRD

Het antwoord bevat de id van de nieuwe afzender, met het voorvoegsel snd_, en elke andere bewerking in deze handleiding gebruikt dat id. Een geslaagde claim kan versturen waar registratie afwezig of optioneel is, zodra die bestemmingen zijn ingeschakeld. Verplichte registratie moet eerst zijn goedgekeurd.

Twee weigeringen komen hier voor. Een 412 betekent dat je organisatie de identiteitsverificatie die deze bewerking vereist niet heeft afgerond: voltooi die in Identity Center en probeer het opnieuw. Een 409 betekent dat de senderstring al geclaimd is.

alpha is het enige type dat deze oproep aanmaakt. Een dedicated nummer wordt een sender wanneer je het uit de voorraad toewijst, dus bij aankoop van het nummer krijg je de sender erbij. Short codes en gedeelde nummers bereiken een werkruimte via toewijzing door Bird in plaats van via aankoop.

Controleren wat een land vereist

Eén leesbewerking beantwoordt wat elk land van een sender vraagt. Het retourneert één rij per land dat de sender kan bereiken, en elke rij is op zichzelf compleet:

Codevoorbeeld

bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL

Laat --country-code weg voor elk land dat relevant is voor de sender. Een leeg gefilterd resultaat betekent dat de sender geen route naar dat land heeft.

Lees zes velden op een rij voordat je verstuurt:

registration_mode is none, optional of required. none vereist geen landregistratie. In combinatie met een overwritten afzender-ID is registratie niet beschikbaar. Oudere expliciete registraties kunnen nog worden vastgelegd voor none-beleid met unknown- of preserved-gedrag, maar ze blokkeren het versturen nooit. optional laat de afzender blijven versturen terwijl je registreert. required blokkeert het versturen tot goedkeuring.
program identificeert de registratiestroom wanneer het land er een benoemt, zoals alpha of numeric. Het kan null zijn wanneer geen benoemd programma van toepassing is.
sender_id_behavior is unknown, preserved of overwritten. Het is onafhankelijk van registration_mode: een verplichte registratie kan het afzender-ID na goedkeuring nog steeds overschrijven. Optionele registratie rapporteert overwritten vóór goedkeuring en preserved na goedkeuring voor de goedgekeurde berichtcategorieën.
status geeft aan waar de afzender staat in het registratieprogramma van het land. Bij required-modus wacht het versturen op approved. Bij optional-modus volgt de status het registratiewerk, maar blokkeert het versturen niet. Registratiestatussen vermeldt elke waarde.
destination_enabled geeft aan of je werkruimte dat land heeft ingeschakeld. Dit is een werkruimte-instelling en heeft niets met de afzender te maken. Het wordt als eerste gecontroleerd, dus een volledig goedgekeurde registratie weigert berichten zolang de bestemming uitstaat. Schakel landen in onder Destinations; Versturen van SMS behandelt de allowlist.
next vermeldt wat dat land vooruithelpt, op volgorde. Een lege lijst betekent dat er niets uitstaat. Elke vermelding noemt één actie en zegt waarom die de moeite waard is, zodat een land dat door een provider wordt beoordeeld de te lezen bron noemt in plaats van een uitspraak te herhalen die die bron bezit.

Rijen bevatten ook timeline_min_days en timeline_max_days, de kortste en langste tijd die de goedkeuring van een land doorgaans kost in werkdagen, en null als het land geen schatting publiceert. Als een registratie is geweigerd, geeft rejection_reason aan waarom.

Dezelfde informatie staat op de detailpagina van elke sender in het dashboard, als een Destinations-tabel met een kolom Status, Country en Category. Een land dat je niet hebt ingeschakeld en waarvoor je niet hebt geregistreerd, staat niet in die tabel, omdat daar niets uitstaat.

Een sender registreren voor een land

Registratie is per land, en de oproep neemt de sender en het land samen:

Codevoorbeeld

bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing

--category beperkt de registratie tot een van transactional, marketing, authentication of service. Laat het weg om voor elke categorie te registreren. Het dashboard voert dezelfde oproep uit via de knop Register op de landrij van de sender.

Wat er daarna gebeurt hangt af van het land. Als het land registraties beoordeelt, komt het record terug als pending en er wordt nog niets in rekening gebracht. Als het land niets beoordeelt, wordt de registratie bij deze oproep goedgekeurd. Een nummer registreren is gratis; een geprijsd alfanumeriek sender-ID brengt eenmalige kosten en maandelijks terugkerende kosten met zich mee, gefactureerd op het moment dat de registratie wordt goedgekeurd, dus een beoordeelde registratie wordt ongefactureerd aangemaakt. Noch deze oproep, noch de vereistenlezing noemt een prijs, dus vraag de accounteigenaar wat een registratie kost voordat je er een aanmaakt.

Als een programma je antwoorden als formulier verzamelt, blijft de registratie op pending staan totdat je het invult. De landrij van de sender biedt dan Complete aan, waarmee de vragen worden geopend die het programma stelt over je bedrijf en je berichten.

Vier weigeringen om af te handelen:

Antwoord	Wat het betekent
402	De wallet had onvoldoende saldo toen de facturering liep. Vul het saldo aan en probeer het opnieuw.
409	Er bestaat al een registratie voor dit land in een andere status dan afgewezen of opgeschort, inclusief een registratie die nog pending review is. Status alleen bepaalt niet of de afzender kan versturen: controleer registration_mode, destination_enabled en of de registratie de berichtcategorie dekt.
412	Je organisatie heeft een openstaande identiteitsverificatie-eis. Rond deze af in Identity Center en probeer het opnieuw.
422	De afzender valt onder een programma met een eigen traject, zoals US 10DLC, toll-free-verificatie of een short code. Zie Programma's met een eigen traject.

Een geweigerde registratie wordt opnieuw ingediend en een opgeschorte wordt gereactiveerd door dezelfde bewerking nogmaals aan te roepen in plaats van een aparte bewerking te gebruiken.

Registratiestatussen

Een landregistratie doorloopt de onderstaande statussen. Het dashboard toont elke status als een label op de rij van de sender:

Status	Wat het betekent en wat je moet doen
registration_required	De registration_mode van het land is required en er is geen registratie gestart. Registreer de afzender voor het land.
pending	Het registratiewerk is gestart. Wanneer het programma een formulier vraagt, rond je het af via Complete op de rij van het land.
under_review	Ingediende informatie wordt beoordeeld of moet worden aangepast. De program_ref van de rij verwijst naar de eigen bron van het programma, de enige plek waar een lopende beoordeling te onderscheiden is van een beoordeling die op jou wacht.
bird_approved	De beoordeling van Bird is geslaagd en goedkeuring door de provider staat nog uit. Er wordt niets van je gevraagd.
carrier_pending	Ingediend bij de goedkeurende provider of het register. Er wordt niets van je gevraagd.
approved	Registratie goedgekeurd.
rejected	De registratie is geweigerd. Lees rejection_reason, corrigeer het en registreer opnieuw via Resubmit.
suspended	Een eerder actieve registratie is opgeschort. Registreer opnieuw via Register again om deze te heractiveren.
not_required	Geen actieve registratie blokkeert het versturen. Controleer registration_mode en sender_id_behavior: none vereist geen landregistratie en maakt deze onbeschikbaar wanneer het afzender-ID wordt overschreven; optional biedt registratie aan zonder verkeer te blokkeren.

Er worden nieuwe statussen toegevoegd naarmate registratieprogramma's veranderen. Behandel een onbekende waarde als een waarde die je code nog niet afhandelt in plaats van als een fout, en lees de next van de rij voor wat je aan het land moet doen.

Sommige programma's openen meerdere landen met één registratie, dus een enkele toll-free-verificatie of campagneregistratie kan meerdere bestemmingen mogelijk maken.

Senderstatus en vervolgacties

De eigen status van een sender dekt wat de sender bezit, en dat is een andere vraag dan of een bepaald land een bericht accepteert:

active: er staat niets open voor deze sender. Een sender die nergens geregistreerd is, geeft active terug, zelfs als elk land dat hij kan bereiken een registratie vereist.
pending_number_ownership: het bewijs dat je het nummer van deze sender bezit is niet in orde, hetzij omdat het niet is aangeleverd, hetzij omdat het land dat het nummer heeft uitgegeven het nog niet heeft geaccepteerd. Elke verzending vanaf deze sender wordt geweigerd totdat dit is afgehandeld. Nummersoverzicht behandelt die levenscyclus.
pending_registrations: de sender heeft landregistraties en geen daarvan is al goedgekeurd. Dit omvat een registratie die in behandeling is en een die geweigerd is; lees next om te zien welke het is.

Daarnaast groepeert destinations de landen waarvoor de sender is ingesteld op basis van wie de volgende stap moet zetten, en de Senders-lijst toont de drie groepen als kolommen:

"Active": landen waarnaar je vandaag kunt versturen, ingeschakeld in je bestemmingsinstellingen en ofwel geen verplichte registratie vereisend, ofwel met een goedgekeurde registratie. Een optionele registratie kan nog in behandeling zijn terwijl het versturen beschikbaar blijft met een overschreven afzender-ID.
"Pending": landen waarvan de registratie loopt en wacht op Bird of op een carrier. Er wordt niets van je gevraagd; deze gaan naar "Active" bij goedkeuring.
"Needs attention": landen waarvoor je geregistreerd bent die niet werken en op jou wachten, omdat de registratie geweigerd of ingetrokken is, of omdat de registratie is goedgekeurd terwijl de bestemming uit staat.

Deze drie groepen dekken alleen landen waarvoor je een registratie hebt, dus een land waarvoor je je zou kunnen registreren maar dat niet hebt gedaan, verschijnt in geen van drieën. Lees voor alles wat de sender kan bereiken en wat elk land zou vereisen wat een land vereist.

Een senderlezing die vervolgacties berekent, retourneert ze in next, hetzelfde routeringsveld dat de vereistenrijen bevatten. Een sender kent alleen zichzelf, dus waar het werk per land is, noemt hij de vereistenlezing in plaats van te raden welk land je bedoelde.

Programma's met een eigen traject

Het program van een land noemt het registratieschema dat het hanteert voor een sendertype. Twee daarvan worden beantwoord door de registratie-oproep in deze gids, en drie hebben een eigen traject:

Programma	Waar het op van toepassing is	Waar het gebeurt
alpha	een alfanumeriek sender-ID	Een afzender registreren voor een land, plus het formulier dat het land vraagt
numeric	een long code	Een afzender registreren voor een land, plus het formulier dat het land vraagt
10dlc	een Amerikaans long code	Registreer een merk en campagne en koppel het nummer: 10DLC-registratie
tfn	een Amerikaans gratis nummer	Tolvrij-verificatie, op de pagina Toll-free verifications
short_code	een short code	Bird beheert de aanvraag; je hoeft niets te doen tenzij deze is afgewezen, in welk geval de next van de rij je naar support verwijst

De registratie-aanroep voor een afzender die onder 10dlc, tfn of short_code valt, retourneert 422. Gebruik in plaats daarvan het programma.

Toll-free-verificatie begint als een concept dat je in een of meer updates invult en vervolgens indient ter beoordeling door de carrier. Het doorloopt draft, submitted, under_review, info_requested, approved en rejected. Een verificatie op info_requested kan worden bewerkt en opnieuw ingediend; een afgewezen verificatie kan opnieuw worden ingediend zolang het herindienervenster open is. Indienen draagt het dossier over aan de carrier ter beoordeling, dus een persoon autoriseert die stap: de CLI en de MCP-server van Bird kunnen een verificatie opstellen en corrigeren, en het indienen zelf gebeurt in het dashboard.

Stoppen met versturen vanaf een sender

Drie afbouwopties verschillen in wat ze behouden, en alle drie zijn dashboardacties op de detailpagina van de sender. Eenmalige kosten die al in rekening zijn gebracht, worden door geen van drieën terugbetaald:

Actie	Wat het doet
Een land deregistreren	Annuleert de terugkerende kosten en behoudt de registratie. Dat land opnieuw registreren hervat dezelfde registratie zonder de eenmalige kosten nogmaals te betalen. Als het land een registratie vereist, stoppen verzendingen daarheen; als registratie optioneel is, gaan verzendingen door, omdat de registratie ze nooit blokkeerde.
Een registratie verwijderen	Verwijdert de landregistratie volledig, annuleert de terugkerende kosten en stopt met het tonen van de bestemming voor de sender. Dat land opnieuw registreren is een nieuwe registratie en brengt de eenmalige kosten opnieuw in rekening.
De sender verwijderen	Geeft een alfanumerieke sender vrij. Elke landregistratie erop wordt verwijderd, de terugkerende kosten worden geannuleerd en de sender wordt onbruikbaar. Dezelfde string later opnieuw claimen maakt een nieuwe sender aan met nieuwe registraties en brengt de eenmalige kosten opnieuw in rekening.

Een sender die aan een nummer gekoppeld is, wordt hier niet verwijderd: geef in plaats daarvan het dedicated nummer vrij, waarmee de bijbehorende sender ook wordt afgebroken. Een sender op een door Bird beheerd gedeeld nummer kan niet worden verwijderd.

Een 10DLC- of toll-free-rij wordt ongedaan gemaakt via het eigen programma, door de campagne los te koppelen of de verificatie te annuleren, in plaats van door te deregistreren.

Vervolgstappen

Vergelijk SMS-nummers en sender-ID's, of bekijk senderregistratie voor je uitrol.

Pagina	Wat het behandelt
SMS versturen	De verstuuroproep, de from-formaten die het accepteert, en de bestemmingsallowlist
10DLC-registratie	Het merk-, campagne- en nummermodel achter US A2P-verzending
Nummertypen	Kiezen tussen mobiele, lokale, nationale, gratis en short-code-nummers
SMS-bestemmingen	Welke sendersoorten elk land accepteert en welke registratie nodig hebben
Opt-outs en trefwoorden	De trefwoordantwoorden die een sender moet respecteren en de onderdrukkingen die ze creëren

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsRegistering your SMS sender ID Begrijp het conceptWhat is sender ID registration, and why do some countries require it?Ontdek de mogelijkheidSMS sender IDs Volg het leerpadBuild your first integration

Ontvang een implementatieoverzicht