> ## 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.

# Slack

> Responder a @menciones y mensajes directos en Slack

Slack permite que el asistente entre en el espacio donde el equipo ya habla. Alguien menciona al bot con @ en un canal, o le escribe en directo, y la respuesta se queda en ese hilo de Slack. Un compañero ve el mismo hilo en el historial y puede pausar al asistente.

## Cuándo usarlo

Úsalo para preguntas internas y para un canal de soporte compartido: un compañero pide el siguiente paso, un resumen o un borrador sin salir de Slack. Conectar un asistente significa que la respuesta usa sus instrucciones y herramientas, y que la conversación queda en el historial.

## Qué oye el asistente

En una app de Slack manual, el asistente oye los eventos de bot que suscribes: una @mención, y mensajes en canales públicos, canales privados, mensajes directos y mensajes directos de grupo. **Add to Slack** suscribe esos eventos por ti. Socket Mode queda apagado.

## Dónde conseguir las claves

La guía del proveedor enlazada muestra las pantallas de estos clics. Sigue los clics de abajo junto con esas imágenes.

Entra en [api.slack.com/apps](https://api.slack.com/apps). **Add to Slack** en un dominio de plataforma de Famulor no pide estas claves. Una app manual necesita el **Bot User OAuth Token** (empieza por `xoxb-`) en **OAuth & Permissions**, y el **Signing Secret** en **Basic Information**. Guía oficial: [Slack apps](https://api.slack.com/apps).

## Crearlo en el proveedor

Sáltate esta sección si usas **Add to Slack**.

1. Abre [api.slack.com/apps](https://api.slack.com/apps) y elige **Create New App**, luego **From scratch**.
2. Ponle nombre a la app, elige el espacio y créala.
3. Abre **OAuth & Permissions** y añade estos Bot Token Scopes: app\_mentions:read, channels:history, channels:read, chat:write, chat:write.public, files:read, files:write, groups:history, groups:read, im:history, im:read, im:write, mpim:history, mpim:read, reactions:read, reactions:write, users:read.
4. Elige **Install to Workspace** y copia el **Bot User OAuth Token**.
5. Abre **Basic Information** y copia el **Signing Secret**.
6. Deja Socket Mode apagado. Pegas la Request URL cuando ya exista la conexión de Famulor.
7. En **Event Subscriptions**, suscribe los eventos de bot app\_mention, message.channels, message.groups, message.im, message.mpim.

## Conectarlo en Famulor

Tu plan incluye este canal. Abre **Settings → Channels**, elige la tarjeta, ponle nombre a la conexión, selecciona un asistente y guarda. Los ajustes de conversación compartidos — retraso de respuesta (5 segundos por defecto) e inactividad (30 minutos por defecto) — están en la página de [canales de mensajería](https://docs.famulor.io/es/channels/messaging.md).

**Add to Slack** es el camino corto en el dominio de plataforma de Famulor, para un espacio raíz. No se ofrece en un dominio de marca blanca, porque la app compartida mostraría el nombre de Famulor. Elige entonces **Show manual credentials**.

En la tarjeta manual, pega **Bot token (xoxb-…)**, **Signing secret**, y si quieres **Workspace name (optional)** y **Bot display name (optional)**.

![Formulario de Slack con selección de asistente y Add to Slack](https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/slack-connect.png?fit=max\&auto=format\&n=bijtnxODi_f3mm69\&q=85\&s=eb3661abf85db8bc3820a18b8a8e4c82)

Settings → Channels → Slack → Add: asistente y Add to Slack cuando la instalación en un clic está disponible.

## Apuntar el proveedor a Famulor

Una instalación en un clic no necesita una URL. Para una app manual:

1. Abre el menú de la conexión y elige **Copy webhook URL**.
2. En la app de Slack, abre **Event Subscriptions** y pega esa dirección como **Request URL**.
3. Deja Socket Mode apagado y guarda. Slack comprueba la dirección. Una @mención del bot aparece después en el historial.

## Historial

Abre el [historial](https://docs.famulor.io/es/monitoring/history.md) y filtra por **Slack**. El hilo, la respuesta del asistente y el análisis, si existe, aparecen ahí. Puedes pausar el asistente y responder tú.

## API, MCP y línea de comandos

La instalación en un clic desde tu propia herramienta usa `GET/POST /api/v1/slack/oauth` o las herramientas MCP `get_slack_oauth_config` y `start_slack_oauth`. Una conexión manual también se puede crear con `create_messaging_connector` o la línea de comandos.

```bash theme={null}
famulor create-messaging-connector --platform slack --name "Support" \
  --assistant-id ASSISTANT_UUID --bot-token xoxb-… --signing-secret … \
  --team-name "Acme" --bot-username Famulor
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.