# Webhooks

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:<br>

   <figure><img src="/files/yHJiMQqP3eqJ2yaTjaHr" alt=""><figcaption></figcaption></figure>

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

   ```json
   {
   	"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**:<br>

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dalego.com/integracoes/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
