1. Qu'est-ce que le modèle Tech Provider (ISV) pour WhatsApp Business ?
Le modèle Tech Provider (Independent Software Vendor) permet à un éditeur de logiciel d'embarquer WhatsApp au cœur de son produit SaaS (logiciel médical, CRM immobilier, ERP de facturation, plateforme e-commerce).
Vos clients professionnels peuvent connecter leur propre numéro WhatsApp directement depuis votre interface sans jamais avoir à créer de compte développeur Meta ni manipuler de clés d'accès complexes.
2. Pourquoi la migration vers Embedded Signup v4 est-elle obligatoire en 2026 ?
Meta a officiellement mis fin au support d'Embedded Signup v2 et v3 le 15 octobre 2026. Toute nouvelle intégration ou mise à jour doit impérativement employer Embedded Signup v4.
Cette version 4 renforce la sécurité des jetons délégués, automatise l'attribution des WABA au système d'infrastructure partenaire et élimine les frictions d'enregistrement grâce à sessionInfoVersion: '4'.
3. Comment implémenter le composant React / Next.js avec sessionInfoVersion 4 ?
Voici le composant d'intégration officiel conforme à la version 4 :
import React, { useEffect } from 'react';
export function WhatsAppEmbeddedSignupButton({
onSuccess
}: { onSuccess: (data: { wabaId: string; phoneId: string }) => void }) {
useEffect(() => {
const handleMessage = (event: MessageEvent) => {
if (event.origin !== 'https://www.facebook.com' && event.origin !== 'https://web.facebook.com') return;
try {
const data = JSON.parse(event.data);
if (data.type === 'WA_EMBEDDED_SIGNUP') {
if (data.event === 'FINISH') {
const { waba_id, phone_number_id } = data.data;
onSuccess({ wabaId: waba_id, phoneId: phone_number_id });
}
}
} catch {}
};
window.addEventListener('message', handleMessage);
return () => window.removeEventListener('message', handleMessage);
}, [onSuccess]);
const launchSignup = () => {
(window as any).FB.login(
(response: any) => {
if (response.authResponse?.code) {
console.log('Code échangé avec succès');
}
},
{
config_id: process.env.NEXT_PUBLIC_META_CONFIG_ID,
response_type: 'code',
override_default_response_type: true,
extras: {
setup: {},
sessionInfoVersion: '4' // Obligatoire v4
}
}
);
};
return (
<button onClick={launchSignup} className="px-4 py-2 bg-emerald-600 text-white font-medium rounded-lg">
Connecter mon WhatsApp Business
</button>
);
}4. Comment isoler les comptes clients, les clés API et les webhooks en multi-tenant ?
Dans une architecture SaaS partagée, la rigueur d'isolation est primordiale :
- Sous-comptes indépendants : Chaque client SaaS dispose de son propre identifiant WABA et de son identifiant de numéro de téléphone (
phone_number_id). - Routage centralisé des webhooks : Un endpoint central reçoit les messages entrants de Meta et aiguille chaque message vers le tenant concerné selon le
phone_number_iddestinataire. - Garantie de non-interférence : La suspension éventuelle d'un numéro client pour mauvaise pratique marketing n'a aucun impact sur les autres locataires de votre plateforme.
5. Quel modèle de facturation et de marges appliquer pour vos clients en dirhams ?
En tant qu'ISV partenaire d'EnvoiSMS, vous achetez vos consommations WhatsApp en dirhams marocains avec facturation mensuelle conforme (TVA 20 %, factures avec ICE/IF/RC). Vous pouvez ensuite refacturer à vos clients sous trois formats :
- Abonnement tout-en-un : Incluant un forfait mensuel de messages (ex: 290 DH/mois pour 500 notifications).
- Facturation au réel avec marge : Vous appliquez un surcoût de 15 % à 30 % sur chaque message délivré.
- Wallet prépayé : Vos clients rechargent leur solde par carte bancaire locale directement dans votre logiciel.
Questions fréquentes
Que se passe-t-il si un client utilise encore un formulaire Embedded Signup v3 ?
Depuis l'extinction officielle du 15 octobre 2026, l'API de Meta renvoie une erreur de paramètre invalide sur les versions antérieures. La mise à niveau vers la version 4 est obligatoire.
Les clients finaux ont-ils besoin de créer leur propre compte développeur Meta ?
Non. Le flux Embedded Signup v4 permet aux professionnels de se connecter simplement avec leur compte Facebook personnel administrateur de leur page sans jamais ouvrir de compte développeur.
Comment gérer la vérification d'entreprise des clients de mon SaaS ?
Vos clients peuvent envoyer immédiatement jusqu'à 250 messages par jour avant vérification. Pour franchir ce palier, ils fournissent leur Registre de Commerce (Modèle J) dans leur Business Suite.
Quels sont les délais d'activation d'un compte client via Embedded Signup v4 ?
L'activation est instantanée : dès que l'utilisateur valide le code OTP sur son téléphone portable, le numéro est opérationnel et peut émettre des messages via l'API.