Como Começar com Campanhas WhatsApp em 7 Passos (2026)
Automatize o engajamento com seus clientes via WhatsApp usando a API Toolzz Chat e impulsione suas vendas.
Como Começar com Campanhas WhatsApp em 7 Passos (2026)
16 de abril de 2026
Em um cenário de comunicação cada vez mais digital, o WhatsApp se consolidou como um canal essencial para o contato direto com clientes. Campanhas proativas bem elaboradas podem aumentar significativamente o engajamento, a conversão e a satisfação do cliente. Este guia detalha como criar e gerenciar campanhas de WhatsApp usando a API do Toolzz Chat, permitindo que você alcance seus clientes de forma eficaz e personalizada.
Pré-requisitos
Para começar, você precisará de uma conta ativa na Toolzz Chat (https://toolzz.com.br/chat). Além disso, é necessário obter um token de API para autenticar suas requisições. Para obter seu token, faça login na sua conta Toolzz Chat e navegue até a seção de configurações da API. Lá, você encontrará seu token exclusivo. Mantenha este token em segurança, pois ele será usado para acessar a API.
Arquitetura
O fluxo de uma campanha de WhatsApp proativa utilizando a Toolzz Chat segue a seguinte arquitetura: Cliente (inicia contato via WhatsApp/Instagram) → Toolzz Chat (recebe a mensagem) → Automação (disparada com base em regras predefinidas) → Agente Humano/IA (atendimento personalizado, se necessário). A Toolzz Chat atua como a central de orquestração, roteando as mensagens e automatizando as interações. A eficiência desse fluxo depende de uma plataforma robusta e integrada, como a Toolzz.
Configuração no Produto
Dentro da interface do Toolzz Chat, você pode configurar uma campanha de WhatsApp acessando a seção "Campanhas". Clique em "Criar Campanha" e defina o nome, a descrição e o público-alvo da sua campanha. É possível segmentar o público com base em atributos personalizados, como tags, interesses ou histórico de compras. Defina a mensagem inicial, que será enviada aos clientes, e as regras de automação que determinarão o fluxo da conversa. Por exemplo, você pode configurar uma regra para enviar uma mensagem de acompanhamento caso o cliente não responda à mensagem inicial.
Implementação via API
Embora a interface do Toolzz Chat ofereça recursos robustos para a criação e gerenciamento de campanhas, a API permite um controle ainda maior e a integração com outros sistemas. Vamos explorar os principais endpoints para a criação e gerenciamento de campanhas.
List Campaigns
Este endpoint permite listar todas as campanhas existentes na sua conta.
URL: /campaigns
Método: GET
Headers:
Authorization: Bearer
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
| page | integer | Número da página (opcional, padrão: 1) |
| per_page | integer | Número de resultados por página (opcional, padrão: 20) |
Exemplo (curl):
bash
curl -H "Authorization: Bearer
Response JSON:
{ "data": [ { "id": "campaign_1", "name": "Campanha de Boas-Vindas", "status": "active" }, { "id": "campaign_2", "name": "Promoção de Natal", "status": "paused" } ], "pagination": { "total": 2, "current_page": 1, "per_page": 20 } }
Edit a Campaign
Permite editar uma campanha existente. Ideal para alterar a mensagem ou segmentação.
URL: /campaigns/{campaign_id}
Método: PUT
Headers:
Authorization: Bearer
Body JSON:
{ "name": "Campanha de Boas-Vindas Atualizada", "message": "Olá, seja bem-vindo à nossa empresa!", "segmentation": { "tags": ["novo_cliente"] } }
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
| campaign_id | string | ID da campanha que será editada |
Response JSON:
{ "id": "campaign_1", "name": "Campanha de Boas-Vindas Atualizada", "status": "active" }
Get Inbox Campaigns
Permite obter campanhas de uma caixa de entrada específica (inbox).
URL: /inboxes/{inbox_id}/campaigns
Método: GET
Headers:
Authorization: Bearer
Parâmetros:
| Parâmetro | Tipo | Descrição |
|---|---|---|
| inbox_id | string | ID da caixa de entrada |
Exemplo (Python): python import requests
url = "https://api.toolzz.dev/inboxes/inbox_1/campaigns"
headers = {
"Authorization": "Bearer
response = requests.get(url, headers=headers)
print(response.json())
Response JSON:
{ "data": [ { "id": "campaign_1", "name": "Campanha de Boas-Vindas", "status": "active" } ] }
Webhooks
Para receber notificações sobre o status das suas campanhas, você pode configurar webhooks. Um webhook é uma URL que a Toolzz Chat chama sempre que um evento específico ocorre, como a criação, atualização ou conclusão de uma campanha. Para adicionar um webhook, utilize o endpoint POST /webhooks e especifique a URL do seu servidor e os eventos que você deseja receber.
Pronto para automatizar seu WhatsApp? Solicite uma demonstração da Toolzz e veja como podemos te ajudar.
Testando a Integração
Após configurar a API e, se aplicável, os webhooks, é fundamental testar a integração para garantir que tudo esteja funcionando corretamente. Envie uma solicitação de teste para o endpoint de criação de campanha e verifique se a campanha é criada com sucesso. Monitore os webhooks para verificar se as notificações estão sendo enviadas corretamente. Utilize a interface do Toolzz Chat para visualizar as campanhas e verificar se os dados estão sincronizados com a API.
Erros Comuns e Troubleshooting
- Erro de Autenticação: Verifique se o token de API está correto e se tem as permissões necessárias.
- Erro de Requisição: Verifique se o corpo da requisição está no formato JSON correto e se todos os parâmetros obrigatórios estão presentes.
- Webhook Não Recebido: Verifique se a URL do webhook está correta e se o seu servidor está acessível. Verifique os logs do seu servidor para identificar possíveis erros.
Conclusão
Integrar a API do Toolzz Chat oferece flexibilidade e personalização na criação e gerenciamento de campanhas de WhatsApp proativas. Ao dominar os endpoints e as configurações, você pode automatizar o engajamento com seus clientes, impulsionar suas vendas e melhorar a experiência do cliente. Com a capacidade de segmentar o público, personalizar mensagens e monitorar o desempenho das campanhas, você estará no caminho certo para o sucesso. Se você busca uma solução completa e eficiente para suas campanhas, conheça a Toolzz e descubra como podemos transformar sua comunicação.
Quer ver na prática?
Comece gratuitamenteDemo Bots
Explore a demo interativa do Toolzz Bots, uma poderosa plataforma no-code que permite a criação de chatbots que operam 24 horas por dia, 7 dias por semana.
.webp){kind=small}
