Notificaciones de Microsoft Teams

FyneDesk puede publicar notificaciones de tickets directamente en Microsoft Teams. Cuando se crea, asigna, responde un ticket, o cambia su estado o prioridad, aparece una tarjeta en el canal de Teams que elijas — con el número de ticket, el título, los detalles clave y un botón Ver en FyneDesk que abre el ticket. Incluido en los planes Pro y Business.

Solo notificaciones, por diseño El bot nunca lee tus mensajes de Teams, y nadie puede crear ni cambiar tickets desde Teams — solo publica tarjetas. Las tarjetas siguen el idioma de correo de tu organización (English, Deutsch, Español, Português). Crear tickets desde dentro de Teams es una función aparte que está en desarrollo.

Lo que necesitarás

  • Un administrador de Microsoft Teams que pueda cargar aplicaciones personalizadas. Hasta que FyneDesk esté listado en la tienda de aplicaciones de Teams, la app se instala mediante Cargar una aplicación personalizada, lo cual debe permitir la directiva de Teams de tu organización.
  • Un Administrador de FyneDesk para vincular el canal y activar la función. La integración está desactivada para tu organización hasta que un administrador la habilite.

Paso 1 — Descargar el paquete de la app de FyneDesk para Teams

La app viene como un pequeño archivo .zip (un manifiesto más íconos). Un administrador de FyneDesk lo descarga desde dentro de FyneDesk: ve a Configuración → Conexiones → Microsoft Teams y haz clic en Descargar paquete de app de Teams (.zip).

Solo desde dentro de FyneDesk El paquete está disponible solo desde tu cuenta de FyneDesk — no hay descarga pública. Eso es deliberado: garantiza que la app que cargas a Teams es el paquete genuino y actual de FyneDesk. Si alguien te envía un .zip de FyneDesk para Teams desde cualquier otro lugar, no lo cargues — descarga tu propia copia desde Configuración. (Una publicación en la tienda de apps de Teams está en camino.)

Paso 2 — Instalarla en Teams

En Microsoft Teams, ve a Aplicaciones → Administrar tus aplicaciones → Cargar una aplicación → Cargar una aplicación personalizada y elige el .zip que recibiste.

¿"Cargar una aplicación personalizada" falta o está atenuado? Tu administrador de Microsoft debe permitir la carga de aplicaciones personalizadas (Centro de administración de Teams → Aplicaciones de Teams → Directivas de instalación), o puede cargar la aplicación para toda la organización él mismo.

Paso 3 — Agregar el bot a un canal

Durante la instalación, elige Agregar a un equipo y selecciona el canal que debe recibir las notificaciones. (También puedes agregarlo a un equipo más tarde mediante las opciones de la app.)

Paso 4 — El bot publica un código de un solo uso

Justo después de unirse, el bot publica un código de vinculación de un solo uso en ese canal. Se ve como XXXX-XXXX y es válido durante 7 días. Este código es la forma en que FyneDesk verifica que el vínculo es legítimo — solo alguien que pueda ver tu canal puede usarlo.

Paso 5 — Vincular el canal en FyneDesk

Un administrador de FyneDesk va a Configuración → Conexiones → Microsoft Teams, pega el código y hace clic en Vincular canal. El canal ahora aparece en Conversaciones vinculadas.

Paso 6 — Activar el interruptor maestro

En la misma página, activa el interruptor maestro. Las notificaciones para tu organización están desactivadas hasta que un administrador habilite esto — nada se publica en Teams antes de eso.

Paso 7 — Elegir el enrutamiento

Para cada tipo de evento — Nuevo ticket, Ticket asignado, Nueva respuesta, Estado cambiado y Prioridad cambiada — elige el canal que debe recibir la tarjeta, o Ningún canal para guardar silencio en ese evento.

Próximamente Las tarjetas de incumplimiento de SLA y de fecha límite llegan en breve — aparecerán en la misma lista de enrutamiento cuando lo hagan.

Paso 8 — Probarlo

