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 berichten gebruiken een vooraf goedgekeurd berichtsjabloon. Verstuur er een uit de beheerde catalogus van Bird, waarvoor je geen eigen nummer nodig hebt en dat verstuurd wordt vanaf een door Bird beheerde afzender, of koppel een eigen nummer en verstuur je eigen sjablonen daarvanaf. 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, en een antwoord met STOP is de meest voorkomende manier: Bird levert de zoekwoordlijst mee, dus dat werkt op je nummers zonder configuratie. Je kunt ook een onderdrukking vastleggen voor één zakelijk account, of een opt-out voor de hele werkruimte. Bird blokkeert latere verzendingen naar het adres in beide gevallen. Zie Opt-outs en zoekwoorden.
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 |
| Verzenden naar een groep | Een groep adresseren, wat daarvoor nodig is, en ontvangstbevestigingen per deelnemer |
| Groepsberichten ontvangen | Welke deelnemer een groepsbericht schreef, en hoe je erop antwoordt |
| Opt-outs | Zoekwoordregels, voorkeuren van ontvangers, en de onderdrukkingslijst |
| WhatsApp-statistieken | Uitgaande bezorgprestaties en inkomend berichtvolume |
| Limieten voor het aantal verzoeken | Capaciteit van 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