Bom dia, pessoal, tudo bem? Tenho visto algumas dúvidas comuns sobre como coletar/extrair dados dos usuários e vim aproveitar esse espaço para deixar referências para documentações existentes e que vão auxiliar nessa solução.
Criando os dados
Registro de Eventos
Antes de tudo, caso você não tenha nenhum dado a ser coletado, você precisa entender o que deseja registrar a respeito do seu usuário como, por exemplo, um funil de eventos do fluxo conversacional, informações de atendimento humano, notas de avaliação, etc.
Para isso você deve usar a ação Registro de Eventos para persistir esses dados no teu bot. Você pode aprender mais sobre isso aqui: Ação: Registro de eventos – Blip | Blip Help
Relatórios
Após saber como funciona o registro de eventos, você pode estar se perguntando como acessar, de forma fácil e visível, esses dados diretamente no teu bot. Para isso, você precisa criar Relatórios Personalizados, entenda mais aqui como criar os seus: Como criar relatórios personalizados – Blip | Blip Help
Coletando os dados
Agora vamos para a parte de coleta de dados. De forma fácil e muito bem documentada, você terá duas opções: Usando Webhook ou usando API. Cada um deles tem sua particularidade.
Usando Webhook
Para usar Webhook você pode seguir essa documentação: Enviando dados para análise através de Webhooks – Blip | Blip Help que mostrará o passo a passo para efetuar a configuração. Lembre-se: para usar Webhook você precisa ter um endereço público que escutará os dados recebidos.
Pontos importantes:
- Os dados chegam pra ti sempre que são registrados.
- Você não precisa ficar efetuando requisições para um endpoint a fim de descobrir se tem novos registros.
- Você precisará tratar os dados e entender que, se existir a chave “category” e “action”, essa informação se trata de um event track (registro de evento) que é o que você deseja coletar.
- O delay de até 2 horas com os novos registros.
Usando API
Para usar API você pode seguir essa documentação: Blip Docs - Get Event Details que mostra exemplos de como efetuar uma requisição HTTP e como esses dados serão entregues. Para executar essa requisição você precisa de:
- Chave de autorização do teu bot/router. Veja aqui como encontrar: Como encontrar a API-KEY do meu bot? – Blip | Blip Help
- Nome da categoria que deseja coletar.
- Uso do Id do Contrato na URL (Esse ID é o subdomínio que aparece no teu endereço quando você acessa um chatbot. É a palavra depois de “https://” e antes de “blip.ai/” do endereço do teu navegador. (Se for a palavra “portal”, então você não está usando o contract id).
Pontos importantes:
- Você tem maior controle sobre quando quer pegar os dados e tratar exatamente aquilo que deseja.
- A informação vai existir em tempo real
- Você só terá os dados se fizer a requisição, diferente do Webhook, que os dados chegarão até você a medida que forem registrados.
É isso, pessoal, espero que esse compilado seja útil e, em caso de dúvida, fiquem a vontade para comentar abaixo. Ótimo dia!
