CallMerlinDocs
Funciones

Canal Slack

Conecta Slack como canal entrante para CallMerlin.

Canal Slack

El canal Slack permite a tus empleados chatear con Merlin a traves de Slack. Escribe @Merlin seguido de una pregunta en un canal de Slack o envia un mensaje directo, y Merlin responde con datos de tus servicios conectados.

Disponibilidad

El canal Slack esta disponible desde el plan Professional.

Como funciona

  1. Un empleado escribe @Merlin cuantas facturas abiertas tengo? en un canal de Slack
  2. Slack envia el mensaje a CallMerlin
  3. En 5-15 segundos, Merlin responde en un hilo
  4. Merlin tiene acceso a las mismas herramientas que el webchat, telefono y escritorio

Requisitos

  • Un plan Professional o superior
  • Un workspace de Slack donde puedas instalar apps
  • Permisos de propietario o admin del workspace

Configuracion

Paso 1: Crear una aplicacion Slack

  1. Ve a api.slack.com/apps y haz clic en Create New App
  2. Elige From scratch
  3. Nombra la app (por ej. Merlin) y selecciona tu workspace
  4. Ve a OAuth & Permissions y agrega estos Bot Token Scopes:
    • app_mentions:read
    • chat:write
    • im:read
    • im:write
    • im:history
    • channels:history
    • users:read
  5. Haz clic en Install to Workspace y autoriza la app
  6. Copia el Bot User OAuth Token (empieza con xoxb-)

Paso 2: Configurar Event Subscriptions

  1. Ve a Event Subscriptions en la configuracion de tu app Slack
  2. Activa Enable Events
  3. Pega la Request URL del dashboard CallMerlin (seccion Canal Slack)
  4. Espera la verificacion de Slack (marca verde)
  5. Agrega estos eventos en Subscribe to bot events:
    • app_mention
    • message.im
  6. Haz clic en Save Changes

Paso 3: Configurar el dashboard

  1. Ve a callmerlin.appDashboardCanal Slack
  2. Introduce el Bot Token (del paso 1)
  3. Introduce el Signing Secret (en Basic InformationApp Credentials)
  4. Haz clic en Probar conexion
  5. Elige un PIN predeterminado (opcional)
  6. Activa el toggle
  7. Haz clic en Guardar

Paso 4: Enviar el primer mensaje

  1. Ve a Slack
  2. Invita al bot a un canal: /invite @Merlin
  3. Escribe @Merlin hola
  4. Merlin responde en un hilo

Asignacion de usuarios

Cada usuario de Slack se vincula a un codigo PIN. El PIN determina los permisos y la plantilla que usa Merlin.

PIN predeterminado

Establece un PIN predeterminado para usuarios de Slack que aun no estan vinculados individualmente.

Consejo: Crea un PIN con permisos de solo lectura como predeterminado.

Filtro de canales

Restringe en que canales de Slack responde Merlin. Dejalo vacio para todos los canales.

Facturacion

Los mensajes de Slack se facturan como sesiones de chat:

  • Primer mensaje = 0,5 minutos
  • Preguntas de seguimiento en 15 minutos = gratis (misma sesion)
  • Despues de 15 minutos = nueva sesion de 0,5 minutos

Limites

LimiteValor
Por usuario20 mensajes por hora
Por canal50 mensajes por hora

Solucion de problemas

Merlin no responde

  1. Verifica que el toggle esta activado
  2. Verifica el Bot Token y el Signing Secret
  3. Verifica que los Event Subscriptions estan activos
  4. Verifica que Merlin esta invitado al canal (/invite @Merlin)
  5. Verifica que el usuario tiene un PIN asignado

En esta pagina