Wiki

Obtenir vos identifiants Meta pour Homenichat

Pour connecter votre numero WhatsApp officiel a Homenichat, vous avez besoin de quatre identifiants generes chez Meta. Cette page vous guide etape par etape, du compte Meta Business jusqu'au collage final dans l'assistant Homenichat. Si vous bloquez sur une etape, vous pouvez nous contacter, on vous accompagne.

Ce que vous obtiendrez a la fin Quatre valeurs a coller dans l'assistant Homenichat : phoneNumberId, businessAccountId, accessToken, et verifyToken (genere par Homenichat). Plus une callbackUrl a copier-coller dans Meta. Compter environ 30 a 45 minutes pour la premiere fois.

Avant de commencer : prerequis

Une adresse mail pro

Pour le compte Meta Business. Utilisez l'adresse que vous voulez voir liee a votre entreprise.

Un telephone avec WhatsApp Business

L'appli WhatsApp Business installee et active sur le numero que vous voulez utiliser.

Un compte Facebook personnel

Meta Business est lie a votre compte Facebook (utilise uniquement pour l'admin, pas publie).

Une CB ou un compte bancaire

Meta peut demander un moyen de paiement avant certains envois API (souvent zero euro a la fin).

Votre HomeniBOX deja installee

La BOX doit etre en ligne au moment du branchement final. Si vous n'avez pas encore de box, voir la page materiel.

30 a 45 minutes devant vous

Sans interruption, ideal pour faire le parcours d'un seul jet.

Important Si votre numero WhatsApp est actuellement utilise dans l'appli WhatsApp Business sur telephone, vous devrez choisir entre continuer de l'utiliser sur telephone uniquement ou le connecter via l'API officielle a Homenichat. Meta travaille sur un mode "coexistence" qui permettra les deux, mais Homenichat ne l'a pas encore active. Si vous voulez garder l'appli telephone pour l'instant, utilisez un second numero pour cette configuration.

Vue d'ensemble du parcours

Creer un compte Meta Business (Meta Business Suite).
Creer un portefeuille business (Business Portfolio).
Ajouter votre numero WhatsApp dans le portefeuille (creation du WABA).
Verifier votre entreprise (option, recommande).
Creer une app Meta Developer et y ajouter le produit WhatsApp.
Generer un access token (System User permanent ou temporaire).
Recuperer le phone_number_id et le business_account_id.
Lancer l'assistant Homenichat qui vous donne la callback URL et le verify token.
Coller la callback URL et le verify token dans Meta, puis valider.
Tester un message entrant pour confirmer que ca marche.

Procedure pas-a-pas

1

Creer un compte Meta Business

⏱ 5 min🔗 business.facebook.com

Allez sur business.facebook.com et connectez-vous avec votre compte Facebook personnel. Cliquez sur "Creer un compte" si vous n'en avez pas encore. Remplissez le nom de votre entreprise et votre email pro.

Capture a venir : ecran d'accueil Meta Business Suite avec bouton "Creer un compte"

Astuce Le compte Facebook personnel sert uniquement a vous authentifier. Vos clients ne le verront jamais. Pas besoin de publier quoi que ce soit sur Facebook.

2

Creer ou verifier votre portefeuille business

⏱ 2 min

Dans Meta Business Suite, dans Parametres > Business Settings > Comptes > Business Assets Group (le menu varie selon la version Meta du moment), assurez-vous qu'un portefeuille business est cree pour votre entreprise. Notez-le. C'est dedans qu'on va attacher le numero WhatsApp.

Capture a venir : page Business Settings, section Business Assets

3

Ajouter votre numero WhatsApp (creation du WABA)

⏱ 10 min📩 SMS de verification recu

Toujours dans Business Settings, allez dans Comptes > Comptes WhatsApp. Cliquez Ajouter, puis Creer un compte WhatsApp Business. Suivez l'assistant Meta. Au bout, Meta enverra un code de verification a votre numero (SMS ou appel) pour confirmer que c'est bien le votre.

Capture a venir : creation du WABA, etape numero de telephone

Si Meta dit que votre numero est deja utilise C'est qu'il est lie a la WhatsApp Business App sur votre telephone. Vous devrez le deconnecter de l'appli avant. Pour cela : ouvrez WhatsApp Business sur le telephone, allez dans Parametres > Compte > Supprimer mon compte (cette action met temporairement le numero en pause), ou contactez le support Meta pour migrer.

4

Verifier votre entreprise (recommande, pas obligatoire pour demarrer)

⏱ 5 min pour soumettre, plusieurs jours de validation Meta

Dans Business Settings > Verification de l'entreprise, suivez la procedure. Meta vous demandera des documents (Kbis, justificatif d'adresse, eventuellement appel video). Vous pouvez utiliser l'API sans verification immediate (avec des limites de volume), mais la verification est necessaire pour les conversations marketing et les volumes eleves.

