> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates de SMS

> Mensagens curtas reutilizáveis para SMS via Twilio

Os **Templates de SMS** ficam em **Templates > Biblioteca**, na aba **SMS**. São usados em:

* **Ficha do cliente** — botão **SMS** para envio individual (ver [Clientes](/clients)).
* **Campanhas de SMS** — envio em lote (ver [Campanhas](/campaigns)).

<Info>
  Para enviar você precisa de uma conexão **Twilio SMS** ativa em [Plugins](/plugins). O remetente pode ser um **número From** ou um **Messaging Service SID**, configurado na conexão.
</Info>

## Criando um template

<Steps>
  <Step title="Abra a aba SMS">
    Em **Templates > Biblioteca**, selecione **SMS**.
  </Step>

  <Step title="Clique em Novo Template">
    Isso abre a tela de criação.
  </Step>

  <Step title="Preencha os campos">
    * **Nome** — identificador interno.
    * **Descrição** — texto curto para a equipe.
    * **Mensagem** — texto simples com variáveis `{{chave}}`, limitado a **1600 caracteres**.
  </Step>

  <Step title="Visualize e salve">
    O **Preview** mostra a contagem de **caracteres** e o número de **segmentos** estimado.
  </Step>
</Steps>

<Tip>
  Um SMS padrão tem **160 caracteres por segmento** (ou 70 quando há acentos/emojis). Mensagens maiores são divididas em mais segmentos e podem custar mais no seu provedor. Sempre que possível, mantenha o texto curto.
</Tip>

## Campos dinâmicos

Aceita **Do cliente**, **Customizado**, **Sistema** e **Manual** — ver [Campos dinâmicos](/files).

Exemplo curto:

```
Olá {{cliente_nome}}, seu código é {{codigo_confirmacao}}. Não compartilhe.
```

Aqui `{{codigo_confirmacao}}` entra como **Manual** e é pedido no envio.

## Lista de templates

A aba **SMS** mostra:

| Coluna        | Descrição                     |
| ------------- | ----------------------------- |
| Template      | Nome                          |
| Mensagem      | Prévia do texto               |
| **Segmentos** | Quantidade estimada por envio |
| Campos        | Quantidade de variáveis       |
| Criado        | Data de criação               |
| Ações         | Editar, Preview, Excluir      |

## Envio pela ficha do cliente

No botão **SMS** da ficha:

1. Escolha um **template** ou digite uma **mensagem livre**.
2. Selecione o **telefone** (em formato internacional, ex: `+5511999999999`).
3. Preencha variáveis **Manual** e confira o **Preview** com contagem de caracteres/segmentos.
4. Envie.

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte a conta Twilio para habilitar envios
  </Card>

  <Card title="Campanhas" icon="bullhorn" href="/campaigns">
    Dispare em lote com este template
  </Card>

  <Card title="Clientes" icon="users" href="/clients">
    Envie individualmente pela ficha do cliente
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Acompanhe status de envio
  </Card>
</CardGroup>