Integraciones de Slack y Mattermost
Recibe notificaciones en tiempo real en el chat de tu equipo cuando se realiza trabajo.
Visión general
TeeckIn puede enviar notificaciones a Slack o Mattermost cuando se producen eventos de temporizador, tareas y entradas de tiempo. Esto ayuda a los equipos a mantenerse informados sobre el progreso del trabajo sin actualizaciones de estado manuales.
Límites del plan
Integraciones personales frente a las de organización
Puedes configurar integraciones en dos ámbitos:
- Personal — configurada en tu propia cuenta, se activa para tu actividad en tu contexto personal. Tú las gestionas aquí.
- Organización — configurada por un administrador o propietario en una organización, se activa para la actividad de los miembros de esa organización. Los miembros no pueden crearlas ni modificarlas. Consulta la documentación de Equipos para más detalles.
Cuando una organización suprime las integraciones personales
El administrador de una organización a la que perteneces puede activar una política que suprime las integraciones personales para los eventos emitidos mientras trabajas dentro de esa organización. Cuando esto ocurre, verás un banner amarillo en tu página de integraciones que indica qué organización las está suprimiendo.
Importante: la supresión se limita únicamente a esa organización. Tus integraciones personales siguen activándose para:
- Los eventos de tu contexto personal (no asociados a ninguna organización).
- Los eventos de otras organizaciones a las que perteneces y que no han activado esta política.
No se elimina nada. Si el administrador desactiva la política más adelante, tus integraciones vuelven a activarse automáticamente para esa organización.
Obtener una URL de webhook
Slack
- Ve a api.slack.com/apps
- Haz clic en «Create New App» y elige «From scratch»
- Nómbrala «TeeckIn» y selecciona tu espacio de trabajo
- Ve a «Incoming Webhooks» en la barra lateral
- Cambia «Activate Incoming Webhooks» a On
- Haz clic en «Add New Webhook to Workspace»
- Selecciona el canal que recibirá las notificaciones
- Copia la URL del webhook (empieza por
https://hooks.slack.com/services/...)
Mattermost
- Ve a los ajustes de tu servidor de Mattermost
- Navega a Integraciones → Incoming Webhooks
- Haz clic en «Add Incoming Webhook»
- Selecciona un canal y dale un nombre como «TeeckIn»
- Copia la URL del webhook
Mantén privada tu URL de webhook
Configurar una integración
- Ve a Ajustes → Integraciones
- Haz clic en «Añadir integración»
- Introduce un nombre (por ej., «Actualizaciones de cliente»)
- Elige la plataforma (Slack o Mattermost)
- Pega tu URL de webhook
- Selecciona qué eventos notificar:
- Temporizador iniciado — cuando un temporizador comienza
- Temporizador detenido — cuando un temporizador termina (incluye la duración)
- Tarea iniciada — cuando una tarea de la lista se marca como «en curso»
- Tarea en pausa — cuando una tarea de la lista se pone en pausa
- Tarea completada — cuando una tarea de la lista se finaliza
- Tarea descartada — cuando una tarea de la lista se descarta (ya no es necesaria)
- Tarea eliminada — cuando una tarea de la lista se elimina
- Tarea asignada — cuando una tarea se asigna a un miembro del equipo (solo organización)
- Entrada de tiempo registrada — cuando se añade una entrada de tiempo manualmente (sin el temporizador)
- Entrada de tiempo editada — cuando se cambia la hora de inicio o de fin de una entrada (muestra la duración antes y después)
- Entrada de tiempo eliminada — cuando se elimina una entrada de tiempo
Activar «Tarea iniciada» también enriquece las notificaciones de «Temporizador iniciado» con el contexto de la tarea en curso (por ej., «Temporizador iniciado en Project Alpha — En curso: Corregir el error de inicio de sesión»).
- Elige un filtro:
- Todos los temas — notifica para cualquier tema
- Temas específicos — solo los temas seleccionados
- Categorías específicas — todos los temas de las categorías seleccionadas
- Haz clic en «Crear integración»
Consejo
Historial de entrega
Cada integración registra sus intentos de entrega recientes. Haz clic en el icono de reloj de una tarjeta de integración para ver el historial de entrega.
El historial muestra:
- Entregado — mensaje enviado correctamente
- Pendiente — mensaje en cola, se reintentará en breve
- Fallido — el mensaje no se pudo entregar tras 5 intentos
En caso de entregas fallidas, el mensaje de error ayuda a diagnosticar problemas como URL de webhook no válidas o problemas de red. TeeckIn reintenta automáticamente las entregas fallidas hasta 5 veces, con intervalos de 5 minutos entre intentos.
Formato de los mensajes
TeeckIn envía mensajes con contexto sobre quién hizo qué y en qué tema:
De forma predeterminada, los mensajes se publican como “TeeckIn Bot” con el avatar del reloj de TeeckIn. Puedes personalizar ambos por integración: define un nombre de bot y una URL de imagen HTTPS pública para el avatar en el formulario de la integración (solo Slack y Mattermost). Deja los campos vacíos para mantener los valores predeterminados.
Opcionalmente, los mensajes de temporizador detenido pueden incluir el tiempo facturable total aún no facturado (un campo “Sin facturar”). El total sigue el filtro de la integración: con temas o categorías concretos seleccionados suma todos ellos, y con «Todos los temas» cubre todo tu espacio de trabajo. Como una integración suele ser el canal de un cliente, se lee como «cuánto trabajo está pendiente de facturar para este cliente» cada vez que un temporizador se detiene allí. Cuenta las entradas facturables completadas no vinculadas a una factura (las facturas canceladas liberan su tiempo de nuevo), y está desactivado de forma predeterminada: activa «Incluir el total sin facturar al detener un temporizador» en el formulario de la integración.
Horarios de las notificaciones
Agrupación
Para evitar el spam de mensajes, TeeckIn agrupa los eventos dentro de una ventana configurable (predeterminada: 10 segundos). Varios eventos dentro de esa ventana se combinan en un solo mensaje.
Puedes ajustar la ventana de agrupación de 5 a 60 segundos al crear o editar una integración. Las ventanas más largas implican menos mensajes, pero actualizaciones menos en tiempo real.
Eventos de agentes de IA
De forma predeterminada, las integraciones notifican tanto la actividad humana como la de los agentes de IA. Si prefieres ver solo la actividad humana, desmarca «Incluir eventos de agentes de IA» al configurar la integración.
Cuando los agentes de IA desencadenan eventos, los mensajes muestran su identidad (por ej., «Claude» o el nombre personalizado de tu agente) con una insignia de «Agente de IA» para una atribución clara.
Solución de problemas
Los mensajes no aparecen
- Revisa el historial de entrega (icono de reloj) en busca de errores
- Verifica que tu URL de webhook sea correcta con el botón de prueba
- Comprueba que la integración esté activada (el interruptor está en On)
- Confirma que el tipo de evento esté seleccionado (por ej., timer_start)
- Asegúrate de que el tema coincida con tus ajustes de filtro
La URL de webhook cambió
Si regeneras tu URL de webhook, edita la integración en Ajustes → Integraciones y pega la nueva URL. La URL anterior dejará de funcionar.
Límite de frecuencia
Slack limita los webhooks entrantes a aproximadamente 1 mensaje/segundo. La agrupación de TeeckIn respeta este límite. Si ves mensajes retrasados durante periodos de mucha actividad, es un comportamiento esperado.