# Infrastructure de chatbot IA pour Fansly : API, webhooks et LLM

> Créez un chatbot IA Fansly réactif sur une infrastructure événementielle. Reliez un LLM à vos workflows via les webhooks et l'API REST sécurisée d'OnlyFansAPI.

**En bref**

- Un chatbot Fansly fiable s'appuie sur le webhook `fansly.messages.received` pour déclencher les réponses, plutôt que d'interroger la boîte de réception en boucle.
- Votre LLM tourne sur vos propres serveurs ou dans un client IA connecté à notre serveur MCP (Model Context Protocol), séparément de l'infrastructure de l'API.
- La boucle de chat principale utilise les endpoints de chat Fansly pour lister l'historique des messages et envoyer la réponse générée par l'IA.
- Un système de chatbot doit conserver une validation humaine pour que votre équipe puisse relire les brouillons ou suspendre l'envoi automatique.

Pour créer un chatbot IA pour Fansly, il vous faut une infrastructure événementielle qui reçoit les messages entrants via des webhooks, les traite avec le grand modèle de langage (LLM) de votre choix et renvoie la réponse via des endpoints de l'API. [OnlyFansAPI](https://fansapi.com) fournit les endpoints REST, les événements webhook et les proxys dédiés (à partir du plan Basic) nécessaires pour connecter un LLM et garder chaque compte protégé.

**Points clés**

- Un chatbot Fansly fiable s'appuie sur le webhook `fansly.messages.received` pour déclencher les réponses, plutôt que d'interroger la boîte de réception en boucle.
- Votre LLM tourne sur vos propres serveurs ou dans un client IA connecté à notre serveur MCP (Model Context Protocol), séparément de l'infrastructure de l'API.
- La boucle de chat principale utilise les endpoints de chat Fansly pour lister l'historique des messages et envoyer la réponse générée par l'IA.
- Un système de chatbot doit conserver une validation humaine pour que votre équipe puisse relire les brouillons ou suspendre l'envoi automatique.

## Créer un chatbot IA pour Fansly : quelle infrastructure utiliser ?

L'infrastructure recommandée pour créer un chatbot IA pour Fansly se compose de webhooks HTTPS pour écouter les messages entrants, d'une file d'attente en arrière-plan pour conserver les requêtes, d'un LLM pour générer les réponses et d'endpoints de l'API REST pour renvoyer le message sur la plateforme.

Votre serveur backend sert de pont entre la plateforme Fansly et votre service d'IA. OnlyFansAPI gère la connexion et le routage pour garder chaque compte protégé, avec 99,98 % de disponibilité et zéro bannissement en plus de 5 ans. La même boucle sur OnlyFans est expliquée dans notre tutoriel pour [créer un chatbot IA OnlyFans](/fr/blog/chatbot-ia-onlyfans-api-webhook-llm).

Le flux fonctionne ainsi :

1. Un fan envoie un message.
2. OnlyFansAPI envoie un webhook à votre endpoint HTTPS.
3. Votre serveur renvoie immédiatement un 200 OK et met le payload en file d'attente pour traitement.
4. Votre tâche en arrière-plan interroge le LLM avec le message du fan et l'historique récent du chat.
5. Vous appelez l'API pour renvoyer la réponse générée dans le chat.

## Événements webhook Fansly pour les chatbots

Interroger des endpoints en boucle pour détecter les nouveaux messages gaspille vos limites de requêtes et augmente la latence. Un chatbot IA prêt pour la production s'appuie sur les webhooks.

### Déclencher les réponses de l'IA avec fansly.messages.received

Le webhook `fansly.messages.received` se déclenche en quasi temps réel lorsqu'un message d'un fan arrive. Votre infrastructure reçoit un payload JSON contenant le contenu du message, l'ID de l'expéditeur et l'ID du groupe de chat.

Pour éviter d'envoyer plusieurs réponses avant que le fan ait fini d'écrire, configurez votre file d'attente pour attendre que le fan soit resté silencieux quelques secondes après son dernier message avant d'appeler le LLM.

