InloggenGratis proefperiode starten
easyCoexistence Officiële API's

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.

10 to 200

Nieuwe bedrijfsklanten die een Tech Provider per voortschrijdende periode van 7 dagen mag aansluiten: standaard 10, na verificatie en review 200.

2 videos

Schermopnames die App Review van een Tech Provider vraagt: een bericht dat wordt verstuurd en ontvangen, en een template dat wordt aangemaakt.

About 24 hours

De gemiddelde doorlooptijd die Meta opgeeft voor de App Review van een WhatsApp-app.

2.24.17

De oudste versie van de WhatsApp Business-app waarmee een klant via Coexistence kan worden verbonden.

30 seconds

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 appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn 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_messaging en whatsapp_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_sync en smb_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.

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

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.
Dit doen met EasyCoexistence

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