Toolzz: personalização total para campanhas de WhatsApp

Lucas (CEO Toolzz)
16 de abril de 2026

No cenário atual de atendimento ao cliente, a comunicação proativa via WhatsApp se tornou essencial. Empresas de diversos setores buscam maneiras de alcançar seus clientes de forma mais direta e personalizada, seja para oferecer promoções, compartilhar informações relevantes ou fornecer suporte imediato. A capacidade de criar e gerenciar campanhas de WhatsApp eficientes pode ser um diferencial competitivo crucial. Este guia detalhado aborda como utilizar a API do Toolzz Chat para construir campanhas de WhatsApp proativas, automatizadas e altamente personalizadas.

Pré-requisitos

Para começar, você precisará de uma conta na plataforma Toolzz Chat (https://chat.toolzz.ai). Além disso, é fundamental obter um token de API para autenticar suas requisições. Para gerar o token, siga estes passos:

1. Faça login na sua conta Toolzz Chat.
2. Acesse a seção de configurações da API.
3. Gere um novo token e guarde-o em um local seguro.

O token de API é uma credencial de segurança que permite que sua aplicação se conecte à API do Toolzz Chat. Mantenha-o confidencial e não o compartilhe com terceiros.

Arquitetura

O fluxo de uma campanha de WhatsApp proativa utilizando a API do Toolzz Chat segue o seguinte caminho:

Cliente → WhatsApp/Instagram → Toolzz Chat → Automação (API) → Agente humano/IA

Inicialmente, o cliente entra em contato através do WhatsApp ou Instagram. A mensagem é recebida pelo Toolzz Chat, que, por meio da API, pode acionar regras de automação para enviar mensagens proativas, como ofertas personalizadas ou lembretes de agendamento. Se a solicitação do cliente exigir intervenção humana, a conversa é encaminhada para um agente de atendimento. Alternativamente, um agente de IA da Toolzz AI pode resolver a demanda sem intervenção humana.

Deseja otimizar ainda mais a sua operação? Conheça a Toolzz AI e descubra como a inteligência artificial pode revolucionar o seu atendimento.

Configuração no produto

Dentro da interface do Toolzz Chat, você pode configurar a base para suas campanhas. Primeiro, configure um Inbox para receber as mensagens dos seus clientes. Em seguida, crie um novo agente. Para maior escalabilidade, crie Times, agrupando agentes com habilidades semelhantes. Lembre-se que você pode usar tanto agentes humanos quanto bots para responder as mensagens. Finalmente, a criação das campanhas é feita na seção de campanhas, onde você define o público-alvo, a mensagem e o agendamento.

Implementação via API

Para criar campanhas de WhatsApp proativas, utilizaremos os seguintes endpoints da API do Toolzz Chat:

• List Campaigns: GET /campaigns - Lista todas as campanhas existentes.
• Edit a Campaign: PUT /campaigns/{id} - Edita uma campanha existente.
• Get Inbox Campaigns: GET /inboxes/{inbox_id}/campaigns - Lista as campanhas associadas a uma caixa de entrada específica.

List Campaigns

URL: https://api.toolzz.dev/campaigns Método: GET Headers: Authorization: Bearer {seu_token_api}

Parâmetros: Nenhum

Exemplo (curl):

bash curl -X GET 'https://api.toolzz.dev/campaigns' -H 'Authorization: Bearer SEU_TOKEN_API'

Response (JSON):

[ { "id": "campaign_id_1", "name": "Campanha de Boas-Vindas", "status": "active", "inbox_id": "inbox_id_1" }, { "id": "campaign_id_2", "name": "Promoção de Aniversário", "status": "paused", "inbox_id": "inbox_id_2" } ]

Edit a Campaign

URL: https://api.toolzz.dev/campaigns/{id} Método: PUT Headers: Authorization: Bearer {seu_token_api}, Content-Type: application/json

Body (JSON):

{ "name": "Nova Campanha de Boas-Vindas", "message": "Olá {nome}, seja bem-vindo à nossa empresa!", "status": "active", "schedule": "2024-12-31T10:00:00Z" }

Tabela de parâmetros:

Response (JSON):

{ "id": "campaign_id_1", "name": "Nova Campanha de Boas-Vindas", "status": "active", "inbox_id": "inbox_id_1", "message": "Olá {nome}, seja bem-vindo à nossa empresa!", "schedule": "2024-12-31T10:00:00Z" }

Get Inbox Campaigns

URL: https://api.toolzz.dev/inboxes/{inbox_id}/campaigns Método: GET Headers: Authorization: Bearer {seu_token_api}

Parâmetros: Nenhum

Exemplo (curl):

bash curl -X GET 'https://api.toolzz.dev/inboxes/inbox_id_1/campaigns' -H 'Authorization: Bearer SEU_TOKEN_API'

Response (JSON):

[ { "id": "campaign_id_1", "name": "Campanha de Boas-Vindas", "status": "active" } ]

Webhooks

Para receber notificações sobre o status das suas campanhas (por exemplo, quando uma campanha é concluída ou quando ocorre um erro), você pode configurar webhooks. Isso permite que seu sistema seja notificado em tempo real sobre eventos importantes, permitindo que você tome medidas apropriadas.

Testando a integração

Após implementar a integração com a API do Toolzz Chat, é fundamental realizar testes rigorosos para garantir que tudo esteja funcionando corretamente. Envie mensagens de teste para diferentes números de WhatsApp e verifique se as campanhas são disparadas no momento certo e se as mensagens são entregues com sucesso. Monitore os logs da API para identificar eventuais erros ou problemas.

Erros comuns e troubleshooting

• Token de API inválido: Verifique se o token de API está correto e se você tem permissão para acessá-lo.
• Erro de formatação JSON: Certifique-se de que o corpo da requisição JSON está formatado corretamente.
• Limite de requisições atingido: A API do Toolzz Chat possui limites de requisições para evitar abusos. Se você atingir o limite, aguarde um tempo e tente novamente.
• Problemas de conexão: Verifique sua conexão com a internet e se o servidor da API do Toolzz Chat está online.

Conclusão

A API do Toolzz Chat oferece uma maneira poderosa e flexível de criar campanhas de WhatsApp proativas e personalizadas. Ao automatizar a comunicação com seus clientes, você pode aumentar o engajamento, melhorar a satisfação do cliente e impulsionar seus resultados. A facilidade de integração e a documentação completa tornam a Toolzz Chat uma excelente escolha para empresas de todos os portes. Ao implementar essa solução, você estará um passo à frente na jornada de atendimento ao cliente.

Com a Toolzz Chat, você centraliza a comunicação e aproveita toda a capacidade da API para personalizar a experiência do seu cliente. Para escalar suas campanhas, explore a integração com a Toolzz AI, que permite criar agentes inteligentes para responder perguntas, qualificar leads e muito mais. Com a Toolzz, a personalização do atendimento ao cliente se torna uma realidade. Explore nossos planos e comece agora mesmo! Ver planos e preços