WhatsApp verzenden en ontvangen vanuit Python

Hoe ontvang je berichten in Python?

Met twee handlers op één route, in welk framework je ook al gebruikt.

De GET-handler beantwoordt Meta's verificatie. Hij leest hub.mode, hub.verify_token en hub.challenge uit de querystring, controleert het token tegen je eigen token en retourneert de challenge als onbewerkte body. Hier JSON retourneren is de meest voorkomende fout en mislukt stilletjes.

De POST-handler ontvangt gebeurtenissen. Retourneer snel 200 en doe het werk daarna, omdat Meta een trage reactie als fout behandelt en opnieuw probeert. Daardoor kun je hetzelfde bericht twee keer verwerken. Zet het in een wachtrij of geef het aan een achtergrondtaak, in plaats van de verwerking direct uit te voeren.

Berichten komen binnen met een wamid-bericht-ID. Het is verstandig daarop vanaf het begin te dedupliceren, omdat nieuwe pogingen normaal zijn en geen uitzondering.

Hoe verzend je?

Eén POST naar het messages-endpoint van de Cloud API voor de phone number id, met een bearer-token.

Beide waarden komen uit de verbinding: het dashboard toont ze en get_api_credentials retourneert ze als je liever wilt dat een assistent ze ophaalt. Niets aan deze aanroep is specifiek voor ons, dus elke HTTP-bibliotheek werkt en het verzoek ziet er precies uit zoals in Meta's eigen documentatie.

Wat verandert door de timing is de body. Binnen 24 uur na het laatste bericht van de klant verzend je een text-object. Daarna verzend je een template-object met de naam van een goedgekeurd template en de taal ervan. Een client die alleen de eerste vorm kent, werkt perfect tijdens tests en mislukt bij het eerste nachtelijke bericht met fout 131047.

Wat heeft een productiehandler daarnaast nodig?

Drie dingen die je makkelijk overslaat, maar die later duur zijn om toe te voegen.

Dedupliceer op de bericht-ID, omdat Meta opnieuw probeert. Controleer de verzoekhandtekening als je publiek bereikbaar bent, want anders kan iedereen die je URL kent ernaar posten. En bepaal hoe lang geleden de contactpersoon voor het laatst schreef, zodat het verzendpad automatisch text of template kiest.

Hiervoor heb je geen framework of bibliotheek nodig. Het zijn een set, een controle en een vergelijking. Als je ze vóór de eerste klant implementeert, krijg je een integratie die stil werkt in plaats van een integratie die je voortdurend waarschuwt.

Veelgemaakte fouten

• JSON retourneren vanuit de verificatie-GET in plaats van de onbewerkte challengewaarde.
• Inline verwerken voordat je 200 retourneert. Meta probeert trage reacties opnieuw en je verwerkt het bericht twee keer.
• Vrije tekst verzenden zonder het venster te controleren. Dat retourneert 131047 en lijkt alsof er niets is gebeurd.

Veelgestelde vragen

Lees verder