Niet-ondersteunde WhatsApp-berichttypen

Sommige berichten werken in de WhatsApp-app, maar kunnen niet worden gelezen via de API. Bird registreert ze als ontvangen berichten met een unsupported-veld. Je kunt zien wie het bericht heeft gestuurd en wanneer, maar je kunt de inhoud niet lezen in het dashboard of via de API. Vraag de afzender om de informatie opnieuw te sturen als tekst of een ander ondersteund berichttype.

Waarom een ontvangen bericht een fout kan bevatten

Meta kan fout 131051 opnemen in een melding van een inkomend bericht wanneer WhatsApp Cloud API die inhoud niet ondersteunt. Een functie kan werken in de WhatsApp-app en toch niet beschikbaar zijn via Cloud API.

Bird registreert die melding met direction: inbound en status: received. De last_error van het bericht kan meta_error_code: "131051" bevatten, hoewel Bird niet heeft geprobeerd het te verzenden. In dit geval beschrijft de fout de niet-beschikbare inkomende inhoud. Het wijst niet op een mislukte uitgaande verzending.

De genormaliseerde last_error.code kan undeliverable lezen op dit ontvangen record. Controleer direction, status en last_error.meta_error_code samen voordat je een record als een bezorgingsfout beschouwt.

Meta gebruikt 131060 ook voor een bericht dat momenteel niet beschikbaar is. Dit kan voorkomen wanneer iemand een bedrijf voor het eerst een bericht stuurt via een gekoppeld WhatsApp Business-appnummer. Het heeft een andere betekenis dan de fout voor niet-ondersteunde inhoud 131051. Zie Meta's referentie voor niet-ondersteunde berichten voor deze meldingen.

Lees het berichttype

Het unsupported.type-veld identificeert de inhoud zo nauwkeurig als de melding toestaat:

Wanneer Meta unsupported.type meegeeft, behoudt Bird de waarde, zoals poll_creation, pin of edit.
Wanneer Meta unsupported.type weglaat, behoudt Bird het top-level type van het bericht in dat veld. Een waarde zoals unsupported of unknown identificeert niet welke actie de afzender heeft uitgevoerd.
Wanneer Meta inhoud meegeeft die het API van Bird niet modelleert, registreert Bird het type hier ook, zoals order of system.

De typenaam bevat niet de ontbrekende inhoud. poll_creation geeft je bijvoorbeeld niet de vraag of keuzes, en edit geeft je niet de vervangende tekst. Bewaar onbekende typewaarden bij het opslaan van berichten, zodat je integratie nieuwe typen kan accepteren.

Bird ondersteunt afbeeldingen, knopantwoorden, lijstantwoorden en reacties. Een niet-ondersteunde notificatie met een van die namen beschrijft die specifieke notificatie; het betekent niet dat de hele functie niet wordt ondersteund. Zie afbeeldingen ontvangen, interactieve antwoorden en reactie-webhooks.

De ontvangen webhook afhandelen

Een niet-ondersteund bericht verstuurt whatsapp.received met data.unsupported.type. De ontvangen webhook bevat niet de last_error van het berichtrecord; haal het bericht op via de API wanneer je die diagnostische informatie nodig hebt.

Handel unsupported expliciet af voordat je inhoud verwerkt. Toon dat de inhoud niet beschikbaar is, sla het type op en bevestig de webhook met een 2xx-respons zodra je het hebt afgehandeld. Dezelfde notificatie opnieuw proberen herstelt de ontbrekende inhoud niet. Zie webhookbezorging voor bevestigings- en retry-gedrag.

Het record blijft zichtbaar in het WhatsApp-log. Bird behandelt het als een inkomend bericht voor het klantenservicevenster.

Voorbeelden om te proberen

Dit zijn voorbeelden van waarden van unsupported.type. Als je WhatsApp-app de bijbehorende actie biedt in het gesprek dat je test, kun je het proberen en het resulterende record inspecteren:

Bericht of actie	`unsupported.type`
Een poll aanmaken	`poll_creation`
Stemmen in een peiling	`poll_update`
Een bericht vastpinnen	`pin`
Een verzonden bericht bewerken	`edit`
Een verdwijnend bericht in de chat bewaren	`keep_in_chat`
Een groepsuitnodiging versturen	`group_invite`
Niet-geïdentificeerd bericht	`unknown`

Beschikbaarheid hangt af van de app, het gesprek en het account. Je ontvangt mogelijk een generiek type, of helemaal geen melding van een inkomend bericht voor een actie. Vergelijk de afzender, het tijdstempel en unsupported.type met de actie die je hebt uitgevoerd. Als het type generiek is, kun je de actie niet uit dat record alleen afleiden.

Volgende stappen

Hoe ontvangen werkt: inkomende berichten, media en webhooks
Interactieve antwoorden ontvangen: knoptaps en lijstselecties
WhatsApp-log: berichten bekijken in het dashboard of API

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.

Probeer de oefening en ontvang een implementatieoverzicht