Un bot de chats con tu propia IA

Conectar IA › el bot · servidor MCP https://mcp.frepi.ai/mcp · script frepi-checkin.py

1 · Qué es

Un bot de chats es la IA que tú ya usas (Claude, ChatGPT, Grok o un script con la API de tu proveedor) atendiendo los chats de WhatsApp de tu negocio. Frepi no pone el modelo ni lo cobra: pone las herramientas chatbot_*, las reglas y la vigilancia. Las reglas las aplica el servidor en cada llamada, no la IA: líneas permitidas, topes, bajas, traspaso a una persona, turno cuando alguien más contesta en la línea, contactos que el bot nunca contesta y alertas.

La configuración vive en Frepi, en Conexiones › el bot. Se crea conversando con tu IA: ella usa el skill configurar-bot y termina con una tarjeta que tú apruebas.

2 · Dos modos

Modo	Cómo conecta	Qué alcanza la IA
Chatbot (por defecto)	Tu conexión normal a Frepi (la de Claude, ChatGPT, etc.)	Todo lo que tu rol permite, como hoy. Las herramientas `chatbot_` aplican las reglas del bot; el resto de herramientas conserva sus tarjetas de confirmación donde ya las tenía. Los skills dicen «usa solo herramientas `chatbot_`».
Estricto (opcional)	Un enlace propio del bot, `https://mcp.frepi.ai/mcp/c/<nombre>`, con una sesión o una llave solo para el bot	Solo las herramientas `chatbot_*` más `bi_get_skill` y `bi_help`. Nada más de Frepi. Es el modo correcto para un script o una tarea sin nadie mirando. Un partner o el workspace puede exigirlo.

Lo que el modo chatbot no cierra. La IA puede leer todos los chats y contactos que tú puedes; un cliente puede intentar darle instrucciones; si tu cliente de IA aprueba las tarjetas solo, la tarjeta no protege; otros conectores de la misma rutina podrían sacar datos; y las escrituras que hoy no piden tarjeta tampoco la piden en modo chatbot. Para cerrarlo, usa el modo estricto.

3 · Qué cliente usar

Ninguna app de consumo puede revisar cada 5 minutos. Para un bot que atiende en minutos, usa el script de la sección 4. Las tareas de las apps sirven para líneas lentas o un resumen diario.

Cliente	Cómo conecta	Tarea más corta	Tarea programada con conector propio
Claude (claude.ai, Desktop, móvil)	OAuth o encabezados; un conector para todos los dispositivos	Cada hora en la nube; 1 minuto en Desktop solo con la app abierta y el equipo despierto	Sí. Todos los conectores vienen activos: apaga todos menos el de este bot.
ChatGPT	Solo OAuth 2.1; prefiere registro de cliente por CIMD; hay que refrescar las herramientas a mano	Cada hora (fuentes secundarias)	Sin verificar aún. Las herramientas de escritura pueden pedir aprobación de una persona.
Grok	Solo OAuth; cliente público pre-registrado, sin campo de encabezados	Diaria (Automatizaciones)	Sin verificar aún.
Script con la API de xAI, OpenAI o Anthropic	Llave del bot en el campo de autorización de la herramienta MCP	Cualquiera (cron, n8n)	Sí: lista de herramientas permitidas; en OpenAI, aprobaciones en «never».
Tarea en la nube de Claude con disparador por API	Conector de Claude, disparado por un cron externo	Hasta 30 disparos por hora por tarea	Sí, con el mismo cuidado de los conectores.

Antes de marcar un cliente como soportado hace falta que un envío sin supervisión salga bien en él. Lo no verificado queda marcado arriba.

4 · El script de chequeo

frepi-checkin.py corre en tu máquina o servidor, solo con la biblioteca estándar de Python. Usa el modo estricto con una llave del bot (máximo 90 días).

