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".

    • 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.

    • 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.

PreviousHelp Scout

Last updated