# Webhooks de entrada e saída

Configure recebimento ou envio de alterações e acompanhe entregas, assinaturas e repetições.

Versão 1.0.0

Em **Integrações → Webhook**, o Master configura **Receber no Askora** ou **Enviar alterações do Askora**. Entrada aplica dados ao destino autorizado; saída informa alterações ao sistema externo.

## Cadastrar e ativar

1. Use **+ Webhook** e escolha direção, recurso, chave compatível e mapeamento opcional.
2. Na saída, informe o destino HTTPS público. Na entrada, utilize a URL de recebimento apresentada nos detalhes.
3. Salve e guarde o segredo exibido uma única vez.
4. Configure o sistema externo, confira o teste pertinente e ative a conexão.

O formulário cria a conexão inativa. Direção, recurso e destino ficam imutáveis depois de salvar; crie outra conexão para mudar esses dados. Nome, chave, mapeamento e situação podem ser editados com a versão atual. Trocar o segredo exige atualizar o correspondente no sistema externo.

## Receber dados

O remetente envia identidade estável do evento e dados conforme o guia da interface. A assinatura usa os bytes originais do corpo e timestamp, com tolerância de cinco minutos. Alterar o corpo exige nova assinatura.

A entrada aceita objeto ou até 100 linhas e aplica a entrega de forma transacional. Repetir a mesma identidade e conteúdo evita nova gravação; reutilizar identidade com conteúdo diferente gera conflito. Assinatura inválida, chave expirada, recurso incompatível ou campos incorretos impedem a entrada.

O teste de entrada valida dados sem persistir e sem verificar assinatura. Portanto, passar nesse teste não comprova que o remetente assinou corretamente uma entrega real.

## Enviar alterações

A saída utiliza eventos posteriores ao cursor inicial e não faz uma carga completa do histórico. O conteúdo é lido na primeira tentativa, preservado nas novas tentativas e pode diferir do instante exato da alteração. Exclusões podem apresentar dados ausentes.

O destinatário deve reconhecer repetições pela identidade do evento: a entrega pode ocorrer mais de uma vez. Resposta de sucesso exige código HTTP 2xx. Há até oito tentativas automáticas, com intervalos crescentes limitados a uma hora; falhas podem ser reagendadas em **Entregas**.

Destino precisa ser HTTPS público compatível, sem redirecionamento. Chave revogada, conexão inativa ou permissão removida impedem envio. O teste de saída pede confirmação porque envia um evento real de teste ao destino, sem dados de negócio.

## Acompanhar falhas

Em Entregas, confira tentativas, resposta HTTP e erro. Corrija destino, autorização ou contrato antes de reagendar. Reenviar não deve criar outra identidade para o mesmo evento. Consulte Atividade da integração para correlacionar a execução, sem expor segredos.

## Disponibilidade

Administração no web, exclusiva do Master; sem tela nativa no aplicativo. Webhooks reutilizam regras dos módulos, inclusive escopo da credencial e fechamentos. Configurar a conexão não comprova entrega a um fornecedor externo até o teste e a operação efetivos.