> ## Documentation Index > Fetch the complete documentation index at: https://docs.famulor.io/llms.txt > Use this file to discover all available pages before exploring further. # Canaux de messagerie (Telegram, Slack, Messenger) > Connectez Discord, Teams, Google Chat et d'autres canaux de messagerie à un même assistant 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. Ces canaux de messagerie sont uniquement textuels ; le téléphone et la voix WhatsApp se configurent séparément. Quel que soit le canal, chaque conversation atterrit dans l'[Historique](/fr/monitoring/history). ## Outils (parité avec la voix) L'assistant peut utiliser sur ces canaux 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 (moteur intégré / Cal.com / Calendly / Acuity / eTermin — les calendriers HighLevel sont réservés à la voix) * Outils intégrés : 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 ne sont pas disponibles sur les canaux texte : transfert d'appel ou d'assistant, fin d'appel, DTMF/clavier et collecte de carte bancaire. ## 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. Si un fournisseur exige un webhook, utilisez l'URL exacte affichée après la connexion du canal. Les domaines personnalisés vérifiés sont pris en charge automatiquement. ## Connexion (interface produit) Settings → Channels → Telegram / Slack / Messenger : 1. Choisissez un assistant. 2. Connectez en un clic quand c'est possible (**Add to Slack**, **Connect with Facebook**) ou collez les identifiants du bot manuellement. 3. Configurez les paramètres de conversation (ci-dessous). 4. Enregistrez — les webhooks Telegram s'enregistrent automatiquement ; Slack/Messenger en **BYO** ont besoin de l'URL de webhook affichée, à renseigner dans leur console développeur. Les installations en un clic ne demandent aucune copie d'URL. ### Slack — Add to Slack L'intégration privilégiée (domaine plateforme / espaces de travail racine uniquement — pas les hébergements en marque blanche) utilise l'**application Slack partagée de Famulor** : 1. Settings → Channels → Slack → **Add to Slack** 2. Approuvez les autorisations Slack demandées. 3. Revenez aux paramètres du canal et vérifiez que la connexion est active. Le collage manuel du jeton de bot + secret de signature reste disponible comme solution de repli (URL de webhook propre à chaque connecteur, affichée dans Settings). Les hébergements en marque blanche ne disposent que du mode manuel (le bot partagé apparaîtrait comme Famulor). API publique : `GET/POST /api/v1/slack/oauth` · MCP : `get_slack_oauth_config`, `start_slack_oauth`. ### Messenger — Connect with Facebook L'intégration privilégiée (domaine plateforme / espaces de travail racine uniquement — pas les hébergements en marque blanche) utilise la **même application Meta de la plateforme** que WhatsApp : 1. Settings → Channels → Messenger → **Connect with Facebook** (HTTPS requis) 2. Approuvez les autorisations demandées et sélectionnez une Page Facebook. 3. Revenez aux paramètres du canal et vérifiez que la connexion est active. Le collage manuel du jeton de page reste disponible comme solution de repli (URL de webhook propre à chaque connecteur, affichée dans Settings). API publique : `GET/POST /api/v1/messenger/facebook-login` · MCP : `complete_messenger_facebook_login`. ## Paramètres de conversation S'applique à tous les canaux texte : | Paramètre | Par défaut | Description | | ---------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Response delay (seconds)** | `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. | | **Inactivity timeout (minutes)** | `30` | Minutes d'inactivité après le dernier message du client avant que la conversation soit marquée comme terminée. | | **Allow re-triggering** | désactivé | Si activé, le webhook de fin de conversation peut se redéclencher lorsque le client relance une conversation terminée puis redevient inactif. | | **Conversation ended webhook URL** | vide | URL HTTPS facultative. Laissez vide pour désactiver. Utilisez **Test webhook** pour envoyer un exemple de charge utile. | ### Webhook de fin de conversation Trois événements déclenchent l'envoi d'une remise `conversation.ended` : * **Inactivity** — le délai d'inactivité ci-dessus s'écoule sans nouveau message du client (vérifié environ une fois par minute). * **Manual** — quelqu'un sélectionne **Actions → End conversation** sur une conversation ouverte dans l'[Historique](/fr/monitoring/history). * **Test** — vous sélectionnez **Test webhook** dans les paramètres du connecteur ; cela envoie toujours un exemple de charge utile réaliste, qu'une conversation réelle se soit terminée ou non. Avant l'envoi, la plateforme exécute les champs d'[analyse](/fr/assistants/analysis) configurés de l'assistant sur la transcription et clôture la conversation, de sorte que la charge utile transporte toujours l'analyse terminée plutôt qu'une version partielle. Par défaut, chaque conversation notifie son webhook une seule fois ; activez **Allow re-triggering** si un client peut relancer une conversation terminée et que vous voulez une nouvelle notification la prochaine fois qu'elle redevient inactive. Une remise ressemble à ceci : ```json theme={null} { "event": "conversation.ended", "timestamp": "2026-08-26T14:32:07.000Z", "reason": "inactivity", "data": { "tenant_id": "9f86d081-0000-4000-8000-000000000020", "conversation_id": "c1b2c3d4-0000-4000-8000-000000000010", "platform": "telegram", "status": "closed", "duration_sec": 187, "message_count": 6, "conversation": { "id": "c1b2c3d4-0000-4000-8000-000000000010", "platform": "telegram", "external_thread_id": "123456789", "external_user_id": "123456789", "external_user_name": "Max Mustermann", "started_at": "2026-08-26T14:28:40.000Z", "ended_at": "2026-08-26T14:32:07.000Z", "last_customer_message_at": "2026-08-26T14:29:55.000Z" }, "connector": { "id": "1b2c3d4e-0000-4000-8000-000000000030", "name": "Support Telegram", "platform": "telegram" }, "assistant": { "id": "2c3d4e5f-0000-4000-8000-000000000040", "name": "Support Assistant" }, "transcript": "Customer: Hi, I need help with my order.\nAssistant: Of course — what's your order number?", "messages": [ { "id": "msg-1", "role": "user", "direction": "inbound", "text": "Hi, I need help with my order.", "created_at": "2026-08-26T14:28:40.000Z" } ], "analysis": { "summary": "Customer asked about an order and got help finding it.", "sentiment": "positive", "success": true, "success_reason": "The order was located and the delivery date confirmed.", "data": { "order_number": "12345" }, "analyzed_at": "2026-08-26T14:32:07.000Z" } } } ``` `reason` vaut `inactivity`, `manual` ou `test`. `conversation`, `connector`, `assistant`, `transcript` et `analysis` sont aussi répétés au niveau racine de la charge utile, pour les récepteurs plus anciens construits sur cette forme aplatie plutôt que sur l'enveloppe `data`. À l'intérieur d'`analysis`, seules les parties que vous avez activées sur l'assistant sont présentes — sentiment, succès et sa raison, et une map `data` de vos propres champs extraits ; voir [Analyse](/fr/assistants/analysis) pour la forme complète. Configurez la cible dans le champ **Conversation ended webhook URL** ci-dessus, ou via `PATCH /api/v1/messaging-connectors/{id}` / `update_messaging_connector` — chaque connecteur de canal possède sa propre URL. Pour renvoyer une remise après coup — par exemple une fois qu'une réévaluation a changé l'analyse — utilisez **Resend webhooks** sur la conversation dans l'[Historique](/fr/monitoring/history). ## Connecteurs Beta Dix canaux supplémentaires se connectent de la même façon, une fois que votre espace de travail a activé les **Beta Features** sous **Settings → Workspace** : Freshdesk, Gmail, Outlook, Zendesk, ServiceNow, Intercom, Zoho Mail, AgentMail, Instagram et Zulip. Leurs entrées restent absentes de **Settings → Channels** tant que les Beta Features ne sont pas activées. Au lieu de coller un token de bot ou un app secret, vous connectez ces canaux via le parcours de connexion OAuth de Famulor : connectez-vous une fois au compte, et Famulor maintient la connexion active. Au-delà des [paramètres de conversation](#paramètres-de-conversation) communs à tous les canaux texte, un connecteur Beta peut ajouter : | Paramètre | Ce qu'il fait | Où il s'applique | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | | **Reply mode** | Envoie automatiquement la réponse de l'assistant, ou l'enregistre comme brouillon dans la boîte mail pour qu'un collègue la relise et l'envoie. | Gmail, Outlook | | **Watch** | Quelle partie de la boîte mail l'assistant traite : la boîte de réception (par défaut), toute la boîte mail, ou un seul libellé ou dossier. | Gmail, Outlook, Zoho Mail | | **Extra action** | Une capacité supplémentaire propre à ce service — appliquer un libellé, taguer un ticket, réagir à un message, et autres actions similaires. Désactivée tant que vous ne l'activez pas. | Chaque connecteur Beta, une action chacun | | **Import existing items** | À la connexion, jusqu'où remonter pour récupérer les messages déjà existants — la dernière heure, 24 heures, ou 7 jours. Par défaut, seuls les nouveaux messages. | Freshdesk, ServiceNow, Intercom, Zoho Mail, Instagram | **Import existing items** n'est pas un import silencieux : chaque message récupéré reçoit une véritable réponse automatique de l'assistant. Laissez cette option sur **Only new messages**, sauf si vous voulez que l'assistant réponde à votre historique existant. ## Facturation L'envoi et la réception de messages sur Telegram, Slack, Messenger, Teams, Discord, Google Chat, X et les connecteurs Beta coûtent des crédits par message, au tarif **Messaging (sent)** / **Messaging (received)** de l'espace de travail — le même tarif qu'utilise [WhatsApp texte](/fr/channels/whatsapp#facturation). Les tarifs actuels figurent sur la [page Usage](https://app.famulor.io/usage) ; voir aussi [Comment l'utilisation est facturée](/fr/billing/minutes). ## Applications de plateforme à créer | Canal | Ce que vous créez | Champs clés | | ----------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | Telegram | Bot via [@BotFather](https://t.me/BotFather) | Jeton de bot | | Slack | Application Slack Famulor (Add to Slack) ou application Slack BYO (Bot + Event Subscriptions) | Installation OAuth ; ou jeton de bot `xoxb-…` + secret de signature (BYO) | | Messenger | Application Meta de la plateforme (Connect with Facebook) ou application Meta + Page en BYO | Jeton d'accès à la Page, secret d'application, jeton de vérification (BYO) ; Facebook Login pour le parcours privilégié | | 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) | Copiez l'URL de webhook propre au connecteur, affichée dans **Settings → Channels**. Telegram la configure automatiquement après l'enregistrement. ## API publique et MCP * REST : `GET/POST /api/v1/messaging-connectors`, `PATCH/DELETE /api/v1/messaging-connectors/{id}`, `GET /api/v1/messaging-connectors/{id}/watch-options` (libellés Gmail / dossiers Outlook et Zoho Mail), `POST /api/v1/messaging-connectors/{id}/ended-webhook-test` * OAuth Slack : `GET/POST /api/v1/slack/oauth` * Modèles WhatsApp : `GET/POST /api/v1/whatsapp/templates` * Voix sortante WhatsApp : `POST /api/v1/calls/whatsapp-outbound` * Outils MCP : `list_messaging_connectors`, `list_messaging_connector_watch_options`, `create_messaging_connector`, `update_messaging_connector`, `delete_messaging_connector`, `test_messaging_ended_webhook`, `get_slack_oauth_config`, `start_slack_oauth`, plus les outils de modèles/appels WhatsApp * Tag OpenAPI : **Messaging** / **Calls** ## WhatsApp Configuration complète (identifiants, champs de webhook, modèles, bascules voix) : **[WhatsApp (Text + Voice)](/fr/channels/whatsapp)**. * **Text :** chat WhatsApp Business, lorsqu'il est inclus dans votre forfait. * **Voice :** appels WhatsApp sur la même connexion, lorsqu'ils sont inclus dans votre forfait — voir [WhatsApp Voice](/fr/telephony/whatsapp-voice). * **Templates :** `GET/POST /api/v1/whatsapp/templates` (+ outils MCP). * **Outbound voice :** `POST /api/v1/calls/whatsapp-outbound`. ## E-mail Configuration complète — connecter un domaine, créer des adresses, définir les valeurs par défaut : **[Configuration du canal e-mail](/fr/channels/email)**. Les conversations e-mail apparaissent dans l'[Historique des e-mails](/fr/email/history) aux côtés de vos autres canaux. ## SMS Un numéro d'espace de travail compatible SMS et pour lequel **Allow outbound SMS** est activé peut envoyer des messages texte via l'outil intégré **Send SMS** — depuis un assistant en cours d'appel ou de chat, ou comme étape d'automatisation (par exemple une confirmation après un appel, ou un rappel de rendez-vous). Voir [SMS](/fr/api-reference/sms) pour savoir quels numéros sont éligibles et pour l'API d'envoi. Quelques bonnes pratiques permettent de garder les SMS utiles plutôt qu'agaçants : * Gardez les messages courts et précis — le SMS ne permet aucune mise en forme riche, et il est facturé par segment de 160 caractères (70 si vous utilisez des emojis ou des caractères accentués), donc la longueur coûte de l'argent. * Incluez des instructions de désinscription là où la loi locale l'exige. * Envoyez-vous un message de test avant de lâcher un modèle sur une campagne complète. * Surveillez les dépenses SMS sous **Usage**, surtout après avoir modifié un modèle ou ciblé un nouveau pays.