Toolzz: escalabilidade para empresas em crescimento com WhatsApp em 2026

Lucas (CEO Toolzz)
18 de abril de 2026

No cenário dinâmico do atendimento ao cliente, a capacidade de se comunicar de forma eficaz e proativa via WhatsApp tornou-se crucial para empresas que buscam escalar suas operações. Este artigo detalha como usar a API Toolzz Chat para criar e gerenciar campanhas de WhatsApp proativas, otimizando o engajamento e impulsionando o crescimento.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes pré-requisitos:

• Conta Toolzz Chat: Uma conta ativa na plataforma Toolzz Chat é essencial. Caso ainda não possua, você pode criar uma conta através do site.
• Token de API: Para interagir com a API, você precisará de um token de autenticação. Acesse sua conta Toolzz Chat, navegue até as configurações de API e gere um token. Mantenha este token em segurança, pois ele será usado em todas as suas requisições.
• Conhecimento básico de APIs: Familiaridade com os conceitos de API, métodos HTTP (GET, POST, PUT, DELETE), e formato JSON é recomendada.
• Ambiente de desenvolvimento: Configure um ambiente de desenvolvimento com as ferramentas necessárias para executar os exemplos de código, como Python com a biblioteca requests ou Node.js com a biblioteca axios.

Arquitetura

A arquitetura da nossa solução envolve o seguinte fluxo:

1. Cliente: O cliente interage com a empresa através do WhatsApp.
2. WhatsApp: A mensagem do cliente é enviada para a plataforma Toolzz Chat.
3. Toolzz Chat: A plataforma Toolzz Chat recebe a mensagem e pode aplicar automações.
4. Automação: A automação, configurada através da API, pode disparar campanhas proativas, enviar mensagens personalizadas ou atribuir a conversa a um agente.
5. Agente Humano/IA: Dependendo da configuração, um agente humano ou um agente de IA da Toolzz pode interagir com o cliente.

Pronto para escalar seu atendimento? Conheça a Toolzz e descubra como podemos te ajudar.

Configuração no produto

Para configurar campanhas de WhatsApp proativas diretamente na interface do Toolzz Chat, siga estes passos:

1. Acesse o painel de controle: Faça login na sua conta Toolzz Chat.
2. Navegue até a seção de Campanhas: No menu lateral, procure e clique na opção "Campanhas".
3. Crie uma nova campanha: Clique no botão "Criar Campanha" para iniciar o processo de criação.
4. Defina o nome e a descrição: Dê um nome descritivo para a sua campanha e adicione uma descrição clara do seu objetivo.
5. Selecione o público-alvo: Escolha os contatos ou segmentos de contatos que receberão a campanha. Você pode importar contatos de um arquivo CSV ou selecionar contatos existentes.
6. Crie a mensagem: Elabore a mensagem que será enviada aos seus contatos. Use variáveis para personalizar a mensagem com o nome, empresa ou outras informações relevantes.
7. Agende o envio: Defina a data e hora em que a campanha será enviada. Você pode agendar campanhas para o futuro ou enviá-las imediatamente.
8. Monitore os resultados: Acompanhe as métricas da campanha, como taxa de entrega, taxa de abertura e taxa de cliques, para avaliar o seu desempenho e fazer ajustes.

Implementação via API

Agora, vamos explorar como criar e gerenciar campanhas de WhatsApp proativas usando a API Toolzz Chat. Abordaremos os seguintes endpoints:

• List Campaigns
• Edit a Campaign
• Get Inbox Campaigns

List Campaigns

Este endpoint permite listar todas as campanhas existentes na sua conta.

• URL: https://api.toolzz.com.br/chat/campaigns

• Método HTTP: GET

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN" }

  Header	Descrição
  Authorization	Token de autenticação da API. Substitua YOUR_API_TOKEN pelo seu token real.

• Code Blocks:

  bash curl -X GET
  'https://api.toolzz.com.br/chat/campaigns'
  -H 'Authorization: Bearer YOUR_API_TOKEN'

  javascript const axios = require('axios');

  const config = { headers: { Authorization: 'Bearer YOUR_API_TOKEN', }, };

  axios .get('https://api.toolzz.com.br/chat/campaigns', config) .then((response) => { console.log(response.data); }) .catch((error) => { console.error(error); });

  python import requests

  url = 'https://api.toolzz.com.br/chat/campaigns' headers = { 'Authorization': 'Bearer YOUR_API_TOKEN' }

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

  print(response.json())

