Webhooks: Automação em Tempo Real

Os Webhooks são "avisos" automáticos que o seu Netshow.me Hub envia para outras ferramentas sempre que algo importante acontece. Enquanto a API espera você pedir uma informação, o Webhook "empurra" a informação para você no exato momento do evento.

Onde acessar

No menu lateral, vá em: Integrações > aba Integrações

Para criar: Clique em Adicionar Integração.
Para gerenciar: Clique no ícone de lápis (editar) ou lixo (excluir) nas integrações existentes.

Configurando a Integração

Ao clicar em adicionar, você encontrará três campos cruciais:

Nome: Identifique para onde os dados estão indo (Ex.: "Automação Make - Vendas").
URL da Integração: O endereço (endpoint) gerado pela sua ferramenta de automação (n8n, Make ou sistema próprio).
Secret (X-Secret): Uma chave de segurança que você cria. O sistema de destino deve validar essa chave para garantir que os dados vieram realmente da Netshow.me.

Eventos Disponíveis (Gatilhos)

Você deve ativar individualmente os eventos que deseja monitorar. Ao clicar no ícone <> no painel, você verá a estrutura de dados de cada um. Os principais eventos são:

Categoria	Evento (Trigger)	Descrição
Usuários	`user.created`	Dispara quando um novo usuário se cadastra.
Assinaturas	`subscription.created`	Dispara quando uma nova assinatura é realizada.
Assinaturas	`subscription.renewed`	Notifica sobre a renovação automática de um plano.
Assinaturas	`subscription.canceled`	Aviso imediato quando uma assinatura é cancelada.
Transações	`transaction.paid`	Confirmação de que um pagamento foi aprovado.
Transações	`transaction.refunded`	Notifica quando um estorno/reembolso é realizado.
Conteúdo	`post.published`	Dispara quando um novo conteúdo (vídeo/post) é publicado.

Exemplos Práticos: O que dá para fazer

Combinando esses eventos com ferramentas como n8n ou Make, você cria "Réguas de Comunicação" inteligentes:

Boas-vindas VIP: Evento subscription.created → Make → Envia mensagem personalizada no WhatsApp do cliente com o link de acesso.
Recuperação de Cancelamento: Evento subscription.canceled → n8n → Adiciona o usuário em uma lista de e-mails de "pesquisa de satisfação" ou oferece um cupom de desconto.
Notificação de Novidade: Evento post.published → Make → Envia uma notificação Push ou mensagem no Telegram para todos os membros de um grupo.
Gestão Financeira: Evento transaction.paid → n8n → Emite a nota fiscal automaticamente e registra a venda em uma planilha do Google Sheets.

Tutorial Rápido: Conectando no n8n / Make

Se você usa ferramentas de automação, o processo segue este padrão:

No n8n/Make: Crie um novo cenário e escolha o módulo "Webhook". Ele vai te dar uma URL exclusiva.
No Hub Netshow.me: Vá em Integrações > Integrações e cole essa URL no campo URL da Integração.
Configuração de Segurança: Crie uma senha no campo Secret no Hub. No n8n/Make, configure um filtro para só processar a requisição se o Header X-Secret for igual à senha que você criou.
Teste: Realize uma ação na plataforma (ex: um cadastro teste) e veja os dados chegando instantaneamente na sua ferramenta de automação.

Estrutura de Exemplo (JSON)

Quando um evento ocorre, sua ferramenta receberá algo assim:

{
"event": "subscription.created",
"happend_at": "2024-05-20 15:30:00",
"data": {
"customer": {
"name": "João Silva",
"email": "joao@email.com"
},
"plan": {
"title": "Plano Premium Anual",
"price": "499.00"
}
}
}

Documentação Completa de Eventos

Para consultar a lista de todos os eventos disponíveis (usuários, planos, pagamentos e conteúdos) e suas respectivas estruturas técnicas, acesse o documento oficial através do link abaixo:

Lista de Eventos e Estrutura de Webhooks - Netshow.me

Para dúvidas adicionais ou apoio, entre em contato com o Suporte pelo WhatsApp:

📱 +55 11 4858-9359
ou Clique aqui