Aller au contenu principal

Configuration

Après avoir installé et activé le module WhatsApp Cloud API Chat & Marketing, vous devez configurer la connexion entre Perfex CRM et l'API WhatsApp Cloud de Meta. Cela implique la création d'une application Meta, la génération des identifiants API, la configuration des webhooks et l'ajustement des paramètres du module.

Configuration de l'application Meta​

L'API WhatsApp Cloud est accessible via une application Meta (Facebook). Si vous n'en avez pas encore créé une, suivez ces étapes.

Étape 1 — Créer un compte Facebook Developers​

  1. Rendez-vous sur developers.facebook.com.
  2. Connectez-vous avec votre compte Facebook.
  3. Si vous y êtes invité, inscrivez-vous en tant que développeur en acceptant les conditions et en vérifiant votre compte.

Étape 2 — Créer une application Meta​

  1. Dans le tableau de bord Facebook Developers, cliquez sur Créer une application.
  2. Sélectionnez Business comme type d'application (ou Autre si Business n'est pas disponible pour votre type de compte).
  3. Saisissez un Nom d'application (ex. : "Perfex CRM WhatsApp") et votre email de contact.
  4. Sélectionnez votre Compte Business (ou créez-en un si nécessaire).
  5. Cliquez sur Créer une application.

Étape 3 — Ajouter WhatsApp à votre application​

  1. Sur le tableau de bord de votre nouvelle application, trouvez WhatsApp dans la liste des produits et cliquez sur Configurer.
  2. Suivez la configuration guidée pour lier un Compte WhatsApp Business.
  3. Un numéro de téléphone de test est automatiquement fourni pour le développement. Vous pourrez ajouter votre propre numéro de téléphone professionnel vérifié ultérieurement.
info

Le numéro de téléphone de test vous permet d'envoyer des messages à un maximum de 5 numéros pré-enregistrés. Pour une utilisation en production, ajoutez et vérifiez votre propre numéro de téléphone professionnel dans les paramètres du compte WhatsApp Business.

Étape 4 — Générer un token d'accès permanent​

Le token temporaire par défaut expire après 24 heures. Pour la production, générez un token d'utilisateur système permanent :

  1. Rendez-vous sur business.facebook.com et naviguez vers Paramètres Business > Utilisateurs système.
  2. Créez un nouvel Utilisateur système (ou utilisez-en un existant) avec un accès Admin.
  3. Cliquez sur Générer un nouveau token, sélectionnez votre application WhatsApp et accordez les permissions suivantes :
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Copiez le token généré — il s'agit de votre token d'accès permanent.
attention

Le token permanent n'est affiché qu'une seule fois. Conservez-le en lieu sûr. En cas de perte, vous devrez en générer un nouveau et mettre à jour les paramètres de votre module.

Configuration du webhook​

Les webhooks permettent à WhatsApp de notifier votre instance Perfex CRM des messages entrants, des accusés de réception et des mises à jour de statut en temps réel.

Configuration du webhook​

  1. Dans le tableau de bord Facebook Developers, allez sur la page WhatsApp > Configuration de votre application.
  2. Sous Webhook, cliquez sur Modifier.
  3. Saisissez l'URL de rappel fournie par le module (trouvable dans Module WhatsApp > Paramètres dans Perfex CRM). Elle suit généralement ce format : 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. Saisissez le Token de vérification affiché dans les paramètres du module.
  5. Cliquez sur Vérifier et enregistrer.
  6. Abonnez-vous aux champs webhook suivants :
    • messages
    • message_template_status_update
astuce

Votre installation Perfex CRM doit être servie en HTTPS avec un certificat SSL valide. Meta rejettera les URL de webhook utilisant HTTP ou ayant des certificats invalides/auto-signés.

Paramètres du module​

Après avoir terminé la configuration de l'application Meta, configurez le module dans Perfex CRM.

  1. Naviguez vers le module WhatsApp Cloud API dans la barre latérale de Perfex CRM.
  2. Allez dans Paramètres et saisissez les informations suivantes :
ParamètreDescription
Token d'accèsLe token d'utilisateur système permanent généré ci-dessus
ID du numéro de téléphoneTrouvable sur la page WhatsApp > Premiers pas de votre application Meta
ID du compte WhatsApp BusinessTrouvable dans les paramètres WhatsApp de votre application Meta
Token de vérification du webhookUne chaîne personnalisée que vous définissez — doit correspondre à ce que vous avez saisi dans la configuration du webhook Meta
ID de l'applicationL'ID de votre application Meta (trouvable sur le tableau de bord de l'application)
  1. Cliquez sur Enregistrer les paramètres.
  2. Utilisez le bouton Tester la connexion pour vérifier que le module peut communiquer avec l'API WhatsApp Cloud.

Configuration de l'intégration​

Pour les configurations avancées, le module prend en charge l'intégration du widget de chat WhatsApp sur des pages externes ou des portails clients. Naviguez vers Module WhatsApp > Paramètres > Intégration pour générer un extrait de code d'intégration et personnaliser l'apparence du widget (couleurs, position, message de bienvenue).

Vérification de l'entreprise​

Pour débloquer la capacité de messagerie complète et l'accès à toutes les catégories de templates, complétez la vérification de votre entreprise Meta :

  1. Rendez-vous sur business.facebook.com > Paramètres Business > Centre de sécurité.
  2. Cliquez sur Démarrer la vérification et suivez le processus guidé.
  3. Soumettez les documents de votre entreprise comme demandé par Meta.
  4. La vérification prend généralement 2 à 5 jours ouvrables.
info

Sans vérification de l'entreprise, votre messagerie est limitée à 250 destinataires uniques par fenêtre glissante de 24 heures. Après vérification, les limites augmentent progressivement en fonction de la qualité et du volume des messages.

Et ensuite ?​

  • Guide d'utilisation — apprenez à utiliser l'interface de chat, lancer des campagnes, configurer des bots et gérer les templates
  • Journaux WhatsApp — consultez les enregistrements complets de toutes les interactions automatisées