Overzicht van WhatsApp
Bird WhatsApp gebruikt hetzelfde platform en dezelfde API-sleutels als Bird Email en Bird SMS. Roep de regionale host aan voor de API-sleutel (https://us1.platform.bird.com of https://eu1.platform.bird.com). WhatsApp-endpoints vallen onder /v1/whatsapp/….
Door het bedrijf geïnitieerde verzendingen gebruiken een vooraf goedgekeurd berichttemplate. Verstuur er een uit de beheerde catalogus van Bird, waarvoor je geen eigen nummer nodig hebt en dat verzendt vanaf een door Bird beheerde afzender, of koppel een eigen nummer en verstuur je eigen templates vanaf dat nummer. Contacten kunnen een bericht sturen naar een eigen nummer, en Bird registreert die inkomende berichten naast de uitgaande.
Hoe verzenden werkt
Verstuur een WhatsApp-bericht met POST /v1/whatsapp/messages: één ontvanger, één template, en optionele tags en metadata. We valideren het verzoek en retourneren 202 Accepted met een bericht-ID. Facturering en bezorging verlopen asynchroon. De API heeft geen batch-endpoint, dus verstuur één verzoek per bericht.
Drie ideeën vormen de hele API:
- Verzenden en bezorgen zijn aparte fasen. Een 202 betekent dat Bird het bericht heeft geaccepteerd. Het apparaat van de ontvanger ontvangt het pas nadat het bericht via WhatsApp een definitief bezorgresultaat bereikt. Een leesbevestiging verschijnt als een read_at-tijdstempel en whatsapp.read-event; het verandert de berichtstatus niet.
- Elke door het bedrijf geïnitieerde verzending gebruikt een template. Geef de template-slug op, een optionele language, en waarden voor de variabelen. Een servicebericht, dus vrije tekst of media, bereikt een contact alleen binnen het 24-uursvenster dat hun eigen bericht opent, en alleen vanaf een nummer dat je werkruimte bezit. Zie WhatsApp-berichten verzenden.
- Categorie en bestemming bepalen afzender en prijs. Elk template heeft een authentication-, utility- of marketing-categorie. Een beheerd template verzendt vanaf het Bird-nummer voor die categorie en bevat daarom geen from-veld; elke andere verzending vermeldt een eigen afzender. De prijs hangt ook af van het land van de ontvanger, en het bericht wordt in twee stappen gefactureerd: de vergoeding van Bird terwijl Bird de verzending verwerkt, en het deel van Meta wanneer het bericht is bezorgd. Zie Kosten en facturering.
De WhatsApp-app in het dashboard
In het dashboard is WhatsApp een van de kanaalapps van de werkruimte. De pagina's:
| Pagina | Waarvoor |
|---|---|
| Messages | Inkomende en uitgaande berichten, met inhoud, events en bezorgdetails per bericht |
| Metrics | Uitgaande bezorgstatistieken en volume inkomende berichten |
| Templates | De templates die je kunt versturen, beheerd en eigen: naam, taal, categorie en een gerenderde preview |
| Numbers | Door Bird beheerde afzendernummers en gekoppelde eigen nummers |
| Groepen | WhatsApp-groepen die je zakelijke nummers beheren, met hun deelnemers en uitnodigingslinks |
Zichtbaarheid
Bird registreert een tijdlijn voor elk bericht. Uitgaande tijdlijnen bevatten accepted-, sent-, delivered-, read- en failure-events. Een inkomende tijdlijn registreert wanneer Bird het bericht heeft ontvangen.
- Een tijdlijn lezen: GET /v1/whatsapp/messages/{message_id}/events retourneert de events van het bericht. De Messages-pagina toont dezelfde tijdlijn. Zie WhatsApp-events.
- Abonneren op uitgaande bezorgevents: stuur publieke whatsapp.accepted-, whatsapp.sent-, whatsapp.delivered-, whatsapp.read-, whatsapp.failed- en whatsapp.rejected-events naar een webhook-endpoint.
- Geaggregeerde statistieken bekijken: de Metrics-pagina heeft aparte tabbladen Outbound en Inbound.
Ontvangen
Bird slaat inkomende berichten op die naar een nummer van je werkruimte zijn gestuurd, met een received-status. Door Bird beheerde nummers ontvangen geen berichten voor je werkruimte. Vind berichten op de Messages-pagina of met GET /v1/whatsapp/messages?direction=inbound. Het berichtdetail toont tekst, ondersteunde media, documenten, locaties en inhoudstypen die Bird niet kan weergeven. Ontvangen media is 30 dagen beschikbaar.
Het tabblad Inbound op de Metrics-pagina toont een tijdreeks Messages received en een uitsplitsing By phone number. Om op elk inkomend bericht te reageren zodra het binnenkomt, abonneer je in plaats daarvan op het whatsapp.received-webhookevent; zie WhatsApp-events.
Sommige ontvangers vragen je te stoppen. Registreer dat als een onderdrukking op één zakelijk account of als een opt-out op persoonsniveau voor de hele werkruimte, en Bird blokkeert hoe dan ook latere verzendingen naar dat adres. Zie Opt-outs.
Vervolgstappen
| Pagina | Wat het behandelt |
|---|---|
| WhatsApp-berichten verzenden | De verzend-API: ontvanger, template, componenten, tags, het asynchrone model |
| Serviceberichten | De negen inhoudstypen, het servicevenster en media verzenden via URL |
| Ontvangen | Inkomende berichten, media ophalen en de whatsapp.received-webhook |
| Templates | De templatecatalogus, categorieën en variabelen, en verzenden op slug |
| WhatsApp-log | Inkomende en uitgaande berichten, inhoud, status en eventtijdlijnen |
| Events | Berichttijdlijnen en publieke uitgaande bezorgwebhooks |
| Groepen | Gedeelde chats met meerdere klanten, uitnodigingslinks en groepslimieten |
| Opt-outs | Onderdrukkingen per account, werkruimtebrede opt-outs en het opheffen ervan |
| WhatsApp-statistieken | Uitgaande bezorgprestaties en inkomend berichtvolume |
| Limieten | Capaciteitslimieten uit het organisatiebeleid, antwoordheaders en 429-afhandeling |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Bekijk de gidsConnecting WhatsApp to Bird: from buying a number to a live channelBegrijp het conceptWhat is the 24-hour customer service window on WhatsApp?Gebruik de toolWhatsApp message builderOntdek de mogelijkheidWhatsApp
Probeer de oefening en ontvang een implementatieoverzicht