WhatsApp Embedded Signup voor je klanten: je eigen Tech Provider-app of een gehoste pagina
Een SaaS kan de nummers van zijn klanten in de WhatsApp Business-app via Meta's Embedded Signup op twee manieren aan de Cloud API koppelen. Het kan zelf een Meta Tech Provider worden, wat bedrijfsverificatie, een App Review met twee video's en een eigen Embedded Signup-build vereist, of klanten doorsturen naar een gehoste Embedded Signup-pagina van een provider die dat al is, en de voltooide verbinding ontvangen.
easyCoexistence draait Meta's Embedded Signup met Coexistence op een gehoste pagina met jouw naam, zodat je klanten hun nummers koppelen zonder dat jij een Tech Provider wordt.
Nieuwe bedrijfsklanten die een Tech Provider per voortschrijdende periode van 7 dagen mag aansluiten: standaard 10, na verificatie en review 200.
Schermopnames die App Review van een Tech Provider vraagt: een bericht dat wordt verstuurd en ontvangen, en een template dat wordt aangemaakt.
De gemiddelde doorlooptijd die Meta opgeeft voor de App Review van een WhatsApp-app.
De oudste versie van de WhatsApp Business-app waarmee een klant via Coexistence kan worden verbonden.
Hoe lang de code die Embedded Signup teruggeeft geldig blijft, zodat de server die kan ruilen voor het token van het bedrijf van de klant.
Wat zijn de twee manieren om de nummers van je klanten aan te sluiten?
Beide gebruiken Meta's Embedded Signup met Coexistence en eindigen op dezelfde plek: het nummer van de klant op de Cloud API, dat nog steeds werkt in de WhatsApp Business-app, en je backend met het token van het bedrijf van de klant. Wat verschilt is wie de eisen van Meta draagt en de code rond het popupvenster.
| Your own Tech Provider app | easyCoexistence's hosted page | |
|---|---|---|
| Before the first customer | Business verification, App Review and your own Embedded Signup build | An API key and a card on the account |
| Name in Meta's popup | Your app | easyCoexistence, with your name on the page around it |
| Code you maintain | The popup, the token exchange, webhook subscriptions and the history sync | A session request and a return page |
| The 14-day rule | A PARTNER_REMOVED webhook for your app to handle | connection.disconnected with PRIMARY_INACTIVITY |
| Meta's message charges | On the customer's WhatsApp Business Account | On the customer's WhatsApp Business Account |
Wat vereist Meta om Tech Provider te worden?
Meta somt de stappen op in zijn gids Become a Tech Provider, die het App Dashboard opent onder de Tech Provider-onboarding van de WhatsApp use case:
- Een Meta-app met de WhatsApp use case, gekoppeld aan je Business Portfolio.
- Bedrijfsverificatie, die eerst komt: Meta start de App Review alleen voor een geverifieerd bedrijf.
- App-instellingen zoals een icoon, een privacybeleid en een categorie.
- Geavanceerde toegang tot
whatsapp_business_messagingenwhatsapp_business_management, verleend via App Review met een schriftelijke toelichting en een schermopname per machtiging. - Twee opnames in totaal: een bericht dat vanuit je app wordt verstuurd en in WhatsApp wordt ontvangen, en je app die een template aanmaakt.
Wat bouw je zodra je bent goedgekeurd?
De onboarding zelf, die Meta's Embedded Signup-gidsen stap voor stap beschrijven:
- De flow op je site, via Facebook Login for Business en Meta's JavaScript SDK, op HTTPS-domeinen die je in de app toestaat.
- Coexistence ingeschakeld in de configuratie van de flow, met sessielogging, wat Meta ervoor vereist.
- Een serververzoek dat de teruggegeven code binnen 30 seconden ruilt voor het token van het bedrijf van de klant.
- Webhooks: je app geabonneerd op het account van elke klant, met de velden
account_update, history,smb_app_state_syncensmb_message_echoes. - Synchronisatie van contacten en geschiedenis binnen 24 uur na onboarding; daarna moet de klant zich afmelden en de flow opnieuw doorlopen.
Wat neemt de gehoste pagina over?
Het hele popupgedeelte. easyCoexistence draait Embedded Signup met Coexistence via de eigen Meta-app als Tech Provider, op een pagina op easycoexistence.com die jouw naam toont. De token-uitwisseling, het webhook-abonnement en het geschiedenisverzoek gebeuren daar, en je backend ontvangt een verbindings-ID. Met een webhook_url op de sessie levert Meta de berichten van het nummer rechtstreeks aan je server, samen met de eenmalige import van contacten en, wanneer de klant dat deelt, tot 180 dagen aan chats. Je code roept daarna de Graph API van Meta rechtstreeks aan met het token van de klant, terwijl easyCoexistence het nummer in de gaten houdt en ondertekende events verstuurt wanneer het verandert.
Wat ziet je klant?
Een pagina met jouw naam en één Connect-knop. Voordat Meta's popup opent, vraagt een checklist de klant om vijf dingen te bevestigen: een actuele WhatsApp Business-app, een nummer dat minstens 7 dagen echt in gebruik is, geen andere API-provider of automatiseringstool erop, geen onofficiële apps, en de telefoon bij de hand met een Facebook-login. Er wordt geen account, e-mailadres of betaalkaart gevraagd.
Wat gebeurt er in Meta's popup?
Meta's flow logt de klant in met Facebook, vraagt om de app te autoriseren en het nummer in te voeren, en toont het profiel van het WhatsApp Business-app-nummer ter bevestiging. De klant kiest of maakt een Business Portfolio aan en scant daarna een QR-code vanuit de WhatsApp Business-app; Meta stuurt het nummer ook een WhatsApp-bericht met een link naar de code. In de app tikt de klant op Connect en kiest of chatgeschiedenis wordt gedeeld. Als laatste komen de accountnaam, een tijdzone en de voorwaarden van Meta. De volgorde kan verschillen terwijl Meta zijn telefoonnummer-eerst-flow uitrolt.
Welke naam toont Meta's popup?
De naam van de app die om toegang vraagt. Op de gehoste pagina is dat easyCoexistence, en die kan niet worden hernoemd, terwijl de pagina rond de popup jouw naam toont uit partner_name. Een eigen Tech Provider-app van jou toont in plaats daarvan de naam van je app, tegen de prijs van de verificatie, review en bouw hierboven beschreven.
Wat is de regel van 14 dagen?
Meta koppelt een Coexistence-nummer los zodra de telefoon met de WhatsApp Business-app ongeveer 14 dagen inactief is geweest, en meldt de reden als PRIMARY_INACTIVITY. De klant verbindt opnieuw door de flow nog eens te doorlopen met hetzelfde nummer. Via de gehoste pagina houdt easyCoexistence elk nummer in de gaten en stuurt het je events-URL connection.disconnected met die reden, zodat een nieuwe connectlink voor de klant het nummer weer kan terugbrengen.
Veelgemaakte fouten
- Bouwen op Embedded Signup v2 of v3. Meta heeft beide op 15 oktober 2026 uitgefaseerd en beantwoordt verzoeken daarvoor als v4.
- Rechten aanvragen die de app niet gebruikt. Meta noemt onnodige rechten een veelvoorkomende reden waarom App Review een indiening afwijst.
- Eén video voor beide rechten opnemen. Meta wil per recht een aparte schermopname en schriftelijke toelichting, en kan een video afwijzen die er meerdere toont.
- Klanten vragen om te verbinden vanaf de telefoon die het nummer heeft. Meta's popup opent daar als nieuw tabblad, en diezelfde telefoon moet de QR-code scannen, dus een computer is eenvoudiger.
Je backend ontvangt het token van elke klant, Meta levert berichten rechtstreeks aan je webhook, en uitvalmeldingen bereiken je als ondertekende events. 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
Moet ik een Meta Tech Provider zijn om de WhatsApp-nummers van mijn klanten aan te sluiten?
Alleen als je Embedded Signup vanuit je eigen Meta-app wilt draaien. Klanten doorsturen naar een gehoste pagina van een Tech Provider koppelt hun nummers zonder jouw eigen bedrijfsverificatie of App Review.
Hoe lang duurt de App Review van Meta voor een WhatsApp-app?
Meta geeft als gemiddelde ongeveer 24 uur op. Bedrijfsverificatie moet klaar zijn voordat de review kan starten, en elke afgewezen indiening voegt nog een ronde toe.
Blijft mijn klant de WhatsApp Business-app gebruiken?
Ja. De app blijft naast de API op hun telefoon werken, en berichten worden tussen de twee gespiegeld. Sommige functies van de app veranderen: broadcastlijsten worden alleen-lezen, en verdwijnende berichten en eenmaal bekijkbare berichten worden uitgeschakeld.
Wie betaalt Meta voor de berichten?
De klant. Meta factureert berichten die via de API worden verstuurd aan het eigen WhatsApp Business-account van de klant, met een betaalmethode die de klant daar toevoegt, terwijl berichten die vanuit de WhatsApp Business-app worden verstuurd gratis blijven.
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