Skip to main content
Hugo is OnlyX’s AI chatter. For every creator whose AI is on, it reads new fan messages and answers them in her voice, keeps conversations warm, sells her content at the prices you set, and hands a chat to your team when a person should take it. On the wire it is always ai; your people are team.

​
What it does

Chats in her voice

Replies as the creator, using her AI persona: name, age, city, backstory, interests, and how she types (capitals, punctuation, emoji, typos, split messages, typing pace).

Sells her content

Offers levels from her AI content ladders: a free preview to tease, then the paid media behind a price that never goes below your floor.

Follows up

Nudges fans who went quiet, within the daily limit you set per fan. Follow-ups are cancelled when your team steps in.

Hands off

Stops and asks for a human when a chat needs one: a safety concern, a payment dispute, a real-world meeting request, and more.
It works from the chat history, the fan’s purchases, the creator’s persona and her content. It respects:
  • her hard limits and boundaries (things she never does or talks about);
  • price floors: a level is never sold below its priceCents, and never outside OnlyFans’ own price limits;
  • active flags: a ladder or level that is not active is never offered;
  • a fan’s sales opt-out: when a fan asks not to be sold to, salesOptOut becomes true and the AI stops offering paid content to that fan;
  • AI disclosure, if you turn it on in the persona: the AI tells fans they are chatting with an AI, in your words.

​
Where it answers

The AI answers a conversation only when all of these are true:
  1. The creator is connected.
  2. The creator’s AI is on (aiEnabled: true).
  3. The conversation’s status is ai.
GET /v1/conversations/{conversationId} reports the combined answer as aiCanReply.

​
When it hands off

A hand-off is the AI saying “a person should take this chat”. The chat’s status becomes handoff, the AI stops replying in it, and a hand-off record (esc_...) explains why. Your team answers the fan (or takes the chat over), then resolves the hand-off with POST /v1/conversations/{conversationId}/handoff/resolve. If nobody replied or took the chat over, resolving returns it to the AI at once, and the AI may answer the waiting fan within seconds; if your team already replied or took it over, the chat stays with your team and resolving only closes the record. See Hand-offs. Each hand-off has a reason, one of: Each reason covers several kinds (for example real_world.meet_request, “Asks to meet”). You choose which kinds hand off for each creator with handoffKinds in her AI persona. When a kind is switched off, the AI handles that situation itself, safely (for example it declines, or stops selling for that conversation). Two kinds can never be switched off: self-harm language (welfare.self_harm) and anyone under 18 (prohibited.underage). They always hand off.

​
Follow-ups

When a fan stops answering, the AI can send a short, in-character follow-up after some hours of silence (unansweredAfterHours), at most maxPerFanPerDay times per fan per day (1 to 4, default 2). Follow-ups:
  • are only sent in chats the AI is handling (ai status) for a connected creator whose AI is on;
  • are cancelled in a chat when your team sends a message there;
  • show up in GET /v1/creators/{creatorId}/ai-settings as plannedToday and sentToday.

​
Review mode

With review mode on, every reply the AI writes waits in the dashboard’s review queue for reviewMinutes (1 to 60). A person can approve, edit or discard it. If nobody reviews it in time, whenUnreviewed decides: send sends it anyway, hold keeps it back. Use review mode while you build trust in a new creator’s setup. Turning review mode off releases the waiting drafts to fans immediately (drafts that have waited more than about ten minutes are discarded instead). That is why switching it off through the API also needs the messages:send scope. Reviewing drafts one by one is done in the dashboard.

​
The welcome message

The welcome message is OnlyFans’ own automatic message to every new subscriber. It is not written by the AI, but it opens every new fan’s conversation, so it lives with the AI settings. You can read and replace it through the API, including a price and media. See AI settings.

​
What the AI will not do

  • It never sells below a level’s floor price, and never offers a ladder or level that is not active.
  • It never offers paid content to a fan whose salesOptOut is true.
  • It never overrides a person: a chat your team holds (team), a hand-off, or ai_off gets no AI replies.
  • It never keeps chatting through a locked safety situation; those always go to a person.