> 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-template-variavel-api-oficial.md).

# Envio em Massa - Template Variável API Oficial

## Envio em Massa - Template Variável API Oficial

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

Use esta aba para disparar templates WABA com variáveis dinâmicas individuais por destinatário. Cada contato recebe a mensagem com seus próprios dados — ideal para personalizar campanhas em escala.

{% hint style="info" %}
Esta aba requer uma conexão via **API Oficial (WABA)**.
{% 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 WABA** 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. Configure **Fechar ticket**, **Atribuir fila** ou **Atribuir usuário** conforme necessário
4. Selecione o **Template** aprovado — as variáveis do template devem corresponder às colunas do seu arquivo (var1, var2...)

#### Preparando os dados

Preencha o campo **Números e variáveis** com uma entrada por linha, no formato:

número,var1,var2,...

```
**Exemplo:**
5511999999999,João,Produto A 5521888888888,Maria,Produto B 5511999999999,"Olá, João",Produto A
```

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 %}

#### Realizando o envio

* Clique em **Enviar** para disparar dentro da janela de 24h
* Clique em **Enviar Marketing** para campanhas fora da janela de 24h da Meta — este botão utiliza a categoria de template Marketing

{% 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 %}


---

# 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-template-variavel-api-oficial.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.