Ir para conteúdo principal

Webhooks Personalizados

Como enviar notificações do seu Conexa para outros softwares.

Victor Munduruca avatar
Escrito por Victor Munduruca
Atualizado há mais de 2 semanas

🔗 Conexão com Outros Softwares: Como Funciona no Conexa

Este artigo aborda aspectos técnicos sobre a integração personalizada do Conexa com outros sistemas. Se você ainda está se familiarizando com o conceito de Webhooks, recomendamos começar por este artigo introdutório.

📡 O que é uma Conexão Personalizada?

A conexão personalizada permite que o Conexa envie dados automaticamente em um formato específico para outro software. Para isso, existem duas formas principais de integração:

  1. Desenvolver sua própria aplicação
    É necessário que um desenvolvedor crie um sistema capaz de receber os dados enviados pelo Conexa e executar ações com base nessas informações.

  2. Utilizar plataformas de automação
    É possível integrar com ferramentas como Zapier, Pluga ou qualquer outro sistema que consiga interpretar os dados recebidos via webhook.

🌐 Informando o Endpoint (URL)

Independentemente da opção escolhida, o Conexa precisa saber para onde enviar os dados. Isso é feito informando a URL (endpoint) da aplicação que receberá os dados gerados pelos eventos no sistema.

🧭 Passo a Passo no Conexa

Com a URL do sistema de destino em mãos, siga os passos abaixo para configurar a conexão no Conexa:

1️⃣ Acesse a tela de Webhooks

No menu lateral, vá até:
Configurações > Integrações > Webhooks

2️⃣ Crie uma nova conexão personalizada

Clique em Nova Conexão e, na lista de opções, selecione "Personalizado".

A partir daí, você poderá configurar o endpoint e os eventos que deseja monitorar.

3️⃣ Configurando a Conexão.

Nesta etapa, recomendamos criar um nome descritivo, relacionado ao que irá ativar o envio das informações e o nome da aplicação que você quer conectar.

No campo "URL", cole o endereço do endpoint que você quer enviar os dados.

Por último, em "Evento", você pode configurar o que irá servir como gatilho para a automação.

🎉 Parabéns!

A automação já está rodando e toda vez que o evento que você configurou acontecer dentro do Conexa, a URL configurada será notificada com os dados relevantes.

Os webhooks podem levar até 5 minutos para serem acionados a partir de que o evento ocorra

📚 Documentação Técnica

Quer saber exatamente quais eventos podem ser integrados e como os dados são enviados pelo Conexa?

Acesse a documentação oficial no link abaixo para consultar a lista completa de eventos disponíveis, os formatos de payload e os detalhes técnicos da integração via Webhooks:

Isto respondeu à sua pergunta?