Overzicht van SMS
Bird SMS verstuurt tekstberichten via hetzelfde platform en dezelfde API-sleutels als Bird Email. Roep Bird aan met een bk_{region}_…-sleutel tegen je regionale host (https://us1.platform.bird.com of https://eu1.platform.bird.com). Bird kiest een route naar de carrier van de ontvanger, splitst je tekst in factureerbare segmenten en rapporteert elk bericht via de afleverbevestiging. SMS-endpoints beginnen met /v1/sms/.
Je kunt vrije tekst versturen met een afzender en categorie naar keuze, of een van de ingebouwde templates van Bird gebruiken, die de inhoud, categorie en afzender levert. Bird ontvangt ook antwoorden op je nummers. Het slaat elk inkomend bericht op naast je verzendingen en verstuurt sms.received. Wanneer een antwoord overeenkomt met een ondersteund opt-out-trefwoord zoals STOP, legt Bird ook een suppressie voor die afzender en abonnee vast. Zie Opt-outs en trefwoorden voor dekking en configuratie.
Hoe verzenden werkt
Verstuur een SMS met POST /v1/sms/messages: één ontvanger en één bericht, met je eigen text met een afzender en categorie, of een template-referentie met de bijbehorende variabelewaarden. Bird valideert het verzoek en de bestemming, bepaalt de afzender en retourneert 202 Accepted met een bericht-ID. Aflevering vindt daarna asynchroon plaats. Volg het resultaat via events en webhooks of de endpoints voor het opvragen van berichten. Om veel onafhankelijke berichten in één aanroep te versturen, gebruik je het batch-endpoint.
Drie ideeën vormen de hele API:
- Verzenden en afleveren zijn aparte fasen. Een
202betekent dat Bird het bericht heeft geaccepteerd. De carrier verwerkt het na acceptatie en kan later een afleverbevestiging terugsturen. Een bevestiging van mislukte bezorging is ook een definitief resultaat; controleer de gerapporteerde status voordat je de verzending als afgeleverd beschouwt. - Tekst wordt per segment gefactureerd. Een bericht dat langer is dan één segment wordt gesplitst en per segment gefactureerd, en de capaciteit per segment hangt af van de tekens die je gebruikt. Tekenlimieten bevat de coderingsregels, de volledige tekenset en hoe je berichten tot één segment beperkt.
- Waarom je verstuurt doet ertoe. Elk bericht draagt een categorie:
transactional,marketing,authenticationofservice. Bird en carriers gebruiken die om het doel van het bericht te begrijpen. Bij een templateverzending komt de categorie uit het template.
Schakel vóór je eerste verzending de bestemmingslanden die je bedient in onder SMS > Destinations. De allowlist is standaard dicht: Bird weigert een verzending naar elk land dat je werkruimte niet heeft ingeschakeld. SMS versturen behandelt deze vereiste, en Je eerste SMS versturen doorloopt een eerste verzending.
Overweeg voor eenmalige verificatiecodes Bird Verify in plaats van het bericht zelf op te stellen. Verify genereert en bezorgt de code via SMS of e-mail, controleert het antwoord en handhaaft verlooptijd, pogingslimieten en afkoelperiodes voor opnieuw versturen.
De SMS-app in het dashboard
In het dashboard is SMS een van de producten in de zijbalk. De pagina's en waar de bijbehorende handleiding staat:
| Pagina | Waarvoor het dient |
|---|---|
| Messages | Elk verzonden bericht, met de event-tijdlijn per bericht en afleverdetails. Handleiding: SMS-log |
| Templates | De ingebouwde templates die je kunt versturen: naam, categorie, talen en variabelen. Handleiding: SMS-templates |
| Metrics | Afleverpercentage, faalpercentage en geaccepteerd volume over tijd. Handleiding: SMS-metrics |
| Senders | De afzender-ID's en nummers waarmee je kunt versturen, en waar elk is geregistreerd. Handleiding: SMS-afzender-ID's |
| Destinations | De landen waarnaar je werkruimte mag versturen; schakel een bestemming in voordat je erheen verstuurt. Handleiding: SMS versturen |
Zichtbaarheid
Gebruik berichtrecords en de beschikbare event-tijdlijn om acceptatie, carrier-overdracht en afleverresultaten te onderzoeken. Berichtdetails bevatten segmenten en eventuele geprijsde kostenonderdelen. Openbare berichtopvragingen dekken de bewaartermijn die beschreven staat in het SMS-log.
- SMS-log: de weergave per bericht in het dashboard. Elke verzending, de event-tijdlijn, segmenten, kosten en carrierdetails.
- SMS-metrics: het totale afleverpercentage, faalpercentage, geaccepteerd volume en afleverlatentie over alles wat je verstuurt.
- Events: het SMS-eventvocabulaire, de berichtlevenscyclus en webhookaflevering naar je eigen endpoints.
Volgende stappen
Verken het SMS-platform voor campagnes, applicatieberichten en antwoorden, of gebruik de SMS-resourcebibliotheek om een workflow te kiezen.
- Je eerste SMS versturen: een API-sleutel, een bestemming, een ingebouwde templateverzending en de afleverstatus
- SMS versturen: de verzend-API: bestemmingen, afzenders, berichttekst, segmenten, categorieën, tags
- Tekenlimieten: GSM-7- en UCS-2-codering, limieten per segment en het maximum van 12 segmenten
- SMS-templates: de ingebouwde templatecatalogus en verzenden via templateverwijzing
- SMS-afzender-ID's: een afzendertype kiezen en registreren per bestemmingsland
- 10DLC-registratie: een merk, campagne en nummer registreren voor A2P-verzending in de VS
- SMS-log: elk bericht, de event-tijdlijn, segmenten en kosten
- SMS-metrics: afleverpercentage, faalpercentage en latentie
- Events: de SMS-eventtypen en webhookaflevering
- Webhooks & events: endpoint instellen, handtekeningverificatie, nieuwe pogingen en replay
- Verify-overzicht: eenmalige verificatiecodes via SMS en e-mail, verzonden en gecontroleerd door Bird
- Bepaal waarheen uw account kan verzenden: een video die laat zien wat een verzending naar een uitgeschakelde bestemming oplevert
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.