Toolzz: Resultados Reais em Campanhas de WhatsApp Proativas

Lucas (CEO Toolzz)
19 de abril de 2026

As campanhas de WhatsApp proativas tornaram-se uma ferramenta poderosa para empresas que buscam engajar clientes, aumentar as vendas e fornecer suporte personalizado. No entanto, gerenciar campanhas em escala, segmentar audiências e garantir a entrega eficiente de mensagens pode ser um desafio. Este guia detalhado demonstra como utilizar a API do Toolzz Chat para criar, automatizar e monitorar campanhas de WhatsApp proativas, oferecendo resultados reais e escaláveis.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Uma conta ativa na Toolzz Chat.
• Um token de API válido. Você pode obter um token acessando o painel da Toolzz Chat, navegando até a seção de API e gerando um novo token.
  • Para obter o token de API, siga estes passos:
    1. Acesse chat.toolzz.ai e faça login.
    2. No menu lateral, clique em "Configurações".
    3. Selecione a aba "API".
    4. Clique em "Gerar Token".
    5. Copie o token gerado. Ele será usado nas requisições da API.
• Conhecimento básico de APIs REST e JSON.
• Uma ferramenta para enviar requisições HTTP (como Postman, Insomnia ou curl).

Arquitetura

O fluxo de uma campanha de WhatsApp proativa utilizando a API Toolzz Chat é o seguinte:

1. Cliente: O cliente interage com a empresa através do WhatsApp ou Instagram.
2. WhatsApp/Instagram: A mensagem do cliente é recebida através do WhatsApp Business API ou Instagram API.
3. Toolzz Chat: A mensagem é encaminhada para a plataforma Toolzz Chat.
4. Automação: A Toolzz Chat processa a mensagem e, com base em regras predefinidas, identifica se a mensagem se encaixa em uma campanha proativa.
5. Agente Humano/IA: Se a campanha for acionada, a Toolzz Chat envia uma mensagem proativa ao cliente ou encaminha a conversa para um agente humano ou agente de IA da Toolzz AI.

Quer otimizar suas campanhas com inteligência artificial? Conheça a Toolzz AI e veja como a automação pode impulsionar seus resultados.

Configuração no Produto

Antes de iniciar a implementação via API, é importante configurar as campanhas proativas diretamente na interface da Toolzz Chat.

1. Acesse a seção de Campanhas: No painel da Toolzz Chat, navegue até a seção "Campanhas".
2. Crie uma nova campanha: Clique em "Nova Campanha" e defina um nome e descrição para a campanha.
3. Defina o público-alvo: Utilize os filtros disponíveis para segmentar o público-alvo da campanha com base em atributos como tags, custom attributes, histórico de conversas, etc.
4. Crie a mensagem: Redija a mensagem que será enviada aos clientes. Utilize variáveis dinâmicas para personalizar a mensagem com dados do cliente.
5. Agende a campanha: Defina a data e hora de início e término da campanha. Você também pode configurar a campanha para ser enviada em horários específicos ou com base em eventos específicos.

Implementação via API

Para automatizar o processo de criação e gerenciamento de campanhas de WhatsApp proativas, você pode utilizar os seguintes endpoints da API Toolzz Chat:

List Campaigns

Este endpoint permite listar todas as campanhas existentes.

• URL: https://api.toolzz.dev/chat/v1/campaigns
• Método: GET
• Headers:
  • Authorization: Bearer <SEU_TOKEN_API>
  • Content-Type: application/json
• Parâmetros: Nenhum

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

• Response JSON:

[ { "id": "campaign_id_1", "name": "Promoção de Verão", "status": "active", "createdAt": "2024-01-20T10:00:00Z" }, { "id": "campaign_id_2", "name": "Lançamento de Produto", "status": "paused", "createdAt": "2024-02-15T14:30:00Z" } ]

Edit a Campaign

Este endpoint permite editar uma campanha existente.

• URL: https://api.toolzz.dev/chat/v1/campaigns/{campaign_id}
• Método: PUT
• Headers:
  • Authorization: Bearer <SEU_TOKEN_API>
  • Content-Type: application/json
• Body JSON:

{ "name": "Promoção de Verão - Atualizada", "status": "active" }

• Parâmetros:

• Response JSON:

{ "id": "campaign_id_1", "name": "Promoção de Verão - Atualizada", "status": "active", "createdAt": "2024-01-20T10:00:00Z", "updatedAt": "2024-03-10T16:00:00Z" }

Get Inbox Campaigns

Este endpoint permite obter as campanhas de WhatsApp na caixa de entrada.

• URL: https://api.toolzz.dev/chat/v1/inbox/{inbox_id}/campaigns
• Método: GET
• Headers:
  • Authorization: Bearer <SEU_TOKEN_API>
  • Content-Type: application/json
• Parâmetros:

bash curl -H "Authorization: Bearer " -H "Content-Type: application/json" https://api.toolzz.dev/chat/v1/inbox/inbox_1/campaigns

• Response JSON:

[ { "id": "campaign_id_3", "name": "Campanha Inbox", "status": "active", "createdAt": "2024-03-01T10:00:00Z" } ]

Webhooks

Para receber notificações em tempo real sobre o status das campanhas (por exemplo, quando uma campanha é iniciada, pausada ou finalizada), você pode configurar webhooks. Consulte a documentação da API para obter mais informações sobre como configurar webhooks.

Testando a Integração

Após implementar a integração, teste cuidadosamente o fluxo completo da campanha. Verifique se as mensagens são enviadas corretamente para o público-alvo segmentado e se as métricas de desempenho da campanha são registradas com precisão.

Erros Comuns e Troubleshooting

• Erro de autenticação: Verifique se o token de API está correto e se você tem permissão para acessar os recursos solicitados.
• Erro de formatação JSON: Certifique-se de que o corpo JSON da requisição está formatado corretamente.
• Limite de taxa: A API Toolzz Chat possui limites de taxa para evitar abusos. Se você atingir o limite de taxa, aguarde um tempo antes de tentar novamente.

Conclusão

Ao utilizar a API da Toolzz Chat, as empresas podem automatizar e otimizar suas campanhas de WhatsApp proativas, alcançando um maior engajamento com seus clientes e impulsionando os resultados de negócios. A flexibilidade e o poder da API permitem criar experiências personalizadas e escaláveis, adaptadas às necessidades específicas de cada empresa. A Toolzz Chat simplifica a complexidade das campanhas de WhatsApp, permitindo que você se concentre no que realmente importa: construir relacionamentos duradouros com seus clientes.

Solicitar demonstração