[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-disparador-de-campanhas-via-whatsapp-saas)
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-introdu%C3%A7%C3%A3o-)
## Funcionalidades
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#funcionalidades)
### 📱 Campanhas dentro do ChatWoot
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-campanhas-dentro-do-chatwoot)
Integração completa com o ChatWoot para gerenciar suas campanhas diretamente dentro da plataforma.
### ⏰ Agendamento e Disparo Imediato
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-agendamento-e-disparo-imediato)
- Agende suas campanhas para uma data e hora específicas.
- Opção para disparo imediato, permitindo envios em tempo real.
### 🖼️ Envio de Imagem
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#%EF%B8%8F-envio-de-imagem)
- Possibilidade de incluir imagens nas mensagens da campanha.
- Suporte para múltiplos formatos de imagem (JPEG e PNG).
- Usar a variavel &img=linkdaimagem.jpg
### 📝 Envio de PDF
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-envio-de-pdf)
- Possibilidade de incluir PDF junto com uma mensagem.
- Usar a variavel &doc=linkdopdf.pdf
### 🎬 Envio de Video
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-envio-de-video)
- Possibilidade de incluir video nas mensagens da campanha.
- Usar a variavel &vid=linkdovideo.mp4
### 🔊 Envio de Audio
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-envio-de-audio)
- Possibilidade de incluir audio nas mensagens da campanha.
- Usar a variavel &audio=linkdoaudio.mp3
### 📊 Limitador de Envios Diário por Empresa
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-limitador-de-envios-di%C3%A1rio-por-empresa)
- Defina um limite diário de envios para cada empresa.
- Evite sobrecarregar a utilização da VPS com o alto fluxo de mensagens.
### ⏳ Temporizador Randômico entre os Envios
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-temporizador-rand%C3%B4mico-entre-os-envios)
- Adicione um temporizador randômico entre os envios para evitar detecção como spam e bloquear o número.
- (Lembrando que isso não é uma garantia de que você não possa perder seu número e sim uma solução para reduzir os riscos.)
### 🔄 Contador de Envios e Falhas
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-contador-de-envios-e-falhas)
- Conta número de envios ✅.
- Conta número de falhas ❌.
### 🚫 Mensagem de Excesso de Limite Diário
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-mensagem-de-excesso-de-limite-di%C3%A1rio)
- Envio automático de uma mensagem quando o limite diário de envios for excedido.
- Mantenha os administradores informados sobre o status das campanhas.
### 📋 Mensagem de Relatório da Campanha
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-mensagem-de-relat%C3%B3rio-da-campanha)
- Receba uma mensagem avisando que o disparo da campanha foi iniciado.
- Receba um relatório detalhado ao final de cada campanha.
- Inclui número total de envios e falhas.
- Inclui número de disparos que restam no dia.
- Inclui os números que não enviaram com o nome do contato.
### 📝 Personalização com Nome e Email do Contato
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-personaliza%C3%A7%C3%A3o-com-nome-e-email-do-contato)
- Use a variável (&nome) para personalizar as mensagens com o nome do contato.
- Use a variável (&email) para personalizar as mensagens com o email do contato.
- Aumente a personalização e eficácia das suas mensagens de campanha.
### 🏷️ Disparos através das Etiquetas dos Contatos
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#%EF%B8%8F-disparos-atrav%C3%A9s-das-etiquetas-dos-contatos)
- Utilize as etiquetas dos contatos para segmentar e direcionar suas campanhas de maneira eficiente.
- Agrupe contatos com base em características específicas e envie mensagens direcionadas.
## 🎉 Benefícios 🎉
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-benef%C3%ADcios-)
- **Automatização**: Reduza o trabalho manual com a automação de campanhas. 🤖
- **Personalização**: Melhore a experiência do cliente com mensagens personalizadas. 🎯
- **Eficiência**: Acompanhe o desempenho em tempo real e otimize suas campanhas. 📊
- **Integração**: Dispare campanhas diretamente pelo ChatWoot sem precisar abrir outro sistema, otimizando tempo e recursos. 🚀
---
## 📘 Tutorial de Automação de Disparo de Campanhas
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-tutorial-de-automa%C3%A7%C3%A3o-de-disparo-de-campanhas)
Vamos começar o tutorial para fazer a automação do sistema de disparo de campanhas usando o n8n e a Evolution API junto ao ChatWoot.
Antes de iniciar, certifique-se de que você já tem instalado:
- ChatWoot
- n8n
- Evolution API
- pgAdmin ou outro de sua preferência para acessar o banco de dados do Postgres
### Passo 1: Criar uma Caixa de Entrada de Canal SMS do Tipo Bandwidth
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#passo-1-criar-uma-caixa-de-entrada-de-canal-sms-do-tipo-bandwidth)
1. **Acesse o ChatWoot**: Faça login na sua conta do ChatWoot.
2. **Configurações**: Vá para a seção de configurações.
3. **Caixas de Entrada**: Selecione "Caixas de Entrada" no menu.
4. **Adicionar Nova Caixa de Entrada**: Clique no botão "Adicionar Nova Caixa de Entrada".
5. **Escolher Tipo de Canal**: Selecione "SMS" e escolha "Bandwidth" como o tipo de canal.
6. **Configurar Detalhes do Canal**:
- Nome da Caixa de Entrada: Disparador (ou o nome que preferir).
- Número de telefone: +741963 (NUMERAÇÃO ALEATÓRIA)
- ID da Conta: 1 (ID DA CAIXA DE ENTRADA CADASTRADA NO CHATWOOT QUE VAI MANDAR AS MENSAGENS)
- ID da aplicação: Instancia (NOME DA INSTACIA NA EVOLUTION)
- Chave API: +5511934849643 (NUMERO DE WHATSAPP PARA RECEBER O RELATORIO)
- Chave secreta API: [](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#passo-2-adicionar-colunas-no-banco-de-dados-do-chatwoot)
1. **Acesse o Banco de Dados**: Use o pgAdmin ou outro software de sua preferência para acessar o banco de dados do ChatWoot.
2. **Adicionar Coluna na Tabela Accounts**:
- Execute o seguinte comando SQL para adicionar a coluna `limite_disparo`: ```
ALTER TABLE accounts
ADD COLUMN limite_disparo INTEGER NOT NULL DEFAULT 500;
```
3. **Adicionar Colunas na Tabela campaigns**:
- Execute os seguintes comandos SQL para adicionar as colunas status\_envia, enviou e falhou na tabela campaigns: ```
ALTER TABLE campaigns
ADD COLUMN status_envia INTEGER NOT NULL DEFAULT 0;
ALTER TABLE campaigns
ADD COLUMN enviou INTEGER NOT NULL DEFAULT 0;
ALTER TABLE campaigns
ADD COLUMN falhou INTEGER NOT NULL DEFAULT 0;
```
4. **Adicionar nova Tabela para guardar os envios que falharem**:
- Execute o seguinte comando SQL para adicionar a tabela campaigns\_failled: ```
-- Cria a sequência
CREATE SEQUENCE campaigns_failled_id_seq;
-- Cria a tabela com a coluna `id` usando a sequência criada
CREATE TABLE campaigns_failled (
id BIGINT PRIMARY KEY NOT NULL DEFAULT nextval('campaigns_failled_id_seq'::regclass),
nomecontato TEXT NOT NULL,
telefone CHARACTER VARYING NOT NULL,
id_campanha INTEGER NOT NULL
);
```
---
### Passo 3: Importar Workflows no n8n
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#passo-3-importar-workflows-no-n8n)
1. **Acesse o n8n**: Faça login na sua instância do n8n.
2. **Adicionar Novo Workflow**:
- Clique em "Add Workflow".
3. **Importar Workflow**:
- Clique nos três pontinhos no canto superior direito.
- Selecione "Import from File".
4. **Importar o Fluxo Disparador**:
- Importe o arquivo de workflow disparador.json.
5. **Importar o Fluxo Reset-Limite-Campanhas**:
- Repita os passos acima e importe o reset-limite-campanha.json.
### Passo 4: Editar o Workflow Disparador no n8n
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#passo-4-editar-o-workflow-disparador-no-n8n)
1. **Acesse o Workflow Disparador**: No n8n, abra o workflow Disparador que você importou.
2. **Editar o primeiro nó do postgres Buscar campanhas**
- Alterar na linha "select \* from campaigns c where campaign\_type = 1 and status\_envia = 0 and account\_id = 1"
- altere o valor e account\_id para o ID da conta do chatwoot.
3. **Editar Nó Info\_Base**:
- Preencha os seguintes campos com suas informações:
- **URL do ChatWoot**
- **URL da Evolution API**
- **URL do view Typebot**
- **Token de acesso da conta do ChatWoot**
- **Global API KEY da Evolution API**
- **Email que vai enviar o relatório**
4. **Conectar Nós do Postgres ao Banco de Dados do ChatWoot**:
- Conecte todos os nós do Postgres ao banco de dados do ChatWoot, garantindo que as informações fluam corretamente entre os sistemas.
### Passo 5: Editar o Workflow reset-limite-campanha no n8n
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#passo-5-editar-o-workflow-reset-limite-campanha-no-n8n)
1. **Acesse o Workflow reset-limite-campanha**: No n8n, abra o workflow reset-limite-campanha que você importou.
2. **Conectar Nós do Postgres ao Banco de Dados do ChatWoot**:
- Conecte todos os nós do Postgres ao banco de dados do ChatWoot, garantindo que as informações sejam atualizadas corretamente para resetar o limite de disparo diário.
- Se desejar altere o limite de envio diario dentro do nó do postgres.
- Recomendação para não sobrecarregar o worflow 500 disparos seguidos.
---
Agora que os workflows foram importados, configurados e editados, sua automação de disparo de campanhas está pronta para funcionar!
## 📢 Cadastro de uma Nova Campanha no ChatWoot
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-cadastro-de-uma-nova-campanha-no-chatwoot)
Para criar uma campanha, siga os passos abaixo:
1. **Clique em Campanhas**: Acesse a seção de Campanhas no ChatWoot.
2. **Clique em Única**: Selecione a opção "Única".
3. **Clique em Criar uma campanha única**: Adicione as informações da sua campanha.
- **Título**: Insira o título da campanha.
- **Mensagem**: Digite a mensagem que quer enviar na campanha.
- Para adicionar o nome do contato à mensagem, digite `&nome`.
- Para adicionar o email do contato à mensagem, digite `&email`.
- Para adicionar uma imagem, digite `&img=urldaimagemaqui.jpg`.
- Para adicionar um video, digite `&vid=urldovideo.mp4`.
- Para adicionar um pdf, digite `&doc=urldopdf.pdf`.
### Exemplo de uso imagem:
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#exemplo-de-uso-imagem)
"*Olá &nome, tudo bem?* *Você já viu esta bela paisagem?*
*&img=[https://img.freepik.com/fotos-gratis/paisagem-de-nevoeiro-matinal-e-montanhas-com-baloes-de-ar-quente-ao-nascer-do-sol\_335224-794.jpg](https://img.freepik.com/fotos-gratis/paisagem-de-nevoeiro-matinal-e-montanhas-com-baloes-de-ar-quente-ao-nascer-do-sol_335224-794.jpg)*"
### Exemplo de uso pdf:
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#exemplo-de-uso-pdf)
"*Olá &nome, tudo bem?* *Segue o nosso catalogo em PDF?*
*&doc=[https://evolution-api.com/files/evolution-api.pdf](https://evolution-api.com/files/evolution-api.pdf)*"
### Exemplo de uso video:
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#exemplo-de-uso-video)
"*Olá &nome, tudo bem?* Você já viu esse vídeo??\_
*&vid=[https://evolution-api.com/files/video.mp4](https://evolution-api.com/files/video.mp4)*"
### Exemplo de uso typebot:
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#exemplo-de-uso-typebot)
"&typebot=id\_da\_url\_do\_fluxo\_do\_typebot"
Exemplo url: [https://chatbotapi.cubochat.com.br/fluxotypebot](https://chatbotapi.cubochat.com.br/fluxotypebot) Usar: fluxotypebot
4. **Selecionar Caixa de Entrada**: No campo "Selecionar caixa de entrada", selecione a caixa de SMS que você criou no início do tutorial.
5. **Público**: Selecione a etiqueta que está atribuída aos contatos que quer disparar a campanha.
6. **Horário Agendado**: Selecione o dia e a hora que quer disparar a campanha. Caso queira disparar a campanha na mesma hora, selecione a data e a hora atual.
7. **Clique em Criar**: Finalize a criação da campanha.
Agora tudo está pronto para enviar a sua campanha!
---
## 📅 Roadmap do Projeto
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-roadmap-do-projeto)
### Versão 1.1 🚀
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-11-)
**Mensagem de Início de Disparo**
- Implementar uma mensagem que indique o início do disparo da campanha para notificar os usuários sobre o processo inicial.
**Correção no limitador**
- Correção no limitador de disparo, foi encontrado um erro que ele rouba 1 limite da conta quando chega em 1.
### Versão 1.2 💡
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-12-)
**Relatório de Finalização por Email**
- Adicionar funcionalidade para enviar um relatório por email ao final da campanha, detalhando métricas e resultados.
**Inclusão do Limite de Disparos Diários no Relatório**
- Introduzir no relatório o número restante de disparos diários disponíveis, fornecendo transparência sobre os limites e uso.
### Versão 1.3 📊
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-13-)
**Adicionando variável**
- Vamos adicionar a variável &email para conseguir personalizar mais ainda a mensagem.
### Versão 1.4 🚨
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-14-)
**Relatório de Falhas de Envio**
- Desenvolver um relatório específico que liste os contatos que falharam no envio, incluindo nome e telefone, para análise e correção.
### Versão 1.5 📑
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-15-)
**Envio de PDF**
- Incluir a inserção de um arquivo pdf dentro da campanha.
### Versão 1.6 🎬
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-16-)
**Envio de VIDEO**
- Incluir a inserção de video dentro da campanha.
### Versão 1.7 🔊
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-17-)
**Envio de AUDIO**
- Incluir a inserção de audio dentro da campanha.
### Versão 1.8 🏷️🏷️
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-18-%EF%B8%8F%EF%B8%8F)
**Multiplas etiquetas**
- Disparar campanha para mais de uma etiqueta.
### Versão 1.9 📇💬 (Já disponível)
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-19--j%C3%A1-dispon%C3%ADvel)
**Buscar etiquetas na conversa**
- Agora alem de buscar a etiqueta do contato ele busca nas conversas. **Envia campanha para grupos**
- Agora suas campanhas tambem serão enviadas para grupos do whatsapp.
### Versão 2.0 \[SAAS\] 🌟
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-20-saas-)
**Apenas um workflow por instancia**
- Este workflow foi desenvolvido para funcionar de forma centralizada com toda a instância do Chatwoot, eliminando a necessidade de criar um novo fluxo no n8n para cada caixa de entrada individual.
- Com esse modelo SaaS, é possível disparar campanhas por todos os números conectados à plataforma de forma unificada. Basta apenas criar as caixas de entrada (SMS) desejadas no Chatwoot, configurar os respectivos disparadores e informar corretamente o Application ID, que deve ser o nome da caixa de entrada cadastrada na Evolution API.
- Dessa forma, o envio de mensagens é direcionado automaticamente para o número vinculado à caixa de entrada correspondente, garantindo escalabilidade, agilidade e padronização no processo de campanhas.
### Versão 2.1 🤖 (Já disponível)
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#vers%C3%A3o-21--j%C3%A1-dispon%C3%ADvel)
**Envia fluxo de mensagem do typebot**
- Agora você pode enviar fluxo de typebot ao invés de mensagem única.
### Considerações Finais 🛠️
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#considera%C3%A7%C3%B5es-finais-%EF%B8%8F)
- Este roadmap pode ser ajustado conforme novas ideias surjam ou prioridades se alterem durante o desenvolvimento. Cada etapa visa melhorar a funcionalidade e a eficiência do disparador de campanhas, proporcionando uma experiência mais completa e eficaz aos usuários.
---
## 📝 Apoio ao Projeto
[](https://github.com/rodtanci/Disparador-de-Campanha-Chatwoot-Evolution#-apoio-ao-projeto)
Quem quiser apoiar o projeto com dicas de melhorias e reportar alguma falha pode me acionar pelo grupo do WhatsApp.
*[https://chat.whatsapp.com/H2as2v9yHre8U2gjNaCWRc](https://chat.whatsapp.com/H2as2v9yHre8U2gjNaCWRc)*
Canal do Youtube: [https://www.youtube.com/@RodrigoTanci](https://www.youtube.com/@RodrigoTanci)
Caso alguém queira contribuir de forma monetária, o chave PIX CNPJ: **36799434000140**