",
"groupPolicy": "allowlist",
"channels": {
"CHANNEL_ID": {
"allow": true,
"requireMention": true
}
}
}
}
}
```
### Fonctionnalités
- Mode Socket ou mode HTTP
- Configuration par salon avec listes blanches
- Historique tenant compte des fils (portée fil ou salon)
- Support de token utilisateur (lecture seule par défaut)
- Intégration de commandes slash (avec option de réponse éphémère)
- Mode de réponse par type de chat (direct, groupe, salon)
- Support des salons de groupe en MP
- Actions : réactions, messages, épingles, recherche, permissions, infos membres, infos salons, liste d'emojis
---
## WhatsApp
### Prérequis d'installation
- Baileys : aucun identifiant externe nécessaire (scan de code QR)
- Cloud API : token d'accès à l'API WhatsApp Business et ID de numéro de téléphone
### Configuration clé
```json
{
"connectors": {
"whatsapp": {
"accounts": {
"default": {
"enabled": true,
"authDir": "./auth/whatsapp"
}
},
"dmPolicy": "pairing",
"sendReadReceipts": true,
"debounceMs": 0
}
}
}
```
### Fonctionnalités
- Répertoire d'authentification par compte pour la persistance de session Baileys
- Mode auto-chat pour les tests
- Préfixe de message pour les messages sortants
- Réactions d'accusé de réception (emoji configurable, comportement MP/groupe)
- Temporisation pour les messages rapides
- Configuration par groupe avec exigences de mention
- Actions : réactions, envoi de message, sondages
Consultez le [Guide d'intégration WhatsApp](/fr/guides/whatsapp) pour des instructions de configuration détaillées.
---
## Signal
### Prérequis d'installation
- signal-cli fonctionnant en mode HTTP/JSON-RPC
- Compte Signal enregistré
### Configuration clé
```json
{
"connectors": {
"signal": {
"enabled": true,
"account": "+1234567890",
"httpUrl": "http://localhost:8080",
"dmPolicy": "pairing"
}
}
}
```
### Fonctionnalités
- Configuration par URL HTTP ou hôte/port
- Chemin CLI avec démarrage automatique optionnel
- Configuration du délai de démarrage (1-120 secondes)
- Mode de réception (`on-start` ou `manual`)
- Options de gestion des pièces jointes et des stories
- Support des accusés de lecture
- Notifications de réactions et niveaux
---
## iMessage
### Prérequis d'installation
- macOS avec iMessage configuré
- Outil CLI pour l'accès à iMessage (par ex., `imessage-exporter`)
### Configuration clé
```json
{
"connectors": {
"imessage": {
"enabled": true,
"cliPath": "/usr/local/bin/imessage-exporter",
"service": "auto",
"dmPolicy": "pairing"
}
}
}
```
> **Note d'activation automatique :** Le connecteur s'active automatiquement lorsque `cliPath` est défini. Sans cela, le plugin ne se chargera pas.
### Fonctionnalités
- Sélection du service : `imessage`, `sms` ou `auto`
- Configuration du chemin CLI et du chemin de la base de données
- Support d'hôte distant
- Configuration de la région
- Basculement de l'inclusion des pièces jointes
- Configuration des mentions et des outils par groupe
---
## BlueBubbles
Se connecte à iMessage via un serveur [BlueBubbles](https://bluebubbles.app) local sur macOS. Contrairement au connecteur iMessage direct, BlueBubbles est accessible par réseau — l'agent n'a pas besoin de tourner sur le même Mac qu'iMessage.
### Prérequis d'installation
- Un Mac avec iMessage connecté et le [serveur BlueBubbles](https://bluebubbles.app) installé
- Le mot de passe du serveur et l'URL accessible depuis la machine exécutant Eliza
### Configuration clé
```json
{
"connectors": {
"bluebubbles": {
"password": "VOTRE_MOT_DE_PASSE_BLUEBUBBLES",
"serverUrl": "http://192.168.1.50:1234"
}
}
}
```
**Variables d'environnement :** `BLUEBUBBLES_PASSWORD`, `BLUEBUBBLES_SERVER_URL`
### Fonctionnalités
- Envoyer et recevoir des iMessages et SMS via un serveur BlueBubbles local
- Réactions tapback (ajout et suppression)
- Répondre à des messages spécifiques dans des fils
- Modifier et annuler des messages envoyés (dépendant de la version macOS)
- Envoyer des pièces jointes avec légendes et effets iMessage
- Gestion des participants de discussions de groupe
- Support des accusés de lecture
- Gestion des messages entrants basée sur les webhooks
Consultez la [référence du connecteur BlueBubbles](/connectors/bluebubbles) pour la référence complète de configuration.
---
## Blooio
Se connecte à la messagerie iMessage et SMS via le service Blooio avec des webhooks signés.
### Prérequis d'installation
- Clé API Blooio
- URL de webhook pour la réception des messages
### Configuration clé
```json
{
"connectors": {
"blooio": {
"enabled": true,
"apiKey": "YOUR_BLOOIO_API_KEY",
"webhookUrl": "https://your-domain.com/blooio/webhook"
}
}
}
```
**Variables d'environnement :** `BLOOIO_API_KEY`, `BLOOIO_WEBHOOK_URL`
### Fonctionnalités
- Messagerie iMessage et SMS via la passerelle Blooio
- Vérification de webhook signé pour les messages entrants
- Envoi de messages sortants
- Activation automatique lorsque `apiKey` est configuré
---
## Microsoft Teams
### Prérequis d'installation
- Enregistrement de bot Azure (ID d'application et mot de passe d'application)
- ID de locataire
### Configuration clé
```json
{
"connectors": {
"msteams": {
"enabled": true,
"botToken": "APP_PASSWORD",
"appId": "APP_ID",
"appPassword": "APP_PASSWORD",
"tenantId": "TENANT_ID",
"dmPolicy": "pairing"
}
}
}
```
> **Note d'activation automatique :** Le connecteur s'active automatiquement lorsque `botToken`, `token` ou `apiKey` est présent dans la configuration. Définissez `botToken` sur le mot de passe de l'application pour déclencher l'activation automatique.
### Fonctionnalités
- Configuration par équipe et par salon
- Configuration du style de réponse
- Paramètres de port et de chemin du webhook
- Listes blanches d'hôtes média (pour le téléchargement et l'authentification)
- ID de site SharePoint pour les téléversements de fichiers dans les discussions de groupe
- Support média jusqu'à 100 Mo (téléversement OneDrive)
---
## Google Chat
### Prérequis d'installation
- Compte de service Google Cloud avec accès à l'API Chat
- Fichier de clé JSON du compte de service ou configuration en ligne
### Configuration clé
```json
{
"connectors": {
"googlechat": {
"enabled": true,
"apiKey": "placeholder",
"serviceAccountFile": "./service-account.json",
"audienceType": "project-number",
"audience": "123456789",
"webhookPath": "/google-chat"
}
}
}
```
> **Note d'activation automatique :** Google Chat utilise l'authentification par compte de service, pas une clé API traditionnelle. Incluez `"apiKey": "placeholder"` pour déclencher l'activation automatique — l'authentification réelle utilise le fichier de compte de service.
### Fonctionnalités
- Authentification par compte de service (chemin de fichier ou JSON en ligne)
- Configuration du type d'audience (`app-url` ou `project-number`)
- Configuration du chemin et de l'URL du webhook
- Configuration par groupe avec exigences de mention
- Modes d'indicateur de saisie (`none`, `message`, `reaction`)
- Politique de MP avec support des discussions de groupe
---
### Prérequis d'installation
- Identifiants API Twitter v2 (clé API, clé secrète API, token d'accès, secret du token d'accès)
### Configuration clé
```json
{
"connectors": {
"twitter": {
"enabled": true,
"apiKey": "...",
"apiSecretKey": "...",
"accessToken": "...",
"accessTokenSecret": "...",
"postEnable": true,
"postIntervalMin": 90,
"postIntervalMax": 180
}
}
}
```
### Fonctionnalités
- Publication automatisée avec intervalles et variance configurables
- Option de publication immédiate
- Surveillance des recherches et des mentions
- Sélection de l'algorithme de timeline (`weighted` ou `latest`)
- Réponse automatique aux mentions
- Basculement du traitement des actions
- Mode simulation pour les tests
- Longueur maximale de tweet configurable (par défaut : 4000)
---
## Farcaster
### Prérequis d'installation
- Clé API Neynar (depuis [neynar.com](https://neynar.com))
- Compte Farcaster avec un UUID de signataire Neynar
- Identifiant Farcaster (FID) du compte de l'agent
### Configuration clé
```json
{
"connectors": {
"farcaster": {
"enabled": true,
"apiKey": "YOUR_NEYNAR_API_KEY",
"signerUuid": "YOUR_SIGNER_UUID",
"fid": 12345,
"channels": ["ai", "agents"],
"castIntervalMin": 120,
"castIntervalMax": 240
}
}
}
```
### Fonctionnalités
- Publication autonome (casting) à intervalles configurables
- Réponse aux @mentions et aux réponses de casts
- Surveillance et participation aux canaux
- Réactions (likes et recasts)
- Casts directs (messages privés)
- Identité on-chain liée à l'adresse Ethereum
- Découpage des fils de casts pour les messages dépassant 320 caractères
---
## Bluesky
### Prérequis d'installation
- Identifiants de compte Bluesky (handle et mot de passe d'application)
### Configuration clé
```json
{
"connectors": {
"bluesky": {
"enabled": true,
"postEnable": true,
"postIntervalMin": 90,
"postIntervalMax": 180
}
}
}
```
**Variables d'environnement :** `BLUESKY_ENABLED`, `BLUESKY_DRY_RUN`, `BLUESKY_USERNAME`, `BLUESKY_PASSWORD`, `BLUESKY_HANDLE`
### Fonctionnalités
- Création de publications à intervalles configurables
- Surveillance des mentions et des réponses
- Mode simulation pour les tests
- Réseau social décentralisé basé sur le protocole AT
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-bluesky`.
---
## Instagram
### Prérequis d'installation
- Identifiants de compte Instagram (nom d'utilisateur et mot de passe)
### Configuration clé
```json
{
"connectors": {
"instagram": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `INSTAGRAM_USERNAME`, `INSTAGRAM_PASSWORD`, `INSTAGRAM_DRY_RUN`, `INSTAGRAM_POLL_INTERVAL`, `INSTAGRAM_POST_INTERVAL_MIN`, `INSTAGRAM_POST_INTERVAL_MAX`
### Fonctionnalités
- Publication de médias avec génération de légendes
- Surveillance et réponse aux commentaires
- Gestion des MP
- Mode simulation pour les tests
- Intervalles de publication et de sondage configurables
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-instagram`.
---
## Twitch
### Prérequis d'installation
- ID client et token d'accès de l'application Twitch
- Canal Twitch auquel se connecter
### Configuration clé
```json
{
"connectors": {
"twitch": {
"enabled": true,
"clientId": "YOUR_CLIENT_ID",
"accessToken": "YOUR_ACCESS_TOKEN"
}
}
}
```
### Fonctionnalités
- Surveillance et réponse au chat en direct
- Gestion des événements de canal
- Gestion des interactions avec l'audience
- Activation automatique lorsque `clientId` ou `accessToken` est configuré
---
## Mattermost
### Prérequis d'installation
- Token de bot Mattermost (depuis Console système > Intégrations > Comptes de bot)
- URL du serveur Mattermost
### Configuration clé
```json
{
"connectors": {
"mattermost": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"baseUrl": "https://chat.example.com",
"chatmode": "all",
"requireMention": false
}
}
}
```
**Variables d'environnement :** `MATTERMOST_BOT_TOKEN`, `MATTERMOST_SERVER_URL`
### Fonctionnalités
- Messagerie dans les salons et en MP
- Restriction du mode de chat (`dm-only`, `channel-only` ou `all`)
- Filtrage par mention (exiger optionnellement les @mentions)
- Déclencheurs de préfixe de commande personnalisé
- Support de serveur auto-hébergé
---
## WeChat
Se connecte à WeChat via un service proxy tiers utilisant la connexion par compte personnel.
### Prérequis d'installation
1. Obtenir une clé API du service proxy WeChat
2. Configurer l'URL du proxy et le port du webhook
3. Scanner le code QR affiché dans le terminal au premier démarrage
### Avis de confidentialité
Le connecteur WeChat dépend d'un service proxy fourni par l'utilisateur. Ce proxy reçoit
votre clé API de connecteur ainsi que les charges utiles de messages et les métadonnées nécessaires
pour relayer le trafic WeChat entrant et sortant. Ne pointez `proxyUrl` que vers une infrastructure
que vous exploitez vous-même ou en laquelle vous avez explicitement confiance pour ce flux de messages.
### Configuration clé
```json
{
"connectors": {
"wechat": {
"apiKey": "",
"proxyUrl": "https://...",
"webhookPort": 18790,
"deviceType": "ipad"
}
}
}
```
| Champ | Description |
|-------|------------|
| `apiKey` | **Requis** -- Clé API du service proxy |
| `proxyUrl` | **Requis** -- URL du service proxy |
| `webhookPort` | Port du listener webhook (par défaut : 18790) |
| `deviceType` | Type d'émulation d'appareil : `ipad` ou `mac` (par défaut : `ipad`) |
**Variables d'environnement :** `WECHAT_API_KEY`
**Multi-comptes :** Supporté via la map `accounts` (même schéma que WhatsApp).
### Fonctionnalités
- Messagerie texte en MP (activée par défaut)
- Support des discussions de groupe (activer avec `features.groups: true`)
- Envoi/réception d'images (activer avec `features.images: true`)
- Connexion par code QR avec persistance automatique de session
- Support multi-comptes via la map accounts
---
## Matrix
### Prérequis d'installation
- Compte Matrix sur n'importe quel homeserver (par ex., matrix.org ou auto-hébergé)
- Token d'accès pour le compte bot
### Configuration clé
```json
{
"env": {
"MATRIX_ACCESS_TOKEN": "syt_your_access_token"
},
"connectors": {
"matrix": {
"enabled": true,
"token": "syt_your_access_token"
}
}
}
```
> **Note d'activation automatique :** Le connecteur s'active automatiquement lorsque `token`, `botToken` ou `apiKey` est présent dans la configuration du connecteur. Définir `"enabled": true` seul n'est pas suffisant — incluez le champ `token`.
**Variables d'environnement :** `MATRIX_ACCESS_TOKEN`, `MATRIX_HOMESERVER`, `MATRIX_USER_ID`, `MATRIX_DEVICE_ID`, `MATRIX_ROOMS`, `MATRIX_AUTO_JOIN`, `MATRIX_ENCRYPTION`, `MATRIX_REQUIRE_MENTION`
### Fonctionnalités
- Messagerie dans les salons et en MP sur n'importe quel homeserver conforme aux spécifications
- Rejoindre automatiquement les invitations de salon
- Support du chiffrement de bout en bout (Olm)
- Filtrage par mention dans les salons
- Support de la fédération entre homeservers
---
## Feishu / Lark
### Prérequis d'installation
- Application personnalisée Feishu/Lark avec ID d'application et secret d'application
- Capacité bot activée sur l'application
### Configuration clé
```json
{
"env": {
"FEISHU_APP_ID": "cli_your_app_id",
"FEISHU_APP_SECRET": "your_app_secret"
},
"connectors": {
"feishu": {
"enabled": true,
"apiKey": "your_app_secret"
}
}
}
```
> **Note d'activation automatique :** Le connecteur s'active automatiquement lorsque `apiKey`, `token` ou `botToken` est présent dans la configuration du connecteur. Définissez `apiKey` sur le secret de l'application pour déclencher l'activation automatique.
**Variables d'environnement :** `FEISHU_APP_ID`, `FEISHU_APP_SECRET`, `FEISHU_DOMAIN`, `FEISHU_ALLOWED_CHATS`
### Fonctionnalités
- Messagerie directe du bot et discussions de groupe
- Liste blanche de chats pour le contrôle d'accès
- Support des domaines Chine (`feishu.cn`) et global (`larksuite.com`)
- Abonnement aux événements pour les messages en temps réel
---
## Nostr
### Prérequis d'installation
- Clé privée Nostr (format nsec ou hex)
### Configuration clé
```json
{
"env": {
"NOSTR_PRIVATE_KEY": "nsec1your_private_key"
},
"connectors": {
"nostr": {
"enabled": true,
"token": "placeholder"
}
}
}
```
> **Note d'activation automatique :** Nostr utilise l'authentification par clé, pas un token traditionnel. Incluez `"token": "placeholder"` dans la configuration du connecteur pour déclencher l'activation automatique — l'authentification réelle utilise la variable d'environnement `NOSTR_PRIVATE_KEY`.
**Variables d'environnement :** `NOSTR_PRIVATE_KEY`, `NOSTR_RELAYS`, `NOSTR_DM_POLICY`, `NOSTR_ALLOW_FROM`, `NOSTR_ENABLED`
### Fonctionnalités
- Connectivité multi-relais
- Publication de notes (événements kind 1)
- Messages directs chiffrés NIP-04
- Politiques d'accès MP (autoriser, refuser, liste blanche)
- Entièrement décentralisé via le réseau de relais
---
## LINE
### Prérequis d'installation
- Token d'accès du canal LINE
- Secret du canal LINE
### Configuration clé
```json
{
"connectors": {
"line": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `LINE_CHANNEL_ACCESS_TOKEN`, `LINE_CHANNEL_SECRET`, `LINE_CUSTOM_GREETING`
### Fonctionnalités
- Messagerie bot et conversations clients
- Types de messages enrichis (texte, autocollant, image, vidéo)
- Support des discussions de groupe
- Gestion d'événements basée sur les webhooks
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-line`.
---
## Zalo
### Prérequis d'installation
- Token d'accès du compte officiel Zalo (OA)
### Configuration clé
```json
{
"connectors": {
"zalo": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `ZALO_ACCESS_TOKEN`, `ZALO_REFRESH_TOKEN`, `ZALO_APP_ID`, `ZALO_APP_SECRET`
### Fonctionnalités
- Messagerie de compte officiel et workflows de support
- Gestion de messages basée sur les webhooks
- Gestion des interactions clients
Une variante pour compte personnel est également disponible sous `@elizaos/plugin-zalouser` pour la messagerie individuelle en dehors du système de compte officiel.
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-zalo`.
---
## Twilio
### Prérequis d'installation
- SID de compte Twilio et token d'authentification
- Un numéro de téléphone Twilio
### Configuration clé
```json
{
"connectors": {
"twilio": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_PHONE_NUMBER`
### Fonctionnalités
- Messagerie SMS (envoi et réception)
- Capacités d'appels vocaux
- Gestion des messages entrants basée sur les webhooks
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-twilio`.
---
## GitHub
### Prérequis d'installation
- Token API GitHub (token d'accès personnel ou token à portée fine)
### Configuration clé
```json
{
"connectors": {
"github": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `GITHUB_API_TOKEN`, `GITHUB_OWNER`, `GITHUB_REPO`
### Fonctionnalités
- Gestion de dépôts
- Suivi et création d'issues
- Workflows de pull requests (création, revue, fusion)
- Recherche de code et accès aux fichiers
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-github`.
---
## Gmail Watch
### Prérequis d'installation
- Compte de service Google Cloud ou identifiants OAuth avec accès à l'API Gmail
### Configuration clé
Gmail Watch est activé via le drapeau `features.gmailWatch` ou les variables d'environnement plutôt que la section `connectors`.
### Fonctionnalités
- Surveillance des messages Gmail via Pub/Sub
- Renouvellement automatique des abonnements de surveillance
- Gestion des événements d'e-mails entrants
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-gmail-watch`.
---
## Nextcloud Talk
### Prérequis d'installation
- URL du serveur Nextcloud et identifiants
### Configuration clé
```json
{
"connectors": {
"nextcloud-talk": {
"enabled": true
}
}
}
```
### Fonctionnalités
- Messagerie basée sur les salons
- Support des conversations en MP et en groupe
- Intégration de plateforme de collaboration auto-hébergée
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-nextcloud-talk`.
---
## Tlon
### Prérequis d'installation
- Identifiants de ship Tlon (nom de ship Urbit et code d'accès)
### Configuration clé
```json
{
"connectors": {
"tlon": {
"enabled": true
}
}
}
```
**Variables d'environnement :** `TLON_SHIP`, `TLON_CODE`, `TLON_URL`
### Fonctionnalités
- Chat et interactions sociales basés sur Urbit
- Messagerie ship-to-ship
- Participation aux discussions de groupe
**Note :** Ce connecteur est disponible depuis le registre de plugins. Installez-le avec `eliza plugins install @elizaos/plugin-tlon`.
---
## Lens
**Plugin :** `@elizaos/plugin-lens`
```json5
{
connectors: {
lens: {
apiKey: "",
}
}
}
```
| Variable d'environnement | Chemin de configuration |
|-------------|-------------|
| `LENS_API_KEY` | `connectors.lens.apiKey` |
**Déclencheurs d'activation automatique :** `apiKey`, `token` ou `botToken`.
**Fonctionnalités :**
- Interactions sociales sur le protocole Lens
- Publication et engagement
---
## Cycle de vie des connecteurs
Le cycle de vie typique d'un connecteur suit ce schéma :
1. **Installer le plugin** -- Les plugins de connecteur sont installés en tant que packages `@elizaos/plugin-{platform}`
2. **Configurer** -- Ajouter la configuration de la plateforme dans la section `connectors` de `eliza.json`
3. **Activer** -- Définir `enabled: true` dans la configuration du connecteur
4. **Authentifier** -- Fournir les identifiants (tokens, clés) ou compléter le flux d'authentification (scan de code QR)
5. **Exécuter** -- Le runtime démarre le connecteur, établit les connexions et commence la gestion des messages
6. **Surveiller** -- Les sondes de statut vérifient la connectivité ; la reconnexion se fait automatiquement en cas d'échec
---
## Support multi-comptes
La plupart des connecteurs supportent plusieurs comptes via la clé `accounts`. Chaque compte a sa propre configuration, authentification et état de session :
```json
{
"connectors": {
"telegram": {
"dmPolicy": "pairing",
"accounts": {
"main-bot": {
"enabled": true,
"botToken": "TOKEN_1"
},
"support-bot": {
"enabled": true,
"botToken": "TOKEN_2",
"dmPolicy": "open",
"allowFrom": ["*"]
}
}
}
}
}
```
Les paramètres au niveau du compte remplacent les paramètres de base du connecteur. Chaque compte fonctionne indépendamment avec sa propre connexion, ses identifiants et son état de session.
---
## Gestion des sessions
Tous les connecteurs gèrent des sessions qui suivent l'état de la conversation à travers les plateformes :
- **Sessions MP** -- une session par utilisateur, régie par `dmPolicy`
- **Sessions de groupe** -- une session par groupe/salon, régie par `groupPolicy`
- **Historique** -- profondeur d'historique de messages configurable par type de session (`historyLimit`, `dmHistoryLimit`)
- **Configurations MP** -- surcharges de MP par utilisateur via l'enregistrement `dms`
Les options de `dmPolicy` sont :
| Politique | Comportement |
|--------|----------|
| `pairing` | Par défaut. L'agent répond après un flux d'appairage/d'intégration. |
| `open` | L'agent répond à tous les MP. Nécessite `allowFrom: ["*"]`. |
| `closed` | L'agent ne répond pas aux MP. |
---
## Guide opérationnel des connecteurs
### Liste de vérification de configuration
1. Configurer les identifiants du connecteur sous `connectors.`.
2. Activer le chargement du plugin connecteur via la configuration du connecteur ou la liste d'autorisation des plugins.
3. Valider les valeurs de politique MP/groupe et les listes d'autorisation avant d'activer les politiques `open`.
4. Pour chaque connecteur, confirmer que le bot/app de la plateforme est créé et que les tokens sont valides (voir les notes spécifiques à la plateforme ci-dessous).
5. Tester la connectivité en mode `pairing` avant de passer au mode `open`.
### Modes de défaillance
**Défaillances générales des connecteurs :**
- Le plugin du connecteur ne se charge pas :
Vérifiez le mappage des ID de connecteur dans `eliza/packages/agent/src/config/plugin-auto-enable.ts` (dans le sous-module upstream elizaOS), la disponibilité du plugin et les surcharges de `plugins.entries`. La couche d'activation automatique mappe les clés de configuration du connecteur aux noms de packages de plugins — une incohérence signifie que le plugin est silencieusement ignoré.
- L'authentification réussit mais aucun message n'arrive :
Vérifiez les paramètres de webhook/socket de la plateforme et les portes de politique (`dmPolicy`, `groupPolicy`). Pour les connecteurs basés sur les webhooks, confirmez que l'URL de rappel est publiquement accessible.
- Secrets de connecteur mal routés :
Confirmez que les variables d'environnement attendues sont remplies depuis la configuration et ne sont pas écrasées par un environnement obsolète. Le schéma de configuration fusionne les variables d'environnement avec la configuration de fichier — l'environnement a la priorité.
**Discord :**
- Token de bot rejeté (`401 Unauthorized`) :
Régénérez le token de bot dans le portail développeur Discord. Les tokens sont invalidés si le mot de passe du bot est réinitialisé ou si le token est divulgué et automatiquement révoqué.
- Le bot est en ligne mais ne répond pas dans les salons :
Vérifiez que le bot a l'intent `MESSAGE_CONTENT` activé dans le portail développeur et que la `groupPolicy` n'est pas `closed`. Confirmez que le bot a la permission `Send Messages` dans le salon cible.
- Limitation de débit (`429 Too Many Requests`) :
Les limites de débit Discord sont par route. Le connecteur devrait reculer automatiquement. Si c'est persistant, réduisez la fréquence des messages ou vérifiez les boucles de messages (le bot se répondant à lui-même).
**Telegram :**
- Le webhook ne reçoit pas les mises à jour :
Telegram nécessite HTTPS avec un certificat valide. Utilisez `getWebhookInfo` pour vérifier le statut. Si vous utilisez le long polling, confirmez qu'aucun autre processus ne sonde le même token de bot (Telegram n'autorise qu'un seul consommateur).
- Token de bot expiré ou révoqué :
Recréez le bot via BotFather et mettez à jour `TELEGRAM_BOT_TOKEN`. Les tokens Telegram n'expirent pas automatiquement mais peuvent être révoqués.
- Messages retardés ou manquants :
Telegram met les mises à jour en tampon pendant 24 heures si le webhook est inaccessible. Après restauration de la connectivité, un flot de messages en retard peut arriver.
**Slack :**
- `invalid_auth` ou `token_revoked` :
Réinstallez l'application Slack dans l'espace de travail. Les tokens de bot sont révoqués lorsque l'application est désinstallée ou que les permissions de l'espace de travail changent.
- Les événements n'arrivent pas :
Confirmez que l'abonnement à l'API Events inclut les types d'événements requis (`message.im`, `message.channels`). Vérifiez que l'URL de requête de l'application Slack est vérifiée et reçoit les réponses de défi.
**WhatsApp :**
- L'appairage QR échoue ou la session se déconnecte :
Les sessions WhatsApp Web expirent après une inactivité prolongée. Réappairez en scannant un nouveau code QR via `POST /api/whatsapp/pair`. Le service `whatsapp-pairing` gère l'état de session.
- Les messages ne sont pas délivrés :
WhatsApp applique des politiques anti-spam strictes. Si le numéro est signalé, les messages sont silencieusement supprimés. Confirmez que le compte professionnel est en règle.
- Problèmes de répertoire d'authentification multi-comptes :
Chaque compte WhatsApp nécessite son propre `authDir` (état d'authentification multi-fichiers Baileys). Si plusieurs comptes partagent un répertoire, les sessions se corrompent mutuellement.
**Signal :**
- signal-cli introuvable :
Le connecteur nécessite `signal-cli` dans le PATH ou un `cliPath` configuré. Pour le mode HTTP, définissez `httpUrl` ou `httpHost`/`httpPort` pour pointer vers une API REST signal-cli en cours d'exécution.
- L'enregistrement du compte échoue :
Signal nécessite un numéro de téléphone vérifié. Utilisez `signal-cli register` ou fournissez un numéro de compte pré-enregistré via `connectors.signal.account`.
- Configuration multi-comptes :
Signal supporte plusieurs comptes via la map `accounts`. Chaque compte doit avoir `account`, `httpUrl` ou `cliPath` défini et ne doit pas être `enabled: false`.
**Twitter :**
- Clé API rejetée :
Confirmez que `connectors.twitter.apiKey` est une clé API Twitter/X valide. Les clés du niveau gratuit ont des limites de débit strictes.
- Échecs de récupération de tweets :
L'API FxTwitter (`api.fxtwitter.com`) est utilisée pour la vérification des tweets. Si la limite de débit est atteinte, les requêtes de vérification échouent silencieusement.
**iMessage (direct) :**
- Chemin CLI introuvable :
Nécessite `cliPath` pointant vers un outil CLI iMessage valide. macOS uniquement — les permissions d'accessibilité sont requises.
**Farcaster :**
- Clé API invalide :
Confirmez que `connectors.farcaster.apiKey` est défini. L'accès au hub Farcaster nécessite une clé API valide.
**Lens :**
- Clé API invalide :
Confirmez que `connectors.lens.apiKey` est défini et que l'API Lens est accessible.
**MS Teams :**
- Token de bot rejeté :
Les bots Teams nécessitent un enregistrement Azure AD. Confirmez que le token de bot est valide et que l'application a les permissions requises dans le portail Azure.
**Mattermost :**
- L'authentification par token échoue :
Confirmez que `connectors.mattermost.botToken` (env : `MATTERMOST_BOT_TOKEN`) est un token d'accès personnel ou un token de bot valide. Vérifiez que l'URL du serveur Mattermost est configurée.
**Google Chat / Feishu :**
- L'authentification par token échoue :
Les deux nécessitent des comptes de service ou des tokens de bot. Confirmez que le token est valide et dispose des portées API de chat requises.
**Matrix :**
- La connexion au homeserver échoue :
Confirmez que l'URL du homeserver Matrix est accessible et que le token d'accès sous `connectors.matrix.token` est valide.
**Nostr :**
- La connexion au relais échoue :
Les connecteurs Nostr communiquent via des relais. Confirmez que les URL des relais sont configurées et accessibles. L'authentification par clé API varie selon le relais.
**Twitch :**
- L'authentification échoue :
Confirmez que `connectors.twitch.accessToken` ou `connectors.twitch.clientId` est défini. Alternativement, définissez `enabled: true` pour forcer l'activation. Assurez-vous que le token d'accès dispose des portées de chat requises.
**Blooio :**
- L'authentification échoue :
Blooio utilise `apiKey`. Confirmez que les identifiants sont définis dans la configuration du connecteur.
**Bluesky :**
- L'authentification échoue :
Confirmez que les variables d'environnement `BLUESKY_USERNAME` et `BLUESKY_PASSWORD` sont définies. Bluesky utilise des mots de passe d'application, pas le mot de passe de votre compte principal.
**Instagram :**
- La connexion échoue ou le compte est verrouillé :
Instagram peut exiger une vérification pour les connexions automatisées. Utilisez un mot de passe spécifique à l'application si disponible. Évitez les tentatives de connexion fréquentes qui peuvent déclencher des verrouillages de compte.
**LINE :**
- Le webhook ne reçoit pas les messages :
Confirmez que `LINE_CHANNEL_ACCESS_TOKEN` et `LINE_CHANNEL_SECRET` sont définis. L'URL du webhook doit être publiquement accessible avec HTTPS.
**Twilio :**
- Les SMS ne s'envoient pas :
Confirmez que `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN` et `TWILIO_PHONE_NUMBER` sont définis. Vérifiez que le numéro de téléphone est compatible SMS et que le compte a un solde suffisant.
**GitHub :**
- Token API rejeté :
Confirmez que `GITHUB_API_TOKEN` est un token d'accès personnel ou un token à portée fine valide avec les permissions de dépôt requises.
### Procédures de récupération
1. **Session de connecteur obsolète :** Redémarrez l'agent. Les connecteurs réinitialisent leurs connexions de plateforme au démarrage. Pour les connecteurs basés sur WebSocket (Discord, Slack), cela force une nouvelle poignée de main.
2. **Rotation de token :** Mettez à jour le token dans `eliza.json` sous `connectors.` et redémarrez. Ne modifiez pas les variables d'environnement dans un processus en cours d'exécution — la configuration est lue au démarrage.
3. **Récupération de limite de débit :** L'agent recule automatiquement sur les réponses 429. Si le connecteur est complètement bloqué, attendez que la fenêtre de limite de débit expire (typiquement 1 à 60 secondes pour Discord, variable selon la plateforme) et redémarrez.
### Commandes de vérification
Ces chemins de test font référence à des fichiers dans le sous-module `eliza`. Exécutez `bun run setup:upstreams` d'abord pour l'initialiser.
```bash
# Suite de tests complète (depuis la racine du dépôt)
bun run test
# Tests de bout en bout
bun run test:e2e
bun run typecheck
```