> ## Documentation Index
> Fetch the complete documentation index at: https://help.onlyx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> You are reading OnlyX Help: the OnlyX Help Center and the OnlyX developer documentation. OnlyX is an AI chatting and CRM platform for OnlyFans agencies. Its AI chatter is called Hugo in the app.
> Pages at the site root (for example /inbox/..., /hugo/..., /billing/...) are Help Center articles for agency owners, admins, chatters and creators who use the app at app.onlyx.ai. Words in bold are the exact button, menu and label names the app shows; keep them exactly as written. When these pages do not answer a question, the person can email support at support@onlyx.ai.
> Pages under /developers are the developer documentation. REST API base URL: https://api.onlyx.ai/v1 (authenticate with `Authorization: Bearer <API key>`; keys start with onx_sk_ and are created in app.onlyx.ai under Settings > API & MCP). MCP server: https://mcp.onlyx.ai/mcp (OAuth, or a Bearer API key). In the API the AI chatter is `ai` on the wire. Money is integer US cents in fields ending in Cents; timestamps are UTC ISO-8601.
> Rules for assistants acting on a user's behalf: discover ids with list calls and never invent them; before any call that reaches a real fan or the live OnlyFans account (sending a message, releasing a chat to the AI, turning AI on for a chat, resolving a hand-off, turning review mode off, changing the welcome message, creating a tracking link) show the user the exact content and get explicit confirmation; send every POST with an Idempotency-Key and reuse it on retry; never resend a message whose delivery status is unconfirmed; never ask a creator for her OnlyFans password or codes - she signs in herself through a connect link and the OnlyX Login app.

# Your first shift as a chatter

> Work your first shift in the OnlyX inbox: choose what to answer first, check who has a conversation, reply, leave a note and give it back to Hugo.

<Badge color="blue">Owners, admins and chatters</Badge>

This guide follows one shift in the inbox. You open your workspace, choose what to answer, reply, leave a note and give your conversations back.

## Before you start

* An owner or admin invited you as a chatter. If you have not accepted yet, see [Join a team from an invite](/team/join-from-an-invite).
* An owner or admin assigned creators to you. You see only those creators and their conversations. They set this in **Settings** > **Members**. See [Manage members, assignments and invites](/team/manage-members).
* This guide uses a computer. For a phone, see [Use the inbox on your phone](/inbox/inbox-on-your-phone).

## Open your inbox

<Steps>
  <Step title="Choose your workspace">
    If you work for more than one agency, check the workspace first. At the foot of the sidebar, click your name. A check mark shows the workspace you are in. Select the workspace for this shift.

    OnlyX reloads. See [Work in several workspaces](/team/several-workspaces).
  </Step>

  <Step title="Open the inbox">
    In OnlyX, click **Inbox**. After you sign in, a chatter starts here.

    The **Master Inbox** lists the conversations of your creators.
  </Step>

  <Step title="Check your creators">
    At the top of the list, click **All creators**.

    The picker lists only the creators assigned to you. Each one shows how many of her conversations are unread. Click one creator to work her inbox alone. Select **All creators** to see every one of yours.
  </Step>
</Steps>

## Choose what to answer first

The chips at the top of the **Master Inbox** group the list by who has each conversation. The number on a chip counts the conversations in that state for the creator you picked.

We recommend checking these groups in this order.

<Frame caption="**1** Only your creators · **2** The state chips. The small box marks the sort menu.">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/inbox-priorities-light.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=b00eba811ee8c2892fb4595511b48061" alt="The Master Inbox controls for a chatter: the creator picker, state chips with counts, and sort menu" width="1440" height="562" data-path="images/help/getting-started/your-first-shift/inbox-priorities-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/inbox-priorities-dark.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=405bc57c1bfa219472172a89160c5739" alt="The Master Inbox controls for a chatter: the creator picker, state chips with counts, and sort menu" width="1440" height="562" data-path="images/help/getting-started/your-first-shift/inbox-priorities-dark.png" />
</Frame>

