> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Campanhas > Como criar e gerenciar campanhas de mensagens automáticas por WhatsApp ou email. # Campanhas As campanhas permitem enviar mensagens automáticas para uma lista de contatos em uma data específica — por exemplo, lembretes de pagamento, avisos de vencimento de contrato, confirmações de consulta ou qualquer comunicação programada. > [!NOTE] > > As campanhas estão disponíveis nos planos **Standard** e **Premium**, mas também são uma funcionalidade em fase piloto: o ChatNorris precisa habilitá-la explicitamente para a sua organização. Se o seu plano as inclui, mas você não vê **Campanhas** no menu de um agente, escreva para **[hola@chatnorris.ai](mailto:hola@chatnorris.ai)** para ativá-las. O limite de contatos por campanha depende do seu plano — confira em **Faturamento e uso → Assinatura**. > [!NOTE] > > Agora as campanhas pertencem a um agente específico, não à organização inteira — elas são criadas e gerenciadas dentro de cada agente. A tela **Campanhas** do menu principal passou a ser uma visualização somente leitura que resume as campanhas de todos os seus agentes, agrupadas por agente, com um link para cada uma. ![TODO: captura da lista de campanhas com status e barra de progresso](https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-lista-campanas.png) ## Canais de envio Cada campanha pode enviar por **WhatsApp**, por **Email** ou pelos **dois** ao mesmo tempo (em **Canal de envio**, você pode marcar os dois). > [tab] WhatsApp > > Envia mensagens usando **modelos aprovados pela Meta**. Você precisa de um canal do WhatsApp Business conectado ao agente (em Publicar) e de pelo menos um modelo aprovado. > > Os modelos são criados, enviados para análise e sincronizados no próprio ChatNorris, em **Modelos do WhatsApp** (veja mais abaixo). Ao criar a campanha, você escolhe o modelo em uma lista com os aprovados e decide qual dado de cada contato vai em cada variável. > > > [!NOTE] > > > > O WhatsApp só permite enviar mensagens proativas (outbound) usando modelos aprovados pela Meta. Não é possível enviar mensagens de texto livre para contatos que não iniciaram a conversa. > > > [!WARNING] > > > > A Meta cobra cada mensagem de modelo diretamente na sua conta do WhatsApp Business, desde a primeira (elas não entram nas 1.000 respostas gratuitas). Você precisa de uma forma de pagamento na Meta. Veja [Custos da Meta no WhatsApp](https://docs.chatnorris.ai/pt/guias/canales-whatsapp-instagram.md#custos-da-meta-no-whatsapp). > [tab] Email > > Envia emails com assunto e corpo personalizados. Você pode usar variáveis como `{{name}}`, `{{due_date}}`, `{{custom1}}` e `{{custom2}}` para personalizar cada mensagem. > > As campanhas de email saem pelo **canal Email do agente**, então o agente precisa ter esse canal conectado em Publicar (o canal Email está incluído no plano Premium; veja [Conectar o canal Email](https://docs.chatnorris.ai/pt/guias/canal-email.md)). As respostas dos destinatários chegam às **Conversas** desse agente. Cada campanha de email também tem sua própria **identidade visual** (logo, cor de destaque e largura do logo), com pré-visualização do cabeçalho. ## Modelos do WhatsApp Na lista de campanhas do agente, clique em **Modelos do WhatsApp**. O ChatNorris cria e envia os modelos diretamente para a Meta analisar, sem sair do app: * **Novo modelo**: preencha nome, categoria (Autenticação, Utilidade ou Marketing), idioma, cabeçalho e rodapé opcionais e o corpo da mensagem. Use `{{1}}`, `{{2}}`, ... para as variáveis que são preenchidas no envio. Você verá uma pré-visualização com dados fictícios. * **Enviar para a Meta**: envia o modelo para análise. O status passa por **Rascunho**, **Em análise** e **Aprovado** ou **Rejeitado** (com o motivo). * **Sincronizar da Meta**: importa os modelos que já existem na sua conta do WhatsApp Business. * **Nova versão**: cria uma nova versão de um modelo existente; a que está em uso é marcada como **Vigente**. ## Criar uma campanha **1. Acesse o agente e depois Campanhas** Entre no agente que vai enviar a campanha (`Agentes → [seu agente] → Campanhas`) e clique em **Nova campanha**. Cada campanha fica vinculada a esse agente — se quiser enviar a partir de outro agente, entre no workspace dele. **2. Preencha as informações básicas** * **Nome da campanha** — um nome interno para identificá-la. * **Usar modelo salvo** (opcional) — parte de uma configuração que você salvou antes; continua editável. * **Canal de envio** — WhatsApp, Email ou os dois. **3. Configure o canal e a mensagem** > [tab] WhatsApp > > * **Canal do WhatsApp** — escolha o número do WhatsApp Business conectado ao agente. > * **Modelo do WhatsApp** — escolha um modelo aprovado e a **Versão / idioma** dele. > * **Variáveis do modelo** — para cada variável (`{{1}}`, `{{2}}`, ...), escolha se vai o nome do contato, a data de vencimento, um campo personalizado ou um texto fixo. > [tab] Email > > * **Canal de email do agente** — o canal Email conectado em Publicar. > * **Nome do remetente** — o nome que os destinatários verão. > * **Assunto do email** — você pode usar variáveis: `Lembrete para {{name}}`. > * **Corpo do email** — use `{{name}}`, `{{due_date}}`, `{{custom1}}`, `{{custom2}}` para personalizar. > * **Identidade visual deste email** — URL do logo, cor de destaque e largura do logo. **4. Defina quando enviar** Em **Quando enviar?**, escolha entre: | Opção | O que faz | | - | - | | **Envio único** | É enviado para todos os contatos assim que você ativa a campanha. Não exige data de vencimento por contato. | | **Lembrete — Dias antes** | "3 dias antes" → envia o lembrete 3 dias antes do vencimento de cada contato. | | **Lembrete — No dia** | Envia no dia do vencimento. | | **Lembrete — Dias depois** | "1 dia depois" → envia um acompanhamento no dia seguinte ao vencimento. | **5. Salve a campanha** Clique em **Criar campanha**. Se você marcar **Salvar como modelo reutilizável**, poderá partir dessa configuração em campanhas futuras. A campanha é criada com status **Rascunho** e não envia nada até você ativá-la. ## Adicionar contatos à campanha **1. Abra o detalhe da campanha** Na lista, clique na campanha que você criou. **2. Adicione contatos** Você pode adicionar contatos de duas formas: Clique em **Adicionar contatos** e escolha uma das duas abas: **Manual (um por um):** * Preencha: nome, telefone no formato internacional (para WhatsApp) e/ou email, data de vencimento e dados opcionais (Custom1, Custom2). * Clique em **Adicionar contato**. **Importar CSV (em massa):** * Clique em **Selecionar arquivo CSV**. A primeira linha deve ter os cabeçalhos. * O ChatNorris mostra quantos contatos detectou e quantas linhas ignorou (por exemplo, se faltar o nome). > [!TIP] > > O CSV aceita as colunas: `name`, `phone`, `email`, `due_date`, `custom1`, `custom2`. A coluna `due_date` deve estar no formato `YYYY-MM-DD`. Em campanhas de **Envio único**, `due_date` é opcional. ## Ativar e pausar uma campanha ![TODO: captura do detalhe de uma campanha com barra de progresso e tabela de contatos](https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-campana-detalle.png) Depois de carregar os contatos: * **Ativar** — a campanha começa a enviar mensagens. Em uma campanha de **Envio único**, as mensagens saem assim que você a ativa. Em um **Lembrete**, o sistema verifica diariamente quais contatos devem receber a mensagem naquele dia. * **Pausar** — interrompe os envios sem excluir os contatos. Você pode reativá-la quando quiser. ## Mover uma campanha para outro agente No detalhe da campanha, o cartão **Mover para outro agente** permite escolher o agente de destino e clicar em **Mover campanha**. Os contatos são mantidos, mas o canal, o modelo do WhatsApp e o status (volta para **Rascunho**) são redefinidos, porque são específicos do agente anterior: você terá que reconfigurá-los no novo agente. Essa ação não pode ser desfeita. ## Ver o progresso Na lista de campanhas do agente, cada campanha mostra: * **Status** — Rascunho, Ativa, Pausada ou Concluída. * **Envio** — Envio único ou o lembrete configurado. * **Progresso** — quantidade de contatos e % já enviado. No detalhe de cada campanha, você verá as **Estatísticas** (Total, Pendentes, Enviados, Com falha e Descadastrados) e o status de cada contato. No menu principal, a tela **Campanhas** (fora do workspace de um agente) mostra um resumo somente leitura com todas as campanhas da sua organização agrupadas por agente — útil para ter uma visão geral, mas para criar ou editar uma campanha você sempre entra pelo agente correspondente. ## Perguntas frequentes > [accordion] Em que horário as mensagens são enviadas? > > Nas campanhas do tipo **Lembrete**, o envio é processado uma vez por dia, às 9:00 UTC: os contatos cuja data corresponde à regra naquele dia recebem a mensagem. Nas campanhas de **Envio único**, as mensagens saem assim que você ativa a campanha. > [accordion] O que acontece se um envio falhar? > > Se o erro for temporário, o ChatNorris tenta enviar de novo automaticamente (até 5 tentativas, com um intervalo entre uma e outra). Se o erro não for recuperável ou as tentativas se esgotarem, o contato passa para o status **Com falha**. > [accordion] Posso excluir um contato de uma campanha? > > Sim. Na tabela de contatos do detalhe da campanha, cada linha tem um botão para excluir o contato. > [accordion] Posso reutilizar os contatos de uma campanha em outra? > > Por enquanto, os contatos ficam vinculados a cada campanha. Para reutilizá-los, você precisa importar o CSV de novo na nova campanha. > [accordion] Onde crio um modelo do WhatsApp? > > No ChatNorris: em `Agentes → [seu agente] → Campanhas → Modelos do WhatsApp`, clique em **Novo modelo**, preencha e use **Enviar para a Meta**. A Meta pode demorar para aprová-lo; quando estiver **Aprovado**, ele aparece na lista de modelos ao criar uma campanha. Se você já tem modelos criados na sua conta do WhatsApp Business, use **Sincronizar da Meta** para trazê-los. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.