Automações
Webhooks
A ação de webhook envia uma chamada HTTP assinada a outro sistema no momento em que algo acontece no Gfacility, com cabeçalhos seus, payload seu e um exemplo legível do que o destinatário recebe.
Atualizado em 25/07/2026
Configuração · Automação · 9.4
Um webhook é a metade de saída da sua integração: no momento em que um ticket, uma reserva, um ativo ou um visitante muda no Gfacility, sai uma chamada HTTP para um URL que é seu. Sem polling, sem exportação noturna, sem middleware para vigiar. É uma das sete ações de 9.2 Automações, por isso herda os mesmos acionadores, condições e histórico de execução de qualquer outra ação.
Use-o quando o outro sistema tem de reagir. Se o que quer é ler dados ao seu próprio ritmo, a API e o conector do Power BI encaixam melhor.
Porque é que isto importa ao negócio
"A área financeira reescreve cada débito à mão"
Reserva fechada, envie as linhas de débito diretamente para o sistema financeiro.
"A nossa página de estado está atrasada face à realidade"
Um incidente grave muda de estado e a página pública atualiza em segundos.
"Os cartões de acesso são pedidos demasiado tarde"
Visitante aprovado, avise o sistema de controlo de acessos antes de ele chegar.
"Os auditores querem um rasto externo"
Os registos eliminados saem para o seu próprio armazém de registos, fora do Gfacility.
O que configura
| Definição | O que faz |
|---|---|
| URL do webhook | O endpoint HTTPS que recebe a chamada. |
| Aplicar a | Os dados de que registo viajam. Um âmbito filho, como os visitantes de uma reserva, envia uma chamada por registo encontrado em vez de uma chamada com uma lista. |
| Enviar as alterações destes campos | O destinatário recebe o valor antigo e o novo de cada campo que escolher. Deixe vazio para enviar todos os campos alterados. |
| Cabeçalhos próprios | Para a autenticação do destinatário, por exemplo Authorization ou X-Api-Key. Vão com cada chamada. |
| Payload adicional | JSON opcional que entra na chamada em "extra", para passar um identificador de inquilino ou uma chave de encaminhamento de que o destinatário precisa. |
| Corpo do pedido próprio | Para um destinatário que exige a sua estrutura exata: o seu JSON passa a ser todo o corpo do pedido e o payload padrão do registo não vai incluído. |
Tokens, para o payload levar valores reais
Os valores do payload adicional e de um corpo de pedido próprio aceitam tokens, escritos com chavetas duplas em volta de um caminho de campo. O editor tem um seletor Inserir token com pesquisa, para não ter de decorar nomes de campos: escolhe o campo e o token é escrito por si. Na execução, cada token é substituído pelo valor desse registo.
É isto que torna útil um corpo fixo: o destinatário recebe o número do ticket, a localização e o e-mail do requerente em vez de um valor de exemplo fixo.
Segurança
Chamadas assinadas
Cada chamada leva um cabeçalho de assinatura HMAC. Verifique-o do seu lado antes de confiar no corpo, para que um terceiro não possa falsificar uma chamada ao seu endpoint.
Cabeçalhos cifrados
Os valores dos cabeçalhos são guardados cifrados e mostrados mascarados depois de gravar. Deixe a máscara como está para manter o valor atual; ninguém volta a ler a sua chave de API a partir do formulário.
Construa, olhe e só então ative
O editor valida o seu JSON enquanto escreve, diz-lhe quando não é válido e mostra um exemplo de estrutura válida. Ao lado, O que o destinatário recebe mostra o payload real, para o comparar com a documentação do outro sistema antes de sair uma única chamada.
A partir daí aplica-se o percurso normal da automação: execução de teste da regra num registo real, verificar a entrada no histórico e ativar.
Que decisões vai tomar?
Payload padrão ou corpo próprio?
Padrão mais payload adicional é mais fácil de manter. Passe ao corpo próprio só quando o destinatário não pode ser alterado.
De que campos precisa o destinatário mesmo?
Enviar todos os campos alterados é cómodo mas ruidoso, e partilha mais do que o destinatário precisa.
De quem é o endpoint?
Indique um responsável do lado recetor. Um webhook que ninguém mantém falha em silêncio durante meses.
O que acontece em caso de falha?
Decida com "parar na primeira ação falhada" se o resto da regra ainda deve correr.