> ## 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.

# Campanhas

> Dispare em lote por Voz, E-mail, SMS ou WhatsApp usando agentes de IA e templates

As **Campanhas** do Kiraa são **omnichannel**: você escolhe o canal certo para a sua ação e a plataforma envia em lote para uma lista de clientes do CRM — sempre com acompanhamento de status por destinatário.

Acesse em **Operação > Campanhas**.

## Canais suportados

<CardGroup cols={2}>
  <Card title="Voz (Ligação)" icon="phone">
    Ligações automatizadas com um **agente de IA** usando um número conectado.
  </Card>

  <Card title="E-mail" icon="envelope">
    Envio em massa via **Gmail** conectado em [Plugins](/plugins), usando um **template de e-mail**.
  </Card>

  <Card title="SMS" icon="message">
    Disparo em massa via **Twilio**, usando um **template de SMS** com campos dinâmicos.
  </Card>

  <Card title="WhatsApp" icon="whatsapp">
    Disparo em massa via **WhatsApp** (API não oficial), usando um **template de WhatsApp**.
  </Card>
</CardGroup>

## Pré-requisitos por canal

| Canal        | Pré-requisitos                                                                                              |
| ------------ | ----------------------------------------------------------------------------------------------------------- |
| **Voz**      | Um [número](/phone-numbers) ativo e um [agente](/agents) configurado                                        |
| **E-mail**   | Conexão **Gmail** ativa em [Plugins](/plugins) e um [template de e-mail](/templates-email)                  |
| **SMS**      | Conexão **Twilio SMS** ativa em [Plugins](/plugins) e um [template de SMS](/templates-sms)                  |
| **WhatsApp** | Pelo menos uma conexão **WhatsApp** em [Plugins](/plugins) e um [template de WhatsApp](/templates-whatsapp) |

<Info>
  Na escolha do canal, canais sem conexão aparecem desabilitados com a mensagem **"Conecte o Gmail em Conexões"**, **"Conecte o Twilio em Conexões"** ou **"Conecte o WhatsApp em Conexões"**.
</Info>

***

## Criando uma campanha

<Steps>
  <Step title="Clique em Nova Campanha">
    Na página **Campanhas**, clique no botão **Nova Campanha**.
  </Step>

  <Step title="Escolha o canal">
    Selecione **Voz**, **E-mail**, **SMS** ou **WhatsApp** no diálogo **Nova Campanha**.
  </Step>

  <Step title="Configure os detalhes">
    Siga o **wizard** específico do canal (veja abaixo).
  </Step>

  <Step title="Acompanhe o andamento">
    Ao concluir, você vai direto para a página de detalhes da campanha com estatísticas, filtros e ações.
  </Step>
</Steps>

***

## Wizards por canal

### Voz (Ligação)

Etapas: **Configuração → Contatos → Agendamento**

1. **Configuração** — Nome, descrição, **Número de Origem** (da lista de números registrados) e **Agente** (ou **Usar agente do número**, quando o próprio número já tem um agente configurado).
2. **Contatos** — busque **clientes do CRM** e marque quais telefones usar para cada cliente (checkboxes). A campanha tenta os telefones selecionados em ordem. Você pode criar um **Novo Cliente** direto daqui.
3. **Agendamento** — defina janela de disparos, horários permitidos, **duração máxima da chamada** e regras de retry.

### E-mail, SMS e WhatsApp (mensagens)

Etapas: **Configuração → Template → Destinatários → Agendamento**

1. **Configuração**
   * **Nome** e **descrição**.
   * **E-mail**: confirma que o Gmail está conectado.
   * **SMS**: confirma que o Twilio está conectado.
   * **WhatsApp**: selecione a **Integração WhatsApp** (se você tiver mais de uma conectada).

2. **Template** — escolha um **template ativo** do canal correspondente.
   * Se não houver, abra [Templates](/files) e crie um primeiro.
   * A prévia aparece ao selecionar: assunto + corpo HTML (E-mail) ou texto/mídia (SMS e WhatsApp).
   * Se o template tiver variáveis, a lista de **Variáveis necessárias** aparece como `{{chave}}`.

3. **Destinatários** — busque clientes do CRM e escolha os destinos:
   * **E-mail**: os **e-mails** cadastrados no cliente.
   * **SMS e WhatsApp**: os **telefones** cadastrados no cliente.
   * Todos os destinos são pré-marcados; expanda a linha para **desmarcar** destinos específicos.
   * Se faltar dado para preencher alguma variável, a plataforma avisa que **esses clientes serão pulados** (com contagem de variáveis faltantes).

