Novidade: os webhooks foram atualizados
Os webhooks agora incluem uma configuração melhorada, registos de entrega, repetição de eventos e verificação de assinatura. Se configurou os webhooks antes de 31 de agosto de 2026, os seus endpoints continuam a funcionar, mas precisa de migrá-los antes de outubro de 2026. 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 do 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 de webhooks:
- Inicie sessão na sua conta Fax.Plus.
- Navegue até 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 quais os eventos a receber. Subscreva todos os eventos ou selecione apenas os que precisa a partir do
catálogo de eventos. -
Opcional: filtrar 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
- Uma vez configurado, Fax.Plus enviará um webhook para o URL especificado sempre que o estado de um fax
mudar. - O payload do webhook incluirá detalhes importantes, tais como o ID do fax, o estado, a data/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, isso indica que o fax está a ser enviado pela primeira vez
- Uma vez configurado, Fax.Plus enviará um webhook para o URL especificado sempre que o estado de um fax
- Verifique a assinatura
- Para cada endpoint criado, é gerado automaticamente um segredo de assinatura que pode utilizar para validar cada pedido recebido em relação a ele. 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 sucesso ou não.
- Novas tentativas: em caso de falha na entrega, os webhooks são automaticamente reenviados.
- Repetição: também pode iniciar novas tentativas manuais a partir do painel ou repetir quaisquer eventos passados num intervalo de tempo escolhido.