Webhooks da Greenn: eventos e como configurar

Webhook é a forma mais direta de ligar a sua venda na Greenn a qualquer outro sistema: em vez de você consultar o painel de tempos em tempos, a Greenn avisa sozinha, no instante em que algo acontece. Hoje a documentação pública da Greenn lista um conjunto amplo de gatilhos de webhook, dos eventos de venda e assinatura ao checkout abandonado e ao novo aviso de reclamação aberta, e a Greenn oferece API aberta na mesma conta. Este guia explica o conceito em linguagem simples, os eventos disponíveis, para que servem na prática e como configurar.

O que é um webhook, sem jargão

Pense em duas formas de saber se algo aconteceu. Na primeira, você fica perguntando de tempos em tempos: "já mudou? já mudou?". Na segunda, alguém te liga assim que muda. Webhook é a segunda forma: um aviso automático que um sistema (a Greenn) envia para outro sistema (o seu) no momento exato em que um evento específico acontece numa venda.

Tecnicamente, o webhook é uma notificação enviada para um endereço de internet que você configura, o endereço da sua integração. Você não precisa entender o protocolo por trás para usar: o que importa é escolher o gatilho certo e apontar para onde o aviso deve chegar.

Webhook é a Greenn avisando o seu sistema na hora, em vez de o seu sistema ficar perguntando de tempos em tempos se algo mudou.

Os eventos que a Greenn confirma hoje

A documentação pública de webhooks e API da Greenn agrupa os eventos por área. Do lado da venda: venda paga, aguardando pagamento, venda recusada (com o motivo), venda não paga, reembolso e chargeback. Do lado da assinatura: paga, em período de teste, pagamento pendente, não paga, cancelada e encerrada. Fora dessas duas famílias: checkout abandonado, com a etapa em que a pessoa parou, e o mais novo, reclamação aberta.

• Reclamação aberta (novo, desde 14 de setembro de 2026): no momento em que o comprador abre uma reclamação no produto, a sua integração recebe o aviso, antes mesmo de qualquer reembolso acontecer. Antes dessa novidade, o webhook só avisava quando a reclamação já tinha terminado, com o reembolso ou o chargeback confirmado, ponto em que não havia mais o que fazer para reverter a situação.
• Reembolso e chargeback: os avisos que já existiam antes dessa novidade continuam disponíveis, e cobrem o desfecho de uma reclamação, não só a abertura dela.

Para o formato de cada evento, com os campos que vêm no aviso e exemplos completos, a documentação pública de webhooks e API da Greenn é a referência oficial.

Por que o gatilho de reclamação aberta muda o jogo

Antes desse gatilho, o webhook só avisava depois que o reembolso já tinha acontecido, ponto em que não havia mais o que fazer para reverter a situação. Agora, o aviso chega no momento em que o comprador abre a reclamação, criando uma janela para agir antes do reembolso se concretizar.

Essa janela importa porque o produtor tem um prazo curto para se posicionar numa reclamação: o guia de reembolso de produto digital detalha que, segundo a Política de Serviços Financeiros da Greenn, você tem 3 dias corridos para responder a uma reclamação aberta antes de a Greenn agir para proteger o comprador, reembolsando o valor. Um aviso automático assim que a reclamação abre ajuda a não perder esse prazo por falta de atenção ao painel.

Casos de uso: o que fazer com o aviso

Um webhook sozinho não resolve nada, ele só avisa. O valor aparece no que você conecta do outro lado. Alguns usos possíveis com os eventos disponíveis:

• Alertar o suporte em tempo real. Ligar o webhook de reclamação aberta a um canal interno (chat da equipe, sistema de tickets) para que alguém entre em contato com o comprador antes do prazo de resposta vencer, em vez de descobrir a reclamação só ao abrir o painel.
• Registrar o evento num sistema próprio. Guardar cada venda paga ou cada reembolso numa planilha ou banco de dados próprio, para acompanhar o histórico sem depender de exportar relatório manualmente.
• Disparar uma automação de atendimento. Iniciar um fluxo de mensagem (por exemplo, perguntar ao comprador o motivo da reclamação) assim que ela abre, ganhando tempo de resposta.

Como configurar um webhook na Greenn

O caminho descrito na própria notícia da Greenn é direto:

1. Abra a configuração de webhooks do produto.
2. Escolha o gatilho desejado, como o de reclamação aberta.
3. Aponte para o endereço da sua integração, o sistema que vai receber o aviso.

Para o formato do payload e exemplos completos de cada evento, a documentação pública de webhooks e API da Greenn é o ponto de partida. Para autenticação e política de reentrega específicas da sua integração, o suporte da Greenn orienta caso a caso; vale confirmar com eles antes de colocar uma automação crítica no ar.

Webhook, API aberta e integrações prontas: quando usar cada um

Nem toda conexão exige webhook. A Greenn já mantém integração nativa com ActiveCampaign e Notazz, que cobre o caso comum sem nenhuma configuração de webhook. Além disso, a Greenn oferece API aberta para consultar e enviar dados sob demanda, e webhooks para receber avisos automáticos de evento. Os três caminhos, integração nativa, API aberta e webhooks, fazem parte da mesma conta que você já usa para vender.

Na prática, a escolha costuma seguir esta lógica:

Webhook é infraestrutura, não decoração

Um webhook bem configurado não aparece para o comprador, mas evita perda silenciosa: reclamação que vence o prazo sem resposta, reembolso que ninguém registrou em lugar nenhum, automação que só roda se alguém lembrar de checar o painel. Para quem já integra a Greenn a um CRM, um sistema de atendimento ou uma planilha própria, vale revisar hoje quais gatilhos você já usa e se o novo aviso de reclamação aberta fecha uma lacuna que hoje depende de alguém olhar o painel na hora certa.

A diferença entre saber de uma reclamação em 5 minutos ou em 2 dias é, muitas vezes, a diferença entre resolver e perder o prazo de resposta.

Se o seu maior ponto de atenção hoje é reduzir o volume de reembolso e reclamação, não só reagir mais rápido a eles, o guia reembolso de produto digital cobre prazo legal, política e como reduzir a taxa sem ferir o direito do cliente. E para entender onde a entrega ao aluno entra nesse fluxo, o guia da área de membros e Greenn Club mostra o outro lado da mesma operação.