Tecnologias Disruptivas em Campanhas WhatsApp

Lucas (CEO Toolzz)
17 de abril de 2026

No cenário atual, a comunicação proativa e personalizada com os clientes é fundamental para o sucesso de qualquer negócio. Campanhas de WhatsApp proativas permitem alcançar o público diretamente, oferecendo promoções, novidades, suporte e informações relevantes. Este tutorial detalha como criar e gerenciar campanhas de WhatsApp proativas utilizando a API do Toolzz Chat, otimizando o engajamento e impulsionando resultados.

Pré-requisitos

Para começar, você precisará de:

• Conta Toolzz Chat: Uma conta ativa na plataforma (chat.toolzz.ai).
• Token de API: Essencial para autenticar suas requisições. Encontre-o nas configurações da sua conta Toolzz Chat, geralmente na seção de integrações ou configurações de desenvolvedor.

Arquitetura

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

1. Cliente: Interage com sua empresa via WhatsApp.
2. WhatsApp/Instagram: A mensagem do cliente é recebida através dessas plataformas.
3. Toolzz Chat: Centraliza as conversas e gerencia a campanha.
4. Automação: A API do Toolzz Chat automatiza o envio de mensagens.
5. Agente humano/IA: Um agente humano ou um agente de IA da Toolzz AI pode intervir se necessário.

Configuração no Produto

Embora este tutorial foque na API, a configuração inicial pode ser feita pela interface do Toolzz Chat:

1. Acesse a seção de Campanhas: No menu principal, procure por "Campanhas" ou "WhatsApp Marketing".
2. Crie uma nova campanha: Defina nome, descrição e público-alvo.
3. Defina o conteúdo: Crie a mensagem (texto, imagens, vídeos, botões).
4. Agende o envio: Escolha data e hora.
5. Monitore: Acompanhe as métricas da campanha.

Implementação via API

5.1. List Campaigns

Este endpoint lista todas as campanhas existentes.

• URL: /api/v1/campaigns

• Método HTTP: GET

• Headers:

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

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Exemplo
  page	integer	Número da página	Não	1
  per_page	integer	Itens por página	Não	10

• Exemplo (Bash):

  bash curl -X GET \n 'https://api.toolzz.dev/api/v1/campaigns?page=1&per_page=10' \n -H 'Authorization: Bearer YOUR_API_TOKEN' \n -H 'Content-Type: application/json'

• Response JSON:

  { "data": [ { "id": "campaign_id_1", "name": "Promoção de Verão", "status": "active" }, { "id": "campaign_id_2", "name": "Lançamento de Produto", "status": "scheduled" } ], "total": 2, "per_page": 10, "current_page": 1, "last_page": 1 }

• URL: /api/v1/campaigns

• Método HTTP: POST

• Headers:

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

• Body JSON:

  { "name": "Campanha de Natal", "message": "Feliz Natal! Aproveite nossos descontos especiais!", "audience": [ "91123456789", "92987654321" ], "scheduled_at": "2024-12-24 10:00:00" }

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Exemplo
  name	string	Nome da campanha	Sim	"Campanha de Natal"
  message	string	Conteúdo da mensagem	Sim	"Feliz Natal! ..."
  audience	array	Lista de números de telefone	Sim	["91123456789", "92987654321"]
  scheduled_at	datetime	Data e hora de envio	Sim	"2024-12-24 10:00:00"

• Exemplo (Python):

  python import requests import json

  url = "https://api.toolzz.dev/api/v1/campaigns" headers = { "Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json" } data = { "name": "Campanha de Natal", "message": "Feliz Natal! Aproveite nossos descontos especiais!", "audience": ["91123456789", "92987654321"], "scheduled_at": "2024-12-24 10:00:00" }

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

• Response JSON:

  { "id": "campaign_id_3", "name": "Campanha de Natal", "status": "scheduled" }