# Infraestructura de chatbot con IA para Fansly: API, webhooks y un LLM

> Crea un chatbot de IA ágil para Fansly con infraestructura basada en eventos. Conecta un LLM a tu flujo con los webhooks y la API REST segura de OnlyFansAPI.

**En resumen**

- Un chatbot de Fansly fiable se apoya en el webhook `fansly.messages.received` para activar las respuestas en lugar de consultar la bandeja de entrada una y otra vez.
- Tu LLM vive en tus propios servidores o en un cliente de IA conectado a nuestro servidor MCP (Model Context Protocol), separado de la infraestructura de la API.
- El ciclo principal del chat usa los endpoints de chat de Fansly para listar el historial de mensajes y enviar la respuesta generada por la IA.
- Los sistemas de chatbot deben mantener un flujo de trabajo con supervisión humana para que tu equipo pueda revisar borradores o pausar el envío automático.

Para crear un chatbot con IA para Fansly, necesitas una infraestructura basada en eventos que reciba los mensajes entrantes mediante webhooks, los procese con el modelo de lenguaje grande (LLM) que elijas y envíe la respuesta de vuelta mediante endpoints de la API. [OnlyFansAPI](https://fansapi.com) ofrece los endpoints REST, los eventos de webhook y los proxies dedicados (desde el plan Basic) necesarios para conectar un LLM y mantener protegida cada cuenta.

**Puntos clave**

- Un chatbot de Fansly fiable se apoya en el webhook `fansly.messages.received` para activar las respuestas en lugar de consultar la bandeja de entrada una y otra vez.
- Tu LLM vive en tus propios servidores o en un cliente de IA conectado a nuestro servidor MCP (Model Context Protocol), separado de la infraestructura de la API.
- El ciclo principal del chat usa los endpoints de chat de Fansly para listar el historial de mensajes y enviar la respuesta generada por la IA.
- Los sistemas de chatbot deben mantener un flujo de trabajo con supervisión humana para que tu equipo pueda revisar borradores o pausar el envío automático.

## Crear un chatbot con IA para Fansly: ¿qué infraestructura usar?

La infraestructura recomendada para crear un chatbot con IA para Fansly consiste en webhooks HTTPS para escuchar los mensajes entrantes, una cola en segundo plano para retener las solicitudes, un LLM para generar las respuestas y endpoints de la API REST para enviar el mensaje de vuelta a la plataforma.

Tu servidor backend actúa como puente entre la plataforma Fansly y tu servicio de IA. OnlyFansAPI gestiona la conexión y el enrutamiento para mantener protegida cada cuenta, con un 99,98 % de disponibilidad y cero baneos en más de 5 años. El mismo flujo en OnlyFans se explica en nuestro tutorial para [crear un chatbot de IA para OnlyFans](/es/blog/chatbot-ia-onlyfans-api-webhook-llm).

El flujo funciona así:

1. Un fan envía un mensaje.
2. OnlyFansAPI envía un webhook a tu endpoint HTTPS.
3. Tu servidor devuelve un 200 OK de inmediato y pone el payload en cola para procesarlo.
4. Tu tarea en segundo plano consulta al LLM con el mensaje del fan y el historial reciente del chat.
5. Llamas a la API para enviar la respuesta generada de vuelta al chat.

## Eventos de webhook de Fansly para chatbots

Consultar endpoints periódicamente en busca de mensajes nuevos desperdicia tus límites de solicitudes y aumenta la latencia. Un chatbot con IA listo para producción se apoya en webhooks.

### Activar respuestas de IA con fansly.messages.received

El webhook `fansly.messages.received` se dispara casi en tiempo real cuando llega un mensaje de un fan. Tu infraestructura recibe un payload JSON con el contenido del mensaje, el ID del remitente y el ID del grupo de chat.

Para no enviar varias respuestas antes de que el fan termine de escribir, configura tu cola en segundo plano para que espere a que el fan lleve unos segundos sin escribir tras su último mensaje antes de llamar al LLM.

### Hacer seguimiento de compras con fansly.media.purchased

Cuando un fan compra contenido multimedia de pago, puedes usar el evento de webhook `fansly.media.purchased` para activar un seguimiento natural. Este evento te indica exactamente qué se compró y por cuánto.

Pasa este contexto a tu LLM para que la IA genere un mensaje de agradecimiento sin intentar volver a vender el mismo contenido.

## Endpoints de chat de Fansly para respuestas con IA

Tu aplicación necesita interactuar con la bandeja de entrada para reunir contexto y enviar el resultado. Los principales endpoints de chat de Fansly son List Chats, List Chat Messages y Send Chat Message.

List Chats obtiene las conversaciones activas:

```http
GET https://app.fansapi.com/api/fansly/{fanslyAccount}/chats
```

List Chat Messages obtiene el historial que sirve de contexto a tu LLM:

```http
GET https://app.fansapi.com/api/fansly/{fanslyAccount}/chats/{chat_id}/messages
```

Send Chat Message envía la respuesta de la IA al fan:

```http
POST https://app.fansapi.com/api/fansly/{fanslyAccount}/chats/{chat_id}/messages
```

Llama a List Chat Messages solo cuando tu LLM necesite el historial como contexto, no para comprobar si hay mensajes nuevos.

Todas las llamadas a la API de Fansly requieren el encabezado `Authorization: Bearer YOUR_API_KEY`, y las llamadas asociadas a una cuenta reciben un ID de cuenta con el formato `fansly_acct_...`.

## Dónde vive el LLM

La plataforma OnlyFansAPI proporciona la infraestructura para enviar y recibir datos, mientras que el LLM queda totalmente bajo tu control. Tú eliges si alojar un modelo de código abierto en local o llamar a un servicio externo como OpenAI o Anthropic.

Para las agencias que quieren desplegar Custom GPTs o agentes de Claude sin construir backends a medida, OnlyFansAPI ofrece un [servidor MCP de OnlyFans](https://fansapi.com/mcp). El servidor expone más de 350 herramientas, incluidas más de 80 herramientas de Fansly, lo que permite que clientes como Claude, ChatGPT y Manus llamen directamente a la API a partir de prompts en lenguaje natural. Si estás construyendo una integración a medida, tu código del LLM interactúa con la API desde tu propio entorno de servidor. Puedes leer la [documentación de OnlyFans MCP](https://docs.fansapi.com/onlyfans-ai/mcp) para ver cómo funciona.

### Mantener la supervisión humana

Los chatbots autónomos conllevan riesgos operativos. Una arquitectura segura mantiene a una persona en el circuito, sobre todo cuando se gestiona contenido de pago o interacciones delicadas con la cuenta.

En lugar de enviar el texto generado por la IA de inmediato, puedes diseñar tu aplicación para guardar las respuestas como borradores. Tus chatters revisan los borradores en cola, los editan para que coincidan con la voz del creador y los envían manualmente. En las rutinas automatizadas, conviene incluir un interruptor manual por chat para que un operador humano pueda tomar el control de la conversación cuando un fan haga preguntas complejas.

## Límites de solicitudes y precios de la infraestructura

Al crear chatbots que procesan mensajes constantemente, debes tener en cuenta los límites de solicitudes. Los límites de la API REST dependen de tu plan: 60 RPM en Free, 1.000 RPM en Basic y 5.000 RPM en Pro, compartidos por todas las claves de tu equipo. El servidor MCP permite 120 solicitudes por minuto por clave de API.

Si tu chatbot supera su límite, la solicitud devuelve un código de estado 429. En el servidor MCP, puedes repartir el trabajo entre varias claves de API.

Los precios de OnlyFansAPI escalan según el número de cuentas. El plan Basic cuesta $69/mes por 1 cuenta e incluye 1.000 RPM y 20.000 créditos/mes. Los webhooks están disponibles desde el plan Basic; el plan Free no tiene ninguno. El plan Pro cuesta $299/mes por 5 cuentas e incluye 5.000 RPM y 100.000 créditos/mes, con cuentas adicionales a $29 que bajan hasta $11,60. Los planes cubren tanto conexiones de OnlyFans como de Fansly, así que no pagas nada extra por conectar una cuenta de [Fansly API](https://fansly-api.com).