> For the complete documentation index, see [llms.txt](https://docs.flowretail.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowretail.com/docs/service/message-texts.md).

# Message texts

Message texts are the SMS and e-mail texts your customers get from Flow Service.

Flow Service sends nothing that you have not written. Write each text in your company's own language first, then in any other language your customers read. The texts are sent by status messages (see [Status messages](https://docs.flowretail.com/docs/service/status-messages.md)), and by staff from the service order.

Go to **Settings → Message texts** (under **Customers**). Users with the **Service configuration** permission see the menu entry. Writing texts needs **Service configuration** or **Template Management**; anyone else sees them read-only. Settings are closed on a shared screen. See [Permissions and roles](https://docs.flowretail.com/docs/service/permissions-and-roles.md).

***

## The list

![Settings → Message texts list with the nine system messages, one own message, a 'Needs Norsk bokmål' badge on one row](https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FwnAIRuv7gOWIM9IV7OCb%2Fservice-message-texts-list.webp?alt=media)

One row per message. The nine system messages are always listed, written or not, and marked <kbd>System message</kbd>. Your own messages follow, sorted by name.

| Field     | Meaning                                                                                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Message   | The message's name. The info icon on a system message says when it is sent.                                                                       |
| Sent by   | SMS or E-mail. Fixed when the message is created.                                                                                                 |
| Languages | The languages written, or <kbd>Not written</kbd>. <kbd>Needs {language}</kbd> means your own language is missing, and the message cannot be sent. |

### System messages

Each exists once for SMS and once for E-mail, except Document by e-mail, which is e-mail only.

| Message                 | Sent when                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| Registration            | A status message uses it. Put it on the start status with the Portal link, so the customer can follow the case. |
| Message to the customer | Staff send the customer a message from the case. Its text must contain Store’s message.                         |
| New portal link         | A new portal link is sent to the customer from the case.                                                        |
| Quote                   | A price offer is sent, so the customer can answer in the portal.                                                |
| Document by e-mail      | A paper is e-mailed from the case, or by a status message that attaches a paper.                                |

Without the text in your own language, the quote and the new portal link cannot be sent on that channel.

***

## New message

![New message dialog with Sent by set to SMS and a name typed](https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2FYvE3V8vafDT79ViqgiDc%2Fservice-new-message-dialog.webp?alt=media)

<kbd>New message</kbd> adds a message of your own. Status messages and the pre-written message on a service order can use it.

| Field   | Meaning                                                                                     |
| ------- | ------------------------------------------------------------------------------------------- |
| Sent by | SMS (default) or E-mail. It cannot be changed later.                                        |
| Name    | The name staff see in lists and when they send the message. Required, up to 100 characters. |

<kbd>Write the text</kbd> opens the editor. Nothing is saved until you save the first text.

***

## The editor

![editor for an e-mail message on the 'Your language' tab, Insert row visible, a variable chip in the text, 'Filled in automatically' line under it](https://593715853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0GCVniU8V4PZKEK4axWz%2Fuploads%2Fs1bZL8hBOqrCj4O803a5%2Fservice-message-editor-email.webp?alt=media)

One tab per language: your company's language first, marked <kbd>Your language</kbd>, then the others of English, Norsk bokmål, Norsk nynorsk, Dansk, Svenska, Suomi and Deutsch. A tick marks a language that is written. Each tab is saved and deleted on its own.

| Field                   | Meaning                                                                                                                                                           |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                    | Your own messages only. Shared by every language.                                                                                                                 |
| Subject                 | E-mail only, required. Plain text; variables work here too.                                                                                                       |
| Insert                  | One button per variable this message can use. It goes in where the cursor was, in the subject or the text. A variable marked `*` is required.                     |
| Text                    | SMS: plain text with line breaks. E-mail: a text editor with bold, italic, heading, lists and links. An e-mail text the editor cannot show opens as HTML instead. |
| Filled in automatically | The variables the text uses. A variable Flow does not know is marked <kbd>Not recognised</kbd>, and the text cannot be saved.                                     |

<kbd>Save</kbd> is available once you change something.

The customer gets the text in their preferred language when you have written it, and in your company's language otherwise. A text that is only spaces counts as not written. Your company's language is set in Flow Admin. After changing it, every message needs a text in the new language; until then, sends are logged as failed.

### Variables

| Insert label    | In the text              | What it inserts                                                                                                                                                                            |
| --------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Service number  | `{{.serviceNumber}}`     | The service order number, such as 10023.                                                                                                                                                   |
| Status          | `{{.serviceStatus}}`     | The status as the customer sees it: its customer-visible label, or its name. See [Statuses](https://docs.flowretail.com/docs/service/statuses.md).                                         |
| Customer name   | `{{.customerName}}`      | The customer's full name.                                                                                                                                                                  |
| Store           | `{{.storeName}}`         | The store handling the service order.                                                                                                                                                      |
| Portal link     | `{{.servicePortalLink}}` | The customer's link to their case in the service portal.                                                                                                                                   |
| Quoted amount   | `{{.quotedAmount}}`      | The latest quoted price, such as 1.450,00. Empty until a price is offered.                                                                                                                 |
| Estimated ready | `{{.readyDate}}`         | When the work is expected to be ready: date and time, or date and "end of day".                                                                                                            |
| Store’s message | `{{.serviceNote}}`       | What staff wrote to the customer. Only in Message to the customer, and required in its text (the subject does not count).                                                                  |
| Document name   | `{{.documentName}}`      | The name of the paper attached, such as Service summary. Offered in e-mail texts other than Message to the customer, New portal link and Quote. Empty unless a paper goes with the e-mail. |

The first seven are offered in every message.

### Preview

<kbd>Preview</kbd> shows the saved text filled with example values in that tab's language. Save first: unsaved changes are not previewed.

### Delete

<kbd>Delete this text</kbd> removes one language. Customers who read it get the text in your language instead. Deleting the text in your own language stops the message from being sent.

While a status message that is switched on sends this message, no language of it can be deleted. Switch that status message off, point it at another text, or delete it first. <kbd>Go to status messages</kbd> opens **Settings → Statuses**.

## Sent messages

Every message Flow Service sends is logged with its delivery state: on the service order it is about, and together with all your company's other messages under **Messages** in Flow Admin. In the Client, a customer's card has a **Messages** tab with the messages sent to that customer.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flowretail.com/docs/service/message-texts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
