Dropp.fans est un service de paiement : vous y créez des liens de paiement, et OnlyChat permet à l'IA d'envoyer ces liens dans les scripts Telegram à la place (ou en complément) des médias payants en Stars. Quand un fan paie sur Dropp, Dropp prévient OnlyChat par un webhook, et la vente est attribuée à la conversation. L'intégration existe pour les agences qui veulent les moyens de paiement que Dropp propose sur Telegram, ou du contenu hébergé sur Dropp plutôt que dans un média Telegram, tout en laissant l'IA mener la conversation. La configuration se fait en deux parties : une fois par organisation (la clé API), puis par créatrice Telegram (profil, dossiers, liens).
Partie 1 : configuration de l'organisation
Ouvrez Account, onglet Integrations (permission Manage Telegram bot), carte Dropp.fans. La carte indique : « Agency-wide Dropp.fans API configuration. Entering your API key automatically registers the webhook on Dropp, no manual setup needed. » (configuration de l'API Dropp.fans pour toute l'agence ; saisir votre clé API enregistre automatiquement le webhook sur Dropp, aucune configuration manuelle) avec un lien « Need help setting this up? See the documentation ».
Lignes de statut
| Ligne | Valeurs |
|---|---|
| API Key | « Not configured », ou les 4 derniers caractères de la clé enregistrée. |
| Webhook | « Active » ou « Not registered ». La synchronisation des liens et l'attribution des ventes ne fonctionnent que lorsqu'il est Active. |
Configure Dropp / Update API key
Le bouton s'appelle Configure Dropp la première fois et Update API key ensuite. Il ouvre un formulaire avec un seul champ, **API Key ***, texte indicatif drp_live_..., et un contrôle afficher/masquer.
L'aide sous le champ, mot pour mot : « Agency-wide key from Dropp.fans → Settings → API. Requires links:read, links:write, webhooks:read, webhooks:write, orders:read, and transactions:read scopes. Permissions are checked automatically on save, a key missing any of them is rejected and never stored. » Autrement dit : clé agence depuis Dropp.fans, Settings, API ; elle doit avoir les six scopes listés ; les permissions sont vérifiées à l'enregistrement et une clé à laquelle il en manque une est rejetée et jamais stockée.
Save (« Verifying & saving... ») se termine par « All required permissions verified » et le toast « All permissions verified, Dropp configuration saved and webhook registered ». Erreurs :
| Message | Correctif |
|---|---|
| « API key is required » | Le champ est vide. |
| « This API key appears to be invalid, it was not saved. Double-check you copied the full key from Dropp.fans → Settings → API. » | Recopiez la clé entière, sans espaces. |
| « This API key is missing required permissions, it was not saved. Generate a new key on Dropp.fans with all the scopes listed above and try again. » | Créez une nouvelle clé sur Dropp avec les six scopes. |
| « Failed to save Dropp configuration » | Réessayez ; si ça persiste, voir Contacter l'équipe. |
- Créez la clé sur Dropp.fansDropp.fans, Settings, API. Accordez les six scopes : links:read, links:write, webhooks:read, webhooks:write, orders:read, transactions:read. Copiez la clé ; Dropp ne l'affiche qu'une fois.
- Collez-la dans Configure Dropp et enregistrezAttendez le toast. La carte affiche maintenant les 4 derniers caractères de la clé et Webhook: Active.
Partie 2 : configuration de la créatrice (onglet Dropp)
Ouvrez une créatrice Telegram et cliquez sur l'onglet Dropp. Un lien « Dropp.fans setup guide » renvoie vers cette documentation.
Bandeaux de garde
- « Dropp API key not configured, Go to Account → Dropp.fans to add your agency API key first. » (clé API Dropp non configurée, ajoutez d'abord votre clé agence dans Account, Dropp.fans).
- « Dropp webhook is not active, Go to Account → Dropp.fans and re-save your API key. Link syncing is disabled until then. » (webhook Dropp inactif, réenregistrez votre clé API ; la synchronisation des liens est désactivée d'ici là).
Une fois la clé enregistrée et le webhook actif, l'onglet affiche trois cartes.
Dropp Creator Profile
Sous-titre « Select which Dropp.fans creator corresponds to this bot. » (choisissez quelle créatrice Dropp.fans correspond à ce bot). Démarre à « No profile linked ». Select Profile ouvre un sélecteur (« Select a profile... ») listant les créatrices trouvées pour votre clé API ; le compte agence lui-même est marqué « (agency account) ». « No creators found for this Dropp API key. » signifie que le compte Dropp n'a pas encore de profils de créatrices. Toasts : « Dropp profile linked » / « Failed to save Dropp profile ».
Le profil décide quels liens cette créatrice peut importer : les liens appartiennent à un profil Dropp, donc chaque créatrice Telegram pointe vers le sien.
Link Folders
Sous-titre « Select which folders to sync. Only links from selected folders will be imported. » (choisissez les dossiers à synchroniser ; seuls les liens des dossiers sélectionnés seront importés). Cliquez sur Fetch Folders (« Fetching... » ; toast « N folder(s) fetched from Dropp » ; erreur « Failed to fetch folders, check your API key and profile »). Chaque dossier a une case à cocher, son nom (« Unnamed folder » s'il n'en a pas) et « N link(s) ». État vide : « No folders yet. Click "Fetch Folders" to load them from Dropp.fans. » Cocher ou décocher une case enregistre immédiatement (« Failed to update folder selection » en cas d'erreur).
Organisez sur Dropp avec des dossiers par créatrice ou par type de contenu ; ici vous ne cochez que ce que cette créatrice vend.
Dropp Links
Sous-titre « Showing links from selected folders only. » (ou « Showing all synced links. » quand aucun dossier n'est sélectionné). Sync Links importe les liens : toasts « N Dropp link(s) synced », ou « N Dropp link(s) synced, N deleted on Dropp, marked inactive » ; erreurs « Sync failed, check that your Dropp API key and profile are configured » et « Dropp webhook is not active, cannot sync links until it's registered ». État vide : « No links synced yet. Select folders above then click "Sync Links". »
Le tableau a les colonnes Name · Description · Price · Content · Status (Active/Inactive) · Actions, regroupées par dossier (« No folder » pour les liens sans dossier, « N link(s) » par groupe).
| Action | Ce qu'elle fait |
|---|---|
| Add description... (ou le crayon) | Ouvre Edit Description, « Shown to the AI as context for "<link>". » (montré à l'IA comme contexte pour ce lien). Texte indicatif « e.g. 5 exclusive photos, lingerie shoot », 500 caractères maximum, toast « Description saved ». |
| Corbeille | Delete Dropp Link : « Are you sure you want to delete "<name>"? This removes it from OnlyChat only, it will remain on Dropp.fans and can be re-synced later. » (ceci le retire d'OnlyChat uniquement, il reste sur Dropp.fans et peut être resynchronisé). Toast « Dropp link deleted ». |
Au-delà du nom et du prix synchronisés depuis Dropp, la description est ce que l'IA sait du lien : ce que le fan obtient, en quelle quantité, dans quel style. Écrivez-la comme vous décrivez un média dans l'onglet Medias. Un lien sans description est un lien que l'IA ne peut pas bien vendre.
- Select ProfileChoisissez la créatrice Dropp qui correspond à cette créatrice Telegram.
- Fetch Folders et cochez ceux à importerNe cochez rien pour importer tous les liens du profil.
- Sync LinksLe tableau se remplit. Relancez-le chaque fois que vous ajoutez, retarifez ou archivez des liens sur Dropp.
- Décrivez chaque lienUne ligne par lien, ce que le fan obtient. Enregistrez.
Partie 3 : les liens Dropp dans les scripts
Dans l'éditeur de script Telegram, chaque étape a un sélecteur Dropp.fans Link (Optional) : « Select Dropp.fans Link, Choose a payment link from your creator's Dropp.fans folders to attach to this step. » (choisissez un lien de paiement dans les dossiers Dropp.fans de votre créatrice pour l'attacher à cette étape). Les liens sont listés avec leur dossier (« · <folder> ») ; « No links in this folder. » quand un dossier est vide.
| Contrôle | Comportement |
|---|---|
| Dropp.fans Link (Optional) | Attache le lien. Les champs de prix se verrouillent avec « Free, the fan pays on Dropp.fans instead. » (gratuit, le fan paie sur Dropp.fans à la place). Le résumé de l'étape dans l'onglet Scripts indique « Step n: paid on Dropp, <link> ». |
| Link preview | Interrupteur : « Enable "Link preview" to show Telegram's preview card for that URL. » (activez l'aperçu de lien pour afficher la carte d'aperçu Telegram de cette URL). Désactivé, le message est texte seul. |
| Discount Dropp.fans Link (Optional) | Apparaît avec Enable discount : « Pick a Dropp link below for the discounted offer. » et « When set, the discounted offer sends this tracked Dropp URL instead of resending the original media at a reduced price. » (une fois défini, l'offre remisée envoie cette URL Dropp suivie au lieu de renvoyer le média original à prix réduit). Créez d'abord le lien moins cher sur Dropp. |
La validation « At least one media is required (or select a Dropp link) » confirme qu'un lien Dropp peut remplacer le média sur une étape payante.
Dans la conversation : l'IA envoie le message de l'étape avec l'URL Dropp suivie. Le fan paie sur Dropp ; le webhook marque la vente sur cette conversation et le Dashboard la compte sous Dropp et Total, voir Telegram Stars pour les vues.
Bon à savoir
- Webhook Not registered est la cause habituelle de « les liens ne se synchronisent pas » et « les ventes ne sont pas attribuées ». Réenregistrez la clé dans Account, Integrations.
- Supprimer un lien ici ne le supprime pas sur Dropp ; la synchronisation le ramène.
- Les liens supprimés sur Dropp sont marqués Inactive après une synchronisation, pas retirés ; les étapes qui les utilisaient ont besoin d'un nouveau lien.
- Commission : une vente Dropp conclue par l'IA est une vente de l'IA ; la commission Telegram de 15 % s'applique depuis votre solde.
- Les créatrices OnlyFans n'ont pas d'onglet Dropp ; l'intégration est réservée à Telegram.