> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/sms.md).

# SMS

O módulo **SMS** envia uma mensagem de texto (SMS) para um ou mais números de telefone diretamente durante o fluxo. É útil para enviar avisos rápidos, como códigos de confirmação ou lembretes.

{% hint style="info" %}
Este módulo é diferente da **Transmissão SMS** do Hyperflow Conversas (envio em massa para uma lista de contatos). Aqui o envio acontece durante a conversa, para um número específico ou uma pequena lista (até 50 números).
{% endhint %}

***

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **SMS** para a área de trabalho do fluxo.

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma integração do tipo **SMS** já cadastrada.
{% endhint %}

***

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

***

### 📋 Campos de configuração

| Campo          | O que preencher                                                                        |
| -------------- | -------------------------------------------------------------------------------------- |
| **Integração** | Selecione a integração SMS já cadastrada                                               |
| **Para**       | Número de telefone com DDD (ex.: `5511987654321`) ou uma lista de números por variável |
| **Mensagem**   | Texto da mensagem a ser enviada                                                        |

{% hint style="warning" %}

* Este módulo envia SMS apenas para números do **Brasil**. Números de outros países não são aceitos.
* O limite é de **50 destinatários** por execução do módulo.
* A mensagem tem limite de **160 caracteres**. Diferente do que costuma acontecer com SMS tradicional, mensagens acima desse limite **não são divididas em várias partes** — elas são descartadas e não chegam ao destinatário.
  {% endhint %}

***

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — a solicitação de envio foi processada.
* **Erro** — não foi possível processar a solicitação (por exemplo, integração inválida ou mais de 50 destinatários).

{% hint style="danger" %}
A saída **Sucesso** indica que a solicitação foi processada, mas não garante que todas as mensagens foram realmente entregues. Números inválidos ou mensagens acima de 160 caracteres são descartados silenciosamente pelo provedor, mesmo quando o módulo segue pela saída de Sucesso. Sempre teste o fluxo com números e mensagens reais antes de publicar em produção.
{% endhint %}

***

## 💡 Caso de uso

**Cenário:** uma empresa quer enviar um código de confirmação por SMS durante o atendimento.

**Configuração:**

1. Adicione o módulo **SMS** ao fluxo, no ponto em que o código precisa ser enviado.
2. Selecione a integração SMS já cadastrada.
3. No campo **Para**, use a variável com o número informado pelo cliente.
4. No campo **Mensagem**, escreva `Seu código de confirmação é {{input.codigo}}`.

**Resultado:** o cliente recebe o código de confirmação por SMS automaticamente durante o atendimento.

***

## 📌 Dicas úteis

* Mantenha a mensagem sempre dentro do limite de 160 caracteres, já que mensagens maiores são descartadas em vez de divididas.
* Use apenas números de telefone do Brasil, com DDD.
* Não envie mais de 50 destinatários em uma única execução do módulo.
* Teste o fluxo periodicamente para confirmar que as mensagens estão realmente chegando aos destinatários.

***

## 📝 Resumo

* O módulo **SMS** envia uma mensagem de texto para um ou mais números durante o fluxo.
* Aceita apenas números do Brasil, com limite de 50 destinatários e 160 caracteres por mensagem.
* Mensagens acima do limite de caracteres ou números inválidos são descartados, mesmo que o módulo indique Sucesso.
* O remetente da mensagem é fixo, definido pela plataforma.