Intégration de Clawdbot avec WhatsApp

Aperçu de l'intégration de Clawdbot avec WhatsApp

L'intégration de Clawdbot avec WhatsApp vous permet de connecter votre assistant IA personnel directement à WhatsApp, la plateforme de messagerie la plus populaire au monde. Clawdbot utilise WhatsApp Web via Baileys, avec le Gateway propriétaire de la session. Cela vous permet d'automatiser les conversations, de recevoir des réponses intelligentes et de gérer vos messages WhatsApp grâce à l'automatisation alimentée par l'IA.

Pourquoi utiliser Clawdbot avec WhatsApp ?

WhatsApp est utilisé par plus de 2 milliards de personnes dans le monde. En intégrant Clawdbot avec WhatsApp, vous débloquez de puissantes capacités d'IA :

Configuration rapide (Débutant)

1. Utilisez un numéro de téléphone séparé si possible (recommandé)
2. Configurez WhatsApp dans ~/.clawdbot/clawdbot.json
3. Exécutez clawdbot channels login pour scanner le code QR (Appareils liés)
4. Démarrez le gateway

Configuration minimale :

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Obtenir un numéro de téléphone

WhatsApp nécessite un véritable numéro de mobile pour la vérification. Les numéros VoIP et virtuels sont généralement bloqués. Il existe deux façons prises en charge d'exécuter Clawdbot sur WhatsApp :

Numéro dédié (Recommandé)

Utilisez un numéro de téléphone séparé pour Clawdbot WhatsApp. Cela offre la meilleure expérience utilisateur avec un routage propre et sans bizarreries d'auto-chat.

Configuration idéale : téléphone Android de rechange/ancien + eSIM. Laissez-le connecté au Wi-Fi et à l'alimentation, et liez-le via QR.

Astuce WhatsApp Business : Vous pouvez utiliser WhatsApp Business sur le même appareil avec un numéro différent pour garder votre WhatsApp personnel séparé.

Exemple de configuration (numéro dédié, liste d'autorisation à utilisateur unique) :

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Numéro personnel (Solution de secours)

Solution de secours rapide : exécutez Clawdbot sur votre propre numéro. Envoyez-vous un message (WhatsApp "Envoyez-vous un message") pour tester.

Exemple de configuration (numéro personnel, auto-chat) :

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

Conseils pour obtenir des numéros

• eSIM local de l'opérateur mobile de votre pays (le plus fiable)
• Carte SIM prépayée — bon marché, doit seulement recevoir un SMS de vérification
• À éviter : TextNow, Google Voice, la plupart des services de "SMS gratuits" — WhatsApp les bloque agressivement

Astuce : Le numéro doit seulement recevoir un SMS de vérification. Après cela, les sessions WhatsApp Web persistent via creds.json.

Configuration de Clawdbot WhatsApp

Prérequis

Avant de connecter Clawdbot à WhatsApp, assurez-vous d'avoir :

• Clawdbot installé sur votre appareil
• Un compte WhatsApp avec un numéro de téléphone actif
• Node.js 22 ou supérieur

Étape 1 : Configurer le canal WhatsApp

Ajoutez la configuration WhatsApp à votre ~/.clawdbot/clawdbot.json :

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Étape 2 : Se connecter avec le code QR

Exécutez la commande de connexion Clawdbot WhatsApp :

clawdbot channels login

Ouvrez WhatsApp sur votre téléphone, allez dans Paramètres > Appareils liés > Lier un appareil, et scannez le code QR affiché par Clawdbot.

Pour la connexion multi-comptes :

clawdbot channels login --account <id>

Étape 3 : Démarrer le Gateway

clawdbot gateway --port 18789

Étape 4 : Vérifier la connexion

Confirmez que votre intégration Clawdbot WhatsApp fonctionne :

clawdbot channels status whatsapp

Fonctionnalités de Clawdbot WhatsApp

Gestion intelligente des messages

Clawdbot WhatsApp traite les messages entrants et génère des réponses contextuelles. L'IA comprend l'historique des conversations et fournit des réponses pertinentes. Le modèle voit suffisamment de contexte pour comprendre les réponses citées.

Options de politique de messages directs

Support des messages de groupe

Clawdbot WhatsApp prend en charge les conversations de groupe. Les chats directs utilisent la session principale de l'agent ; les groupes restent isolés.

Support des médias

Clawdbot WhatsApp peut traiter et répondre à :

• Messages texte
• Images (avec IA de vision)
• Messages vocaux (audio PTT avec transcription)
• Documents
• Messages de localisation

Accusés de lecture

Clawdbot WhatsApp peut envoyer des accusés de lecture lorsqu'il est configuré.

Réactions d'accusé de réception

Réagir automatiquement à la réception pour confirmer la réception du message.

Configuration de Clawdbot WhatsApp

Exemple de configuration complète

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

Écritures de configuration

Par défaut, WhatsApp est autorisé à écrire des mises à jour de configuration déclenchées par /config set|unset. Désactiver avec :

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Stockage des identifiants Clawdbot WhatsApp

Clawdbot stocke les identifiants WhatsApp en toute sécurité :

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• Copie de sauvegarde à creds.json.bak (restaurée en cas de corruption)
• Compatibilité héritée : les anciennes installations stockaient les fichiers Baileys directement dans ~/.clawdbot/credentials/

Les données de votre session WhatsApp restent sur votre machine locale, garantissant la confidentialité.

Dépannage de Clawdbot WhatsApp

Connexion perdue

Si Clawdbot WhatsApp se déconnecte :

1. Vérifiez la connexion Internet
2. Réauthentifiez : clawdbot channels login
3. Consultez les journaux : cat /tmp/clawdbot/whatsapp.log

Les messages ne s'envoient pas

Si Clawdbot WhatsApp ne parvient pas à envoyer des messages :

1. Vérifiez l'état du compte : clawdbot channels status whatsapp
2. Vérifiez la configuration de la liste d'autorisation
3. Assurez-vous que le gateway Clawdbot est en cours d'exécution
4. Un écouteur actif est requis pour les envois sortants

Code QR expiré

Si le code QR de Clawdbot WhatsApp expire :

clawdbot channels logout
clawdbot channels login

Déconnexion

La déconnexion supprime l'état d'authentification WhatsApp (mais conserve le oauth.json partagé) :

clawdbot channels logout
# ou pour un compte spécifique
clawdbot channels logout --account <id>

Meilleures pratiques de Clawdbot WhatsApp

1. Utilisez un numéro dédié : Un numéro de téléphone séparé offre la meilleure expérience
2. Définissez des limites claires : Configurez des listes d'autorisation pour contrôler l'accès de Clawdbot WhatsApp
3. Surveillez l'utilisation : Consultez régulièrement les journaux de Clawdbot WhatsApp
4. Mettez à jour régulièrement : Maintenez Clawdbot à jour pour la dernière compatibilité WhatsApp
5. Sauvegardez les identifiants : Sauvegardez périodiquement vos identifiants Clawdbot WhatsApp

Pourquoi pas Twilio ?

Les numéros WhatsApp Business ne conviennent pas à un assistant personnel :

• Meta impose une fenêtre de réponse de 24 heures
• L'utilisation à volume élevé déclenche un blocage agressif
• Les comptes professionnels ne sont pas destinés aux messages d'assistant personnel

Prochaines étapes

• Intégration de Clawdbot avec Telegram - Connectez Clawdbot à Telegram
• Intégration de Clawdbot avec Discord - Configurez Clawdbot sur Discord
• Guide de configuration de Clawdbot - Guide d'installation complet