Help Desk

Refine Message

How the composer's Refine message button turns an agent's draft into a polished reply, and how to set the tone it writes in with Copilot, MCP or the REST API.

Refine message is the magic wand in the reply box. It turns whatever an agent has typed, from a few words to a full reply, into a complete, polished message in the same language, ready to send. It only changes the draft; nothing is sent until the agent clicks Send.

It works on replies to customers and on emails to third parties (external threads).

What it does

Refine reads the agent's draft and the whole conversation, then:

  • Keeps the meaning. It uses the conversation for context and facts, such as order numbers and what was already said, but never adds promises, offers, policies or facts that are in neither the draft nor the conversation.
  • Keeps the language of the draft.
  • Leaves out sign-offs. Your email signature is added when the email is sent.
  • Adapts to the channel the agent is replying on.
  • Protects the customer on external threads. In an email to a supplier or warehouse it doesn't copy the customer's name, email address, phone number or postal address, unless the draft already has them.

If the agent keeps typing while Refine is working, their edits are kept and the refined text is not applied.

Setting the tone

By default Refine writes in a professional, empathetic tone. Each business can set its own Refine instructions to change the tone, formality and style, for example:

Formal and corporate. Address the customer with the polite form.
Short paragraphs, no exclamation marks.

The instructions shape how replies read. They can't override the rules above: Refine still keeps the draft's language and meaning, adds no facts or promises and adds no sign-off, even if the instructions ask for it. Up to 2,000 characters.

These instructions only affect Refine for your human agents. The AI agent's own tone is its persona and voice.

There's no settings page for this yet. Set it with Copilot, MCP or the REST API.

With Copilot

Ask Copilot, for example: "Make refined replies formal and corporate, and address customers with the polite form." To go back to the default tone, ask it to remove the Refine instructions.

With MCP and the REST API

MCPRESTWhat it does
get_helpdesk_settingsGET /rest/v1/helpdesk-settingsReads the business's help desk settings, including refineInstructions.
update_helpdesk_settingsPATCH /rest/v1/helpdesk-settingsChanges only the fields you send; null or an empty string removes the instructions.
curl -X PATCH https://api.octocom.ai/rest/v1/helpdesk-settings \
  -H "X-API-Key: $OCTOCOM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "businessSlug": "your-business",
    "refineInstructions": "Formal and corporate. Address the customer with the polite form."
  }'
{
  "data": {
    "businessSlug": "your-business",
    "refineInstructions": "Formal and corporate. Address the customer with the polite form.",
    "updatedAt": "2026-11-19T15:04:05.000Z"
  }
}

Reading needs the helpdesk:read scope and changing needs helpdesk:write. Every change is recorded in the configuration history.

On this page