Skip to main content
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) :

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

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).
  • 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, indicateur de forfait whatsapp_voice.
  • Modèles : GET/POST /api/v1/whatsapp/templates (+ outils MCP).
  • Voix sortante : POST /api/v1/calls/whatsapp-outbound.