Webhooks

Dispare dados a partir de qualquer plataforma e receba notas e comentários de seus usuários sem a necessidade de envio dos links de avaliação. Também é possível registrar as conversões realizadas.

Com essa facilidade, qualquer sistema de atendimento que possua as ferramentas necessárias para a leitura de notas e feedbacks, seja através de API ou postbacks, poderá ser integrado pela sua equipe de programadores.

1. No menu lateral, acesse a categoria Configurar e escolha a opção Webhooks;

2. Selecione o usuário, link de avaliação ou pixel de conversão, como no exemplo abaixo:

   
3. Nosso sistema vai exibir um payload, no formato JSON, para cada seleção escolhida:

   {
   	"code": "123456789",
   	"hookey": "fmts527fydlmw1cgjc",
   	"user": "fmts52hwdlm69cvcf",
   	"tracker": "fmts52ogslm6fnodw",
   	"feedback": "Comentário opcional",
   	"rate": 3
   }

   A estrutura dos dados será sempre a mesma. Com a exceção dos campos feedback e rate, que não precisam ser enviados para salvar uma conversão realizada. Abaixo, uma breve explicação sobre cada um dos campos:

   • O campo "code" faz referência ao código da conta. Geralmente é o CPF ou CNPJ utilizado no ato da assinatura. Esse valor sempre será o mesmo.

   • Para autorizar a entrada dos dados, é necessário que o campo "hookey" possua o mesmo código indicado em sua tela de Webhooks. Ele pode ser alterado quando for preciso através do nosso painel.

   • Cada usuário possui um código distinto que será revelado ao selecionar o colaborador desejado. Basta escolher o membro da equipe e copiar o dado apresentado no campo "user". Se estiver usando nossa API para resgatar esse valor, considere o campo "code" do usuário desejado dentro do objeto "users".

   • Seu link de avaliação ou pixel de conversão possui um código chamado "tracker", que também será exibido em nosso modelo de envio após sua seleção. Buscando esses dados via API, consulte os objetos "urls" e "pixels", contidos nas propriedades de cada usuário.

   • Caso o payload seja para gravar uma avaliação recebida, é obrigatório o envio do campo "rate", que deve ser um número inteiro, maior ou igual a 1 e menor ou igual a 5.

   • Ainda considerando o recebimento de uma nota, é possível enviar de maneira opcional um comentário através do campo "feedback". Ele aceita até 200 caracteres.

4. Envie as informações formatadas para a URL abaixo, utilizando o método POST:

   https://api.dalego.com/webhooks/

5. Se tudo correr da maneira esperada, você receberá uma resposta, em formato JSON, conforme o seguinte modelo:

   {
   	"status": 200,
   	"fingerprint": "1mugmna1olk7c2t55"
   }

Pronto! Você acaba de integrar seu sistema de atendimento atual com a nossa solução.