Crea un ticket de prueba en FyneDesk. La tarjeta debería llegar a tu canal elegido en segundos, con un botón Ver en FyneDesk que abre el ticket.

Opcional — mensajes directos personales para los asignados

El agente al que se le asigna un ticket puede recibir un mensaje personal (1:1) del bot en lugar de — o además de — la publicación en el canal:

  • El agente instala la misma app en Teams de forma personal (Agregar para mí).
  • FyneDesk lo identifica por su correo laboral — el correo de su cuenta de Teams debe ser el mismo que su correo de inicio de sesión de FyneDesk.
  • Marca Enviar MD al asignado en un evento, y una tarjeta personal va a quien tenga el ticket asignado.

Agregar más canales

Agrega el bot a otro canal en Teams. Una vez que tu organización está vinculada, los nuevos canales en el mismo inquilino de Microsoft se conectan automáticamente y simplemente aparecen en tu lista de Conversaciones vinculadas — el bot solo publica un código nuevo si realmente se necesita uno.

Cómo desactivarlo

  • Para un canal: quita el bot del canal en Teams. FyneDesk lo nota y deja de enrutar allí automáticamente.
  • Para todo: el interruptor maestro en Configuración → Conexiones → Microsoft Teams silencia todas las notificaciones de Teams al instante, sin desinstalar nada.

Preguntas frecuentes

¿Por qué un código en lugar de "Iniciar sesión con Microsoft"?

El código demuestra que la persona que vincula realmente controla tanto el canal de Teams como el espacio de trabajo de FyneDesk. Como el bot lo publica dentro de tu canal, solo alguien que pueda leer ese canal puede completar el vínculo — esto evita que cualquier otra persona reclame el Teams de tu empresa.

¿Qué puede ver el bot?

Nada en tus conversaciones. Solo publica tarjetas. Conoce los canales a los que fue añadido explícitamente y, para instalaciones personales, el nombre y el correo laboral del usuario (usado únicamente para hacer coincidir al asignado).

¿Qué idiomas?

Las tarjetas siguen la configuración de idioma de correo de tu organización (Configuración → Correo): English, Deutsch, Español, Português.

¿Cuánto cuesta?

Las notificaciones de Microsoft Teams están incluidas en los planes Pro y Business — sin costo adicional.

¿Y la configuración con webhook + Power Automate?

Esa ruta todavía funciona — consulta Enviar notificaciones de FyneDesk a Microsoft Teams (webhooks). Pero para las notificaciones de canal, este bot nativo es el camino más sencillo: sin flujo que construir, y las tarjetas ya vienen formateadas y traducidas para ti.

Próximamente

Las tarjetas de incumplimiento de SLA y de fecha límite llegan pronto. Crear y actualizar tickets desde dentro de Teams es una función Business aparte que está en desarrollo.

Solución de problemas

Las notificaciones de Teams no funcionan — soluciones comunes

No llega ninguna tarjeta después de un ticket de prueba. Verifica que el interruptor maestro esté encendido en Configuración → Conexiones → Microsoft Teams, y que el tipo de evento (p. ej. Nuevo ticket) esté enrutado a un canal en lugar de Ningún canal.

El código de vinculación caducó. Los códigos son válidos durante 7 días. Quita el bot del canal y agrégalo de nuevo — publica un código nuevo.

"Cargar una aplicación personalizada" está atenuado. Tu administrador de Microsoft debe permitir la carga de aplicaciones personalizadas (Centro de administración de Teams → Aplicaciones de Teams → Directivas de instalación) o cargar la aplicación para toda la organización.

Un agente no recibe mensajes directos personales. Necesita instalar la app de forma personal (Agregar para mí), y el correo de su cuenta de Teams debe coincidir exactamente con su correo de inicio de sesión de FyneDesk. Luego asegúrate de que Enviar MD al asignado esté marcado en el evento.

Las tarjetas están en el idioma equivocado. Las tarjetas siguen el idioma de correo de tu organización (Configuración → Correo), no el idioma de Teams de cada usuario.