Quem pode utilizar esta funcionalidade?
Disponível no plano Enterprise.
Acessível a Proprietários e Administradores na aplicação web.
Novidade: os webhooks foram atualizados
Os webhooks incluem agora uma configuração melhorada, registos de entrega, reenvio de eventos e verificação de assinatura. Se configurou webhooks antes de 31 de agosto de 2026, os seus endpoints continuam a funcionar, mas tem de migrá-los antes de 15 de janeiro de 2027. Pode seguir os passos de migração.
Os webhooks permitem receber, em tempo real, atualizações sobre os fax enviados e recebidos diretamente a partir de Fax.Plus. Ao configurar webhooks, pode automatizar a monitorização das suas transmissões de fax e integrar as atualizações de estado nos seus sistemas existentes.
Referência para programadores: Para consultar todos os detalhes técnicos, incluindo tipos de eventos, estrutura do payload e verificação de assinaturas, veja a documentação da API Fax.Plus sobre webhooks.
Configuração de webhooks
- Abra o painel Webhooks:
- Entre na sua conta Fax.Plus.
- Navegue até à secção Integrações em Definições.
- Localize Webhooks e clique em Gerir.
- Adicione um endpoint:
- Clique em Adicionar endpoint e introduza o URL absoluto no seu servidor que receberá os eventos.
- Escolha os eventos que pretende receber. Subscreva todos os eventos ou selecione apenas os de que precisa no
catálogo de eventos. -
Opcional: filtre por número de fax. Associe um ou mais dos seus números de fax para receber apenas os eventos
desses números.
-
Receba atualizações de estado
- Depois de configurado, Fax.Plus enviará um webhook para o URL indicado sempre que o estado de um fax
mudar. - O payload do webhook incluirá detalhes importantes, como o ID do fax, o estado, a data e hora e as
informações do destinatário.
Nota: Se hook.id for diferente de data.id, o fax está a ser reenviado. Se hook.id for igual a data.id, indica que o fax está a ser enviado pela primeira vez
- Depois de configurado, Fax.Plus enviará um webhook para o URL indicado sempre que o estado de um fax
- Verifique a assinatura
- Para cada endpoint criado, é gerado automaticamente um segredo de assinatura que pode usar para validar cada pedido recebido. Saiba mais sobre a verificação de assinaturas de webhooks.
- (Opcional) Verifique os endereços IP de origem:
- Pode verificar se os webhooks que recebe provêm da nossa lista de IPs autorizados:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Pode verificar se os webhooks que recebe provêm da nossa lista de IPs autorizados:
Resolução de problemas e monitorização
- Registos e observabilidade: no painel de webhooks, pode ver todos os eventos e se foram entregues com êxito ou não.
- Novas tentativas: Em caso de falha na entrega, os webhooks são reenviados automaticamente.
- Repetição: Também pode acionar novas tentativas manuais a partir do painel ou repetir quaisquer eventos passados num intervalo de tempo à sua escolha.