Herramientas (paridad con voz)
Las siete plataformas de mensajería comparten un mismo pipeline de respuestas. El asistente puede usar las mismas herramientas aptas para texto que en voz:- Herramientas API (HTTP)
- Herramientas MCP (servidores de espacio de trabajo + asistente)
- Búsqueda en la base de conocimientos
- Integraciones de calendario (nativa / Cal.com / Calendly)
- Integradas: hora actual, horario comercial, enviar SMS, enviar correo electrónico, programar devolución de llamada, definir variable
purpose=email).
Requisitos previos
- Tu plan incluye el canal que quieres conectar (Telegram, Slack, Messenger, Teams, Discord, Google Chat, X, WhatsApp texto / WhatsApp voz).
- La base del webhook es tu URL de la app base: el host de la plataforma (por ejemplo,
https://app.famulor.io) o el dominio personalizado verificado de este espacio de trabajo. No necesitas acceso a las variables de entorno del servidor; el producto genera las URLs de webhook por ti después de conectar un canal. - La IA de la plataforma para las respuestas de texto la configura el operador.
Conectar (interfaz del producto)
Configuración → Canales → Telegram / Slack / Messenger:- Elige un asistente.
- Conecta en un clic si está disponible (Añadir a Slack, Conectar con Facebook) o pega las credenciales manuales.
- Configura los ajustes de conversación (más abajo).
- Guarda: los webhooks de Telegram se registran automáticamente; Slack/Messenger BYO necesitan la URL de webhook mostrada. Las instalaciones one-click usan el webhook compartido de la plataforma.
Slack: Añadir a Slack
Incorporación preferida (solo dominio de plataforma / workspaces raíz) con la app Slack de Famulor compartida: Configuración → Slack → Añadir a Slack. Los eventos llegan a/api/webhooks/slack y se enrutan por team_id. El pegado manual sigue como alternativa (hosts de marca blanca: solo manual).
API pública: GET/POST /api/v1/slack/oauth · MCP: get_slack_oauth_config, start_slack_oauth.
Messenger: conectar con Facebook
La incorporación preferida (solo para dominio de la plataforma / espacios de trabajo raíz, no para hosts de marca blanca) usa la misma app de Meta de la plataforma que WhatsApp:- Configuración → Canales → Messenger → Conectar con Facebook (requiere HTTPS)
- El usuario concede permisos de página → elige una página de Facebook → creamos el conector y llamamos a
subscribed_apps - Los operadores de la plataforma configuran el webhook de Messenger a nivel de app de Meta en la URL de la app base (
/api/webhooks/meta/messenger-platform) y se suscriben a messages - Los eventos se enrutan al conector del espacio de trabajo según el ID de página
GET/POST /api/v1/messenger/facebook-login · MCP: complete_messenger_facebook_login.
Configuración de conversación
Se aplica a todos los canales de texto (Telegram, Slack, Messenger):Webhook de conversación finalizada
Cuando una conversación finaliza (por tiempo de inactividad), la plataforma:- Marca la conversación como finalizada.
- Ejecuta las variables de análisis posterior a la llamada del asistente sobre la transcripción del chat (el mismo
analysis_configque en voz). - Envía (POST) un payload JSON a tu URL de webhook (si está configurada), incluidas las variables extraídas.
/api/cron/messaging-inactivity (cada minuto en la plataforma).
Apps de plataforma que creas
Patrón de URL de webhook:
https://app.famulor.io/api/webhooks/messaging/{platform}/{connector_id}
Resolución del host (solo estas dos opciones, sin alternativa de revendedor/subdominio):
- El dominio personalizado verificado propio de este espacio de trabajo, administrado en Administrador de inquilino → Configuración → Dominios
- Si no, la URL de la app base de la plataforma
setWebhook de Telegram usa automáticamente esa misma URL resuelta.
API pública y MCP
- REST:
GET/POST /api/v1/messaging-connectors,PATCH/DELETE /api/v1/messaging-connectors/{id} - Plantillas de WhatsApp:
GET/POST /api/v1/whatsapp/templates - Voz saliente de WhatsApp:
POST /api/v1/calls/whatsapp-outbound - Herramientas MCP:
list_messaging_connectors,create_messaging_connector,update_messaging_connector,delete_messaging_connector, además de herramientas de plantillas/llamadas de WhatsApp - Etiqueta OpenAPI: Messaging / Calls
- Texto: Meta Cloud API sobre
messaging_connectors(platform=whatsapp), flag de planwhatsapp_channel. - Voz: conector de voz de WhatsApp de la plataforma con las mismas credenciales; consulta WhatsApp Voice, flag de plan
whatsapp_voice. - Plantillas:
GET/POST /api/v1/whatsapp/templates(+ herramientas MCP). - Voz saliente:
POST /api/v1/calls/whatsapp-outbound.