Configurar e Solucionar Problemas#
Visualize, crie e edite webhooks a partir do Dashboard, visualize quais webhooks foram enviados, seus payloads e tente novamente para sincronizar os dados coletados.
Visualizar, criar e editar webhooks a partir do Dashboard#
Você também pode gerenciar os webhooks do seu aplicativo a partir do Dashboard.
- Acesse dashboard.pluggy.ai
- Vá para a aba "Applications"
- Acesse a página de configurações do aplicativo clicando no ícone de lápis no aplicativo onde você deseja gerenciar os webhooks.
Aqui, você poderá visualizar os webhooks que já criou, editar a URL e os eventos aos quais está inscrito, excluí-lo ou até mesmo desativá-lo.
Nota: Apenas administradores ou proprietários da equipe podem editar webhooks.
Limitações de Webhook:
- Você pode criar um máximo de 5 webhooks por evento. Se precisar registrar mais, considere consolidar seus endpoints ou usar uma única URL de webhook com roteamento interno.
- Webhooks apontando para ferramentas de teste conhecidas (como Request Catcher, ngrok ou URLs de desenvolvimento local semelhantes) são automaticamente excluídos após 90 dias.
Monitorar Eventos de Webhook#
Além de gerenciar as configurações de webhook, você pode monitorar a entrega de webhooks e solucionar problemas através da página de Eventos.
- Navegue até dashboard.pluggy.ai/events
- Visualize todos os eventos de webhook enviados para seus aplicativos em tempo real
Use os filtros disponíveis para restringir os eventos de webhook:
- Intervalo de Datas: Filtrar eventos por data de criação
- Tipo de Evento: Selecionar tipos de eventos específicos ou visualizar todos os eventos
- Pesquisar: Pesquisar por Application Client ID, Item ID ou qualquer texto
Nota: A página de eventos de webhook é atualizada automaticamente a cada minuto para mostrar os eventos mais recentes e seu status.
Detalhes Avançados do Evento#
Clique em qualquer linha de evento de webhook para visualizar informações detalhadas em um modal, incluindo:
- Informações básicas: Timestamp de Criação e Conclusão, Tipo de Evento, URL de Destino, ID do Conector/Item, Número de tentativas e Status de Entrega
- Informações de erro para eventos falhados
Tentar Novamente Eventos de Webhook#
A funcionalidade de tentar novamente permite que você reenvie manualmente qualquer evento de webhook, independentemente de seu status atual. Isso é útil para testes, depuração ou para garantir a entrega de eventos importantes.
- Clique na linha do evento para abrir o modal de detalhes
- Clique no botão "Retry" para tentar manualmente a entrega do webhook
- O modal será fechado e o webhook será colocado na fila para nova tentativa
Recursos Adicionais: Para informações abrangentes sobre parâmetros de payload de webhook, tipos de eventos, manuseio de notificações e detalhes de implementação, consulte a documentação completa de Webhook.