Saltearse al contenido
Nappai Documentation

Teams Webhook

Teams Webhook pone en marcha un flujo cuando ocurre algo en Microsoft Teams: se publica un mensaje en un canal, llega un mensaje a un chat, se crea un canal nuevo o se añade un miembro a un equipo.

Cuando registras el flujo, NappAI pide a Microsoft que le avise de esos cambios usando tu credencial, así que no tienes que copiar ninguna dirección en Teams. Cada aviso ejecuta el flujo con los datos del mensaje o del cambio.

Cuándo usarlo

  • Quieres que un agente de IA responda las preguntas que tu equipo publica en un canal de soporte.
  • Necesitas registrar en una hoja de cálculo cada petición que llega a un canal de Teams.
  • Quieres dar la bienvenida automáticamente a cada persona nueva que se une a un equipo.
  • Quieres recibir en otra herramienta un aviso cada vez que alguien te escribe por chat.

Configuración

Necesitas una credencial Microsoft Teams, que se conecta iniciando sesión con tu cuenta de Microsoft. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Microsoft Teams de la cuenta que quieres vigilar. Al elegirla se cargan tus equipos, canales y chats.
EventQué inicia el flujo. Ver Eventos. Por defecto, On new channel message.
Team (obligatorio)El equipo que se vigila. Solo aparecen los equipos de los que formas parte. Al cambiarlo se recarga la lista de canales. Se usa en On new channel, On new channel message y On new team member.
Channel (obligatorio)El canal en el que se vigilan los mensajes nuevos. Solo en On new channel message.
Chat (obligatorio)Uno o varios chats que se vigilan. Los chats individuales aparecen con el nombre de la otra persona y los de grupo con su tema o sus miembros. Solo en On new chat message.
Ignore Own MessagesSi está activado, se ignoran los mensajes que envías tú con esa cuenta. Así evitas que el flujo se active con sus propias respuestas. Activado por defecto.
DataCampo de prueba. Te permite probar el flujo con un aviso de ejemplo sin esperar a uno real. Déjalo vacío en el uso normal.

Eventos

EventoQué inicia el flujo
On new channelSe crea un canal nuevo en el equipo elegido.
On new channel messageSe publica un mensaje en el canal elegido.
On new chat messageLlega un mensaje a uno de los chats elegidos.
On any chat messageLlega un mensaje a cualquiera de tus chats, también a los que se creen más adelante. En este caso NappAI revisa tus chats cada poco tiempo en lugar de esperar el aviso de Microsoft.
On new team memberSe añade una persona al equipo elegido.

Activar el webhook

El flujo solo recibe avisos cuando está registrado:

  1. Guarda el flujo y publica una versión. Necesitas una versión publicada del flujo. Consulta Versiones y publicación.
  2. En el panel de ajustes del nodo pulsa Consumir.
  3. En el panel que se abre pulsa Registrar Webhook. El estado pasa a Sincronizado.

Si después cambias el evento, el equipo, el canal o los chats, el estado aparece como Desincronizado: vuelve a registrarlo. Desde el mismo panel puedes Cancelar registro del Webhook.

Resultado

La salida Data contiene el aviso recibido: el tipo de cambio, los identificadores del equipo, del canal, del chat o del mensaje según el evento y, cuando es un mensaje, su contenido, el nombre del remitente y la fecha. Si llegan varios avisos a la vez, salen todos juntos. Si todos los mensajes recibidos son tuyos y Ignore Own Messages está activado, el flujo no continúa.

Conéctala a un agente de IA para leer y responder el mensaje, o a Channel Messages o Chat Messages para contestar en Teams.

Ejemplo

El equipo de soporte interno de una empresa quiere responder automáticamente a las dudas frecuentes del canal Ayuda IT.

  1. Añade Teams Webhook y elige la credencial Microsoft Teams de la cuenta de soporte.
  2. En Event elige On new channel message, en Team el equipo de IT y en Channel Ayuda IT.
  3. Deja Ignore Own Messages activado.
  4. Conecta la salida Data a un agente que conozca las respuestas habituales y después a Channel Messages con la operación Reply Message.
  5. Publica el flujo, pulsa Consumir y después Registrar Webhook.

Buenas prácticas

  • Mantén Ignore Own Messages activado si el flujo escribe en el mismo canal o chat que vigila. Si no, responderá a sus propias respuestas sin parar.
  • Usa On any chat message solo si de verdad necesitas todos tus chats: el flujo se ejecutará con cada mensaje que recibas.

Componentes relacionados