WhatsApp API instellen in n8n
In deze gids verbind je n8n met de WhatsApp Cloud API of een provider (bijv. Twilio/360dialog). We behandelen het aanmaken van tokens/credentials, het verifiëren van webhooks en het veilig verzenden/ontvangen van berichten.
Wat is de WhatsApp API?
De WhatsApp Cloud API (Meta) en providers bieden endpoints voor het versturen/ontvangen van berichten, media en templates. Ideaal voor notificaties, supportflows en automatisering met n8n.
Benodigdheden
• Meta Business account of provider‑account (Twilio/360dialog)
• Verifieerde telefoonnummer/Business ID
• Permanent access token of provider credentials
• Toegang tot jouw n8n‑installatie
Stap 1 – Kies je integratiepad
• Cloud API (Meta): direct beheer via Meta for Developers
• Provider: eenvoudiger onboarding en tooling (kosten/licenties verschillen)
Stap 2 – Credentials en tokens
Maak een permanent token aan (Cloud API) of configureer provider‑credentials. Bewaar secrets in n8n Credentials en beperk rechten (least‑privilege).
Stap 3 – Webhook verificatie
Exposeer een n8n Webhook node als endpoint. Verifieer de token/challenge van WhatsApp. Beveilig met secret en restricties (IP’s/headers).
Stap 4 – Berichten versturen/ontvangen
Gebruik ‘HTTP Request’ of community nodes. Verstuur templates (HSM), tekst en media. Parse inkomende events (status, delivery, messages).
Stap 5 – Logging, retries en validatie
Log responsecodes, voeg retries toe (rate‑limits), valideer payloads en behandel errors (bijv. ongeldige template/ontvanger).
Tips & best practices
• Gebruik goedgekeurde message templates
• Houd audit‑logs bij en mask gevoelige data
• Beperk rate en implementeer back‑off
• Test in sandbox/ontwikkelnummer
Veelgemaakte fouten
• 401/403: ongeldig of verlopen token
• 400: ongeldige template/parameters
• Webhook niet geverifieerd of URL onbereikbaar
📱 Meta Business Portfolio Setup
Volledige Meta configuratie:
1) Ga naar business.facebook.com
2) Maak Business Portfolio aan met bedrijfsnaam
3) Voeg WhatsApp Business Asset toe
4) Koppel Facebook Page (verplicht)
5) Verificatie bedrijf met KVK documenten
6) Wacht op goedkeuring (24-48 uur)
⚠️ Gebruik een schoon telefoonnummer dat nog niet bij WhatsApp bekend is!
🔑 Permanente Access Token Genereren
Stap-voor-stap token setup:
1) Open Meta for Developers dashboard
2) Selecteer je WhatsApp Business App
3) Ga naar API Setup → Access Tokens
4) Genereer System User token (niet User token!)
5) Selecteer permissions: whatsapp_business_messaging + whatsapp_business_management
6) Token vervalt na 60 dagen - stel reminder in!
💡 Pro tip: Gebruik Graph API Explorer voor onbeperkte test tokens tijdens development
📞 Virtueel Telefoonnummer via Twilio
Waarom Twilio voor WhatsApp:
• SMS-capable nummer vereist voor verificatie
• €5-15/maand voor dedicated nummer
• Ondersteunt alle landen
• Direct beschikbaar zonder wachttijd
Alternatieve providers:
• MessageBird (Nederlandse provider)
• Vonage (voorheen Nexmo)
• 360dialog (WhatsApp specialist)
• Directly via Meta (duurst maar officieel)
⚡ Webhook Configuratie in Detail
Complete webhook setup:
1) N8N Webhook Node:
• HTTP Method: POST
• Response Mode: Immediately
• Response Code: 200
• Response Data: {"status": "ok"}
2) Meta Webhook Config:
• Callback URL: https://jouw-n8n.nl/webhook/whatsapp
• Verify Token: genereer veilige string
• Subscribe to fields: messages, message_status, message_template_status
3) Verificatie Challenge:
• Meta stuurt GET request met hub.challenge
• N8N moet exact die waarde terugsturen
• Gebruik IF node voor GET/POST routing
💬 Message Templates Beheren
Template Management:
• Maak templates in Meta Business Suite
• Categorieën: Marketing, Utility, Authentication
• Review proces: 24 uur (werkdagen)
• Variables: {{1}}, {{2}} voor dynamische content
Template Quality Score:
• Groen: Hoge kwaliteit
• Geel: Medium (let op!)
• Rood: Lage kwaliteit (kan geblokkeerd worden)
Monitor je metrics voor optimale deliverability!
🤖 Chatbot Flows Bouwen
Intelligente conversatie flows:
1) Welcome Flow: Eerste contact afhandeling
2) Menu System: Numbered options (1,2,3)
3) FAQ Bot: Keyword matching
4) Human Handoff: Escalatie naar support
Best Practices:
• Max 24 uur response window
• Gebruik Quick Reply buttons
• Implement typing indicators
• Session management met Redis/Database
📊 Analytics & Monitoring
KPIs om te tracken:
• Message delivery rate
• Read rate (blauwe vinkjes)
• Response time metrics
• Template performance
• User engagement rate
N8N Monitoring Setup:
• Log alle API responses
• Track webhook failures
• Monitor rate limits (1000 msg/sec)
• Alert bij errors via Slack/Email
🔐 Security & Compliance
GDPR & Privacy:
• Opt-in vereist voor marketing messages
• Data retention max 90 dagen (Meta)
• User kan data deletion aanvragen
• Implement double opt-in flows
Security Best Practices:
• Encrypt sensitive data in N8N
• Use environment variables voor tokens
• IP whitelist voor webhooks
• Regular security audits
💰 Kosten & Pricing Model
WhatsApp Business API Kosten:
• User-initiated: €0.00 (eerste 24 uur)
• Business-initiated: €0.03-0.08 per message
• Template messages: Volume-based pricing
Eerste 1000 conversations/maand GRATIS!
Cost Optimization:
• Gebruik 24-hour window maximaal
• Batch notifications waar mogelijk
• Monitor conversation metrics
🚀 Geavanceerde Use Cases
E-commerce Integration:
• Order confirmations & tracking
• Abandoned cart recovery
• Product catalogs met carousel
• Payment links via WhatsApp Pay
Customer Support:
• Ticketing system integratie
• Live chat handoff
• Satisfaction surveys
• Knowledge base bot
Marketing Automation:
• Broadcast lists (met opt-in!)
• Drip campaigns
• Event reminders
• Loyalty programs
🛠️ Troubleshooting Guide
Common Issues & Solutions:
📍 Webhook not receiving messages:
• Check SSL certificate (must be valid)
• Verify webhook URL is publicly accessible
• Test with ngrok voor local development
📍 Template rejected:
• Avoid promotional content in Utility templates
• No excessive CAPS or special characters
• Clear call-to-action required
📍 Rate limit errors:
• Implement exponential backoff
• Use queue system (Redis/RabbitMQ)
• Monitor throughput metrics
📚 Handige Resources
Officiële Documentatie:
• Meta WhatsApp Cloud API Docs
• WhatsApp Business Platform
• N8N Webhook Tutorial
Testing Tools:
• Postman Collections voor API testing
• WhatsApp Test Numbers (Meta sandbox)
• Graph API Explorer
• Webhook.site voor debugging