Os principais conceitos de Campanhas WhatsApp explicados
Aprenda a criar campanhas de WhatsApp proativas usando a API do Toolzz Chat e aumente o engajamento.

Os principais conceitos de Campanhas WhatsApp explicados
17 de abril de 2026
No cenário atual do atendimento ao cliente, a comunicação proativa se tornou crucial para o sucesso de qualquer negócio. As campanhas de WhatsApp, ao permitirem o envio de mensagens direcionadas e personalizadas, oferecem uma oportunidade única de engajar clientes, promover ofertas e fornecer suporte em tempo real. Este guia detalhado explora como criar e gerenciar campanhas de WhatsApp proativas utilizando a API do Toolzz Chat, desde a configuração inicial até a análise de resultados.
Pré-requisitos
Para acompanhar este tutorial, você precisará de:
- Conta Toolzz Chat: https://chat.toolzz.ai (caso ainda não tenha, crie uma conta).
- Token de API: Um token de API para autenticar suas chamadas à API do Toolzz Chat.
- Número de telefone WhatsApp Business: Um número de telefone registrado no WhatsApp Business para enviar as campanhas.
Para obter o seu token de API, acesse o painel da Toolzz Chat, navegue até a seção de configurações da API e gere um novo token. Mantenha-o em segurança, pois ele concede acesso à sua conta.
Arquitetura
O fluxo de uma campanha de WhatsApp proativa utilizando a API do Toolzz Chat segue os seguintes passos:
- Cliente: O cliente interage com sua empresa por meio do WhatsApp ou Instagram.
- WhatsApp/Instagram: A mensagem do cliente é recebida pela plataforma.
- Toolzz Chat: A mensagem é processada pelo Toolzz Chat.
- Automação: A automação da campanha é acionada com base em regras pré-definidas.
- Agente Humano/IA: Dependendo da lógica da campanha, a mensagem pode ser enviada diretamente ao cliente ou encaminhada para um agente humano ou um agente de IA para atendimento personalizado.
Precisa de uma solução completa para gerenciar suas campanhas? Conheça a Toolzz e simplifique sua comunicação com o cliente.
Configuração no produto
Dentro da interface do Toolzz Chat, você pode configurar campanhas de WhatsApp de forma visual e intuitiva. Para criar uma nova campanha, siga os seguintes passos:
- Acesse a seção "Campanhas" no menu lateral.
- Clique em "Nova Campanha".
- Defina o nome da campanha, o número de telefone remetente e o público-alvo.
- Crie a mensagem da campanha, utilizando recursos como texto, imagens, vídeos e botões interativos.
- Defina as regras de segmentação para garantir que a mensagem seja enviada apenas para os clientes relevantes.
- Agende o envio da campanha ou envie-a imediatamente.
Implementação via API
Para uma maior flexibilidade e personalização, você pode utilizar a API do Toolzz Chat para criar e gerenciar campanhas de WhatsApp de forma programática. A seguir, detalharemos os principais endpoints e exemplos de código.
List Campaigns
Este endpoint permite listar todas as campanhas existentes em sua conta.
- URL:
https://api.toolzz.dev/v1/campaigns - Método:
GET - Headers:
Authorization: Bearer {seu_token_de_api}
bash curl -X GET 'https://api.toolzz.dev/v1/campaigns' -H 'Authorization: Bearer {seu_token_de_api}'
Tabela de Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Valor Padrão | Exemplo |
|---|---|---|---|---|---|
| page | number | Número da página | Não | 1 | 1 |
| per_page | number | Número de resultados por página | Não | 20 | 20 |
Response JSON:
{ "data": [ { "id": "campaign_id_1", "name": "Campanha de Boas-Vindas", "status": "active" }, { "id": "campaign_id_2", "name": "Promoção de Aniversário", "status": "inactive" } ], "pagination": { "total": 2, "per_page": 20, "current_page": 1, "last_page": 1 } }
Edit a Campaign
Este endpoint permite editar uma campanha existente.
- URL:
https://api.toolzz.dev/v1/campaigns/{campaign_id} - Método:
PUT - Headers:
Authorization: Bearer {seu_token_de_api}Content-Type: application/json
javascript const data = { "name": "Nova Campanha Editada", "message": "Olá, {nome}! Aproveite nosso desconto especial." };
fetch('https://api.toolzz.dev/v1/campaigns/campaign_id_1', { method: 'PUT', headers: { 'Authorization': 'Bearer {seu_token_de_api}', 'Content-Type': 'application/json' }, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data));
Tabela de Parâmetros:
| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo |
|---|---|---|---|---|
| name | string | Nome da campanha | Não | Nova Campanha Editada |
| message | string | Mensagem da campanha | Sim | Olá, {nome}! Aproveite |
Response JSON:
{ "id": "campaign_id_1", "name": "Nova Campanha Editada", "message": "Olá, {nome}! Aproveite nosso desconto especial.", "status": "active" }
Get Inbox Campaigns
Este endpoint permite obter as campanhas da caixa de entrada.
- URL:
https://api.toolzz.dev/v1/campaigns/inbox - Método:
GET - Headers:
Authorization: Bearer {seu_token_de_api}
python import requests
headers = { "Authorization": "Bearer {seu_token_de_api}" }
response = requests.get("https://api.toolzz.dev/v1/campaigns/inbox", headers=headers)
print(response.json())
Response JSON:
{ "campaigns": [ { "id": "campaign_id_1", "name": "Campanha de Boas-Vindas" } ] }
Webhooks
Para receber notificações em tempo real sobre o status das suas campanhas (enviadas, entregues, falhadas, etc.), você pode configurar webhooks. Os webhooks permitem que o Toolzz Chat envie dados para um endpoint especificado sempre que um evento relevante ocorrer.
Testando a integração
Após implementar a integração, é fundamental realizar testes rigorosos para garantir que tudo esteja funcionando corretamente. Envie mensagens de teste para diferentes números de telefone e verifique se as campanhas são entregues e processadas conforme esperado.
Quer ver a Toolzz em ação?
Comece gratuitamenteErros comuns e troubleshooting
- Token de API inválido: Verifique se o token de API está correto e ativo.
- Número de telefone inválido: Certifique-se de que o número de telefone do WhatsApp Business está registrado e ativo.
- Problemas de conectividade: Verifique se há problemas de conectividade entre sua aplicação e a API do Toolzz Chat.
- Erros de formatação JSON: Certifique-se de que o corpo das requisições está formatado corretamente em JSON.
Conclusão
As campanhas de WhatsApp proativas, impulsionadas pela API do Toolzz Chat, oferecem uma poderosa ferramenta para aumentar o engajamento dos clientes, promover ofertas e fornecer suporte personalizado. Ao seguir este guia detalhado, você estará apto a criar e gerenciar campanhas de WhatsApp eficazes que impulsionarão o crescimento do seu negócio. Se você busca uma solução completa para otimizar seu atendimento, confira os planos da Toolzz e encontre o ideal para sua empresa.
Configuração do ToolzzVoice
Veja como configurar agentes de voz e ligações telefônicas com IA no Toolzz Voice.


















