Canal Teams
Conectar Microsoft Teams como canal entrante para CallMerlin.
Canal Teams
Con el canal Teams, tus empleados pueden chatear con Merlin directamente en Microsoft Teams. Escribe @CallMerlin seguido de una pregunta en un canal de Teams y Merlin responde con datos de tus servicios conectados.
Disponibilidad
El canal Teams esta disponible a partir del plan Professional.
Como funciona
- Un empleado escribe
@CallMerlin cuantas facturas tengo?en un canal de Teams - Merlin envia inmediatamente un mensaje intermedio: "Estoy trabajando en ello..."
- En 5-15 segundos, Merlin responde con la respuesta real
- Merlin tiene acceso a las mismas herramientas que el webchat, telefono y escritorio
Hablar en lugar de escribir (movil)
En el movil, escribe @CallMerlin y dicta tu pregunta con el micro del teclado (iOS, Gboard, SwiftKey). Merlin recibe texto normal, como si lo hubieras escrito. Sin configuracion extra.
Requisitos
Antes de poder activar el canal Teams necesitas:
- Un plan Professional o superior
- Una conexion Microsoft 365 activa (en Conexiones en el panel de control)
- Permisos de propietario de equipo en el equipo de Teams donde Merlin estara activo
Requisito del administrador IT
El administrador de Microsoft 365 / Teams debe tener habilitado "Cargar aplicaciones personalizadas":
- Ve al Centro de administracion de Teams
- Navega a Aplicaciones de Teams → Directivas de configuracion
- Abre la directiva que se aplica a tus usuarios (ej. Global)
- Establece "Cargar aplicaciones personalizadas" en Activado
Sin esta configuracion la opcion "Crear un webhook saliente" no aparecera en Teams.
Configuracion
Paso 1: Crear un webhook saliente en Teams
- Abre Microsoft Teams (web o escritorio)
- Ve al equipo donde Merlin debe estar activo
- Haz clic en los tres puntos (•••) junto al nombre del equipo
- Haz clic en Administrar equipo
- Ve a la pestana Aplicaciones
- Haz clic abajo a la derecha en "Crear un webhook saliente"
- Completa:
- Nombre:
Merlin - URL de devolucion de llamada: la URL que se muestra en el panel de CallMerlin en Canal Teams
- Descripcion:
Asistente de IA para tus herramientas de negocio
- Nombre:
- Haz clic en Crear
- Aparece un token de seguridad HMAC. Copialo inmediatamente, solo se muestra una vez
Paso 2: Configurar el panel de control
- Ve a callmerlin.app → Panel de control → Canal Teams
- Pega el token HMAC del paso 1
- Introduce tu ID de inquilino (disponible en Azure Portal → Microsoft Entra ID → Informacion general)
- Selecciona tu conexion de Microsoft 365 (debe existir ya en Conexiones)
- Elige un PIN predeterminado (opcional, para nuevos empleados)
- Activa el interruptor
- Haz clic en Guardar
Paso 3: Enviar tu primer mensaje
- Vuelve a Teams
- Escribe
@CallMerlin holaen el canal - Merlin responde con "Estoy trabajando en ello..." seguido de un saludo
Con el primer mensaje, tu cuenta de Teams se registra automaticamente en el panel de CallMerlin.
Asociacion de usuarios
Cada usuario de Teams se vincula a un codigo PIN. El PIN determina que permisos y que plantilla usa Merlin.
Registro automatico
Cuando un empleado escribe @CallMerlin por primera vez en Teams, su cuenta se registra automaticamente. Lo veras aparecer en el panel bajo Canal Teams → Asociaciones de usuarios.
Asignar un PIN
- Ve a Canal Teams en el panel de control
- Busca al empleado en la tabla Asociaciones de usuarios
- Selecciona un PIN del menu desplegable
- La asociacion se activa inmediatamente
Desasociar un PIN
Haz clic en Desasociar junto a un empleado para eliminar la asociacion PIN. El empleado vuelve al PIN predeterminado (si hay uno configurado).
PIN predeterminado
Establece un PIN predeterminado para los usuarios de Teams que aun no estan asociados individualmente. Los nuevos empleados tendran acceso inmediato sin asociacion manual.
Consejo: Crea un PIN con permisos de lectura limitados como predeterminado. Asigna permisos mas amplios mediante asociaciones individuales.
Resumenes de reuniones (transcripcion Zoom/Teams)
Para resumenes de reuniones de video (no solo chat de Teams): activa la transcripcion en vivo durante la reunion, pide a tu admin del tenant que active el acceso API de transcripcion Graph, y concede en el PIN el permiso Resúmenes de reuniones.
El panel bajo Canal Teams muestra la checklist. Detalles: Resumenes de reuniones.
Resumir conversaciones y pedir consejo
Merlin no escucha pasivamente los chats del equipo. Siempre empiezas con @CallMerlin. Comandos utiles en el hilo donde tu equipo debate:
| Comando | Resultado |
|---|---|
@CallMerlin resume esta conversacion | Resumen del hilo |
@CallMerlin cuales son los puntos de accion? | Puntos de accion de la reunion |
@CallMerlin que se decidio? | Decisiones del hilo |
@CallMerlin elabora un plan de accion | Pasos concretos siguientes |
Para otro canal de Teams o historial mas largo necesitas una conexion Microsoft 365. Tu admin debe tener activado Leer mensajes en tu PIN (en Usuarios PIN → Permisos):
@CallMerlin lee el canal de marketing y da consejo@CallMerlin que se discutio en la ultima hora en este canal?
Facturacion: igual que cualquier sesion de Teams (empieza como 1 minuto; mensajes extra en la misma sesion pueden anadir minutos). Ver Facturacion.
Nota: en comandos de resumen (p. ej. "resume esta conversacion") Merlin lee automaticamente hasta 50 mensajes del hilo actual. Para otras preguntas aplica el contexto de 10 minutos.
Consejo tras una reunion: Escribe
@CallMerlin resume esta conversaciony luego@CallMerlin crea tareas para cada punto de accionen el mismo hilo. En 15 minutos cuenta como una sola sesion.
Contexto y preguntas de seguimiento
Merlin recuerda el contexto de la conversacion durante 10 minutos. Dentro de esta ventana puedes hacer preguntas de seguimiento:
@CallMerlin cuantas facturas tengo?→ Merlin responde con el numero@CallMerlin y cuantas de ellas estan impagadas?→ Merlin entiende "de ellas"
Despues de 10 minutos comienza una nueva conversacion sin contexto previo.
Facturacion
Los mensajes de Teams se facturan como sesiones de chat:
- Primer mensaje empieza como 1 minuto
- Mensajes extra en la misma sesion (dentro de 10 minutos) pueden anadir minutos
- Tras 10 minutos de silencio = sesion nueva desde 1 minuto
Es la misma tarifa que las sesiones de webchat.
Limites
Para prevenir abusos, se aplican limites por hora:
| Limite | Valor |
|---|---|
| Por usuario | 20 mensajes por hora |
| Por canal | 50 mensajes por hora |
Cuando se alcanza el limite, Merlin indica cuantos minutos hay que esperar.
Que puedes preguntar?
Todo lo que puedes preguntar a Merlin via webchat, telefono o escritorio tambien funciona en Teams. Ejemplos por conexion:
Contabilidad (Moneybird)
@CallMerlin cuantas facturas pendientes tengo?@CallMerlin crea una factura borrador para Bakker BV, 2500 EUR sin IVA@CallMerlin cual es el estado de la factura 2025-0042?
Agenda y correo (Microsoft 365 / Google)
@CallMerlin que tengo en mi agenda manana?@CallMerlin tengo correos sin leer?@CallMerlin envia un correo a jan@ejemplo.es con el asunto "Presupuesto"
CRM y contactos
@CallMerlin busca el numero de telefono de Bakker BV@CallMerlin crea un nuevo contacto: Jan de Vries, jan@ejemplo.es
Base de conocimiento
@CallMerlin como funciona nuestra politica de devoluciones?@CallMerlin cual es el procedimiento en caso de baja por enfermedad?
Limitaciones
- Funciona solo en canales publicos, no en canales privados ni DMs
- Cada equipo de Teams necesita su propio webhook (no se comparte entre equipos)
- Merlin no puede enviar archivos ni usar Adaptive Cards
- Las respuestas estan limitadas a 4000 caracteres
Solucion de problemas
"Crear un webhook saliente" no aparece
El administrador IT debe habilitar "Cargar aplicaciones personalizadas" en el Centro de administracion de Teams. Consulta la seccion Requisito del administrador IT.
"Error al enviar el webhook" durante la creacion
- Verifica que la URL de devolucion de llamada es correcta y comienza con
https:// - Espera 5-10 minutos e intentalo de nuevo (Teams puede estar temporalmente lento)
- Prueba con el cliente web de Teams en lugar de la aplicacion de escritorio
Merlin no responde
- Comprueba que el interruptor esta ACTIVADO en el panel
- Comprueba que el token HMAC esta correctamente pegado
- Comprueba que el ID de inquilino es correcto
- Comprueba que hay una conexion de Microsoft 365 seleccionada
- Comprueba que el usuario tiene un PIN (o que hay un PIN predeterminado configurado)
"Asocia tu cuenta de Teams a un PIN"
El empleado no tiene PIN asociado y no hay PIN predeterminado configurado. Ve al panel y asigna un PIN, o configura un PIN predeterminado.
"Se ha alcanzado el presupuesto mensual"
La cuenta tiene un tope de presupuesto y se ha alcanzado. Aumenta el tope en Facturacion en el panel de control.
Merlin no entiende el contexto
El contexto caduca despues de 15 minutos. Si haces una pregunta de seguimiento despues de ese tiempo, repite la informacion relevante en tu mensaje. Para resumenes usa los comandos de Resumir conversaciones: Merlin lee entonces hasta 50 mensajes del hilo automaticamente.