---
title: Disparo
slug: aura/disparo
docTags: 
createdAt: 2025-07-07T20:39:55.890Z
---

:::BlockQuote
Esta funcionalidade está disponível apenas para o papel de **Supervisor**.
:::

 A ferramenta de disparo de mensagens foi desenvolvida para facilitar o envio de comunicações em massa pelo WhatsApp, utilizando templates previamente aprovados. Com ela, é possível organizar listas de contatos, realizar envios de forma rápida e acompanhar o status de cada mensagem, garantindo uma comunicação eficiente e padronizada. O sistema suporta o envio de mensagens do tipo texto, imagens e carrossel.

## Contatos

 A seção contatos permite a criação e o gerenciamento de listas de contatos que serão utilizadas nos envios de mensagens. O usuário pode adicionar contatos manualmente ou importar um arquivo CSV com os dados. 

Para criar uma lista, siga os passos abaixo:

### Acessando a tela de contatos

1. No menu lateral, clique em **Disparo > Contatos**.
2. O sistema exibirá a seguinte tela:

![Menu contatos](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/XiAcH2s2XtsFard_Yz-TV_contatos.png)

### Realizando cadastro

1. Dê um nome para sua lista no campo **"Nome da lista"**.
2. No campo **"Lista de contatos"**, insira os contatos no seguinte formato:
   - `+55DDD988887777,variável_1,variável_2,variável_3,...`

:::BlockQuote
⚠️ **Informação Importante** ⚠️

O número de telefone deve ser informado no formato internacional:
:::

- **+55** → Código do Brasil.
- **61** → DDD (exemplo: Brasília).
- **988887777** → Número do telefone.

**Variáveis (marcadores):**

As variáveis inseridas após o telefone permitem personalizar cada mensagem de acordo com o template selecionado:

- Cada `variável_X` corresponde a um marcador `{{X}}` no corpo do template.
- A ordem das variáveis deve ser exatamente a ordem de substituição no texto.

**Funcionamento:**

- Ao disparar, cada **{{1}}**, **{{2}}**… é substituído pelo valor da sua respectiva **variável\_1**,**variável\_2**…
- Os marcadores são definidas na criação do template na **Gupshup**. Esses marcadores são substituidos ao informar as váriaves na criação da lista de contatos.

**Exemplo:**

![Lista de contatos](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/orfVhbro-LaZiyNnBMzji_listadecontatos.png)

1. Após concluir a configuração, clique em **"Criar lista"** para finalizar.

### Importar via arquivo CSV

1. Dê um nome para sua lista no campo **"Nome da lista"**.
2. No campo **"Lista de contatos"**, selecione um arquivo `.csv`.
3. Clique em **Importa CSV** para seleciona o arquivo.

![Importar CSV](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RVQlqjnigjzRY1pccYfo9_importarcsv.png)

1. O sistema processará o arquivo e exibira os contatos na **"lista de contatos"**.
2. Para finalizar a criação, clique em **"Criar lista"**.

### Excluindo lista

 Após a criação, as listas de contatos ficam visíveis na parte inferior da tela. Para excluir uma lista, clique no ícone da "lixeira" localizado ao lado do nome da lista desejada e confirme a ação quando solicitado. A exclusão é imediata e não pode ser desfeita. 

![Importar CSV](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/I6B2K6zMueDVARkBVPNZC_excluirlistadecontatos.png)

## Templates

 Na opção templates, o sistema exibe todos os modelos de mensagens previamente aprovados na Gupshup e disponíveis para envio via WhatsApp. Através dessa tela, o usuário pode visualizar os templates cadastrados e iniciar um disparo de mensagens selecionando o modelo desejado. 

Para realizar o cadastro de um template na Gupshup, siga as informações abaixo:

### Criando template na Gupshup

