Repolode
frain-dev

frain-dev/convoy

Gateway open source de webhooks que recebe, persiste, entrega e depura eventos, com novas tentativas, limitação de taxa e disjuntor.

Alternativa open source a:SvixHookdeck

Estrelas
2,889
Forks
188
Issues abertas
45
Último commit
há 3 dias

O que é?

Convoy é um gateway de webhooks que fica na borda da rede. Ele recebe webhooks de provedores terceirizados e os encaminha para serviços internos. Também transmite webhooks de sistemas internos para endpoints de clientes, evitando que os serviços internos fiquem expostos diretamente à internet pública.

Para fazer as entregas, o Convoy limita o tráfego por endpoint, tenta novamente as entregas com falha usando intervalos constantes ou exponenciais com jitter e oferece novas tentativas em lote para endpoints que falham repetidamente. Quando um endpoint falha várias vezes seguidas, o disjuntor é aberto e o endpoint é testado antes que o tráfego seja retomado. Também é possível desativar o endpoint e enviar uma notificação por e-mail, Slack ou Microsoft Teams. As assinaturas podem filtrar conteúdo, cabeçalhos, parâmetros de consulta e caminho, além de executar uma transformação em JavaScript antes da entrega.

O projeto é distribuído em componentes separados de servidor e agente, que podem ser escalados de forma independente. Ele também oferece um dashboard voltado para clientes, que pode ser incorporado via iframe, SDKs gerados para Go, Python, JavaScript, Ruby, PHP e Java, além de opções de implantação com Docker e Helm.

Recursos principais

  • 01Recebe e encaminha webhooks de provedores para serviços internos
  • 02Entrega webhooks com limitação de taxa por endpoint e novas tentativas configuráveis
  • 03Usa disjuntor para testar endpoints com falha antes de retomar o tráfego
  • 04Distribui um evento para vários endpoints com base no tipo ou no conteúdo do evento
  • 05Oferece suporte a assinatura de payload, bearer token, OAuth2 e mTLS para endpoints
  • 06Permite pesquisar eventos por metadados, payload JSON e chave de idempotência

Casos de uso

  • Encaminhar webhooks de provedores terceirizados para microsserviços internos sem expô-los publicamente
  • Entregar webhooks de um produto SaaS a endpoints de clientes, com novas tentativas e monitoramento
  • Oferecer aos clientes um dashboard de autoatendimento para depurar e reproduzir eventos de webhook

Início rápido

  1. 1

    Abra o guia de instalação do Docker no README

  2. 2

    Ou siga o guia de instalação do Kubernetes com Helm no README

Antes de usar

  • É licenciada sob a Elastic License v2.0, que disponibiliza o código-fonte, mas não é uma licença de código aberto reconhecida pela OSI e restringe sua oferta como serviço gerenciado.
  • A opção de fila do Postgres é experimental e requer uma licença.
  • A edição gratuita Community é limitada a um usuário, uma organização e dois projetos.

Em coleções

Tópicos

Perguntas frequentes

O que é convoy?
Gateway open source de webhooks que recebe, persiste, entrega e depura eventos, com novas tentativas, limitação de taxa e disjuntor. Convoy é um gateway de webhooks que fica na borda da rede. Ele recebe webhooks de provedores terceirizados e os encaminha para serviços internos. Também transmite webhooks de sistemas internos para endpoints de clientes, evitando que os serviços internos fiquem expostos diretamente à internet pública.
convoy é gratuito? Qual é a licença?
convoy é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
convoy ainda é mantido?
Manutenção ativa. O último commit de convoy foi em 5 de nov. de 2026.
Para que posso usar convoy?
Encaminhar webhooks de provedores terceirizados para microsserviços internos sem expô-los publicamente Entregar webhooks de um produto SaaS a endpoints de clientes, com novas tentativas e monitoramento Oferecer aos clientes um dashboard de autoatendimento para depurar e reproduzir eventos de webhook
Como instalar convoy?
Abra o guia de instalação do Docker no README Ou siga o guia de instalação do Kubernetes com Helm no README
Onde consigo convoy?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/frain-dev/convoy

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados