Pour activer WhatsApp sur Click-to-Connect, nous enregistrerons votre application Meta. 3 informations sont nécessaires :
- ID de l'application
- Clé secrète de l'application
- Jeton d'accès temporaire
Pour ce faire, nous devons préparer le terrain sur META. Créez et configurez :
- Un portefeuille de business.
- Une application
- Un compte WhatsApp Pro
Ce qu'il faut savoir :
- Pour effectuer ces actions sur Meta, vous devez disposer d'un compte développeur META
- Pour activer le compte WhatsApp Pro, vous devez disposer d'un numéro capable de répondre aux appels et/ou aux SMS
- L'utilisation du service META est gratuite jusqu'à un certain point, vous devrez enregistrer une méthode de paiement.
URL META utiles :
- Business Settings : https://business.facebook.com/latest/settings
- Gestionnaire WhatsApp : https://business.facebook.com/latest/whatsapp_manager
- Vos applications : https://developers.facebook.com/apps
- Utilisation d'APIS Meta : https://developers.facebook.com/tools/explorer
1. Création d'un portefeuille Business
- S'authentifier sur : https://business.facebook.com/latest/settings
- Dans la colonne de gauche, cliquez sur Créer un portefeuille business
Il suffit de configurer et d'utiliser l'adresse e-mail de votre administrateur Meta.
- Créer > Suivant > Suivant > Confirmer
2. Création de l'application
- Toujours sur cette page : https://business.facebook.com/latest/settings
- Cliquez sur Applications > Ajouter
- Cliquez sur Create a new app ID
-
Vous êtes maintenant sur la page de configuration de vos applications : https://developers.facebook.com/apps
-
Remplissez les détails de l'application > Suivant
- Choisissez votre cas d'utilisation, si aucun ne correspond, sélectionnez Autre > Suivant
-
Type d'application ; Enterprise > Suivant
- Vérifiez les détails > Envoyer
- Votre application a été créée et vous êtes maintenant sur son tableau de bord.
- Si une erreur s'est produite, vérifiez si votre application a été créée sur cette page : https://developers.facebook.com/apps
- Si c'est le cas, cliquez sur le nom de votre application pour accéder au tableau de bord.
Ajoutez des produits à votre application
- Sur le côté droit du tableau de bord, vous pouvez configurer 3 produits : WhatsApp, WebHooks et Facebook Login for Business.
- Copiez l'identifiant de l'app en haut de la page et conservez-le
3. Connectez votre application à votre portefeuille Business
- Retour à la page : https://business.facebook.com/latest/settings
-
Cliquez sur Applications > Ajouter
- Associez un identifiant d'application
- Demandez l'accès à un identifiant d'application
- Votre application apparaît maintenant sur votre portefeuille d'affaires.
- Nous devons maintenant affecter un utilisateur à cette application
- Menu de gauche > personnes
- Choisissez la personne à qui vous souhaitez attribuer des droits
- Attribuez votre application à cet utilisateur et donnez-lui le contrôle total
- Dans la section Applications, vous verrez maintenant la personne que vous avez choisie avec un contrôle total sur votre nouvelle application.
4. Créer un compte WhatsApp Business
- Toujours sur cette page : https://business.facebook.com/latest/settings
- Cliquez sur Compte WhatsApp > Ajouter
- Remplissez les détails
- Ajoutez un numéro de téléphone et choisissez comment vous souhaitez être contacté pour recevoir le code de vérification > Continuer
- Entrez votre code de vérification > Suivant
- Conservez ce code PIN
- Votre compte WhatsApp Business a été créé
- Conservez l'identifiant de votre compte WhatsApp Business
5. Enregistrer votre numéro WhatsApp
- Ouvrez l'explorateur Graph API : https://developers.facebook.com/tools/explorer
- Sur la droite, sélectionnez votre autorisation WhatsApp et votre application Meta, puis générez un jeton d'accès.
- Authentifiez-vous
- Sélectionnez votre application
Nous allons maintenant envoyer 2 requêtes :
- Reprise de l'IPHONE_ID
- GET / <WABA_ID>/numéros_de_téléphone
- WABA_ID = l'identifiant de votre compte WhatsApp Business
- Conservez l'identifiant = PHONE_ID
Sauvegarder le numéro de téléphone sur le portefeuille Business :
- POST / PHONE_ID> / enregistrer
- Cet objet doit également être collé dans la section JSON située à gauche
{
"messaging_product" : "whatsapp",
"pin" : "<YOUR_PIN>"
}
6. Configuration de l'application META
- Retour à la page : https://developers.facebook.com/apps
- Sélectionnez votre application
- Dans la colonne de gauche, App Settings > Advanced
- Allow API access to app parameters > Save changes
- Dans la colonne de gauche, Facebook Login for Business > Paramètres
- Connexion OAuth intégrée au navigateur
- Dans la section "URI de redirection OAuth valide", entrez l'URL en fonction de l'environnement de l'instance C2C :
- RED : https://red-c2c-admin.openrainbow.io/main/settings/global/
- PROD : https://click-to-connect-admin.openrainbow.io/main/settings/global/
- Sauvegardez les modifications
7. Enregistrer et activer votre application META sur Click-to-Connect Administration
N'oubliez pas que 3 informations sont requises :
- ID de l'application (vous l'avez)
- Clé secrète de l'application
- Jeton d'accès temporaire (vous pouvez en générer un nouveau dans l'API Graph Explorer)
Récupération de la clé secrète de votre application :
- Retour à la page : https://developers.facebook.com/apps
- Sélectionnez votre application
- Paramètres de l'application > Général
- Clé secrète > Afficher
S'authentifier sur Click-to-Connect Admin :
- Paramètres > WhatsApp
- Remplissez les champs du formulaire avec les informations requises et sauvegardez.
- Vous êtes alors redirigé vers OAuth Meta > Reassociate
- Vous êtes ensuite redirigé vers Click-to-Connect Admin.
L'activation peut prendre quelques secondes, mais vous finirez par voir apparaître des messages WhatsApp que vous pourrez personnaliser.
- Si là les messages n'apparaissent pas, n'hésitez pas à recharger la page pour vous assurer que l'activation a bien travaillé.
- Reprenez l'ID de votre Bot utilisateur connecté à Click-to-Connect Admin
- Cliquez sur l'icône en haut à droite de l'application pour le découvrir.
- Conservez cet identifiant
8. Configuration des Webhooks
- Retour à la page : https://developers.facebook.com/apps
- Sélectionnez votre application
- Dans la colonne de gauche, Webhooks
URL de rappel :
- RED : "https://red-c2c.openrainbow.io/webhook/meta/whatsapp/<RAINBOW_USER_BOT_ID>".
- PROD : "https://click-to-connect.openrainbow.io/webhook/meta/whatsapp/<RAINBOW_USER_BOT_ID>".
Vérifier le Token :
- Saisissez le jeton d'accès saisi dans Click-to-Connect Admin.
- Vérifiez et enregistrez
- Puis souscrivez à toutes les options
Nous allons maintenant faire la même chose dans la section WhatsApp
- Dans la colonne de gauche, WhatsApp > Configuration
URL de rappel :
- RED : : "https://red-c2c.openrainbow.io/webhook/meta/whatsapp/<RAINBOW_USER_BOT_ID>".
- PROD : : "https://click-to-connect.openrainbow.io/webhook/meta/whatsapp/<RAINBOW_USER_BOT_ID>".
Vérifier le jeton :
- Indiquez le jeton d'accès dans Click-to-Connect
- Vérifiez et enregistrez
- Souscrivez ensuite à toutes les options
9. Vérification finale
- Sur la page du WhatsApp Manager : https://business.facebook.com/latest/whatsapp_manager
- Dans la colonne de gauche : Outils de compte > Numéros de téléphone
Vous pouvez voir le numéro de votre compte WhatsApp Business, s'il affiche un statut " Connecté " et une qualité élevée, tout s'est bien passé
C'est ici que vous pouvez personnaliser son apparence dans l'application WhatsApp (votre logo par exemple).
10. Testez votre configuration
- Il ne vous reste plus qu'à tester votre configuration
- Envoyez un message WhatsApp à votre compte WhatsApp Business
- S'il répond, tout va bien, sinon contactez l'assistance Click-to-Connect.