{ "data": [ { "id": "campaign_1", "name": "Campanha de Boas-vindas", "status": "active", "channel": "whatsapp" } ], "pagination": { "total_items": 10, "current_page": 1, "per_page": 1 } }

Editar uma Campanha (Edit a Campaign)

Este endpoint permite atualizar os detalhes de uma campanha existente.

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

javascript fetch('https://api.toolzz.dev/api/v1/campaigns/campaign_1', { method: 'PUT', headers: { 'Authorization': 'Bearer {seu_token_api}', 'Content-Type': 'application/json' }, body: JSON.stringify({ "name": "Nova Campanha de Boas-vindas", "message": "Olá, seja bem-vindo!", "status": "paused" }) }) .then(response => response.json()) .then(data => console.log(data));

• Parâmetros (Body):

| Parâmetro | Tipo | Descrição | Obrigatório | Exemplo | | :-------- | :------- | :--------------------------------------- | :---------- | :---------------------- | | name | string | Nome da campanha | Sim | "Promoção de Verão" | | message | string | Mensagem a ser enviada | Sim | "Desconto especial!" | | status | string | Status da campanha (active, paused, draft) | Sim | "active" |

• Response (exemplo):

{ "id": "campaign_1", "name": "Nova Campanha de Boas-vindas", "status": "paused", "channel": "whatsapp" }

Obter Campanhas do Inbox (Get Inbox Campaigns)

Este endpoint permite obter as campanhas associadas a um determinado inbox.

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

python import requests

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

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

if response.status_code == 200: data = response.json() print(data) else: print(f'Erro: {response.status_code}')

Webhooks

Para ser notificado sobre eventos relacionados a campanhas (como o início ou término de uma campanha), você pode configurar webhooks. Isso permite que seus sistemas externos reajam automaticamente a essas mudanças.

Testando a Integração

Após configurar a campanha na Toolzz Chat e implementar a integração via API, teste cuidadosamente o fluxo de mensagens. Verifique se as mensagens estão sendo enviadas para os destinatários corretos, se o conteúdo está correto e se as automações estão funcionando conforme o esperado. Utilize diferentes cenários para garantir a robustez da sua integração.

Erros Comuns e Troubleshooting

• Token de API inválido: Verifique se o token de API está correto e se possui as permissões necessárias.
• Erros de validação: Certifique-se de que os parâmetros enviados na requisição estão de acordo com a documentação da API.
• Problemas de conectividade: Verifique se o seu servidor tem acesso à API da Toolzz Chat.

Conclusão

Criar campanhas proativas de WhatsApp com a API da Toolzz Chat oferece um controle granular e flexibilidade para personalizar a experiência do cliente. Ao automatizar o envio de mensagens relevantes e direcionadas, você pode aumentar o engajamento, gerar leads qualificados e impulsionar as vendas. A combinação da interface intuitiva da Toolzz Chat com a robustez da API permite criar campanhas altamente eficazes e escaláveis. Se você busca uma plataforma que integra todas essas funcionalidades, explore os planos e preços da Toolzz e encontre a opção ideal para o seu negócio.