Dá. A comunidade consegue avisar um sistema seu toda vez que algo acontece dentro dela — alguém entrou, terminou um curso, resgatou uma recompensa, respondeu uma pergunta de acesso. É o que a plataforma chama de webhook de saída.
Antes de qualquer coisa: isso é diferente do . Se não estiver claro, leia Webhook de entrada e webhook de saída primeiro.
Quem pode usar
A tela aparece para todo mundo, mas só os podem criar, editar e reenviar. Nos outros planos ela abre em modo leitura, com os botões desligados.
Se você está num plano abaixo e precisa disso, o caminho é falar com o suporte sobre a mudança de plano — não há como destravar pela tela.
O que você precisa antes de começar
Uma URL que aceite receber dados. Isso quer dizer um endereço no seu servidor, na sua ferramenta de automação ou no serviço que você usa, preparado para receber os eventos. Se ninguém do seu time vai construir esse endereço, este recurso não resolve nada sozinho — ele não escreve em planilha nem manda e-mail por conta própria.
Como cadastrar
No painel, em Configurações → Webhooks, clique em Novo webhook:
- Nome — livre, só para você identificar depois. Se você tem mais de um destino, use nomes que digam para onde vai.
- URL — o endereço do seu sistema, começando com
https://. - Eventos — marque os que interessam. A lista está logo abaixo.
Salve. Você pode cadastrar vários webhooks na mesma comunidade, cada um com a sua URL e a sua seleção de eventos — útil quando um sistema só quer eventos financeiros e outro só quer eventos de conteúdo.
Os eventos disponíveis
A tela agrupa os eventos em seis blocos:
Perguntas de acesso — nova resposta a uma pergunta de acesso.
Conteúdos — novo comentário em aula, nova resposta a comentário, aula concluída, curso iniciado, curso finalizado, prova concluída (com acerto ou com erro), nova avaliação de aula, nova avaliação de curso.
Financeiro — aplicado, assinatura iniciada ou renovada, assinatura expirada.
Usuários — primeiro acesso de uma pessoa, novo acesso, saída de um membro, novo membro, nova publicação, publicação restringida pela moderação, novo comentário em publicação, nova resposta a comentário.
Recompensas — novo resgate, nova solicitação.
Eventos — participação confirmada em um evento da agenda.
Testar antes de confiar
A própria tela tem um teste de webhook: ela dispara um envio para a sua URL para você conferir se o seu lado recebeu e entendeu. Faça isso antes de marcar muitos eventos.
Quando algo falha
A tela guarda o histórico de disparos, com o resultado de cada envio, e mostra um gráfico com o resumo. Se o seu servidor estava fora do ar, você não perde os eventos: pode reenviar um por um, reenviar vários selecionados ou usar a opção de reenviar os que falharam.
Antes de reenviar manualmente, saiba que a Nichoos já tenta sozinha algumas vezes, com intervalo crescente, antes de marcar um envio como falho. Reenviar logo depois de uma queda momentânea costuma ser desnecessário.
Um cuidado do seu lado: reenvio significa que o seu sistema pode receber o mesmo evento mais de uma vez. Se o seu processamento cria alguma coisa (um contato, um pedido, uma linha), ele precisa aguentar repetição sem duplicar.
Só marque o que você vai usar
Eventos de acesso e de comentário disparam muito em comunidade ativa. Marcar tudo "por precaução" enche o seu histórico, dificulta achar o que importa e sobrecarrega o seu servidor à toa. Comece pelos dois ou três que você realmente vai processar e adicione depois.