Este endpoint permite obter os resultados de um chat específico.

• URL: https://api.toolzz.dev/bots/v1/results
• Método: GET
• Headers:
  • Authorization: Bearer YOUR_API_TOKEN
• Parâmetros:
  • botId (string): ID do bot.
  • chatId (string): ID do chat.

Exemplo (curl):

bash curl -X GET 'https://api.toolzz.dev/bots/v1/results?botId=654321098765&chatId=987654321098' -H 'Authorization: Bearer YOUR_API_TOKEN'

Resposta JSON:

{ "data": [ { "id": "1234567890", "chatId": "987654321098", "botId": "654321098765", "timestamp": "2024-10-27T10:00:00Z", "result": { "nome": "João da Silva", "email": "[email protected]", "interesse": "Produto X" } } ] }

2. Enviar Dados para o CRM (Exemplo Genérico)

Este é um exemplo genérico de como você enviaria os dados para a API do seu CRM. Adapte a URL, headers e body de acordo com a documentação do seu CRM.

python import requests import json

Substitua com seus valores

API_TOKEN = "YOUR_API_TOKEN" CRM_API_URL = "https://seu-crm.com/api/leads" CRM_API_TOKEN = "SEU_CRM_API_TOKEN"

Obter os resultados do bot (usando a resposta do exemplo anterior)

results = { "data": [ { "id": "1234567890", "chatId": "987654321098", "botId": "654321098765", "timestamp": "2024-10-27T10:00:00Z", "result": { "nome": "João da Silva", "email": "[email protected]", "interesse": "Produto X" } } ] }

Iterar sobre os resultados e enviar para o CRM

for result in results['data']: data = { "nome": result['result']['nome'], "email": result['result']['email'], "interesse": result['result']['interesse'] }

headers = {
    "Authorization": f"Bearer {CRM_API_TOKEN}",
    "Content-Type": "application/json"
}

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

if response.status_code == 201:
    print(f"Lead criado com sucesso: {result['result']['nome']}")
else:
    print(f"Erro ao criar lead: {response.status_code} - {response.text}")

Testando

Após configurar a integração, utilize o recurso de “Preview Chat” na plataforma Toolzz Bots para simular uma conversa com o chatbot e verificar se os dados estão sendo enviados corretamente para o CRM. Acesse a seção de resultados na API (conforme demonstrado acima) ou verifique diretamente no seu CRM se o novo registro foi criado ou atualizado com as informações coletadas pelo chatbot.

Erros Comuns

• Chave de API inválida: Verifique se a API Key do Toolzz Bots está correta e ativa.
• URL da API do CRM incorreta: Confirme se a URL da API do seu CRM está correta e acessível.
• Formato JSON inválido: Certifique-se de que o body da requisição está no formato JSON correto, com aspas duplas em volta das chaves e valores.
• Mapeamento de campos incorreto: Verifique se os campos do chatbot estão corretamente mapeados para os campos correspondentes no CRM.
• Problemas de CORS: Se você estiver enfrentando problemas de CORS (Cross-Origin Resource Sharing), verifique se o seu CRM permite requisições da origem do Toolzz Bots.

Conclusão

A integração entre chatbots e CRM é uma estratégia poderosa para otimizar processos e melhorar a experiência do cliente. Ao monitorar as métricas corretas, como taxa de conversão, tempo médio de resposta, e número de leads qualificados gerados pelo chatbot, sua empresa poderá identificar oportunidades de melhoria e maximizar o retorno sobre o investimento. A Toolzz Bots oferece uma plataforma flexível e intuitiva para criar e integrar chatbots com seus sistemas existentes, permitindo que você aproveite ao máximo os benefícios dessa tecnologia.