Capture a venir : formulaire de verification d'entreprise

5

Creer une app Meta Developer et y ajouter WhatsApp

⏱ 5 min🔗 developers.facebook.com/apps

Allez sur developers.facebook.com/apps. Cliquez sur "Creer une App". Choisissez le type "Business". Donnez un nom (ex: "WhatsApp Homenichat - Mon Cabinet"), rattachez-la a votre Business Portfolio cree a l'etape 2.

Une fois l'app creee, dans le menu de gauche cliquez "Ajouter un produit" et choisissez WhatsApp. Suivez l'assistant. Meta vous demandera de selectionner votre WABA (cree a l'etape 3).

Capture a venir : Meta Developer Console avec "Ajouter un produit > WhatsApp"

6

Recuperer phoneNumberId et businessAccountId

⏱ 2 min

Dans votre app Developer, allez dans WhatsApp > API Setup. Vous voyez :

Champ Meta	Ou il sert dans Homenichat
Phone number ID	phoneNumberId
WhatsApp Business Account ID	businessAccountId

Copiez ces deux valeurs dans un brouillon en attendant. Ce sont des nombres (par exemple 589510807587130).

Capture a venir : page "WhatsApp > API Setup" avec les deux IDs encadres

7

Generer un Access Token permanent (System User)

⏱ 8 min🔑 A faire une seule fois

Le token temporaire affiche par defaut sur la page WhatsApp API Setup expire au bout de 24h. Pour un usage durable, il faut creer un System User qui detient un token permanent.

Dans Business Settings, allez dans Utilisateurs > Utilisateurs systeme.
Cliquez "Ajouter", donnez-lui un nom (ex: "WhatsApp Integrator Homenichat"), choisissez le role "Administrateur".
Une fois cree, cliquez "Ajouter des assets", ajoutez votre WABA avec les autorisations completes.
Cliquez "Generer un token". Choisissez votre app Meta Developer (etape 5).
Cochez les permissions : whatsapp_business_management et whatsapp_business_messaging.
Selectionnez "Le token n'expire jamais".
Copiez immediatement le token affiche. Il commence par EAA.... Meta ne le re-affichera plus jamais.

Capture a venir : Business Settings > Utilisateurs systeme > generation du token avec permissions cochees

Sauvegardez le token immediatement. Mettez-le dans un gestionnaire de mots de passe ou un endroit sur. Si vous le perdez, il faudra en regenerer un nouveau (ce qui invalidera l'ancien).

8

Recuperer l'App Secret (optionnel mais recommande)

⏱ 1 min

Dans Meta Developer Console, dans votre app, allez dans Parametres > General. Cliquez sur "Show" a cote de "Secret de l'app". Copiez la valeur.

Cette cle sert au relai Homenichat pour verifier que les webhooks recus viennent bien de Meta (signature HMAC). Sans elle, les webhooks fonctionnent mais sans verification de signature.

Capture a venir : Parametres > General avec l'App Secret affiche

9

Lancer l'assistant Homenichat sur votre telephone

⏱ 2 min

Ouvrez l'application Homenichat, allez dans Parametres > WhatsApp officiel Meta. Touchez "Configuration Meta assistee" et suivez les ecrans.

Quand vous arrivez a l'ecran "Configurez le webhook dans Meta", Homenichat vous affiche deux valeurs a copier-coller dans Meta :

La Callback URL publique. Elle a la forme https://webhooks.homenichat.com/meta/<votre-id>.
Un Verify Token genere par Homenichat (chaine de caracteres aleatoires). Meta s'en sert pour valider que c'est bien vous qui configurez le webhook.

Touchez "Copier" sur chaque champ, ou notez les valeurs.

Capture a venir : ecran "Webhook setup" dans l'app Homenichat avec les deux boutons Copier

10

Brancher le webhook dans Meta

⏱ 3 min

Retournez dans Meta Developer Console > votre app > WhatsApp > Configuration > Webhooks. Cliquez "Configurer un webhook".

Dans Callback URL, collez la valeur de Homenichat.
Dans Verify Token, collez le token genere par Homenichat.
Cliquez "Verifier et enregistrer". Meta envoie une requete de verification a Homenichat ; ca prend quelques secondes.

Si Meta dit "Verifie", parfait. Sinon, verifiez que vous avez bien colle les bonnes valeurs (pas d'espaces) et que votre HomeniBOX est en ligne.

Ensuite, sous "Champs du webhook", abonnez-vous au moins a : messages, message_template_status_update, account_update.

Capture a venir : page "Webhooks" dans Meta Developer avec callback URL et verify token colles

11

Coller les identifiants dans l'assistant Homenichat

⏱ 2 min

Retournez dans l'assistant Homenichat sur votre telephone, passez a l'ecran "Saisissez vos identifiants Meta", et collez :

Champ Homenichat	Valeur a y coller
phoneNumberId	Recupere a l'etape 6
businessAccountId	Recupere a l'etape 6
accessToken	Token EAA... de l'etape 7
appSecret	Recupere a l'etape 8 (optionnel)

Touchez "Verifier".

12

Validation finale

⏱ 1 min

Homenichat lance trois verifications automatiquement :

Connexion Meta Graph API : test que votre token est bon.
Listing des templates : verifie que vous pouvez envoyer/recevoir des modeles.
Activation du relai : Homenichat enregistre votre callback URL pour transmettre les webhooks Meta a votre BOX.

Trois feux verts ? C'est plie. Vos messages WhatsApp arriveront dans Homenichat des le prochain message client.

Test recommande Demandez a quelqu'un (votre conjoint, un ami) d'envoyer un WhatsApp a votre numero pro depuis son propre WhatsApp. Le message doit apparaitre dans l'inbox Homenichat dans la seconde. Si rien n'arrive sous 30 secondes, voir la section depannage ci-dessous.

Recap des valeurs collectees

Les 4 identifiants Meta

phoneNumberId	nombre, ex: 589510807587130
businessAccountId	nombre, ex: 578793621992297
accessToken	chaine longue commencant par EAA...
appSecret	chaine hex 32 caracteres (optionnel)

Depannage

Meta refuse mon callback URL ("Verification echouee")

Verifiez que votre HomeniBOX est en ligne (le voyant doit etre vert).
Verifiez que vous avez bien colle le verify token SANS espace avant ou apres.
Re-generez une nouvelle session dans l'app Homenichat et recommencez le branchement.
Si ca persiste : contactez-nous, on peut diagnostiquer le passage du challenge depuis nos serveurs.

L'access token est rejete avec "Invalid OAuth access token"

Verifiez que vous avez utilise le token System User permanent (etape 7), pas le token temporaire qui expire en 24h.
Verifiez que le System User a bien les deux permissions whatsapp_business_management et whatsapp_business_messaging.
Verifiez que votre System User a bien votre WABA dans ses assets, avec autorisations completes.

Aucun message entrant ne tombe dans Homenichat

Verifiez que vous etes bien abonne au champ messages dans les Webhooks Meta (etape 10).
Verifiez sur l'app que la box est en ligne.
Demandez a Meta de renvoyer un evenement de test : Meta Developer Console > Webhooks > "Tester".

Meta demande un moyen de paiement avant que je puisse envoyer

C'est normal pour les conversations marketing et au-dela de 1000 conversations service par mois. Dans Business Settings > Paiements, ajoutez une carte ou un compte bancaire. Vous n'etes pas facture si vous ne depassez pas le gratuit. Homenichat ne facture jamais vos messages : c'est Meta qui encaisse, directement.

Besoin d'aide ?

Si vous bloquez, ecrivez-nous a support@homenichat.com. Donnez-nous l'etape qui coince et un screenshot du message d'erreur si possible. On vous accompagne. Pour les utilisateurs Team (9 euros/mois), cette assistance est prioritaire.

Vous avez besoin de la HomeniBOX d'abord ?

Sans box, le wizard ne pourra pas activer le relai webhook a la fin. Voir nos configurations materiel.

Configurations materiel