1. Acesse o site da [Gupshup](https://www.gupshup.io/pt) e faça o login na plataforma.
2. Após o login, você será direcionado para a página de **Dashboard**.
3. Escolha a **API do WhatsApp** com a qual deseja trabalhar e clique na opção **"Overview"**.

![Dashboard](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/4A0WiIBx4ORGZTBFc5soZ_dashboard.png)

1. Para criar um novo **"Template"**, clique na opção **"Criar modelo"**.

![Criar modelo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/LbIKJHkod4myiQIFt-x8T_criarmodelo.png)

1. Preenchar os campos conforme descrito abaixo:

- **Nome do template:** Escolha um nome descritivo para o seu template.
- **Categoria:** Selecione a categoria adequada para o template, de acordo com as diretrizes da Meta (**Marketing** ou **Utilidade**).
- **Idioma:** Selecione o idioma do template.
- **Rótulos de modelos:** Insira um rótulo que facilite a organização dos templates.
- **Cabeçalho (opcional):** Adicione um título no topo da mensagem, se necessário.
- **Corpo:** Insira o texto principal da mensagem. Caso tenha variáveis, utilize os **marcadores** na seguinte forma: `{{1}}`, `{{2}}`, `{{3}}`...
  **Exemplo de corpo com marcadores:**

  ```text
  Oi {{1}}, seu pedido {{2}} foi confirmado para {{3}} às {{4}}.
  ```
- **Variáveis (opcional):** Se você adicionou **marcadores** no campo **Corpo**, expanda a seção Variáveis e defina um nome para cada um deles.
  - A ordem dos nomes deve seguir o índice dos marcadores. O primeiro ao `{{1}}`, o segundo ao `{{2}}` e assim por diante.
  - Esses nomes facilitam a identificação das variáveis e, uma vez definidos, passam a ser campos obrigatórios no momento do envio.
  - Na nossa plataforma, ao cadastrar sua **lista de contatos**, você poderá informar, para cada contato, um valor diferente para cada variável configurada.

**Carrossel (Categoria Marketing):** Formato interativo com até 10 cards, com imagem, título, legenda e botão(s). Caso opte por esse formato, preencha as seguintes informações:

- **Tipo de mídia do cabeçalho:** Atualmente, apenas o formato **imagem** é suportado.
- **Número de botões:** Defina quantos botões deseja incluir.
- **Tipo de botão:**
  - **Resposta rápida:** Envia uma resposta predefinida ao clicar.
  - **URL:** Redireciona o usuário para um site específico.
- **Card:** Adicione a **imagem** (máx. 5 MB), insira a **descrição** e configure os **botões** conforme o tipo escolhido.
- **Rodapé (opcional):** Adicione um rodapé para a mensagem.
- **Botões (opcional):** Adicione botões de resposta rápida ou ações.

1. Após preencher todas as informações, clique em **"Visualizar e enviar"** para revisar o conteúdo. Se estiver tudo correto, finalize clicando em **"Enviar"**.

![Criar modelo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/yxgYNGG7BkrkuEp1KipVc_pre-visualizacao.png)

**Observações:**

- As categorias de template seguem definições da Meta. Escolha a que melhor representa o propósito da mensagem.
- O conteúdo do template deve seguir as políticas e diretrizes da Meta para aprovação.
- A aprovação do template pode levar algum tempo.

### Citsmart Aura - Acessando menu "Template"

1. No menu lateral, clique em **Disparo > Templates.**
2. A tela exibirá todos os templates já aprovados.

![Templates](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/nBk33gfnpWul0m-QSsv-Q_templates.png)

### Realizando o disparo

1. Localize o template desejado e clique no ícone azul, conforme imagem:

![Envio de templates](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/uoG_0kO_xZjzyrrcW52jP_enviodetemplates.png)

1. O sistema abrirá o seguinte formulário:

![Formulário de envio](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/jwZzNPVmXbIo5dEKNxzKQ_formulariodeenvio.png)

1. Selecione a **lista de contados** previamente criada.
2. Defina o **horário** e a **data de envio** desejados e clique em **Criar disparo**.

O sistema irá agendar o envio e exibirá uma confirmação. Você poderá acompanhar o status na aba **Envios**.

:::BlockQuote
**⚠️ Observação Importante ⚠️**  Os templates utilizados nos envios são importados automaticamente da Gupshup. É necessário que o template seja criado, enviado e aprovado por lá antes de estar disponível na plataforma.
:::

## Envios

 A tela de Envios permite acompanhar todos os disparos de mensagens realizados através da plataforma. Nela, o usuário pode visualizar o status de cada envio, identificando se a mensagem foi enviada com sucesso, cancelada, apresentou falha ou está agendada para um horário futuro.

Veja abaixo como acessar a funcionalidade:

### Acessando os envios

1. No menu lateral, clique em **Disparo > Envios**.
2. A tela exibirá a listagem de envios agendados, concluídos ou com erro.

![Envios](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/EITPa7H08m1oawcr_uGaA_envios.png)

O sistema possui os seguintes status:

- **Agendado (cinza)** – Envio programado para data/hora futura.
- **Enviado (verde)** – Mensagem enviada com sucesso.
- **Falha (vermelho)** – Ocorreu um erro no envio.
- **Cancelado (laranja)** – Envio cancelado antes da execução.

### Cancelar agendamento

Se o status estiver como **Agendado**, é possível cancelar o envio clicando no ícone de cancelamento, conforme imagem abaixo:

![Cancelando agendamento](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/QL1H32ULl9HxHmZJh6uDE_cancelaragendamento.png)