O que são Webhooks?#
Webhooks permitem que a Pluggy notifique sua aplicação sobre eventos sem que você precise solicitar atualizações, mantendo você atualizado com as últimas mudanças nos itens que você criou.
Configurando Webhooks#
Você pode configurar Webhooks de duas maneiras:
- Usando o Dashboard da Pluggy: Vá para Aplicações, em seguida clique no ícone "Editar" para sua aplicação. Role para baixo até a seção "Webhooks", onde você pode registrar novos webhooks e visualizar, editar ou excluir os existentes.
- Usando nossa API diretamente: Configure URLs de notificação específicas para cada evento particular ou configure um único ponto de escuta para todos os eventos usando um cliente HTTP como o Postman.
Por favor, consulte nosso Guia de Webhooks para mais informações sobre como configurar Webhooks, payloads, tipos de eventos e solicitações disponíveis.
Recebendo Notificações#
Uma vez que você tenha configurado os webhooks, valide se todos os tipos de eventos estão sendo recebidos conforme esperado. É importante ter validado com sucesso que cada evento foi recebido.
Para testar isso, você pode usar ferramentas como requestcatcher.com para confirmar que as notificações estão sendo enviadas corretamente.
Responda rapidamente com um código de status 2xx#
Para reconhecer a recepção do evento de notificação, seu endpoint deve retornar um código HTTP 2xx para a Pluggy. Se a Pluggy receber qualquer outro código de status, isso indicará que você não recebeu o evento.
Se a Pluggy não receber uma resposta bem-sucedida, a notificação do evento será tentada novamente. Após várias falhas ao enviar o evento, marcaremos a notificação como falhada e a notificação será perdida.
Como é muito importante confirmar a recepção do evento, seu endpoint deve retornar uma resposta de sucesso antes de realizar qualquer lógica de negócios que possa resultar em um erro.