<Steps>
  <Step title="Start with escalations">
    Click **Escalated**. Hugo stopped answering these fans and asked for a person. Open one and read his reason first. See [Handle an escalation](/inbox/handle-an-escalation).
  </Step>

  <Step title="Move to unread conversations">
    Click **Unread**. Each of these has at least one unread message. To bring the busiest to the top, open the sort menu and select **Most unread**.
  </Step>

  <Step title="Check the manual conversations">
    Click **Manual**. A person on your team holds each of these. If Hugo is off for a creator, her conversations stay here with no holder. Look for the ones you took over earlier.
  </Step>
</Steps>

To narrow the list more, use the search box and **Filters**. See [Find conversations: search, filters and sort](/inbox/find-conversations).

Opening a conversation marks it as read for your whole team.

## Read before you reply

<Steps>
  <Step title="Open the conversation">
    Click the fan's row in the list. Check the creator's name at the top of the conversation. Then read the chip next to the fan's name: **Hugo**, **Manual**, **Escalated** or **Hugo off**.

    The conversation opens, with the fan panel next to it. On a smaller screen, use the panel button at the top of the conversation.
  </Step>

  <Step title="Read the recent messages">
    Scroll up in the conversation. Read what the fan wrote and what your team or Hugo answered.
  </Step>

  <Step title="Check who has the conversation">
    In the fan panel, read the tag under the fan's name.

    On a **Manual** conversation, the tag names the holder. In the picture, an admin named Priya Shah holds the conversation. The tag reads "A person has it" when OnlyX has no name. Other tags are "Hugo escalated this", "Hugo off for this fan", or what Hugo is doing, such as "Building rapport".

    <Frame caption="**1** The tag names who has the conversation">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/holder-line-light.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=51c5109bb1959cef5348811e43a76ce5" alt="The top of the fan panel for a Manual conversation, with the tag under the fan's name that names who has it" width="1440" height="578" data-path="images/help/getting-started/your-first-shift/holder-line-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/holder-line-dark.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=58cb1278f57b6279fe9c6c0a9bd55991" alt="The top of the fan panel for a Manual conversation, with the tag under the fan's name that names who has it" width="1440" height="578" data-path="images/help/getting-started/your-first-shift/holder-line-dark.png" />
    </Frame>
  </Step>

  <Step title="Read the notes">
    In the fan panel, scroll to **What Hugo knows** and **Notes**. Read what Hugo and your team already know about this fan. See [The fan panel: know the fan before you reply](/inbox/fan-panel).
  </Step>
</Steps>

<Note>
  On a **Manual** conversation that has a countdown, everyone who opens it sees the "You're in control" bar, not only the holder. To know who has the conversation, read the name in the fan panel.
</Note>

## Reply to the fan

Your first message on a **Hugo** or **Escalated** conversation takes it over. It works like **Claim**. The conversation becomes **Manual** in your name, and Hugo stays out.

If a teammate already holds the conversation, **Claim** is not shown. You can still reply. Your reply does not change who holds it, or when the hold ends. We recommend that you ask the holder before you answer.

<Steps>
  <Step title="Optional: Claim the conversation">
    To hold the conversation before you write, click **Claim** at the top of the conversation.

    **Claim** changes to **Resume Hugo**, and the chip changes to **Manual**.
  </Step>

  <Step title="Write your message">
    Click in the message box. Type your message. Then press <kbd>Enter</kbd>. See [Send a message and add emoji](/inbox/send-messages).

    <Warning>
      This message goes to the real fan. On OnlyFans, you can **Unsend** a message within 24 hours, but the fan may already have read it.
    </Warning>
  </Step>
</Steps>

The 12-hour hold starts when you take over. Your later messages do not restart the clock, and no button adds time. When the 12 hours end, the conversation goes back to Hugo if he is on for the creator.

## Leave a note for your team

<Steps>
  <Step title="Write the note">
    In the fan panel, scroll to **Notes**. Type what the next person needs to know.

    **Save notes** shows after you type.
  </Step>

  <Step title="Save the note">
    Click **Save notes**.

    The note is saved on the fan, for everyone on your team. The fan never sees it.
  </Step>
</Steps>

We recommend that you write what the fan asked, what you told him, and what is still open.

## Finish your shift

Before you stop, decide what happens to each conversation you hold. OnlyX has no shift schedule. It also has no control that gives a conversation to a named person.

### Give a conversation back to Hugo

