bash curl -X GET
'https://api.toolzz.com/chat/campaigns'
-H 'Authorization: Bearer {seu_token_api}'
-H 'Content-Type: application/json'

Code Block (Python):

python import requests

url = 'https://api.toolzz.com/chat/campaigns' headers = { 'Authorization': 'Bearer {seu_token_api}', 'Content-Type': 'application/json' }

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

print(response.json())

Tabela de parâmetros:

Response JSON:

[ { "id": "campaign_123", "name": "Campanha de Boas-Vindas", "description": "Campanha para dar as boas-vindas a novos clientes", "status": "running", "created_at": "2023-10-27T10:00:00Z", "updated_at": "2023-10-27T10:00:00Z" }, { "id": "campaign_456", "name": "Promoção de Aniversário", "description": "Campanha para oferecer um desconto especial no aniversário do cliente", "status": "scheduled", "created_at": "2023-10-26T15:30:00Z", "updated_at": "2023-10-26T15:30:00Z" } ]

Editar uma Campanha (Edit a Campaign)

Este endpoint permite editar uma campanha existente. Você pode alterar o nome, a descrição, o status e outros parâmetros da campanha.

{ "name": "Nova Campanha de Boas-Vindas", "description": "Campanha de boas-vindas atualizada para novos clientes", "status": "scheduled" }

Code Block (cURL):

bash curl -X PUT
'https://api.toolzz.com/chat/campaigns/{campaign_id}'
-H 'Authorization: Bearer {seu_token_api}'
-H 'Content-Type: application/json'
-d '{ "name": "Nova Campanha de Boas-Vindas", "description": "Campanha de boas-vindas atualizada para novos clientes", "status": "scheduled" }'

Code Block (Python):

python import requests import json

url = 'https://api.toolzz.com/chat/campaigns/{campaign_id}' headers = { 'Authorization': 'Bearer {seu_token_api}', 'Content-Type': 'application/json' } data = { "name": "Nova Campanha de Boas-Vindas", "description": "Campanha de boas-vindas atualizada para novos clientes", "status": "scheduled" }

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

print(response.json())

Tabela de parâmetros:

Response JSON:

{ "id": "campaign_123", "name": "Nova Campanha de Boas-Vindas", "description": "Campanha de boas-vindas atualizada para novos clientes", "status": "scheduled", "created_at": "2023-10-27T10:00:00Z", "updated_at": "2023-10-28T08:00:00Z" }

Obter Campanhas de Inbox (Get Inbox Campaigns)

Este endpoint permite obter as campanhas associadas a uma inbox específica.

• URL: https://api.toolzz.com/chat/inboxes/{inbox_id}/campaigns
• Método HTTP: GET
• Headers:
  • Authorization: Bearer {seu_token_api}
  • Content-Type: application/json

Code Block (cURL):

bash curl -X GET
'https://api.toolzz.com/chat/inboxes/{inbox_id}/campaigns'
-H 'Authorization: Bearer {seu_token_api}'
-H 'Content-Type: application/json'

Code Block (Python):

python import requests

url = 'https://api.toolzz.com/chat/inboxes/{inbox_id}/campaigns' headers = { 'Authorization': 'Bearer {seu_token_api}', 'Content-Type': 'application/json' }

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

print(response.json())

Tabela de parâmetros:

Response JSON:

[ { "id": "campaign_789", "name": "Campanha de Retenção", "description": "Campanha para reter clientes existentes", "status": "running", "created_at": "2023-10-25T09:00:00Z", "updated_at": "2023-10-25T09:00:00Z" }, { "id": "campaign_101", "name": "Pesquisa de Satisfação", "description": "Campanha para coletar feedback dos clientes", "status": "completed", "created_at": "2023-10-24T14:20:00Z", "updated_at": "2023-10-24T14:20:00Z" } ]

Webhooks (se aplicável)

Embora não seja estritamente necessário para campanhas de WhatsApp proativas, você pode configurar webhooks para receber notificações sobre eventos relacionados às campanhas, como:

• campaign.created: Quando uma nova campanha é criada.
• campaign.updated: Quando uma campanha é atualizada.
• campaign.started: Quando uma campanha é iniciada.
• campaign.completed: Quando uma campanha é concluída.
• campaign.failed: Quando uma campanha falha.

Para configurar webhooks, você pode usar os endpoints Add A Webhook, List All Webhooks e Update A Webhook Object da API do Toolzz Chat.

Testando a integração

Após implementar as campanhas de WhatsApp proativas via API, é fundamental testar a integração para garantir que tudo esteja funcionando corretamente. Aqui estão algumas dicas para testar a integração:

1. Envie mensagens de teste: Envie mensagens de teste para diferentes números de telefone para verificar se as mensagens estão sendo entregues corretamente.
2. Verifique a segmentação: Verifique se a segmentação está funcionando corretamente, enviando mensagens para diferentes grupos de contatos.
3. Monitore os resultados: Monitore os resultados das campanhas para verificar se elas estão atingindo seus objetivos.
4. Analise os logs: Analise os logs da API para identificar erros ou problemas.

Erros comuns e troubleshooting

Ao implementar campanhas de WhatsApp proativas via API, alguns erros comuns podem ocorrer. Aqui estão alguns exemplos e como resolvê-los:

• Erro de autenticação: Verifique se o token de API está correto e se você tem permissão para acessar os endpoints da API.
• Erro de validação: Verifique se os dados que você está enviando para a API são válidos e se estão no formato correto.
• Erro de limite de taxa: A API do Toolzz Chat tem um limite de taxa para evitar abusos. Se você exceder o limite de taxa, tente novamente mais tarde.
• Mensagens não entregues: Verifique se o número de telefone do destinatário está correto e se o destinatário não bloqueou seu número.

Se você encontrar algum problema ao implementar campanhas de WhatsApp proativas via API, consulte a documentação da API do Toolzz Chat ou entre em contato com o suporte técnico da Toolzz.

Conclusão

Implementar campanhas de WhatsApp proativas via API do Toolzz Chat pode ser uma estratégia eficaz para reduzir custos, otimizar o atendimento ao cliente e aumentar a eficiência da sua empresa. Ao automatizar o envio de mensagens personalizadas e segmentadas, você pode alcançar seus clientes de forma mais eficaz e melhorar a experiência do cliente. Além disso, ao integrar o Toolzz Chat com outras ferramentas, como CRMs e sistemas de automação de marketing, você pode criar fluxos de trabalho mais eficientes e otimizar ainda mais seus resultados.

Potencialize com agentes de IA da Toolzz:

O Toolzz Chat cuida do atendimento humano. Mas e se um agente de IA da Toolzz AI respondesse as primeiras perguntas, qualificasse o lead, e só transferisse para o humano quando necessário? Com Custom Functions, seu agente consulta CRM, agenda reuniões e resolve problemas — tudo por WhatsApp. Já imaginou interagir com essa automação por voz? Conheça a Toolzz AI.