• Response JSON:

  [ { "id": "campaign_1", "name": "Promoção de Verão", "description": "Campanha para promover descontos de verão", "status": "active", "created_at": "2026-01-01T10:00:00Z", "updated_at": "2026-01-01T10:00:00Z" }, { "id": "campaign_2", "name": "Lançamento de Produto", "description": "Campanha para anunciar o lançamento de um novo produto", "status": "inactive", "created_at": "2026-02-15T14:30:00Z", "updated_at": "2026-02-15T14:30:00Z" } ]

• URL: https://api.toolzz.com.br/chat/campaigns/{campaign_id}

• Método HTTP: PUT

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json" }

  Header	Descrição
  Authorization	Token de autenticação da API. Substitua YOUR_API_TOKEN pelo seu token real.
  Content-Type	Indica que o corpo da requisição está no formato JSON.

• Body JSON:

  { "name": "Nova Promoção de Verão", "description": "Campanha atualizada para promover descontos ainda maiores de verão", "status": "active" }

  Parâmetro	Tipo	Descrição
  name	string	Novo nome da campanha.
  description	string	Nova descrição da campanha.
  status	string	Novo status da campanha (active ou inactive).

• Code Blocks:

  bash curl -X PUT
  'https://api.toolzz.com.br/chat/campaigns/campaign_1'
  -H 'Authorization: Bearer YOUR_API_TOKEN'
  -H 'Content-Type: application/json'
  -d '{ "name": "Nova Promoção de Verão", "description": "Campanha atualizada para promover descontos ainda maiores de verão", "status": "active" }'

  javascript const axios = require('axios');

  const config = { headers: { Authorization: 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json', }, };

  const data = { name: 'Nova Promoção de Verão', description: 'Campanha atualizada para promover descontos ainda maiores de verão', status: 'active', };

  axios .put('https://api.toolzz.com.br/chat/campaigns/campaign_1', data, config) .then((response) => { console.log(response.data); }) .catch((error) => { console.error(error); });

  python import requests import json

  url = 'https://api.toolzz.com.br/chat/campaigns/campaign_1' headers = { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json' } data = { "name": "Nova Promoção de Verão", "description": "Campanha atualizada para promover descontos ainda maiores de verão", "status": "active" }

  response = requests.put(url, headers=headers, data=json.dumps(data))

  print(response.json())

• Response JSON:

  { "id": "campaign_1", "name": "Nova Promoção de Verão", "description": "Campanha atualizada para promover descontos ainda maiores de verão", "status": "active", "created_at": "2026-01-01T10:00:00Z", "updated_at": "2026-03-01T12:00:00Z" }

• URL: https://api.toolzz.com.br/chat/inboxes/{inbox_id}/campaigns

• Método HTTP: GET

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN" }

  Header	Descrição
  Authorization	Token de autenticação da API. Substitua YOUR_API_TOKEN pelo seu token real.

• Code Blocks:

  bash curl -X GET
  'https://api.toolzz.com.br/chat/inboxes/inbox_1/campaigns'
  -H 'Authorization: Bearer YOUR_API_TOKEN'

  javascript const axios = require('axios');

  const config = { headers: { Authorization: 'Bearer YOUR_API_TOKEN', }, };

  axios .get('https://api.toolzz.com.br/chat/inboxes/inbox_1/campaigns', config) .then((response) => { console.log(response.data); }) .catch((error) => { console.error(error); });

  python import requests

  url = 'https://api.toolzz.com.br/chat/inboxes/inbox_1/campaigns' headers = { 'Authorization': 'Bearer YOUR_API_TOKEN' }

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

  print(response.json())

• Response JSON:

  [ { "id": "campaign_1", "name": "Promoção de Verão", "description": "Campanha para promover descontos de verão", "status": "active", "created_at": "2026-01-01T10:00:00Z", "updated_at": "2026-01-01T10:00:00Z" } ]