> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/usuario/ferramentas-do-atendimento/envio-em-massa-texto-variavel.md).

# Envio em massa - Texto Variável

## Envio em massa - Texto Variável

{% hint style="warning" %}
**Disponível para o perfil: Administrador, Supervisor e Usuário**
{% endhint %}

Use esta aba para enviar mensagens de texto com variáveis dinâmicas individuais por destinatário, via conexões não oficiais (QR Code). Cada contato recebe a mensagem com seus próprios dados sem necessidade de template aprovado.

{% hint style="warning" %}
Algumas APIs não oficiais não geram tickets. As opções **Fechar ticket**, **Atribuir fila** e **Atribuir usuário** não terão efeito nessas conexões.
{% endhint %}

{% hint style="info" %}
Esta página detalha o funcionamento desta aba específica. Para uma visão geral da funcionalidade, tutoriais em vídeo e orientações de uso, acesse Envio em Massa.
{% endhint %}

#### Configurando o disparo

1. Selecione a conexão em **WhatsApp / Conexão**
2. Defina o intervalo entre envios em **Min (s)** e **Max (s)** — o sistema sorteia um valor aleatório entre os dois para cada mensagem
3. Ative **Grupos** se o destino forem grupos de WhatsApp
4. Configure **Fechar ticket**, **Atribuir fila** ou **Atribuir usuário** conforme necessário

#### Preparando os dados

Preencha o campo **Dados** com uma entrada por linha, no formato:

```
**Exemplos:**
5511999999999,João,Produto A 5521888888888,Maria,Produto B
```

Regras de preenchimento:

* Um registro por linha, sem linhas em branco
* Se uma variável contiver vírgula, envolva-a em aspas duplas: `5511999999999,"Olá, João",Produto A`
* Garanta que o texto não tenha quebras de linha internas — cole tudo em uma linha só

Você também pode clicar em **Importar CSV** para subir um arquivo já formatado com as colunas de número e variáveis.

#### Regra do 9º dígito (Brasil)

O sistema valida os números conforme a regra brasileira de telefonia. Entender essa regra evita envios para números errados ou a criação de contatos duplicados no banco.

| Tipo de número                              | DDD      | Formato correto     |
| ------------------------------------------- | -------- | ------------------- |
| Telefone fixo (1º dígito após DDD = 1 a 4)  | qualquer | Sem o 9º dígito     |
| Celular — capitais e regiões metropolitanas | DDD < 30 | **Com** o 9º dígito |
| Celular — interior                          | DDD ≥ 30 | Sem o 9º dígito     |

**Comportamento do sistema ao importar:**

* **Duplicatas** — após a normalização, números duplicados são mesclados automaticamente e o sistema exibe quais foram agrupados
* **Números divergentes da regra** — são marcados com um aviso, mas o envio prossegue com o número como foi digitado
* **Variantes do mesmo contato** — um número com e sem o 9º dígito pode gerar um contato novo no banco caso não esteja em conformidade com a regra; verifique antes de disparar para evitar duplicidade na base

{% hint style="info" %}
Padronize os números antes de importar: normalize o 9º dígito conforme o DDD e remova espaços, traços ou parênteses. Isso evita avisos de validação e duplicidades no banco de contatos.
{% endhint %}

#### Compondo a mensagem

* Ative **Incluir Texto** e use `{{var1}}`, `{{var2}}` no corpo da mensagem para inserir as variáveis de cada linha
* Ative **Incluir Arquivo Local** para anexar um arquivo do seu computador (imagem, vídeo ou documento) ao disparo

#### Realizando o envio

1. Clique em **Enviar** e aguarde sem fechar a página
2. Cada número receberá a mensagem com seus próprios valores de variáveis

{% hint style="danger" %}
Não feche a página durante o envio. O progresso é processado pelo navegador e o disparo pode ser interrompido se a aba for fechada.
{% endhint %}

{% hint style="info" %}
**Boas práticas:** teste com um número próprio antes de disparar para toda a lista. Defina intervalos maiores para listas acima de 100 contatos.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.norux.chat/usuario/ferramentas-do-atendimento/envio-em-massa-texto-variavel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.