### Relancer après un achat avec fansly.media.purchased

Lorsqu'un fan achète un média payant, vous pouvez utiliser l'événement webhook `fansly.media.purchased` pour déclencher une relance naturelle. Cet événement vous indique exactement ce qui a été acheté et pour quel montant.

Transmettez ce contexte à votre LLM pour que l'IA génère un message de remerciement sans tenter de revendre le même contenu.

## Endpoints de chat Fansly pour les réponses de l'IA

Votre application doit interagir avec la boîte de réception pour rassembler le contexte et envoyer le résultat. Les principaux endpoints de chat Fansly sont List Chats, List Chat Messages et Send Chat Message.

List Chats récupère les conversations actives :

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

List Chat Messages récupère l'historique qui sert de contexte à votre LLM :

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

Send Chat Message envoie la réponse de l'IA au fan :

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

N'appelez List Chat Messages que lorsque votre LLM a besoin de l'historique comme contexte, pas pour vérifier l'arrivée de nouveaux messages.

Tous les appels API Fansly exigent l'en-tête `Authorization: Bearer YOUR_API_KEY`, et les appels liés à un compte prennent un ID de compte au format `fansly_acct_...`.

## Où se situe le LLM

La plateforme OnlyFansAPI fournit l'infrastructure pour envoyer et recevoir les données, tandis que le LLM reste entièrement sous votre contrôle. Vous choisissez d'héberger un modèle open source en local ou d'appeler un service externe comme OpenAI ou Anthropic.

Pour les agences qui veulent déployer des Custom GPTs ou des agents Claude sans développer de backend sur mesure, OnlyFansAPI propose un [serveur MCP OnlyFans](https://fansapi.com/mcp). Le serveur expose plus de 350 outils, dont plus de 80 outils Fansly, ce qui permet à des clients comme Claude, ChatGPT et Manus d'appeler directement l'API à partir de prompts en langage naturel. Si vous développez une intégration sur mesure, votre code LLM interagit avec l'API depuis votre propre environnement serveur. Consultez la [documentation OnlyFans MCP](https://docs.fansapi.com/onlyfans-ai/mcp) pour voir comment cela fonctionne.

### Garder un humain dans la boucle

Les chatbots autonomes comportent des risques opérationnels. Une architecture sécurisée garde un humain dans la boucle, en particulier pour le contenu payant ou les interactions sensibles avec les comptes.

Au lieu d'envoyer immédiatement le texte généré par l'IA, vous pouvez concevoir votre application pour enregistrer les réponses comme brouillons. Vos chatteurs relisent les brouillons en attente, les modifient pour qu'ils correspondent à la voix du créateur et les envoient manuellement. Pour les routines automatisées, prévoyez un interrupteur manuel par chat afin qu'un opérateur humain puisse reprendre la conversation lorsqu'un fan pose des questions complexes.

## Limites de requêtes et tarifs de l'infrastructure

Lorsque vous créez des chatbots qui traitent des messages en continu, vous devez tenir compte des limites de requêtes. Les limites de l'API REST dépendent de votre plan : 60 RPM sur Free, 1 000 RPM sur Basic et 5 000 RPM sur Pro, partagées par toutes les clés de votre équipe. Le serveur MCP autorise 120 requêtes par minute par clé API.

Si votre chatbot dépasse sa limite, la requête renvoie un code de statut 429. Sur le serveur MCP, vous pouvez répartir le travail entre plusieurs clés API.

Les tarifs d'OnlyFansAPI évoluent selon le nombre de comptes. Le plan Basic coûte $69/mois pour 1 compte et inclut 1 000 RPM et 20 000 crédits/mois. Les webhooks sont disponibles à partir du plan Basic ; le plan Free n'en propose aucun. Le plan Pro coûte $299/mois pour 5 comptes et inclut 5 000 RPM et 100 000 crédits/mois, avec des comptes supplémentaires à $29, un prix qui descend jusqu'à $11,60. Les plans couvrent les connexions OnlyFans comme Fansly : vous ne payez rien de plus pour connecter un compte [Fansly API](https://fansly-api.com).