{ "data": [ { "id": "campaign_1", "name": "Campanha de Boas-vindas", "status": "active", "created_at": "2024-10-27T10:00:00Z" }, { "id": "campaign_2", "name": "Promoção de Natal", "status": "paused", "created_at": "2024-11-15T14:30:00Z" } ], "pagination": { "total_items": 2, "current_page": 1, "total_pages": 1 } }

2. Edit a Campaign

Este endpoint permite editar uma campanha existente.

• URL: /campaigns/{campaign_id}
• Método HTTP: PUT
• Headers:
  • Authorization: Bearer {seu_token_de_api}
  • Content-Type: application/json

javascript fetch('https://api.toolzz.dev/campaigns/campaign_1', { method: 'PUT', headers: { 'Authorization': 'Bearer SEU_TOKEN_AQUI', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "Nova Campanha de Boas-vindas", "message": "Olá! Bem-vindo à nossa empresa." }) });

• Parâmetros:

  Parâmetro	Descrição	Tipo	Obrigatório	Exemplo
  campaign_id	ID da campanha a ser editada	string	Sim	campaign_1
  name	Nome da campanha	string	Não	Nova Campanha de Boas-vindas
  message	Mensagem da campanha	string	Não	Olá! Bem-vindo à nossa empresa.

• Response JSON (exemplo):

{ "id": "campaign_1", "name": "Nova Campanha de Boas-vindas", "status": "active", "created_at": "2024-10-27T10:00:00Z", "updated_at": "2024-12-01T15:45:00Z" }

3. Get Inbox Campaigns

Este endpoint permite listar as campanhas associadas a um inbox específico.

• URL: /inboxes/{inbox_id}/campaigns
• Método HTTP: GET
• Headers:
  • Authorization: Bearer {seu_token_de_api}
  • Content-Type: application/json

python import requests

url = 'https://api.toolzz.dev/inboxes/inbox_1/campaigns' headers = { 'Authorization': 'Bearer SEU_TOKEN_AQUI', 'Content-Type': 'application/json' }

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

print(response.json())

• Response JSON (exemplo):

{ "data": [ { "id": "campaign_1", "name": "Campanha de Boas-vindas", "status": "active" } ] }

Webhooks

Para receber notificações sobre eventos relacionados às campanhas (por exemplo, conclusão de envio, falha no envio), você pode configurar webhooks. Configure um endpoint em sua aplicação para receber notificações POST da Toolzz Chat. Os payloads dos webhooks contêm informações detalhadas sobre o evento.

Testando a integração

Após implementar a integração, teste minuciosamente as campanhas de WhatsApp. Verifique se as mensagens estão sendo enviadas corretamente, se os destinatários estão sendo segmentados corretamente e se as regras de automação estão funcionando como esperado. Utilize ferramentas de depuração e logs para identificar e corrigir quaisquer erros.

Erros comuns e troubleshooting

• Token de API inválido: Verifique se o token de API está correto e se não expirou.
• Problemas de conectividade: Verifique a conectividade de rede e se a API da Toolzz Chat está acessível.
• Erros de validação: Verifique se os dados enviados nas requisições da API estão no formato correto e se atendem aos requisitos de validação.
• Templates de mensagem não aprovados: Utilize templates de mensagem aprovados pelo WhatsApp Business API.

Conclusão

A integração da API Toolzz Chat simplifica a criação e gerenciamento de campanhas de WhatsApp proativas, permitindo que sua empresa se conecte com clientes de forma mais eficaz e personalizada. Ao automatizar o envio de mensagens e segmentar o público-alvo, você pode impulsionar suas vendas, melhorar o engajamento e fortalecer o relacionamento com seus clientes, tudo isso com um excelente custo-benefício.

Se você busca uma plataforma completa para otimizar suas campanhas e automatizar o atendimento, conheça a Toolzz e descubra como podemos ajudar sua empresa a alcançar resultados incríveis.