SMS studio
Overview
An SMS is short, expensive and read at once. The SMS studio helps with all three: it suggests texts in your brand voice, counts characters and segments exactly the way the carrier bills, appends the opt-out word and shows the cost before sending.
What is saved is an SMS campaign; it is sent only with its own permission and after a confirmation. You reach the studio through SMS studio in campaigns and in dispatches.
Core tasks
Ideas. At the top are the ideas for SMS — created on their own (every Monday, on occasions) or by hand with Suggest ideas, each with an approach and a reason with figures. Use sets the idea as the brief and fetches the texts right away; one click, and you only choose. SMS ideas appear on their own only once the SMS channel is set up.
Get suggestions. Describe briefly what it is about and choose how many segments the SMS may have at most. The studio delivers three variants, each with its count and opt-out word. Use puts a variant into the text.
Understand characters and segments. An SMS knows two encodings:
- GSM-7 — the normal character set: 160 characters in one segment, from two segments on 153 per
segment. Characters such as €, [ or { count twice.
- Unicode — as soon as a single character lies outside GSM-7, such as an emoji or a typographic
quotation mark: 70 characters in one segment, from two segments on 67 per segment.
Every segment costs like a separate SMS. The count comes from the server and is the same one the send bills by. The studio's suggestions stay within GSM-7.
Opt-out word. Every marketing SMS must say how to opt out, such as "Opt out: STOP". Without it the SMS cannot be sent — neither here nor from a campaign. Add opt-out appends it. Whoever replies STOP is opted out of SMS at once (consents).
Cost up front. With an audience selected the studio shows reachable recipients, total segments, price per segment and the sum. Reachable is whoever has a confirmed SMS consent and a mobile number; how many fail on that is shown below. The confirmation before sending repeats the sum.
Fields in detail
The column What it does answers what changes in the system — not what the field is called. The grey name behind it is the API field.
Suggestions
| Field | Required | Values / format | What it does |
|---|---|---|---|
What it is about brief | yes | text | Occasion and offer, such as "Autumn sale: 20 % off all furniture until Sunday". |
Brand brandId | no | one of your brands | Whose brand profile sets the voice. |
Language locale | no | language code | The language of the texts; also sets the opt-out word. |
Count count | no | 1–5 | How many variants are created. |
Segments at most parts | no | 1–3 | How long a variant may get. Longer suggestions are cut to this limit. |
Cost up front
| Field | Required | Values / format | What it does |
|---|---|---|---|
Channel channel | yes | SMS, WhatsApp | What is estimated: SMS per segment, WhatsApp per message. |
Audience audienceId | no | an audience | Who is to be reached. Without an audience there is only the count. |
Brand brandId | no | one of your brands | Limits the consents to this brand. |
Text text | for SMS | text | The text that is counted. |
SMS campaign smsCampaignUlid | no | an SMS campaign | Instead of text and audience: those of an existing SMS campaign. |
Encoding encoding | — | GSM-7, Unicode | Result of the count. |
Segments segments | — | number | How many segments the SMS has. |
Total totalCents | — | amount | Reachable recipients × segments × price. Empty if no price is set. |
Settings & permissions
- Module
module.marketing, for suggestions also the AI switched on; sending runs through the SMS
module and the configured SMS provider.
marketing.campaign.manage— use the studio;octi.sms.send— send.- Prices under Settings → Marketing → Cost of SMS and WhatsApp: price per SMS segment and per WhatsApp
message in cents. Out of the box there are guide values (8 and 13 cents); enter your provider's prices. Without a price the studio shows the quantities but no sum.
- Through the API:
POST /v1/marketing/sms-studio/textsandPOST /v1/marketing/message-estimate.
FAQ & troubleshooting
My text has 120 characters and still two segments. Then it contains a character outside GSM-7, often a typographic quotation mark or an emoji. The count shows Unicode — replace the character.
Send is greyed out. The opt-out word is missing, or you lack the permission octi.sms.send.
Many recipients are "not reached". For SMS only a separate SMS consent under the mobile number counts — a mail consent is not enough.