# Webhooks (deprecado)

{% hint style="warning" %}
O cadastro de novos endpoints de webhooks no formato antigo (deprecado) não está mais disponível. No entanto, os endpoints já cadastrados continuarão funcionando normalmente.
{% endhint %}

Para conseguir usar os *webhooks* da API do [Autentique](https://www.autentique.com.br), você precisa:

1. Acessar a [página de configurações de acesso a API](https://painel.autentique.com.br/perfil/api) e registrar uma URL de callback. Para testes, recomendamos o uso do [Beeceptor](https://beeceptor.com) para receber os webhooks.
2. Pronto! Agora você receberá um evento de todos os documentos da conta, quando alguém assinar algum deles.

> Eventos de rejeitado não enviam webhooks.

O corpo da requisição enviada quando alguma das partes assinar são as informações do documento no seguinte formato:

{% hint style="info" %}
O formato abaixo é exibido em JSON para visualização, porém o webhook retorna os dados em x-www-form-urlencoded.
{% endhint %}

```javascript
{
  "partes": [
    {
      "nome": "Cassiano Calegari",
      "email": "cassiano@autentique.com.br",
      "cpf": "36653414930",
      "nascimento": "1931-01-01",
      "empresa": "Autentique",
      "funcao": "assinar",
      "visualizado": { // Quando o signatário visualiza o documento
        "created": "2018-01-01 17:09:02",
        "ipv4": "170.233.43.253",
        "geotrack": {
          "country": "Brasil",
          "countryISO": "BR",
          "state": "Rio Grande do Sul",
          "stateISO": "RS",
          "city": "Erechim",
          "zipcode": "99700",
          "latitude": -22.8305,
          "longitude": -43.2192
        }
      },
      "assinado": { // Quando o signatário assina o documento
        "created": "2018-01-01 17:09:02",
        "ipv4": "170.233.43.253",
        "geotrack": {
          "country": "Brasil",
          "countryISO": "BR",
          "state": "Rio Grande do Sul",
          "stateISO": "RS",
          "city": "Erechim",
          "zipcode": "99700",
          "latitude": -22.8305,
          "longitude": -43.2192
        }
      },
      "rejeitado": { // Quando o signatário rejeita o documento
        "created": "2018-01-01 17:09:02",
        "motivo": null, // ou string, com motivo escrito por signatário para rejeição do documento
        "ipv4": "170.233.43.253",
        "geotrack": {
          "country": "Brasil",
          "countryISO": "BR",
          "state": "Rio Grande do Sul",
          "stateISO": "RS",
          "city": "Erechim",
          "zipcode": "99700",
          "latitude": -22.8305,
          "longitude": -43.2192
        }
      },
      "mail": {
        "sent": false, // ou datetime: "2018-01-01 21:00:00"
        "opened": null, // ou datetime: "2018-01-01 21:00:00"
        "refused": null, // ou datetime: "2018-01-01 21:00:00"
        "delivered": null, // ou datetime: "2018-01-01 21:00:00"
        "reason": null // ou string, com erro retornado pelo servidor de email
      }
    }
  ],
  "documento": {
    "uuid": "9ab23456325c40c2a5023051cf4bbf0e",
    "nome": "Contrato de Marketing",
    "rejeitavel": true,
    "created": "2018-01-01 17:09:00",
    "updated": "2018-01-01 17:09:00",
    "excluido": null, // ou datetime: "2018-01-01 21:00:00",
    "transacao": false,
    "pendente": 0,
    "publicado": "2018-01-01 17:09:01",
    "disponivel": true
  },
  "remetente": {
    "nome": "Cassiano Calegari",
    "empresa": "Autentique",
    "email": "cassiano@autentique.com.br",
    "cpf": "36653414930",
    "nascimento": "1931-01-01"
  },
  "arquivo": {
    "original":"https:\/\/storage.googleapis.com\/d6e\/ca2485d9e4bc5e2e8d6c8f18b95d3141\/e808f22467bf2173760ca9a6d3addbefab49f978c67ab5987.original.pdf",
    "assinado":"https:\/\/api.autentique.com.br\/documentos\/e808f22467bfa973760cf7a6d3addbefab49f978c67ab5987\/assinado.pdf"
  }
}
```


---

# 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.autentique.com.br/api/2/integracao/webhooks-1.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.
