# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/10dlc). - **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](/docs/guides/numbers/number-types) behandelt hoe het eigen type van een nummer wordt gekozen, en [Een nummer kopen en vrijgeven](/docs/guides/numbers/buying-numbers) behandelt het toewijzen ervan. Welke soorten een land accepteert en of het ze beoordeelt, verandert naarmate carriers en toezichthouders hun regels herzien. [SMS-bestemmingen](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders)-pagina **Add sender** en kies **Add sender ID**, voer vervolgens de string in. Via de API: ```cli 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**](https://bird.com/dashboard/w/trust) 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: ```cli 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](#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**](https://bird.com/dashboard/w/sms/destinations); [Versturen van SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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: ```cli 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**](https://bird.com/dashboard/w/trust) 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](#programmas-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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#controleren-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](#een-sender-registreren-voor-een-land), plus het formulier dat het land vraagt | | `numeric` | een long code | [Een afzender registreren voor een land](#een-sender-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](/docs/guides/sms/10dlc) | | `tfn` | een Amerikaans gratis nummer | Tolvrij-verificatie, op de pagina [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers), of bekijk [senderregistratie](/products/sms/compliance/sender-id-registration) voor je uitrol. | Pagina | Wat het behandelt | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [SMS versturen](/docs/guides/sms/sending-sms) | De verstuuroproep, de `from`-formaten die het accepteert, en de bestemmingsallowlist | | [10DLC-registratie](/docs/guides/sms/10dlc) | Het merk-, campagne- en nummermodel achter US A2P-verzending | | [Nummertypen](/docs/guides/numbers/number-types) | Kiezen tussen mobiele, lokale, nationale, gratis en short-code-nummers | | [SMS-bestemmingen](/products/sms/destinations) | Welke sendersoorten elk land accepteert en welke registratie nodig hebben | | [Opt-outs en trefwoorden](/docs/guides/sms/opt-outs-and-keywords) | De trefwoordantwoorden die een sender moet respecteren en de onderdrukkingen die ze creëren | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [SMS sender IDs](/sms-api/features/compliance/sender-id-registration) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)