SMS API FAQ

Installeer de SDK en verstuur naar het goedgekeurde testnummer +15005550006 in ongeveer vijf minuten. U kunt een CI-check uitvoeren nog voordat u een nummer hebt ingericht.

Eén verzendendpoint, tweerichtings-inbound, nummerprovisioning (lange codes, korte codes, gratis nummers en alfanumerieke afzender-ID's), A2P 10DLC- en opt-out-compliance, directe operator-routing en afleveringsanalytics — alles op één API.

Bird bereikt meer dan 150 landen via 240+ directe operatorverbindingen, met operator-grade routeherselectie wanneer een operatorpad verslechtert.

Om applicatie-naar-persoon-verkeer naar Amerikaanse nummers te verzenden, ja. Merk- en campagneregistratie wordt afgehandeld in het dashboard en de status is opvraagbaar via de API.

Per bericht, tegen een tarief dat afhangt van het bestemmingsland en het afzendertype waarmee u verzendt. Een Amerikaanse long code en een Britse alfanumerieke afzender worden dus apart geprijsd. Tarieven worden per land gepubliceerd op de SMS-prijzenpagina.

Ja, facturering gaat per segment in plaats van per bericht. Eén segment bevat 160 GSM-7-tekens, of 70 zodra één emoji of niet-Latijns teken het hele bericht naar Unicode forceert. Langere tekst wordt gesplitst en elk segment wordt gefactureerd, dus een enkel afwijkend teken kan de kosten van een grote campagne verdubbelen.

Carrierkosten zijn per bericht en variëren per bestemming en carrier. In de VS brengt 10DLC ook registratiekosten voor merk en campagne met zich mee. Beide staan vermeld op de pagina met SMS-carrierkosten.

Het SMS-logboek toont het aantal segmenten en de kosten per individueel bericht zodra het geprijsd is; SMS-statistieken aggregeren geaccepteerd volume, segmenten en uitgaven over tijd.

Een GSM-7-bericht past 160 tekens per segment; overschakelen naar Unicode (UCS-2) voor emoji of niet-Latijnse schriften verlaagt dat naar 70. Langere berichten worden samengevoegd over segmenten, en de SDK meldt het aantal voordat u verzendt.

Twaalf segmenten, wat ruwweg 1.836 GSM-7-tekens of 804 Unicode-tekens is. Bird kapt nooit af: een body boven de limiet komt terug als een 422. De limiet telt segmenten in plaats van tekens, juist omdat de twee coderingen verschillende hoeveelheden bevatten.

Maximaal 100 in een batchaanroep, elk met een eigen ontvanger en tekst. Een enkel bericht gaat naar precies één ontvanger, dus een batch is hoe u uitwaaiert.

Een gratis-tier sleutel krijgt 10 enkele verzendingen en 5 batchaanroepen per minuut, en betaalde abonnementen verhogen beide. Elke respons bevat een IETF RateLimit-header die aangeeft wat er over is en wanneer het venster reset, dus stuur daarop in plaats van op een hardgecodeerd getal.

Dat wordt bepaald door de operators, niet door Bird. Een geregistreerde 10DLC lange code krijgt doorvoer op basis van de vertrouwensscore van het merk en het campagnetype: meer dan een ongeregistreerd nummer, minder dan een korte code. Korte codes krijgen het hoogste, meest voorspelbare tarief.

Voor Amerikaans applicatieverkeer dekt een 10DLC long code de meeste tweerichtings- en OTP-scenario's. Programma's met hoog volume en één-naar-veel communicatie schakelen over op een short code; toll-free is een optie voor de VS/Canada zonder 10DLC.

Een long code of toll-free nummer is direct beschikbaar en begint met verzenden zodra de registratie of verificatie is goedgekeurd. Short codes worden door carriers gecontroleerd en duren doorgaans weken.

Ja. Long codes, short codes en toll-free nummers zijn tweerichtings: koppel het inkomende verkeer van een nummer aan een webhook en antwoorden komen binnen als ondertekende events. Alfanumerieke afzender-ID's zijn alleen eenrichtingsverkeer.

Dat hangt af van het afzendertype en het land. Amerikaans applicatieverkeer vereist A2P 10DLC, toll-free vereist verificatie en veel landen eisen voorregistratie van afzender-ID — dit wordt allemaal vanuit het dashboard geregeld.

Het is een korte tekstreeks, meestal uw merknaam, die in het "van"-veld van de ontvanger wordt weergegeven in plaats van een telefoonnummer. Het is een label op het bericht, geen nummer dat u bezit.

Houd het kort: doorgaans maximaal 11 tekens op GSM-netwerken. De exacte beperking hangt af van het bestemmingsland en de operator, en wat elk daarvan accepteert.

Een tolvrij nummer is een 8xx-nummer (800, 888, 877 en de overige tolvrije prefixen) dat SMS verzendt en ontvangt in de VS en Canada. Het verwerkt applicatieverkeer zonder A2P 10DLC, zodra het de tolvrije verificatie heeft doorlopen.

Nee. Tolvrije nummers vallen buiten het A2P 10DLC-systeem. In plaats daarvan doorlopen ze een tolvrije verificatie, waarbij de carriers de toepassing en berichtinhoud beoordelen voordat het nummer op vol volume mag verzenden.

Een 10-cijferige lange code (10DLC) is een standaard lokaal telefoonnummer dat is goedgekeurd voor applicatie-naar-persoon SMS in de VS zodra het merk en de campagne bij de operators zijn geregistreerd.

Geregistreerde 10DLC lange codes krijgen geverifieerde doorvoer die afhangt van de vertrouwensscore van het merk en het campagnetype: meer dan een ongeregistreerd nummer, minder dan een korte code.

Een short code is een 5- tot 6-cijferig nummer dat carriers goedkeuren voor grootschalige één-op-veel SMS: marketingcampagnes, meldingen en OTP met hoog volume. Het is het afzendertype met de hoogste doorvoer, en het doorloopt een carrier-controle voordat het kan verzenden.

Reken in weken, niet in minuten. Carriers beoordelen elk short code-programma voordat het live gaat, dus een short code brengt een reële doorlooptijd met zich mee — anders dan een long code, die u kunt kopen en direct kunt gebruiken zodra de registratie is goedgekeurd.

Een dedicated short code is uitsluitend van u, dus de verzendreputatie is volledig uw eigen. Een gedeelde short code verdeelt een nummer over afzenders via keywords: goedkoper, sneller te starten, maar u erft de reputatie van alle anderen die het nummer delen.

U kiest zelf, bij een vrije-tekstverzending: geef een nummer door dat uw workspace bezit, een short code of een alfanumeriek afzender-ID als het bestemmingsland dat toestaat. Laat u het weg, dan wordt de verzending geweigerd in plaats van geraden. Een templateverzending is de uitzondering, omdat die zijn eigen afzender selecteert.

Die vertelt Bird en de carriers waarom u verzendt, en landspecifieke complianceregels zoals opt-outbeleid en stille uren zijn eraan gekoppeld. De categorie is verplicht bij een vrije-tekstverzending; een templateverzending neemt de classificatie van het template over.

Geef een idempotency key mee en een herhaald verzoek retourneert het oorspronkelijke resultaat in plaats van het bericht twee keer te versturen. Zonder key wordt een nieuwe poging als een nieuw bericht behandeld.

Elke statuswijziging stuurt een HMAC-ondertekende webhook (queued, sent, delivered of failed), met daarin het afleverbevestigingsrapport van de carrier en het aantal segmenten.

Elk bericht dat naar uw ingerichte nummer wordt gestuurd, komt binnen als een HMAC-ondertekende sms.received webhook. U verifieert één handtekening, leest de from, to en text, en routeert het naar uw eigen logica — dezelfde envelope die u al verwerkt voor afleverbevestigingen.

Ja. Antwoord door te verzenden vanaf hetzelfde nummer waarop het bericht binnenkwam. Stel from in op uw nummer en to op de oorspronkelijke afzender, en de conversatie blijft van begin tot eind op één nummer.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

U hebt een nummer nodig dat tweerichtingsverkeer ondersteunt. Lange codes, korte codes en gratis nummers ondersteunen inkomende berichten; alfanumerieke afzender-ID's zijn alleen voor verzenden en kunnen geen antwoorden ontvangen.

Uw bericht gaat rechtstreeks naar de mobiele operator via een van onze 240 directe verbindingen, niet via een keten van wederverkopers. Minder tussenstappen betekent minder plekken waar een bericht kan vastlopen of een bezorgbevestiging kan verdwijnen.

Bird selecteert de route in realtime opnieuw. Als een pad ontvangstbevestigingen begint te verliezen of vertraagt, neemt het volgende bericht een gezondere verbinding naar dezelfde operator — en de verzending die u heeft geschreven verandert nooit.

Elk bericht retourneert een bezorgbevestiging van de carrier als een sms.delivered of sms.failed webhook, met daarin de mcc_mnc, country en latency_ms. Dat is de eigen bevestiging van de operator, geen aanname van onze kant.

Ja. We voeren bij elke verzending een MNP-lookup uit om de huidige operator van de ontvanger te bepalen, zodat een geporteerd nummer wordt gerouteerd naar de carrier die het daadwerkelijk beheert. Voor zelfstandige nummerinformatie, zie Lookup.

Routing balanceert kosten en bezorgkwaliteit per bestemming. Transactioneel verkeer zoals eenmalige toegangscodes geeft de voorkeur aan het pad met de hoogste kwaliteit; bulkverkeer kan richting laagste kosten neigen. De selectie gebeurt per bericht, achter dezelfde API-aanroep.

Van het afleveringsbevestigingsbericht (DLR) van de operator voor elke verzending. Bird registreert de bevestiging bij het bericht en bundelt die bevestigingen tot aflever-, faal- en latentiecijfers. Een afleveringstelling is de bevestiging door de operator, geen schatting van Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Beide kan. Elke afleveringsstatus komt al binnen als webhook, dus u kunt uw eigen opslag bouwen vanuit de eventstream. De stats-API is er voor wanneer u Bird de aggregatie wilt laten doen in plaats van zelf een teller bij te houden.

Geef het bericht-ID door aan het events-endpoint en u krijgt de volledige tijdlijn: in wachtrij, verzonden, afgeleverd of mislukt, elk met een tijdstempel en bij een fout de redencode van de operator. Dat is het rapport dat u daadwerkelijk nodig hebt wanneer een klant zegt dat een sms nooit is aangekomen.

Ja. Afmelding is omkeerbaar. Een ontvanger die START sms't, wordt van de suppressielijst verwijderd en kan weer berichten ontvangen. De keuze blijft bij de ontvanger.

De suppressielijst is een opvraagbare API-resource. Zoek een nummer op voordat u een doelgroep samenstelt, zodat een afgemelde ontvanger nooit opnieuw in een verzending terechtkomt.

Dat hangt af van waar u naartoe verzendt en wat u verzendt. Amerikaans applicatieverkeer vereist A2P 10DLC merk- en campagneregistratie. Veel landen vereisen voorregistratie van afzender-ID's voor alfanumerieke afzenders. Opt-out-afhandeling geldt overal en vereist geen setup.

Bird dient elke registratie in bij de operators of registers en rapporteert de status via de API. Uw code kan de status van de registratie pollen en wachten op goedkeuring, in plaats van te verzenden naar een campagne die nog niet actief is.

Nee. Het gebruikt dezelfde client en sleutels als verzending, nummers en tweerichtingsverkeer. Registratiestatus en de suppressielijst zijn API-resources naast de verzendaanroep, zodat één integratie zowel het verzenden als de regels eromheen afdekt.

Om spoofing tegen te gaan, bezorgen veel landen alleen alfanumerieke afzender-ID's die vooraf zijn geregistreerd bij de lokale carriers of toezichthouder. Waar die regel geldt, wordt een niet-geregistreerde merkafzender geweigerd of herschreven.

Bird doet dat. U dient het afzender-ID en de bestemming in via het dashboard, Bird draagt het over aan het lokale register en de API rapporteert de status zodat u weet wanneer de afzender actief is.

Goedkeuring verloopt via externe carriers en registers en verschilt per land — doorgaans dagen tot weken. Vraag de registratiestatus op via de API en wacht op goedkeuring voordat u vanaf dat afzender-ID verzendt.

A2P 10DLC is het Amerikaanse carrier-framework voor application-to-person SMS verzonden via standaard 10-cijferige long codes. Een bedrijf registreert het merk achter het verkeer en een campagne die de berichten beschrijft, en de carriers beoordelen beide voordat ze doorvoer toekennen.

Het merk is de juridische entiteit die het verkeer verstuurt. Een campagne beschrijft een specifieke berichttoepassing onder dat merk. Eén merk kan meerdere campagnes hebben, en u koppelt nummers aan een campagne in plaats van aan het merk.

Merk- en campagnebeoordeling verloopt via de carriers en het register en duurt doorgaans dagen tot weken. Vraag de campagnestatus op via de API zodat uw code wacht op goedkeuring voordat er wordt verzonden.

Nee. 10DLC is een Amerikaans framework. Andere landen hebben hun eigen regels, waarbij veel landen in plaats daarvan voorregistratie van het afzender-ID vereisen, en opt-out-keywordverwerking geldt overal waar u verzendt.

Uw aanroep naar Bird wel, via HTTPS, en dat geldt ook voor de inkomende webhook die wij u sturen. De laatste stap is niet aan ons om te versleutelen: SMS is een carrierprotocol zonder end-to-end-encryptie, en het bericht is leesbaar op het toestel en voor de carrier. Dat is de reden om gevoelige informatie uit de berichttekst te houden en de voorkeur te geven aan WhatsApp of e-mail voor alles wat vertrouwelijk is.

Elk event is HMAC-ondertekend. Verifieer de handtekening met het geheim van uw endpoint voordat u actie onderneemt op de payload, en roteer dat geheim vanuit het dashboard wanneer u dat nodig acht.

In de regio waar uw organisatie wordt gehost, ofwel us1 of eu1. Uw API-sleutel draagt dit in het prefix (bk_us1_…, bk_eu1_…), waardoor de SDK's en de CLI automatisch het juiste endpoint kiezen zonder dat u er een hoeft te configureren.

Alleen waarvoor u hem autoriseert. Een sleutel bevat een lijst met scopes, elk op read of write, zodat een sleutel die SMS verstuurt uw nummers niet kan beheren of een ander kanaal kan lezen. Control-plane-acties zoals het beheren van leden en het uitgeven van sleutels zijn uitsluitend via het dashboard mogelijk en geen sleutel kan erbij.

Beide. Een sleutel accepteert een allowlist van CIDR-ranges en weigert verzoeken van elders. Bij rotatie blijft de oude sleutel gedurende een overgangsperiode werken (standaard 24 uur, of nul om hem direct in te trekken), zodat een wissel geen downtime vereist.

Ja. Het auditlogboek is een alleen-lezen, organisatiebreed overzicht van elke beheeractie, met de actor, de workspace, het tijdstip en het resultaat, en het exporteert naar OCSF voor uw eigen SIEM.

Certificeringen en beveiligingsdocumentatie staan in het Trust Center op trust.bird.com. De gegevensverwerkingsovereenkomst, privacyverklaring en het beleid voor aanvaardbaar gebruik zijn gepubliceerd op bird.com/legal. Voor een leveranciersvragenlijst helpt uw Bird-accountteam u verder.