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
purpose=email).
Prérequis
- Votre forfait inclut le canal que vous souhaitez connecter (Telegram, Slack, Messenger, Teams, Discord, Google Chat, X, WhatsApp texte / WhatsApp voix).
- 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é. - 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 :- Choisissez un assistant.
- Connectez en un clic si disponible (Ajouter à Slack, Se connecter avec Facebook) ou collez les identifiants manuels.
- Configurez les paramètres de conversation (voir plus bas).
- 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 :- Paramètres → Canaux → Messenger → Se connecter avec Facebook (HTTPS requis)
- L’utilisateur accorde les autorisations de Page → sélectionne une Page Facebook → nous créons le connecteur et appelons
subscribed_apps - 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 - Les événements sont acheminés vers le connecteur de l’espace de travail selon l’ID de la Page
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 :- Marque la conversation comme terminée.
- Exécute les variables d’analyse post-appel de l’assistant sur la transcription du chat (même
analysis_configque pour la voix). - Envoie une charge utile JSON en POST à l’URL de votre webhook (si définie), incluant les variables extraites.
/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) :
- Le domaine personnalisé vérifié propre à cet espace de travail, géré sous Tenant Admin → Settings → Domains
- Sinon, l’URL d’application de base de la plateforme
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
- Texte : API Meta Cloud sur
messaging_connectors(platform=whatsapp), indicateur de forfaitwhatsapp_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.