> ## Documentation Index
> Fetch the complete documentation index at: https://woku.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agente de follow up

> Conoce el agente de inteligencia artificial que conversa por WhatsApp o correo con cada cliente que pidió mejorar algo y entrega el caso con evidencia

El **agente de follow up** es un **agente de inteligencia artificial** de woku. Cuando un cliente deja un comentario de **mejora** en un woku, NPS, CSAT o CES, el agente le escribe para entender mejor qué pasó: hace preguntas concretas, recibe fotos, audios y documentos, y le entrega a tu equipo un resumen con la evidencia.

Así, un comentario corto como "llegó roto" se convierte en un caso completo: qué se rompió, cómo llegó y qué esperaba el cliente, sin que nadie de tu equipo tenga que escribirle.

<Note>
  El agente es una inteligencia artificial. Si el cliente le pregunta si es una persona, responde con honestidad que es un agente de inteligencia artificial de tu empresa que toma los detalles para el equipo.
</Note>

## Cuándo actúa

El agente conversa solo cuando la respuesta cumple todas estas condiciones:

* El comentario se clasificó como **Mejora**. Los comentarios de **Reconocimiento** no reciben seguimiento.
* El cliente está **identificado** y tiene WhatsApp o correo. Las respuestas anónimas no reciben seguimiento.
* Es una respuesta **individual** a la herramienta. Las respuestas dentro de un Flow no reciben seguimiento.
* El cliente no pidió dejar de recibir seguimientos.

El agente se activa por empresa. Consulta con el equipo de woku para habilitarlo en la tuya.

## Dónde conversa

El agente escribe donde ya está tu cliente:

* **Si respondió la encuesta por WhatsApp**, el agente sigue en **ese mismo chat**, justo después de la encuesta, sin enviar una plantilla nueva. La encuesta y el seguimiento quedan como una sola conversación.
* **Si respondió por web, API, correo o un código QR**, el agente le escribe por el **número de WhatsApp de follow up** o por **correo**.

Por WhatsApp, el agente solo escribe dentro de la ventana de 24 horas que permite Meta desde el último mensaje del cliente.

## Cómo conversa

* Hace **una pregunta concreta a la vez** sobre lo que contó el cliente.
* **No pide datos que tu empresa ya tiene** ni cosas que el cliente ya dijo, como fechas, número de pedido o el producto que compró.
* **Cierra cuando ya tiene lo necesario**. Si el comentario ya explicaba todo, el primer mensaje puede ser directamente un cierre.
* Si el cliente **no quiere seguir**, cierra la conversación con respeto y sin insistir.
* **Nunca promete reembolsos, descuentos ni acciones**, ni dice que algo ya se resolvió. Solo reúne información para tu equipo.
* Si el cliente no responde, envía **un recordatorio** como máximo y luego cierra por inactividad.

Un "gracias" o un "ok" después del cierre no reabre la conversación.

## Fotos, audios y documentos

El cliente puede responder con **texto**, **fotos**, **audios** y **documentos** (por ejemplo PDF, Word, Excel o presentaciones), por WhatsApp o por correo. El agente los lee y no vuelve a preguntar lo que ya muestran. Los videos no son compatibles: si el cliente envía uno, el agente le pide que cuente por escrito lo que muestra.

Cada archivo se guarda de forma **privada** con una etiqueta estable en la conversación, por ejemplo **Archivo 2**. Solo se puede abrir desde el admin de woku, con sesión iniciada en la empresa.

## El resumen para tu equipo

Cuando la conversación termina con respuestas del cliente, el agente genera un **resumen** con:

* Un **resumen ejecutivo** de lo que agregó el seguimiento.
* **Acciones a tomar**, **temas** y **sentimiento**.
* **Citas a los archivos** que respaldan cada afirmación, por ejemplo "(Archivo 1)".

Ese resumen llega a donde tu equipo trabaja:

* **Tickets de soporte**: si la respuesta generó un ticket, el resumen y los archivos se suman al ticket.
* **Planes de acción**: los resúmenes de seguimiento se usan como contexto al generar planes, sin cambiar sus métricas.

## Dónde ver las conversaciones

En el admin, las respuestas con seguimiento muestran el botón **Agente de IA** en la lista de respuestas de cada herramienta. Ahí ves la conversación completa, la encuesta previa, los archivos con su vista previa y el resumen. La misma conversación se abre desde el detalle del ticket y desde la evidencia de los planes de acción.

## Correo del cliente

Cuando el agente continúa el chat de la encuesta por WhatsApp, no pide el correo al principio para no interrumpir lo importante. Si el cliente no tiene correo registrado, el agente se lo pide al final, una sola vez y de forma opcional. Si el cliente responde con su correo, queda guardado en su ficha.

## Para desarrolladores

Las conversaciones se leen por API con `GET /v1/follow-ups/:id`, por los SDKs de [JavaScript](/docs/development/sdk-javascript#seguimiento) y [Python](/docs/development/sdk-python#seguimiento) y por MCP con `get_follow_up`. El detalle está en la [guía de la API](/docs/development/api#procedencia-y-seguimiento).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.