1: Phlo WhatsApp overzicht
Phlo WhatsApp is de WhatsApp-laag van het Phlo-platform. Het stelt een Phlo-app in staat om WhatsApp-berichten te verzenden en te ontvangen via een kleine gateway, terwijl je applicatiecode gewone Phlo blijft: een route om te ontvangen, de WhatsApp resource om te verzenden.
1.1: Het gateway-model
Phlo WhatsApp draait een gateway-proces (gebouwd op whatsapp-web.js) voor elk WhatsApp-nummer. De gateway beheert de verbinding met WhatsApp en biedt een kleine, geheime HTTP API op localhost. Je Phlo-app communiceert nooit direct met WhatsApp; het communiceert met de gateway.
- Één proces per nummer, gekoppeld door eenmaal een QR-code te scannen.
- Inkomend: de gateway POST elke binnenkomende boodschap naar een webhook route in je app.
- Uitgaand: je app roept de HTTP API van de gateway aan via de
WhatsAppresource.
Deze splitsing houdt de langlevende, stateful WhatsApp-sessie buiten je aanvraagcyclus. Je app blijft stateless en kortlevend; de gateway houdt de sessie vast.
1.2: De twee richtingen
| Richting | Je schrijft | Draagt |
|---|---|---|
| Ontvangen | een POST route, geheime controle |
inkomende berichten |
| Verzenden | %WhatsApp(url, secret)->... |
tekst, media, peilingen, locaties |
1.3: Wat je aansluit
- De
WhatsAppresource (het vereistHTTP). security/credszodat de gateway-URL en het geheim komen uitdata/creds.iniof de omgeving, nooit uit de code.- Een webhook route voor inkomende berichten.
De phlo-demo-whatsapp repository is een complete, credential-beschermde referentie voor beide richtingen. Zonder inloggegevens blijft het inert, dus het is veilig om overal uit te voeren.