Toolzz: líder em Campanhas WhatsApp custo-benefício

Lucas (CEO Toolzz)
18 de abril de 2026

No mundo dinâmico do atendimento ao cliente, a capacidade de alcançar os clientes de forma proativa é crucial. Campanhas de WhatsApp proativas permitem que as empresas se conectem com seus clientes de maneira personalizada e eficiente, oferecendo suporte, promoções e informações relevantes. Este tutorial detalhado explora como usar a API do Toolzz Chat para criar e gerenciar campanhas de WhatsApp proativas, otimizando o engajamento e a satisfação do cliente.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes elementos:

• Conta Toolzz Chat: Uma conta ativa no Toolzz Chat.
• Token de API: Um token de API válido para autenticação. Para gerar um token, faça login na sua conta Toolzz Chat, vá para as configurações da API e crie um novo token.
• Conhecimento básico de programação: Familiaridade com APIs, requisições HTTP e formato JSON.
• Ambiente de desenvolvimento: Um ambiente configurado com as ferramentas necessárias (Node.js, Python, etc.).

Arquitetura

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

1. Cliente: O cliente possui um número de telefone registrado no sistema.
2. WhatsApp/Instagram: A mensagem da campanha é enviada via WhatsApp (ou Instagram).
3. Toolzz Chat: O Toolzz Chat recebe a requisição da API e gerencia o envio da mensagem.
4. Automação: (Opcional) Regras de automação direcionam a conversa para um agente ou chatbot.
5. Agente humano/IA: Interação com o cliente, se necessário.

Configuração no Produto

Embora este tutorial se concentre na API, é importante entender a configuração na interface do Toolzz Chat:

1. Criação da Campanha: Defina o nome, a lista de contatos e o conteúdo da mensagem.
2. Configuração do Canal: Selecione o canal de envio (WhatsApp, Instagram).
3. Agendamento: Determine a data e hora de envio.
4. Acompanhamento: Monitore os resultados da campanha (taxa de entrega, abertura).

Implementação via API

5.1 Listar Campanhas (List Campaigns)

Este endpoint permite listar as campanhas existentes.

• URL: https://api.toolzz.dev/v1/campaigns

• Método HTTP: GET

• Headers:

  text Authorization: Bearer YOUR_API_TOKEN Content-Type: application/json

• Parâmetros: Nenhum

• Exemplo (Python):

  python import requests

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

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

  if response.status_code == 200: print(response.json()) else: print(f"Error: {response.status_code} - {response.text}")

• Response JSON:

  [ { "id": "campaign_id_1", "name": "Promoção de Verão", "status": "active", "created_at": "2024-10-27T10:00:00Z" }, { "id": "campaign_id_2", "name": "Lançamento de Produto", "status": "draft", "created_at": "2024-10-26T14:30:00Z" } ]

• URL: https://api.toolzz.dev/v1/campaigns

• Método HTTP: POST

• Headers:

  text Authorization: Bearer YOUR_API_TOKEN Content-Type: application/json

• Body JSON:

  { "name": "Oferta Especial", "recipients": ["5511999999999", "5521988888888"], "message": "Aproveite nossa oferta especial! Use o código DESCONTO10 para 10% de desconto.", "channel": "whatsapp", "scheduled_at": "2024-11-05T10:00:00Z" }

• Parâmetros:

  Parâmetro	Tipo	Descrição
  name	string	Nome da campanha.
  recipients	array	Lista de números de telefone dos destinatários.
  message	string	Conteúdo da mensagem a ser enviada.
  channel	string	Canal de envio (whatsapp, instagram).
  scheduled_at	datetime	Data e hora agendadas para o envio da campanha (formato ISO 8601).

• Exemplo (JavaScript):

  javascript const axios = require('axios');

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

  const data = { "name": "Oferta Especial", "recipients": ["5511999999999", "5521988888888"], "message": "Aproveite nossa oferta especial! Use o código DESCONTO10 para 10% de desconto.", "channel": "whatsapp", "scheduled_at": "2024-11-05T10:00:00Z" };

  axios.post(url, data, { headers }) .then(response => console.log(response.data)) .catch(error => console.error(error));

• Response JSON:

  { "id": "campaign_id_3", "name": "Oferta Especial", "status": "scheduled", "created_at": "2024-10-27T10:30:00Z" }