Como adicionar Dashbot a Botpress para Chatbot Analytics

Neste artigo, vamos detalhar os passos necessários para ligar o Botpress ao Dashbot, uma ferramenta de análise específica para chatbots, com um nível gratuito. Incluímos um código que pode ser copiado e colado para que possa capturar adequadamente os tipos de resposta de conteúdo mais comuns com pouco ou nenhum trabalho!

Porquê utilizar algo diferente da análise incorporada de Botpress? O External Analytics permite extrair dados do Botpress e usá-los na plataforma de sua escolha. Se tiver diferentes tipos de bots e quiser fundi-los, ou se quiser ter mais controlo sobre as análises, uma solução dedicada como a Dashbot pode ajudá-lo a gerir as suas análises com maior facilidade e controlo.

Sobre o Dashbot

Para projetos menores, a Dashbot permitirá que você monitore o engajamento para ver como seu bot está se saindo de modo geral. Também pode procurar conversas individuais para ter uma compreensão visual de como as conversas estão a decorrer. Se o seu chatbot estiver a começar a ter um volume elevado, pode usar o Dashbot para personalizar a sua conversa a seu gosto. Pode pensar nisto como se tivesse o Power BI para a análise de chatbots.

O Dashbot é gratuito para 1000 mensagens/mês, pelo que pode facilmente experimentá-lo. Também tem dois outros níveis, um para pequenas e médias empresas chatbots com um limite mensal de mensagens muito mais elevado, e um plano personalizado para empresas. Pode escolher o plano que mais lhe convém.

Instruções

Criando seu bot na Dashbot e obtendo sua chave de API

1. Vá para reports.dashbot.io/signup e crie sua conta dashbot.
2. Clique em "Adicionar chatbot".
3. Preencher o formulário e enviar
4. Escolha um nome qualquer para o seu chatbot. Este nome é apenas para referência.
5. Seleccione "Universal" para a plataforma.
6. Escolha uma categoria que se adeqúe ao seu caso de utilização.
7. Seleccione prod ou dev. Isto é apenas para sua referência.
8. Mantenha a janela após o envio aberta. Irá precisar dela para copiar a chave de API mais tarde (duas vezes!) e também para verificar e aceder à análise do chatbot.

Adicionar o código de ligação + a chave API correcta em Botpress

1. Instale o Botpress (se ainda não o fez!) e abra-o.
   
2. Criar (se ainda não o fez) e abrir o bot clicando no seu nome.
3. Navegue até à página do editor de código.
4. Clique no botão mais ao lado de "Hooks", seleccione "Event Hooks" -> "Before Outgoing Middleware"
5. Dê um nome ao seu ficheiro dashbot-analytics-outgoing.js e submeta-o
6. No editor do hook recém-criado, copie o texto daqui e cole-o no conteúdo principal do hook.
7. Alterar o valor "DASHBOT_KEY" para o valor obtido na etapa 4.
8. [Recomendado] Se estiver a experimentar pela primeira vez, defina DEBUG_DEV como verdadeiro
9. Premir guardar
10. Clique no botão mais ao lado de "Hooks", seleccione "Event Hooks" -> "After Incoming Middleware"
11. Dê um nome ao seu ficheiro dashbot-analytics-incoming.js e submeta-o
12. No editor do hook recém-criado, copie o texto daqui e cole-o no conteúdo principal do hook.
13. Alterar o valor "DASHBOT_KEY" para o valor obtido na etapa 4.
14. [Recomendado] Se estiver a experimentar pela primeira vez, defina DEBUG_DEV como verdadeiro
15. Premir guardar
16. Abra o emulador e envie uma mensagem.

Certificar-se de que tudo funciona no Dashbot

1. Volte ao Dashbot e clique em verificar.
2. Se o texto do botão não for verificado, volte atrás e certifique-se de que colou a chave api correcta, e defina DASHBOT_KEY para true antes de enviar uma mensagem.
3. Clique no botão "Ver relatórios" junto ao botão Verificado.
4. Divirta-se a analisar as análises do seu chatbot!

Importante - para a produção

O comportamento padrão é enviar análises apenas se o sinalizador de desenvolvimento estiver definido como verdadeiro (DEBUG_DEV nos dois arquivos de middleware) ou para Produção, é necessário adicionar uma variável de ambiente chamada EXPOSED_EXTERNAL_ANALYTICS e defini-la como verdadeira. Pode adicioná-la onde normalmente configura as variáveis de ambiente Botpress .

É isso mesmo! Sinta-se à vontade para reutilizar esse código para outros fins de rastreamento. Pode até enviar as suas análises para o Google Analytics, Segment ou qualquer outra solução personalizada. Só precisa de ajustar as funções sendAnalytics para se adequarem à sua implementação.

‍