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
- Use + Webhook e escolha direção, recurso, chave compatível e mapeamento opcional.
- Na saída, informe o destino HTTPS público. Na entrada, utilize a URL de recebimento apresentada nos detalhes.
- Salve e guarde o segredo exibido uma única vez.
- 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.