É possível utilizar um bot para capturar e realizar pesquisas de seus clientes de uma forma que o Droz Bot seja a unica forma de contato, isso pois a pesquisa será respondida diretamente no atendimento do bot!

Configurando o Droz Survey

Em primeiro momento, será necessário a criação de um formulário, e uma pesquisa para que possamos usá-lo de template para o que será capturado no bot. Veja um exemplo:

Formulário:

Importante!

Ao criar o formulário certifique-se de não usar apresentação em vídeos no formulário, pois a integração não suporta esta tipagem!

Pesquisa

Importante: As informações alocadas aqui não serão relevantes ao cliente, pois o mesmo não estará o usando o Survey em si, recomendamos uma nomenclatura que ajude a identificar, por exemplo, o nome do bot que fará a coleta dos dados!

O seguinte passo é prepararmos nossa API, para utilizarmos no Droz Bot.

Para ter acesso às informações, acesse a Documentação API's Droz Survey, ou através da interface do próprio Survey:

A API usada será de Import Answer:

/surveys/{surveyId}/import/answers

O JSON à ser usado dentro do bot será o seguinte, conforme disponível na documentação:

{
   "groupId":"string",
   "answers": [
   {
     "email":"string",
     "name":"string",
     "finished":"2022-11-16T15:46:03.495Z",
     "Q{number}-{type}":"string"
   }
  ]
}

Isso conclui o processo necessário do lado do Droz Survey.

Importante salientar que, todo uso de API requer um TOKEN 

Configurando o Droz Bot

Adicionamos um conector ao bot que fará a coleta dos dados; Para facilitar a configuração, acesse as 'Configurações Avançadas' em "Empresa" no Survey, o mesmo já entrega a URL base pronta para uso:

Seguindo o exemplo, o Endpoint utilizado será o seguinte:

https://app.2listen.com.br/api/v1/demo-atlantic/surveys/7450ef45-c7ce-492a-8983-31e2fc94ef49/import/answers

O surveyId pode ser localizado ao acessar o relatório da pesquisa que foi criada para essa integração, a numeração necessária estará exposta na própria url:

Para autenticar, use o formato Basic:

Preencha a informação do usuário que criou o token, não podendo ser transferido, apenas refeito. Ou seja, apenas o usuário que estiver logado poderá utilizar o Token criado para essa integração:

• Neste exemplo, descrevemos o token criado ao usuário que o criou para facilitar visualização.

Resta então, configurar a requisição. É recomendado que o fluxo do bot já esteja configurado com as variáveis que serão usadas para a coleta de cada uma das perguntas utilizadas; Isso facilita no próprio processo de edição do JSON base, disponível na documentação. Exemplo de requisição editada com as variáveis em cada campo:

Entendendo os campos:

https://app.2listen.com.br/api/v1/{company-alias}/clients-groups

Importante: As questões deverão seguir a ordem das pesquisas no Survey, então se a primeira pergunta for NPS no Survey, aqui no JSON a primeira também deverá ser "Q1- NPS". 

Tabela de Referência