WhatsApp-log
De pagina Berichten in het Bird-dashboard is het overzicht van elk WhatsApp-bericht dat je werkruimte heeft verstuurd: elke verzending via POST /v1/whatsapp/messages verschijnt hier, nieuwste eerst. Gebruik de pagina om te bevestigen dat een bericht is verstuurd, te zien waar het zich bevindt in de bezorgcyclus en te lezen welk template het heeft gegenereerd. Zie de dashboardrondleiding voor een overzicht van waar deze pagina in het dashboard past.
De berichtenlijst
Elke rij is één bericht. De kolommen zijn:
| Kolom | Wat het toont |
|---|---|
| Status | De huidige status van het bericht (zie Statussen), als een gekleurde stip |
| From | Het WhatsApp-afzendernummer waarmee het bericht is verstuurd |
| To | Het nummer van de ontvanger |
| Template | Het template waarmee het bericht is verstuurd (klik op de rij om het bericht te openen) |
| Category | De categorie van het template |
| Sent | Wanneer de verzending is geaccepteerd, als relatieve tijd (hover voor het exacte tijdstip) |
De lijst is gepagineerd, 25 berichten per pagina; gebruik Prev en Next om tussen pagina's te navigeren.
Zoeken en filteren
Een berichtenlog loopt snel vol, dus de pagina begint met een ontvangerzoekveld en twee filters. Ze zijn combineerbaar: een statusfilter plus een datumbereik toont alleen berichten die aan beide voldoen.
Zoeken op ontvanger. Het zoekvak matcht een exact ontvangernummer in E.164-formaat. Typ het volledige nummer waarnaar je hebt gestuurd, bijvoorbeeld +14155550100, om elk bericht aan dat nummer te vinden. De zoekopdracht matcht de volledige waarde, niet een deel ervan.
Status. Filter op een of meer statussen. Status is multi-select, dus je kunt bijvoorbeeld alles tonen dat nog onderweg is door Accepted en Sent samen te selecteren. De opties zijn Accepted, Sent, Delivered, Failed, Rejected en Received.
Datum. Filter op wanneer het bericht is verstuurd: kies een preset (laatste 3, 7 of 30 dagen) of kies een aangepast bereik in de kalender.
Als een filtercombinatie niets oplevert, toont de pagina een geen-resultaten-status met een Clear filters-actie om terug te keren naar de volledige lijst.
Statussen
De status van een bericht geeft aan waar het zich bevindt in de bezorgcyclus. Een bericht loopt vanaf accepted richting een definitieve statusmelding.
| Status | Betekenis |
|---|---|
| Accepted | We hebben het bericht aangenomen en bereiden de overdracht aan WhatsApp voor |
| Sent | Overgedragen aan WhatsApp; wacht op een bezorgbevestiging |
| Delivered | WhatsApp heeft bezorging aan de ontvanger bevestigd |
| Failed | Verzending of bezorging is mislukt; bekijk de geregistreerde fout |
| Rejected | Bird heeft het bericht geweigerd voordat het werd verstuurd. Het is niet verzonden en er zijn geen kosten in rekening gebracht |
| Scheduled | In de wachtrij om op een later tijdstip te verzenden |
| Canceled | Een ingepland bericht dat is geannuleerd voor verzending, zonder verdere verzending |
| Received | Een inkomend bericht |
Een bericht krijgt de status rejected als de ontvanger op de suppressielijst van je werkruimte staat, het saldo de verzending niet dekt of er geen geconfigureerde prijs is voor de bestemming. Een leesbevestiging is geen status: wanneer een ontvanger een bezorgd bericht leest, registreert Bird een read_at-tijdstip en een whatsapp.read-event op het bericht, en de bezorgstatus blijft delivered.
Een bericht inspecteren
Klik op een rij om het bericht te openen. De header toont het template dat het bericht heeft gegenereerd, de huidige status, de ontvanger en de categoriebadge, boven twee tabbladen:
- Events: een tijdlijn van alles wat er met het bericht is gebeurd, op volgorde, elk met een tijdstip. De reeks loopt Accepted, Sent, Delivered, daarna de leesbevestiging als de ontvanger het bericht heeft gelezen, of een fout of weigering met de bijbehorende foutomschrijving. Dit is dezelfde stroom die je kunt uitlezen met GET /v1/whatsapp/messages/{message_id}/events.
- Details: de metadata van het bericht. Hier vind je het ID (met een kopieerknop), de afzender- en ontvangernummers, de slug, taal en categorie van het template, en de tijdstippen van verzending, bezorging en lezen. Ook staat hier de foutomschrijving als een bericht niet is aangekomen, plus eventuele tags en metadata die bij de verzending zijn meegegeven.
Hetzelfde log via de API
Alles op deze pagina leest uit GET /v1/whatsapp/messages en de bijbehorende sub-resources per bericht. De lijst gebruikt drie van de filters op de pagina: status, category en het datumbereik (created_after/created_before). Daarnaast zijn er filters waarvoor de pagina geen besturingselement heeft: direction, een tag en een exacte to of from. to en from verwijzen naar dezelfde uiteinden van het bericht als in het antwoord, dus to is het contact bij een uitgaand bericht en je zakelijke nummer bij een inkomend bericht; beide accepteren een E.164-telefoonnummer of een business-scoped user-ID. De ontvangerzoekopdracht van de pagina is het enige filter zonder directe tegenhanger, omdat het een contact in beide richtingen matcht en to of from dat alleen niet kan uitdrukken. De tijdlijn achter het tabblad Events is GET /v1/whatsapp/messages/{message_id}/events; WhatsApp events beschrijft hoe je die programmatisch uitleest.
Volgende stappen
- WhatsApp-berichten versturen: de verzendpayload achter elke rij
- WhatsApp events: de lifecycle-stroom per bericht achter de tijdlijn
- WhatsApp-statistieken: het geaggregeerde overzicht van alle berichten hier
- WhatsApp-prijzen: wat een bericht kost, per bestemming en categorie
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