4. **Agendamento** — defina quando iniciar o envio e opções de ritmo/limite.

<Tip>
  Templates com variáveis dependem de campos do cliente (ex: `{{cliente_nome}}`, `{{cliente_cpf}}`). Certifique-se de que as fichas estão preenchidas para evitar pulos. Veja o catálogo completo em [Campos dinâmicos](/files).
</Tip>

***

## Página de detalhes

A página de uma campanha mostra, em todos os canais:

* **Badge de canal** (Voz, E-mail, SMS ou WhatsApp) junto ao nome.
* **Progresso** (`Progresso: X de Y contatos`) e barra de porcentagem.
* **Cards de estatísticas** — Total, Na Fila, Enviadas/Concluídas, Finalizadas, Taxa de Sucesso (labels variam por canal).
* **Ações gerais** — **Pausar**, **Iniciar/Retomar**, e **Mais Ações** (cancelar, excluir).

### Diferenças por canal

| Tópico            | Voz                                                     | Mensagens (E-mail/SMS/WhatsApp)            |
| ----------------- | ------------------------------------------------------- | ------------------------------------------ |
| Tabela principal  | **Contatos**                                            | **Destinatários**                          |
| Coluna de destino | Telefone                                                | E-mail (E-mail) ou Telefone (SMS/WhatsApp) |
| Cabeçalho         | Mostra **Agente** e **Número** da campanha              | Foca em estatísticas de envio              |
| **Mais Ações**    | Inclui **Adicionar Contatos** e **Exportar Resultados** | Somente ações gerais (cancelar/excluir)    |

### Status possíveis

**Voz**: Pendente, Na Fila, Em Chamada, Concluído, Não Atendeu, Ocupado, Caixa Postal, Falhou.

**Mensagens**: Pendente, Na Fila, Enviando, Enviado, Entregue, Falhou, Limite Tentativas, Cancelado e **Pulado (variáveis)** — quando faltaram dados para preencher o template.

Você pode filtrar por status, buscar por cliente, e acionar ações por linha:

* **Voz** — tentar novamente, remover contato.
* **Mensagens** — **Reenviar** (quando permitido) e **Remover** destinatário.

***

## Lista de campanhas

Na página principal **Campanhas** você tem:

* **Busca** por nome, descrição ou agente (voz).
* **Filtro de status** — Rascunho, Ativa, Pausada, Concluída, Cancelada.
* **Filtro de canal** — Todos, Voz, E-mail, SMS, WhatsApp.
* **Badge de canal** em cada linha.

***

## Boas Práticas

<CardGroup cols={2}>
  <Card title="Escolha o canal certo" icon="compass">
    Voz para decisões em tempo real; E-mail para conteúdo formal e rastreável; SMS para alertas curtos; WhatsApp para conversas casuais e confirmações.
  </Card>

  <Card title="Templates bem testados" icon="flask">
    Envie para si mesmo primeiro via [ações no cliente](/clients) antes de disparar em lote.
  </Card>

  <Card title="Fichas completas" icon="id-card">
    Mantenha telefones, e-mails e campos customizados preenchidos para evitar destinatários pulados por variáveis.
  </Card>

  <Card title="Ritmo adequado" icon="gauge">
    Em SMS e WhatsApp, velocidades muito altas aumentam risco de bloqueio. Use janelas de horário comercial e ritmo moderado.
  </Card>
</CardGroup>

***

## Resolução de Problemas

| Problema                                   | Solução                                                                    |
| ------------------------------------------ | -------------------------------------------------------------------------- |
| Canal aparece desabilitado no picker       | Conecte o provedor correspondente em **Integrações > Plugins**             |
| Muitos destinatários "Pulados (variáveis)" | Complete os campos do cliente que alimentam as variáveis do template       |
| Ligações "Não Atendeu" em excesso          | Ajuste janela de horários e tentativas na etapa **Agendamento**            |
| WhatsApp falha em sequência                | Verifique se a conexão está **Ativa** em Plugins e reduza o ritmo de envio |

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Templates" icon="file-pen" href="/files">
    Crie templates de e-mail, SMS, WhatsApp e documentos com campos dinâmicos
  </Card>

  <Card title="Plugins" icon="plug" href="/plugins">
    Conecte Gmail, Twilio e WhatsApp para habilitar todos os canais
  </Card>

  <Card title="Clientes" icon="users" href="/clients">
    Enriqueça a base para evitar destinatários pulados
  </Card>

  <Card title="Atividade" icon="list-check" href="/activity">
    Acompanhe todos os envios da organização em um único painel
  </Card>
</CardGroup>