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-lhe receber atualizações em tempo real sobre os seus faxes 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.
Configuração de webhooks
- Abra o painel Webhooks:
- Inicie sessão 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 irá 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 eventos relativos a
esses números.
-
Receba atualizações de estado
- Depois de configurado, Fax.Plus enviará um webhook para o URL especificado sempre que o estado de um fax
se alterar. - 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 não for igual a 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 especificado sempre que o estado de um fax
- Verifique a assinatura
- Por cada endpoint criado, é gerado automaticamente um segredo de assinatura que pode utilizar para validar cada pedido recebido. Saiba mais sobre como verificar assinaturas de webhooks.
- (Opcional) Verifique os endereços IP de origem:
- Pode verificar que 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 que 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.
- Reenvio: também pode acionar novas tentativas manuais a partir do painel ou reenviar quaisquer eventos anteriores num período de tempo à sua escolha.