> ## Documentation Index > Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt > Use this file to discover all available pages before exploring further. # Canaux de messagerie (Telegram, Slack, Messenger) > Connectez des bots texte à vos assistants via Paramètres → Canaux La messagerie multicanale permet à un même assistant de répondre aux clients sur Telegram, Slack, Messenger, Microsoft Teams, Discord, Google Chat, X et WhatsApp. Le téléphone et la **voix** WhatsApp utilisent la pile vocale de la plateforme ; ces canaux de messagerie sont uniquement textuels (la voix WhatsApp partage les mêmes identifiants Meta que le texte). ## Outils (parité avec la voix) Les sept plateformes de messagerie partagent le même pipeline de réponse. L'assistant peut y utiliser les mêmes outils compatibles texte que sur la voix : * Outils API (HTTP) * Outils MCP (serveurs d'espace de travail et d'assistant) * Recherche dans la base de connaissances * Intégrations calendrier (natif / Cal.com / Calendly) * Fonctions intégrées : heure actuelle, horaires d'ouverture, envoi de SMS, envoi d'e-mail, planification d'un rappel, définition de variable Les actions réservées à la voix sont ignorées sur les canaux texte : transfert d'appel/d'assistant, fin d'appel, DTMF/clavier, collecte de carte bancaire. Les réponses automatiques par e-mail utilisent la même couche d'outils (`purpose=email`). ## Prérequis 1. Votre forfait inclut le canal que vous souhaitez connecter (Telegram, Slack, Messenger, Teams, Discord, Google Chat, X, WhatsApp texte / WhatsApp voix). 2. La base du webhook est votre **URL d'application de base** : soit l'hôte de la plateforme (par exemple `https://app.famulor.io`), soit le domaine personnalisé vérifié de cet espace de travail. Vous n'avez pas besoin d'accéder aux variables d'environnement du serveur ; le produit génère les URL de webhook pour vous une fois le canal connecté. 3. L'IA de la plateforme pour les réponses textuelles est configurée par l'opérateur. ## Connexion (interface du produit) Paramètres → Canaux → Telegram / Slack / Messenger : 1. Choisissez un assistant. 2. Connectez en un clic si disponible (**Ajouter à Slack**, **Se connecter avec Facebook**) ou collez les identifiants manuels. 3. Configurez les paramètres de conversation (voir plus bas). 4. Enregistrez — les webhooks Telegram sont enregistrés automatiquement ; Slack/Messenger **BYO** nécessitent l'URL de webhook affichée. Les installs one-click utilisent le webhook plateforme partagé. ### Slack — Ajouter à Slack Onboarding recommandé (domaine plateforme / workspaces racine uniquement) via l’**app Slack Famulor** partagée : Paramètres → Slack → **Ajouter à Slack**. Les événements arrivent sur `/api/webhooks/slack` et sont routés par `team_id`. Le collage manuel reste en secours (hôtes marque blanche : manuel uniquement). API publique : `GET/POST /api/v1/slack/oauth` · MCP : `get_slack_oauth_config`, `start_slack_oauth`. ### Messenger — Se connecter avec Facebook L'intégration recommandée (domaine de la plateforme / espaces de travail racine uniquement — pas les hôtes en marque blanche) utilise la **même application Meta de la plateforme** que WhatsApp : 1. Paramètres → Canaux → Messenger → **Se connecter avec Facebook** (HTTPS requis) 2. L'utilisateur accorde les autorisations de Page → sélectionne une Page Facebook → nous créons le connecteur et appelons `subscribed_apps` 3. Les opérateurs de la plateforme configurent le webhook Messenger au niveau de l'application Meta sur l'**URL d'application de base** (`/api/webhooks/meta/messenger-platform`) et s'abonnent à **messages** 4. Les événements sont acheminés vers le connecteur de l'espace de travail selon l'ID de la Page Le collage manuel du jeton de page reste disponible en solution de repli (URL de webhook propre à chaque connecteur, affichée dans Paramètres). API publique : `GET/POST /api/v1/messenger/facebook-login` · MCP : `complete_messenger_facebook_login`. ## Paramètres de conversation S'applique à tous les canaux texte (Telegram, Slack, Messenger) : | Paramètre | Par défaut | Description | | ----------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Délai de réponse (secondes)** | `5` | Curseur `0`–`30`. Attend après le dernier message du client avant d'envoyer une seule réponse (regroupe les rafales de messages rapprochés). `0` = réponse instantanée à chaque message. | | **Délai d'inactivité (minutes)** | `30` | Minutes d'inactivité après le dernier message du client avant que la conversation ne soit marquée comme terminée. | | **Autoriser le redéclenchement** | désactivé | Si activé, le webhook de fin de conversation peut se déclencher à nouveau lorsque le client relance une conversation terminée puis redevient inactif. | | **URL du webhook de fin de conversation** | vide | URL HTTPS facultative. Laissez vide pour désactiver. Utilisez **Envoyer une requête de test** pour envoyer un exemple de charge utile. | ### Webhook de fin de conversation Lorsqu'une conversation se termine (délai d'inactivité), la plateforme : 1. Marque la conversation comme terminée. 2. Exécute les variables d'**analyse post-appel** de l'assistant sur la transcription du chat (même `analysis_config` que pour la voix). 3. Envoie une charge utile JSON en POST à l'URL de votre webhook (si définie), incluant les variables extraites. Cron : `/api/cron/messaging-inactivity` (toutes les minutes sur la plateforme). ## Applications de plateforme à créer | Canal | Ce que vous créez | Champs clés | | ----------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | Telegram | Bot via [@BotFather](https://t.me/BotFather) | Jeton du bot | | Slack | Application Slack (Bot + Event Subscriptions) | Jeton de bot `xoxb-…`, secret de signature | | Messenger | Application Meta de la plateforme (Se connecter avec Facebook) ou application Meta + Page en mode BYO | Jeton d'accès à la Page, secret d'application, jeton de vérification (BYO) ; connexion Facebook pour le parcours recommandé | | Teams | Bot Azure | ID d'application, mot de passe d'application | | Discord | Application Discord | Jeton de bot, clé publique, ID d'application | | Google Chat | Application GCP Chat + compte de service | JSON du compte de service | | X | Application développeur X + webhook Activity API | Secret consommateur, jeton utilisateur OAuth (ou ID client + jeton de rafraîchissement) | Modèle d'URL de webhook : `https://app.famulor.io/api/webhooks/messaging/{platform}/{connector_id}` Résolution de l'hôte (uniquement ces deux options — pas de repli revendeur/sous-domaine) : 1. Le domaine personnalisé vérifié propre à cet espace de travail, géré sous **Tenant Admin → Settings → Domains** 2. Sinon, l'**URL d'application de base** de la plateforme Telegram `setWebhook` utilise automatiquement cette même URL résolue. ## API publique et MCP * REST : `GET/POST /api/v1/messaging-connectors`, `PATCH/DELETE /api/v1/messaging-connectors/{id}` * Modèles WhatsApp : `GET/POST /api/v1/whatsapp/templates` * Voix sortante WhatsApp : `POST /api/v1/calls/whatsapp-outbound` * Outils MCP : `list_messaging_connectors`, `create_messaging_connector`, `update_messaging_connector`, `delete_messaging_connector`, ainsi que les outils WhatsApp pour les modèles et les appels * Tag OpenAPI : **Messaging** / **Calls** ## WhatsApp Configuration complète (identifiants, champs de webhook, modèles, bascules voix) : **[WhatsApp (Texte + Voix)](/channels/whatsapp)**. * **Texte :** API Meta Cloud sur `messaging_connectors` (`platform=whatsapp`), indicateur de forfait `whatsapp_channel`. * **Voix :** connecteur vocal WhatsApp de la plateforme, sur les mêmes identifiants — voir [WhatsApp Voice](/telephony/whatsapp-voice), indicateur de forfait `whatsapp_voice`. * **Modèles :** `GET/POST /api/v1/whatsapp/templates` (+ outils MCP). * **Voix sortante :** `POST /api/v1/calls/whatsapp-outbound`.