Connectez OpenClaw à Zalo en utilisant l'API Official Account. Ce guide couvre OpenClaw v2026.2+, la configuration Zalo OA, la configuration des identifiants API, la gestion des messages et l'intégration webhook pour les assistants IA auto-hébergés.
Intégration Zalo
Connectez OpenClaw à Zalo et laissez votre assistant IA répondre aux messages instantanément.
En résumé
- ✓ Prérequis : Node.js 22+, OpenClaw installé
- ✓ Configuration : Ajouter la section Zalo à openclaw.json
- ✓ Temps : environ 10 minutes
- ✓ Nécessite : Compte Zalo + OA (Compte Officiel)
Prérequis
- 1.
OpenClaw installé
Suivez le guide d'installation si ce n'est pas déjà fait.
- 2.
Compte Officiel Zalo (OA)
Vous devez créer un Compte Officiel Zalo sur oa.zalo.me.
- 3.
Identifiants API Zalo
Obtenez votre ID OA et votre clé API depuis le tableau de bord Zalo OA.
Étapes de configuration
Étape 1 : Créer un Compte Officiel Zalo
Si vous n'avez pas encore d'OA :
- Visitez oa.zalo.me
- Inscrivez-vous pour un Compte Officiel (suivez l'assistant)
- Vérifiez votre compte
- Obtenez votre ID OA depuis le tableau de bord
Étape 2 : Configurer openclaw.json
Ajoutez la configuration Zalo à votre fichier openclaw.json :
{
"channels": {
"zalo": {
"enabled": true,
"oaId": "your_oa_id",
"apiKey": "your_api_key",
"allowFrom": ["*"]
}
}
}Étape 3 : Démarrer OpenClaw
Démarrez OpenClaw avec Zalo activé :
openclaw startLe bot se connectera à Zalo et sera prêt à recevoir des messages.
Étape 4 : Tester votre assistant IA
Ouvrez Zalo et recherchez votre Compte Officiel :
- Ouvrez l'application Zalo
- Recherchez le nom de votre OA
- Envoyez un message pour démarrer une conversation
🎉 Connecté ! Votre assistant IA Zalo est maintenant prêt.
Configuration avancée
Autoriser des utilisateurs spécifiques
Limitez qui peut interagir avec votre assistant IA :
{
"channels": {
"zalo": {
"enabled": true,
"oaId": "your_oa_id",
"apiKey": "your_api_key",
"allowFrom": ["user_id_1", "user_id_2"]
}
}
}Configuration du Webhook
Pour les fonctionnalités avancées, configurez le webhook dans le tableau de bord Zalo OA :
- Allez dans le tableau de bord OA → Paramètres avancés → Webhook
- Définissez l'URL du webhook sur votre serveur OpenClaw
- Activez les événements que vous souhaitez recevoir
Dépannage
Clé API invalide ?
Vérifiez votre clé API dans le tableau de bord Zalo OA. Assurez-vous que l'API est activée pour votre compte.
Messages non reçus ?
Vérifiez que votre openclaw.json a "enabled": true pour le canal Zalo et consultez les logs.
OA non trouvé ?
Assurez-vous que votre Compte Officiel est vérifié et actif. Les nouveaux OA peuvent nécessiter une approbation préalable.
Guides connexes
Questions fréquentes
Zalo OA est-il gratuit ?
Les Comptes Officiels Zalo ont des niveaux gratuit et premium. Les fonctionnalités API de base sont gratuites avec des limitations. Consultez les tarifs Zalo pour les détails.
Puis-je utiliser un compte Zalo personnel ?
Non, vous avez besoin d'un Compte Officiel Zalo (OA) pour utiliser l'API. Créez-en un sur oa.zalo.me.
Zalo supporte-t-il les messages de groupe ?
Zalo OA peut envoyer des messages aux utilisateurs qui ont interagi avec votre OA. Pour les messages de groupe, vous devez gérer une page fan.
Comment obtenir les identifiants API ?
Allez sur oa.zalo.me, sélectionnez votre OA, allez dans Paramètres avancés → API → Créer une clé API.