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 vast dat verdere berichten van die afzender aan die abonnee worden geblokkeerd. 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 202 betekent 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, authentication of service. 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. Standaard is alleen het thuisland van je organisatie toegestaan. Bird weigert een verzending naar elk ander land. SMS versturen behandelt deze vereiste.
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 kostenonderdelen waarvoor een prijs beschikbaar is. Voor het opvragen van berichten geldt de bewaartermijn uit 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.
| Pagina | Wat het behandelt |
|---|---|
| SMS versturen | De verzend-API: bestemmingen, afzenders, inhoud, segmenten, categorieën, tags |
| Tekenlimieten | GSM-7- en UCS-2-codering, limieten per segment en de limiet van 12 segmenten |
| SMS-templates | De ingebouwde templatecatalogus en verzenden via templatereferentie |
| SMS-afzender-ID's | Een afzendertype kiezen en het registreren per bestemmingsland |
| 10DLC-registratie | Een merk, campagne en nummer registreren voor US A2P-verzending |
| 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-inrichting, handtekeningverificatie, opnieuw proberen en replay |
| Verify-overzicht | Eenmalige verificatiecodes via SMS en e-mail, verstuurd en gecontroleerd door Bird |
| Bepaal waarheen uw account kan verzenden | Een video: laat zien wat een verzending naar een uitgeschakelde bestemming retourneert |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Bekijk de gidsSMS pumping explainedBegrijp het conceptWhat is SMS pumping, and how do I stop it?Ontdek de mogelijkheidSMS destinationsVolg het leerpadBuild your first integration
Ontvang een implementatieoverzicht