Skip to main content

Before you start

A phone number with SMS capability. See Phone numbers.
SMS write permission.
A2P 10DLC registration under way if you text US numbers. See Compliance — it takes days to weeks, so start early.
Default roles don’t include SMS access. Only Admin and Super Admin have it. If someone on your team can’t see the SMS section in the menu, they need a custom role with the SMS module.

Steps

Open the editor and choose Lumina

Chat → SMS → Agents, then press Create Agent. The Conversation engine window opens: pick Lumina.
The engine can’t be changed later. As the window itself says: “An agent’s engine is chosen at creation and cannot be changed afterwards.”
Conversation engine window with two engine cards; the Lumina card is marked New and lists live message-by-message transcripts, human takeover and a test chat that streams tool calls

Choose Lumina — the engine is fixed once the agent exists

Name and description

In the top bar. Only your team sees the description.

Model and language

First settings group, AI Model & Responses. It’s the only one that starts open.
  • LLM Model — every option shows its price per message. The default is GPT-5 Mini. There is no temperature control.
  • Language — English, Español (Latinoamérica), Español (España) or Multilingual.
Language does not force the reply language. Lumina detects the customer’s language and mirrors it. This setting only changes the language of the handoff summary and of calendar labels. To force a language, write it as a rule in the prompt — see The Language setting.
The language selector prints its heading twice and its help text talks about calls. Ignore both — it’s the same field.
AI Model & Responses group expanded with LLM Model showing GPT-5 Mini and its per-message price, the Language select set to English, and the four collapsed groups below

The model group open, the rest collapsed

LLM Model listbox open, listing each model with its per-message price and a one-line description

Every model is priced per message

Channel: number, type and first message

SMS Channel group.
  • Phone Number — required for an inbound agent. An outbound agent also needs one, to send from.
  • Agent Type — Inbound or Outbound. The default is Outbound, so choose deliberately.
  • Inbound shows Routing: a weekly schedule, or Default Agent for the number. Outbound shows First Message, which is required.
For a first agent, choose Inbound and make it the number’s default agent, so no text goes unanswered.
SMS Channel group with a phone number selected, Agent Type set to Inbound, and the Routing row reading Default agent — handles unmatched traffic, with an Edit schedule link

Inbound: number, type and routing

Write the prompt

The centre column: a single document with context, conversation flow and rules. It’s the only required content field.
SMS is billed per message and read on a small screen. One idea per message.

The prompt, FAQs and variables

How to structure and personalise it.

Check the Summary and save

The Summary tab lists what’s missing under Required to create: Name, Agent Prompt, and First Message for an outbound agent.Press Create Agent. The agent is live immediately — you’ll see SMS agent created successfully and land back on the agent list.

Check that it works

Text the number from your phone. You should get a reply within seconds and see the thread under CRM → Conversations with the Lumina badge. If nothing comes back, check in this order:
  1. The agent is Active.
  2. Its schedule covers now in the agent’s timezone, or the number has a default agent. Otherwise the text is dropped silently — nothing is sent back.
  3. Your own number isn’t opted out. See Compliance.

What doesn’t exist

  • A wizard — the editor is one screen.
  • A server-side draft — Draft saved is a browser autosave.
  • Changing the engine after creation.

Next step

The prompt, FAQs and variables

It replies. Now define exactly what it says.