De messages-webhook

Wat de payload bevat

Eén of meer berichten in één levering, elk met de afzender, een id en een type. Het type bepaalt welke andere velden aanwezig zijn.

• Het telefoonnummer van de afzender en de telefoonnummer-id van het nummer waarnaar diegene schreef.
• Een wamid-bericht-id, waarop deduplicatie is gebaseerd.
• Een Unix-tijdstempel.
• Een type: text, image, audio, video, document, sticker, location, contacts, reaction, button of interactive.
• Bij mediatypen een media-id om op te halen, niet de bytes zelf.

Waarom het bij een gerouteerd nummer nooit bij ons aankomt

Omdat de override dit veld, samen met smb_message_echoes, naar de bestemming stuurt die je opgeeft.

Meta laat een app bepalen waar een WhatsApp Business Account zijn webhooks aflevert. Wij stellen die override in op jouw URL, waardoor het berichtenpad volledig buiten onze infrastructuur blijft. Aan onze kant is er geen kopie, wachtrij of opslag, omdat de levering daar nooit aankomt.

Als er geen bestemming is ingesteld, vallen deze gebeurtenissen terug op onze standaardcallback, waar de handler ze laat vallen zonder ze op te slaan. Dat is het verschil tussen een bewering over opslag en een codepad: gespreksinhoud kan nergens naartoe.

Correct bevestigen

Geef 200 terug voordat je het werk doet, niet erna.

Meta ziet een traag antwoord als een fout en probeert het opnieuw. Daardoor ziet een handler die alles inline verwerkt hetzelfde bericht meer dan één keer. Antwoord onmiddellijk, zet de payload op een wachtrij of achtergrondtaak en laat het werk buiten het verzoek plaatsvinden.

Bij serverless is dit niet optioneel. Een functie die antwoord geeft en daarna doorgaat, kan worden stilgezet zodra ze antwoordt. De bevestiging en verwerking moeten dus echt gescheiden zijn.

Dedupliceren

Altijd op basis van wamid, omdat herhalingen normaal zijn en geen uitzondering.

Hetzelfde bericht kan twee keer aankomen door oorzaken die niets met een fout aan jouw kant te maken hebben: een traag antwoord, een time-out van het netwerk of een uitrol tijdens de levering. Bewaar geziene id's en sla herhalingen over. Dat zijn maar enkele regels code en het voorkomt dat een klant één keer of twee keer antwoord krijgt.

Op een Coexistence-nummer is dit extra belangrijk, omdat smb_message_echoes via hetzelfde pad aankomt. Een handler die elke gebeurtenis als nieuw behandelt, antwoordt dan boven op iemand die al handmatig heeft gereageerd.

Veelgemaakte fouten

• 200 verwerken voordat je het terugstuurt. Meta probeert een traag antwoord opnieuw, waardoor je het bericht twee keer verwerkt.
• Deduplicatie overslaan. Herhalingen zijn bewust ingebouwd, geen randgeval.
• Mediabytes in de payload verwachten. Er staat een media-id in om ze op te halen.

Veelgestelde vragen

Lees verder