Como posso utilizar webhooks para verificar o estado do meu fax enviado ou recebido?

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

  1. Abra o painel Webhooks:
  2. 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.
  3. 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

  4. Verifique a assinatura
  5. (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

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.
Este artigo foi útil?
0 de 1 acharam isto útil
Mais artigos nesta seção