bash curl -X GET 'https://api.toolzz.dev/chat/v1/campaigns' -H 'Authorization: Bearer YOUR_API_TOKEN' -H 'Content-Type: application/json'

{ "campaigns": [ { "id": "campaign_1", "name": "Promoção de Natal", "status": "active", "created_at": "2023-12-01T10:00:00Z" }, { "id": "campaign_2", "name": "Lançamento de Produto", "status": "paused", "created_at": "2023-11-15T14:30:00Z" } ] }

Edit a Campaign

Este endpoint permite modificar os detalhes de uma campanha de WhatsApp existente.

Body JSON:

{ "name": "Nova Promoção de Natal", "status": "active", "message": "Aproveite nossa nova promoção de Natal!" }

Exemplo (javascript):

javascript const response = await fetch('https://api.toolzz.dev/chat/v1/campaigns/campaign_1', { method: 'PUT', headers: { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "Nova Promoção de Natal", "status": "active", "message": "Aproveite nossa nova promoção de Natal!" }) });

Parâmetros:

Response JSON:

{ "id": "campaign_1", "name": "Nova Promoção de Natal", "status": "active", "message": "Aproveite nossa nova promoção de Natal!", "created_at": "2023-12-01T10:00:00Z" }

Get Inbox Campaigns

Este endpoint permite obter informações sobre as campanhas na caixa de entrada do WhatsApp.

python import requests

url = 'https://api.toolzz.dev/chat/v1/inbox/campaigns' headers = { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' }

response = requests.get(url, headers=headers) print(response.json())

{ "campaigns": [ { "id": "campaign_1", "name": "Promoção de Natal", "status": "active", "messages_sent": 1000, "messages_read": 500 } ] }

Webhooks

Para receber notificações em tempo real sobre o status das suas campanhas, você pode configurar webhooks. Ao configurar um webhook, você especifica uma URL para a qual a Toolzz Chat enviará uma notificação sempre que um evento específico ocorrer, como o disparo de uma mensagem, a alteração do status de uma campanha ou o recebimento de uma resposta do cliente. Isso permite que você reaja em tempo real a eventos importantes e mantenha seus sistemas sincronizados.

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 acionadas corretamente, se as mensagens são entregues e se as respostas são processadas adequadamente. Utilize as ferramentas de depuração da API para identificar e corrigir eventuais erros.

Erros comuns e troubleshooting

Alguns erros comuns que podem ocorrer durante a integração incluem problemas de autenticação (token inválido), erros de formato de dados (JSON inválido), erros de rede (falha na conexão com a API) e erros de configuração (webhook incorreto). Verifique se o token de API está correto, se o formato dos dados JSON está de acordo com a documentação da API e se a URL do webhook está configurada corretamente.

Conclusão

As campanhas de WhatsApp proativas são uma ferramenta essencial para empresas que buscam engajamento direto com seus clientes. Ao utilizar a API do Toolzz Chat, você pode automatizar o processo de criação e gerenciamento de campanhas, personalizar as mensagens e integrar sua solução com outros sistemas para oferecer uma experiência do cliente ainda mais completa. Em 2026, a capacidade de adaptar-se rapidamente às mudanças no comportamento do consumidor e de oferecer experiências personalizadas será fundamental para o sucesso das campanhas de WhatsApp. A Toolzz Chat oferece a flexibilidade e a escalabilidade necessárias para atender às demandas do futuro, permitindo que você se concentre em construir relacionamentos duradouros com seus clientes.

Com a Toolzz Chat, você tem o controle total das suas comunicações com o cliente, impulsionando seus resultados e fidelizando sua base de clientes. Explore os planos e preços e solicite uma demonstração para descobrir como a Toolzz Chat pode transformar a sua estratégia de atendimento ao cliente.