Reaja aos eventos do provedor
As integrações não apenas permitem que seu aplicativo alcance um serviço, mas também permitem que seu aplicativo reaja quando algo acontece nesse serviço. Uma nova mensagem chega no Slack, uma issue é aberta no GitHub, um formulário é enviado no Calendly — e seu aplicativo responde automaticamente. Esta página explica a ideia e como você a configura.
O que é um gatilho de evento
Um gatilho de evento conecta algo que acontece em um serviço externo a algo que seu aplicativo faz em resposta. Você escolhe o evento de seu interesse e o que deve acontecer quando ele disparar.
Alguns exemplos do que você pode construir:
- Uma nova issue do GitHub é aberta → seu aplicativo registra e notifica sua equipe.
- Uma mensagem é postada em um canal do Slack → seu aplicativo mostra isso em um dashboard ao vivo.
- Uma reunião do Calendly é agendada → seu aplicativo atualiza o cadastro do cliente.
Você não precisa fazer polling de mudanças nem escrever nenhuma infraestrutura. Você descreve o evento e a resposta, e Kliv escuta o evento e executa sua resposta quando ele acontece.
O que pode responder a um evento
Quando um evento é acionado, você pode fazer uma destas duas coisas:
- Executar lógica personalizada no lado do servidor. O evento pode acionar uma edge function — um pequeno pedaço de lógica de bastidores que faz tudo o que você precisa, como salvar um registro, chamar outra integração ou enviar um e-mail. Você descreve o que deveria fazer; a IA escreve.
- Atualize seu aplicativo ao vivo. O evento pode ser transmitido diretamente para seu aplicativo para que seus visitantes vejam atualizações em tempo real — útil para feeds ao vivo, painéis e visualizações de atividades.
Uma resposta que executa lógica personalizada também pode reagir por meio de suas integrações — por exemplo, reagir a uma nova issue do GitHub postando um resumo no Slack. Para que isso funcione, a ação utilizada deve ser permitida para eventos; veja Controlar quem pode usar um conector.
Como configurar
Você configura os gatilhos de eventos em Configurações → Integrações — abra a integração, depois a conta conectada, que lista os eventos que ela pode escutar. Para cada acionador que você escolher:
- o evento a ser ouvido e
- a resposta — execute lógica personalizada ou transmita para seu aplicativo.
Uma vez salvo, Kliv observa o evento e executa sua resposta cada vez que ele ocorre.
Bom saber
- A entrega é confiável. Kliv tem como objetivo entregar cada evento pelo menos uma vez e tenta novamente se sua resposta não for bem-sucedida na primeira vez, para que um soluço momentâneo não perca o evento.
- Os eventos contam para o seu uso. Reagir aos eventos recebidos consome o uso da sua conta.
Relacionado
- Estendendo seu aplicativo com edge functions — o que a lógica personalizada do lado do servidor pode fazer.
- Controlar quem pode usar um conector — permite que um evento utilize as ações de uma integração.
- O que você pode conectar — as integrações disponíveis.