WhatsApp in je SaaS toevoegen met Embedded Signup en Coexistence
Een SaaS voegt WhatsApp toe door het bestaande nummer van elke klant te koppelen via Embedded Signup met Coexistence van Meta, zodat het nummer blijft werken in de WhatsApp Business-app. Met de Partner API van easyCoexistence draait één connect-sessie per klant die koppelstroom op een gehoste pagina; Meta levert de berichten van het nummer aan je webhook_url, en je backend antwoordt via de Cloud API met het eigen token van de klant.
Vaste doorvoer van een nummer dat zowel met de WhatsApp Business-app als met de Cloud API wordt gebruikt.
De oudste versie van de WhatsApp Business-app waarmee het nummer van een klant via Coexistence kan worden verbonden.
Hoe ver terug de chatgeschiedenis reikt die Meta bij onboarding kan delen; die moet binnen 24 uur gesynchroniseerd zijn.
Het servicevenster van WhatsApp na een bericht of oproep van een gebruiker; elk nieuw bericht start het opnieuw.
De datum waarop Meta Embedded Signup v2 en v3 heeft uitgefaseerd, met integraties die naar v4 zijn overgezet.
Wat zijn de onderdelen van een WhatsApp-integratie?
Vijf, en easyCoexistence neemt het eerste en het laatste voor zijn rekening. Je product houdt de gesprekslogica, de inbox en wat je model of het personeel van je klanten schrijft, terwijl Meta de berichten tussen het nummer en je server vervoert:
Wat verandert Coexistence voor je klanten?
Ze behouden hun nummer en hun telefoon. De WhatsApp Business-app blijft naast de Cloud API werken, zodat medewerkers op de telefoon antwoorden terwijl je product via de API antwoordt, en wat zij vanuit de app verzenden komt bij je webhook aan als smb_message_echoes. Daar horen drie beperkingen bij: het nummer verstuurt vast 20 berichten per seconde, alleen de API kan templates versturen, en Meta koppelt het nummer los wanneer de telefoon ongeveer 14 dagen inactief blijft.
Hoe ziet de koppelstap eruit in je product?
Een knop Connect WhatsApp die vanuit je backend POST /connect-sessions aanroept met een redirect_url, het id van je klant als external_ref, en webhook_url met webhook_verify_token, zodat Meta het nummer vanaf de eerste minuut naar jou routeert. De klant bevestigt op de gehoste pagina een korte checklist, doorloopt de popup van Meta, scant met de WhatsApp Business-app een QR-code en keert terug naar jou met een connection_id. Of je Embedded Signup liever vanuit je eigen Tech Provider-app draait, staat afgewogen in de Embedded Signup-gids.
Hoe bereiken berichten je backend?
Van Meta rechtstreeks naar de webhook_url, zonder tussenstop bij easyCoexistence en zonder kopie. Het veld messages bevat wat klanten sturen en de status van wat jij verstuurt, en smb_message_echoes bevat wat medewerkers vanuit de app versturen. Meta ondertekent elke levering met het app-geheim van easyCoexistence, dat nooit wordt gedeeld, dus een lange willekeurige geheime waarde in het URL-pad authenticeert die. Twee nummers binnen één WhatsApp Business Account delen één bestemming: routeer op value.metadata.phone_number_id.
Hoe antwoordt je backend en verstuurt het templates?
Met de Graph API van Meta en het token van de klant uit GET /connections/{id}?credentials=1, dat ook de send_endpoint teruggeeft. Vrije tekst gaat uit binnen 24 uur na het laatste bericht van de persoon; daarna alleen een template dat Meta heeft goedgekeurd:
- Antwoord: POST /<
PHONE_NUMBER_ID>/messages met type text, binnen het venster. - Template: dezelfde aanroep met type template, een templatenaam en de bijbehorende taalcode.
- Template aanmaken: POST /<
WABA_ID>/message_templates, en daarna de status opvragen, want beoordelingsresultaten komen niet bij jewebhook_urlaan. - Media: POST /<
PHONE_NUMBER_ID>/media om te uploaden; inkomende media komt aan als een ID dat je met hetzelfde token ophaalt.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Kan je product de bestaande chats van de klant importeren?
Eén keer, bij het koppelen. Met een webhook_url op de sessie vraagt easyCoexistence Meta om de contacten van het nummer te sturen en, als de klant dat in de app goedkeurt, tot 180 dagen aan chats, die aankomen als smb_app_state_sync- en history-webhooks. Meta staat dat alleen toe binnen 24 uur na het koppelen, dus zorg dat het endpoint antwoordt voordat de link wordt verstuurd. De gids over chatgeschiedenis behandelt de payloads.
Wie betaalt Meta voor de berichten?
Je klant. Meta factureert de berichten die je backend via de API verstuurt aan het eigen WhatsApp Business Account van de klant, met een betaalmethode die die klant daar toevoegt; een bedrijf zonder betaalmethode kan geen marketingtemplates versturen. easyCoexistence rekent je account per gekoppeld nummer en brengt nooit kosten voor berichten in rekening of voegt opslag toe aan de prijzen van Meta.
Wat gebeurt er als een nummer wegvalt?
Je events-URL ontvangt connection.disconnected met de reden van Meta wanneer die bekend is. PRIMARY_INACTIVITY is de regel van 14 dagen, en een nieuwe connect-sessie voor die klant brengt hetzelfde nummer weer terug. connection.token_missing betekent dat het nummer is gekoppeld zonder het token van de klant: het ontvangt berichten, maar kan niet versturen totdat een nieuwe sessie het opnieuw koppelt.
Veelgemaakte fouten
- De koppellink verzenden voordat je webhook-endpoint antwoordt. De geschiedenisimport loopt één keer, binnen 24 uur na het koppelen, en inhoud die wordt verstuurd voordat je URL werkt, gaat verloren.
- Antwoorden met vrije tekst nadat het venster is gesloten. Zodra er 24 uur zijn verstreken sinds het laatste bericht van de persoon, gaat alleen een goedgekeurd template nog door.
- Een campagne vanaf één nummer op volle snelheid starten. Een Coexistence-nummer verstuurt 20 berichten per seconde, dus zet de verzendingen van elk nummer in de wachtrij op dat tempo.
- Verwachten dat medewerkers templates vanaf de telefoon versturen. In Coexistence verstuurt alleen de API ze, dus plaats het versturen van templates in je product.
easyCoexistence voegt WhatsApp toe aan je SaaS met Embedded Signup van Meta en Coexistence, via een gehoste pagina met jouw naam erop: je klanten behouden hun nummer en de WhatsApp Business-app, Meta levert berichten aan je server en bereikt je als ondertekende events. Dezelfde API koppelt Instagram, Facebook, TikTok, YouTube, LinkedIn en meer kanalen. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan een klant een nummer koppelen dat bij een andere WhatsApp API-provider staat?
Niet zolang het daar staat. De gehoste checklist vraagt om een nummer zonder andere API-provider of automatiseringstool, dus de klant ontkoppelt het eerst bij die provider.
Kan mijn SaaS WhatsApp-templates voor de klanten versturen?
Ja, via de Cloud API met het token van elke klant: maak het template aan in het WhatsApp Business Account van de klant, wacht op de beoordeling door Meta en verstuur het daarna.
Leest easyCoexistence de WhatsApp-berichten van mijn klanten?
Nee. Meta levert de berichten van een nummer rechtstreeks aan de webhook_url die je instelt. Een nummer zonder webhook_url valt terug op de callback van easyCoexistence, waar berichten worden weggegooid zonder dat ze worden opgeslagen.
Wat kost easyCoexistence per WhatsApp-nummer?
US$ 9 tot US$ 0,75 per nummer per maand, afhankelijk van de schijf van je totaal aantal verbindingen, met 3 dagen gratis proefperiode. De berichtkosten van Meta gaan naar het eigen WhatsApp Business Account van elke klant.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op