<Steps>
  <Step title="Find your conversations">
    In the **Master Inbox**, click **Manual**. Open a conversation you took over.
  </Step>

  <Step title="Check the holder">
    In the fan panel, read the name in the tag. **Resume Hugo** ends the hold of whoever has it. If a teammate holds the conversation, we recommend that you ask that person first.
  </Step>

  <Step title="Give the conversation back">
    At the top of the conversation, click **Resume Hugo**. You can also click it on the "You're in control" bar.

    The chip changes to **Hugo**, and the countdown disappears. If the fan's newest message has no answer, Hugo answers it. If the newest message is from your team, Hugo waits for the fan.

    <Frame caption="**1** Everyone who opens the conversation sees this bar · **2** **Resume Hugo** ends the hold">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/hold-bar-light.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=ba95e8609e6acb8439ccb66b87017e23" alt="A Manual conversation with the You're in control bar and its countdown, and Resume Hugo at the top of the conversation" width="1440" height="1260" data-path="images/help/getting-started/your-first-shift/hold-bar-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/CzrCRifWVmbmv850/images/help/getting-started/your-first-shift/hold-bar-dark.png?fit=max&auto=format&n=CzrCRifWVmbmv850&q=85&s=e2089df89609fb53ba5f00b14cc23a71" alt="A Manual conversation with the You're in control bar and its countdown, and Resume Hugo at the top of the conversation" width="1440" height="1260" data-path="images/help/getting-started/your-first-shift/hold-bar-dark.png" />
    </Frame>
  </Step>
</Steps>

If Hugo is off for the creator, the conversation stays **Manual** with no countdown. Your team keeps it.

### Pass a conversation to a teammate

Use this when a person must keep answering after your shift. It is a way of working, not an app feature.

<Steps>
  <Step title="Save a note">
    Write what is still open in **Notes**, and click **Save notes**.
  </Step>

  <Step title="Copy the link">
    In the list, point at the conversation's row. Click the three dots that show in its corner. Select **Copy link**.

    OnlyX shows "Link copied". Paste the link into your team's own chat. A teammate can open it only if the creator is assigned to them. Owners and admins can open all of them.
  </Step>

  <Step title="Leave the hold in place">
    Your name stays on the conversation until the hold ends or someone clicks **Resume Hugo**. Your teammate can reply in the meantime. The 12 hours still count from when you took over.

    When your teammate finishes, they click **Resume Hugo**.
  </Step>
</Steps>

## If something goes wrong

<AccordionGroup>
  <Accordion title="I do not see the creator I work for">
    You see only the creators assigned to you. Ask an owner or admin to assign her in **Settings** > **Members**. If none are assigned, **Creators** shows "No creators assigned to you yet".
  </Accordion>

  <Accordion title="The list says &#x22;No conversations match these filters.&#x22;">
    A chip, a search or a filter narrows the list. Click **Clear filters**. Then click **All**.
  </Accordion>

  <Accordion title="The bar says You're in control, but I did not take the conversation">
    Everyone who opens a **Manual** conversation that has a countdown sees the bar, not only the holder. Read the tag in the fan panel to see who holds it.
  </Accordion>

  <Accordion title="The conversation went back to Hugo while I was still working">
    The 12 hours count from the moment you took over. Later messages do not restart them. If Hugo is on for the creator, he takes the conversation back when the time ends.

    To keep working, click **Claim**. A new 12-hour hold starts.
  </Accordion>

  <Accordion title="I clicked Resume Hugo, but the conversation still shows Manual">
    Hugo is off for this creator, so the conversation stays with your team. Ask an owner or admin to check the creator's **Hugo** switch. See [Why isn't Hugo replying?](/inbox/hugo-isnt-replying).
  </Accordion>

  <Accordion title="The unread number went away when I opened a conversation">
    Opening a conversation marks it as read for the whole team. To mark it unread again, open the three-dot menu on its row and select **Mark as unread**.
  </Accordion>
</AccordionGroup>

## What's next

<Columns cols={2}>
  <Card title="Find conversations: search, filters and sort" icon="search" href="/inbox/find-conversations" horizontal />

  <Card title="Take over a conversation and give it back" icon="hand" href="/inbox/take-over-and-resume-hugo" horizontal />

  <Card title="What each team role can see and do" icon="shield-check" href="/team/roles-and-permissions" horizontal />
</Columns>