Intégration WhatsApp

Connectez votre bot AskIA à WhatsApp Business afin que vos clients puissent discuter avec lui directement depuis leur téléphone.

Prérequis

Un compte AskIA avec au moins le plan Growth
Un compte Meta Business — business.facebook.com
Un numéro de téléphone WhatsApp Business (peut être un nouveau numéro — aucune SIM requise)
Une application Meta vérifiée avec le produit WhatsApp activé

Aucun compte WhatsApp existant requis

Vous n'avez pas besoin d'un compte WhatsApp existant. Meta vous permet d'enregistrer un nouveau numéro (par ex. un numéro VoIP) directement dans le portail développeur.

Étape 1 — Créer une Application Meta

Allez sur developers.facebook.com/apps
Cliquez sur Créer une App → choisissez le type Business
Sur le tableau de bord de l'app, cliquez sur Ajouter un Produit et sélectionnez WhatsApp
Suivez la configuration pour lier votre compte Meta Business et enregistrer un numéro de téléphone

Étape 2 — Collecter vos identifiants

Depuis la section WhatsApp de votre application Meta, notez :

Phone Number ID — trouvé sous WhatsApp → Configuration de l'API
Token d'accès permanent — générez-en un dans Meta Business Settings → Utilisateurs système
App Secret — trouvé sous Paramètres de l'app → Basique

Utilisez un token permanent

Les tokens temporaires expirent après 24 heures. Générez toujours un token permanent d'utilisateur système dans Meta Business Settings pour une utilisation en production.

Étape 3 — Ajouter le canal dans AskIA

Ouvrez votre bot dans le tableau de bord AskIA
Allez dans l'onglet Intégrations
Cliquez sur Ajouter un canal → WhatsApp
Remplissez :
- Phone Number ID
- Token d'accès
- App Secret
- Verify Token — choisissez une chaîne secrète, par ex. my-secret-token
Enregistrez le canal — AskIA vous affichera votre URL de Webhook

Étape 4 — Configurer le webhook dans Meta

Dans votre application Meta, allez dans WhatsApp → Configuration
Sous Webhook, cliquez sur Modifier
Entrez :
- URL de callback :
```
https://askiabot.com/api/webhooks/whatsapp/YOUR_BOT_ID
```
- Verify Token : la même chaîne que vous avez définie à l'étape 3
Cliquez sur Vérifier et Enregistrer
Sous Champs Webhook, abonnez-vous à messages

Remplacez YOUR_BOT_ID par l'ID du bot affiché dans votre tableau de bord AskIA (Paramètres → Bot ID).

Étape 5 — Tester

Envoyez un message à votre numéro WhatsApp Business depuis n'importe quel téléphone. Vous devriez recevoir une réponse du bot en quelques secondes.

Si le bot ne répond pas, vérifiez l'onglet Intégrations dans AskIA pour les journaux d'erreurs, et assurez-vous que le webhook est abonné au champ messages dans Meta.

Types de messages pris en charge

Messages texte — entièrement pris en charge
Messages vocaux — transcrits et traités automatiquement
Images — reçues mais non analysées (réponse textuelle uniquement)
Messages template — utilisés pour les notifications sortantes (par ex. mises à jour de statut de commande)

Fenêtre de messagerie de 24 heures

WhatsApp n'autorise les réponses libres que dans les 24 heures suivant le dernier message du client. Au-delà de cette fenêtre, le bot ne peut envoyer que des modèles de messages pré-approuvés. Il s'agit d'une politique Meta, pas d'une limitation AskIA.