{ "data": [ { "id": "campaign_id_1", "name": "Campanha de Boas-Vindas", "status": "active", "created_at": "2024-10-26T10:00:00Z" }, { "id": "campaign_id_2", "name": "Promoção de Natal", "status": "paused", "created_at": "2024-11-15T14:30:00Z" } ], "total": 2, "page": 1, "per_page": 10 }

2. Edit a Campaign

Este endpoint permite editar uma campanha de WhatsApp proativa existente.

• URL: https://api.toolzz.dev/v1/campaigns/whatsapp/{campaign_id}
• Método: PUT
• Headers:
  • Authorization: Bearer <seu_token_de_API>
  • Content-Type: application/json

javascript const campaignId = 'campaign_id_1'; const payload = { "name": "Nova Campanha de Boas-Vindas", "status": "active", "message": "Olá! Seja bem-vindo à nossa empresa!" };

fetch('https://api.toolzz.dev/v1/campaigns/whatsapp/' + campaignId, { method: 'PUT', headers: { 'Authorization': 'Bearer ', 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }) .then(response => response.json()) .then(data => console.log(data));

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Valor Padrão	Exemplo
  campaign_id	string	ID da campanha a ser editada	Sim		campaign_id_1
  name	string	Nome da campanha	Não		Promoção de Aniversário
  status	string	Status da campanha (active/paused)	Não		active
  message	string	Mensagem da campanha	Não		Olá, cliente!

• Response JSON (exemplo):

{ "id": "campaign_id_1", "name": "Nova Campanha de Boas-Vindas", "status": "active", "message": "Olá! Seja bem-vindo à nossa empresa!", "created_at": "2024-10-26T10:00:00Z", "updated_at": "2024-10-27T15:45:00Z" }

3. Get Inbox Campaigns

Este endpoint retorna as campanhas que estão ativas na caixa de entrada do WhatsApp.

• URL: https://api.toolzz.dev/v1/campaigns/whatsapp/inbox
• Método: GET
• Headers:
  • Authorization: Bearer <seu_token_de_API>
  • Content-Type: application/json

Webhooks

Para receber notificações sobre eventos relacionados às campanhas de WhatsApp, você pode configurar webhooks. Por exemplo, você pode receber uma notificação quando uma campanha for criada, atualizada ou excluída. A documentação completa sobre webhooks está disponível em https://docs.toolzz.dev/chat-reference/webhooks.

Testando a integração

Após configurar a API e os webhooks, é importante testar a integração para garantir que tudo esteja funcionando corretamente. Envie mensagens para o seu número de WhatsApp e verifique se as automações estão sendo acionadas conforme esperado. Monitore os logs da API para identificar possíveis erros ou problemas.

Erros comuns e troubleshooting

• Erro de autenticação: Verifique se o token de API está correto e se você tem permissão para acessar o endpoint.
• Erro de validação: Verifique se os parâmetros enviados na requisição estão corretos e no formato esperado.
• Erro interno do servidor: Entre em contato com o suporte da Toolzz para obter ajuda.

Conclusão

A API do Toolzz Chat oferece uma maneira poderosa e flexível de automatizar e escalar suas campanhas de WhatsApp proativas. Ao utilizar os endpoints e webhooks disponíveis, você pode criar experiências de atendimento personalizadas e eficientes, que impulsionam o engajamento do cliente e aumentam as vendas. Ao dominar a API, você não apenas escalará suas campanhas, mas também garantirá que a qualidade do atendimento seja mantida, proporcionando uma experiência superior para seus clientes. Se você busca uma solução completa para a gestão de seus canais de comunicação, conheça todos os planos e preços da Toolzz e encontre o ideal para o seu negócio.