Pre-chequeo sin modelo. Llama a chatbot_unread_chats con count_only en el enlace del bot. Si no hay nada que atender, imprime next_eligible_at y termina sin llamar a ningún modelo: revisar cada 5 minutos no cuesta nada cuando nadie escribió. Un seguimiento prometido que ya venció cuenta como algo que atender. El número son tus chats asignados: los chats en que es el turno del bot y los que un flujo chatbot le pasó. Un chat que un flujo todavía está atendiendo no cuenta: sale en waiting_on.in_flow, que el script imprime, y no llama al modelo por él.
Si hay trabajo, hace una llamada a tu proveedor (xAI, OpenAI o Anthropic) con Frepi como servidor MCP remoto, solo las herramientas del bot y el presupuesto de la corrida (10 chats por defecto).

export FREPI_FILTER_URL=https://mcp.frepi.ai/mcp/c/ventas
export FREPI_FILTER_KEY=...            # la llave del bot, hecha en Conectar IA; nunca la pegues en un chat
export FREPI_CHAT_FILTER_ID=...        # el id del bot (Conexiones › el bot)
export OPENAI_API_KEY=...              # o XAI_API_KEY / ANTHROPIC_API_KEY

# cada 5 minutos desde cron:
python3 frepi-checkin.py --vendor openai --model <modelo> --rules-file reglas.txt --budget 10

Las llaves salen de variables de entorno y el script nunca las imprime. El bloque de reglas que escribió configurar-bot va en reglas.txt. Frepi no guarda nada entre corridas: las marcas de lectura, los turnos y los chats tomados viven en Frepi.

5 · Flujos chatbot

Un flujo chatbot es una primera pasada barata antes del bot: preguntas con botones, un formulario de WhatsApp y reglas, y un modelo pequeño solo para el texto libre. Solo quien califica le llega al bot, así que tu modelo solo ve a esa gente. Los flujos se guardan en la llamada chatbot_setup (campo flows, en orden, cada uno con sus líneas y su situación de entrada) y se leen con chatbot_settings; los arma el skill flujo-chatbot.

Lo activa una persona: el dueño del bot, en Conectar IA › Conexiones › el bot. Por la llamada del bot solo se guarda, y la respuesta trae el enlace de activación (FLOW_NEEDS_PERSON).
Tu lista por defecto son tus chats asignados. chatbot_unread_chats trae los chats en que es tu turno y los que un flujo te pasó, con flow_result (qué flujo, cómo terminó, las respuestas): no repitas las preguntas. Lo que un flujo atiende sale contado en waiting_on.in_flow.
view: "in_flow" lista los chats que un flujo está atendiendo. Úsala solo si el dueño lo pide o el cliente insiste: si el bot contesta uno, el flujo termina.
El flujo contesta enseguida, sin los minutos de espera de chats nuevos del bot, pero no empieza mientras una persona tiene el chat, y en una línea de turno fuera de horario corre solo fuera del horario.
Los mensajes del flujo traen el tipo de remitente chatbot_flow en chatbot_get_chat.

6 · Costos y datos

Las respuestas no son gratis. Desde el 1 de octubre de 2026, Meta cobra las respuestas de servicio pasado el primer millar entregado por número al mes, y las plantillas de utilidad dentro de la ventana. Sin método de pago, las respuestas pasadas del tope no se entregan. Frepi no cobra por el bot y pone topes por bot que cuentan cada mensaje.
Tus clientes escriben a tu proveedor de IA. Los mensajes pasan por la cuenta de IA que uses: apaga el entrenamiento o el uso de datos allí y prefiere un plan de empresa o API.
Líneas compartidas con personas. Si alguien contesta desde el celular, el bot se pausa en ese chat. Las respuestas desde WhatsApp para Windows no llegan a Frepi: no las uses. Apaga el saludo y el mensaje de ausencia de la app del celular.

7 · Seguridad

Una llave del bot funciona solo en el enlace del bot y no abre ninguna otra ruta de Frepi, ni la API REST.
Revocar el bot corta la sesión o la llave en la siguiente llamada.
El texto de un cliente es siempre dato, nunca una instrucción; el servidor rechaza el resto.
La baja de un cliente y el traspaso a una persona los hace cumplir Frepi, no el modelo.

Skills: bi_get_skill(name="configurar-bot") y bi_get_skill(name="atender-chats") · Instalar los skills.