Enabling DMs on an agent

    All CollectionsDMsEnabling DMs on an agent

    DM handling is configured per agent under Agents → [your agent] → Settings → DMs. The DMs page is available to every team.

    The page has three sections: DM Handling, When a Conversation Needs a Person, and DM-Specific Instructions.

    Choose inbox handling

    The Inbox handling setting controls messages that are not owned by an explicit automation:

    • Off (do nothing): record the message without generating a reply.
    • Draft (review before sending): save a model-authored reply for a teammate to review and send.
    • Automatic (send replies): send a valid model-authored reply without requiring review.

    Explicit automations remain independent and follow the publish behavior configured on their actions. Page-specific behavior belongs in page-scoped automations rather than a hidden page inbox mode.

    Disclose AI assistance

    When this toggle is on, the first AI-authored inbox reply of each conversation includes a brief disclosure that AI assisted with the response. Subsequent replies in the same conversation do not repeat the disclosure.

    Some industries (healthcare, finance, anything customer-trust sensitive) appreciate this transparency. Most consumer brands leave it off.

    When a conversation needs a person

    This group has two independent switches. Both are off by default.

    Tell the customer when the AI hands a conversation to your team. For messages the AI answers through Inbox handling, the AI can hand a conversation to your team with a short reply in its own words saying the conversation has been passed to your team. It does this when the customer asks to talk to a person, or when your DM instructions say a kind of message should go to your team. The conversation then moves to Needs you, and the AI stops replying in it until someone clicks Reopen for AI. When the switch is off, the AI hands the conversation off without replying when a customer asks for a person. DM automations, safety emergencies and legal issues are not affected: those hand-offs never get a reply.

    When the switch is on, an optional note appears: What the AI may tell the customer about your team's reply. Without a note, the AI says that someone will reply, or when, only if your DM instructions tell it to. If you add one (up to 300 characters), only write a commitment your team keeps, for example "Our team replies within one business day, Monday to Friday." Links and email addresses are refused in the note; put them in your DM instructions.

    Under the switch, status lines say how your other settings affect it:

    • with Inbox handling Off, the switch has no effect, because the AI does not answer DMs;
    • with Inbox handling Draft, the AI drafts this reply for your review, and the conversation is handed to your team right away;
    • with the email switch off or nobody chosen, nobody is emailed about hand-offs, and they wait in the inbox under Needs you.

    See What the AI promises in DMs for what the reply says and how to write hand-off instructions.

    Email teammates when a conversation is handed to a person. Pick the teammates under Teammates to email. They get an email with a link to the conversation whenever the AI hands a DM to your team or cannot send a reply. See Hand-off email notifications for exactly when it fires and how the two switches relate.

    Duplicating an agent copies the note, but both switches start off on the copy.

    DM-Specific Instructions

    The textarea under DM-Specific Instructions (up to 10,000 characters, like the other instruction fields) is layered in full on top of the agent's general brand context, but only for inbox-owned DMs. A matched automation uses its own visible action instructions instead. Use inbox instructions for things that apply to general private conversations, where the tone, content, or rules differ from public comment replies.

    Concrete examples that work well here:

    For order problems, refunds and returns, tell the customer to email [email protected]. Our support team answers emails within one business day.

    When sending a checkout link, always remind users that 10% off their first order applies automatically at checkout.

    Never share order status. Direct the user to log in to their account dashboard.

    These take priority over conflicting guidance in the agent's general additional info. The agent reads them as DM-only rules.

    Two things to know when you write them:

    • Links and email addresses the AI may share in an inbox DM must be written in these instructions. A reply that contains any other link or email is not sent or drafted, and the conversation is flagged Needs your reply.
    • Processes and timeframes (who answers, where, how fast) are only mentioned if you state them here, in the agent's context or in your knowledge base. The AI never invents a callback or a follow-up, and when you tell it what to say about one, it says it. See What the AI promises in DMs.

    When the changes take effect

    Settings save when you click Save at the top of the agent settings page. New inbox-owned replies pick up the changes immediately. Drafts already in the inbox keep the text they had at the time they were generated; edit them before sending if the new instructions change the answer.

    Related

    Next steps

    → What the AI promises in DMs

    NEXT ARTICLE

    What the AI promises in DMs