Os Webhooks são uma excelente maneira de integrar sua plataforma Cursology com outros sistemas externos. Eles permitem que você receba notificações automáticas em tempo real sobre eventos específicos que acontecem em sua conta, sem a necessidade de fazer verificações manuais.
Neste artigo, vamos te ensinar como criar uma integração via Webhook personalizado na nossa plataforma, para que você possa automatizar processos e melhorar a interação entre sistemas.
Passo a Passo para Criar um Webhook Personalizado
1. Acesse a seção de Integrações
Primeiro, acesse sua conta na plataforma Cursology e vá até a área de Integrações. Você pode encontrá-la no menu de configurações, dentro da aba de Marketing.
2. Selecione a opção Webhook
Dentro da área de Integrações, clique em Nova Integração e, em seguida, selecione a opção Webhook.
3. Preenchendo os Dados da Nova Integração
Agora, você precisa preencher os dados da sua nova integração de Webhook.
Descrição: Informe uma descrição clara e objetiva para sua integração. Isso ajudará a identificar facilmente o propósito dessa integração no seu painel de gerenciamento.
URL: Insira a URL do seu sistema ou aplicação externa para a qual os dados do Webhook serão enviados. Essa URL precisa ser a do seu servidor de recepção de Webhook.
4. Configuração dos Headers (Cabeçalhos)
Os Headers são campos opcionais que você pode configurar para enviar informações adicionais junto com a solicitação de Webhook para o seu sistema. Você pode definir:
Chave: A chave identificadora para o header.
Valor: O valor correspondente à chave.
Esses cabeçalhos podem ser necessários para autenticação ou para fornecer dados adicionais ao seu sistema.
5. Seleção do Produto
Em seguida, você precisará selecionar o produto relacionado à integração do Webhook. Isso irá vincular a chamada do Webhook ao produto específico em sua plataforma.
6. Escolha os Eventos que Acionarão o Webhook
Agora, você deve selecionar os eventos que irão disparar o envio do Webhook. Cada evento que você escolher gerará uma notificação para a URL que você forneceu, informando sobre a ocorrência do evento.
Exemplos de eventos comuns podem incluir:
Compra realizada: Quando um comprador realizar uma compra.
Abandono de carrinho: Quando um visitante da página de checkout não finalizou o processo de compra.
7. Salve a Integração
Após preencher todos os campos obrigatórios, clique em Salvar para concluir a criação da sua integração via Webhook.
Você pode criar quantas configurações quiser, editá-las, desativá-las ou removê-las da lista. Para isso, basta selecionar o botão correspondente à ação na lateral direita da configuração
Como Funciona o Webhook?
Quando o evento que você configurou ocorrer na plataforma, a Cursology enviará automaticamente uma requisição HTTP POST para a URL que você especificou, contendo os dados relacionados ao evento. Essa requisição pode incluir informações como dados do aluno, valores da transação, e outros detalhes importantes.
Esse processo permite que o seu sistema externo reaja automaticamente a esses eventos, sem que você precise consultar a plataforma manualmente.
Consultando o Histórico de Eventos Enviados
Após criar a integração, você poderá consultar o histórico dos eventos enviados diretamente na plataforma. Isso permite que você tenha um controle detalhado sobre os dados que foram transmitidos ao seu sistema, facilitando a análise e o monitoramento da integração.
O histórico exibirá as requisições feitas e os status de cada evento, permitindo que você verifique se os dados estão sendo enviados corretamente e se algum erro ocorreu durante o processo.
Exemplo de Utilização
Vamos supor que você configure um Webhook para ser disparado sempre que um aluno realizar uma compra. Assim que o pagamento for confirmado na plataforma, a Cursology enviará uma notificação para a URL que você configurou, com todos os detalhes da transação, como o valor pago, nome do aluno e curso adquirido. Com isso, você pode integrar essa informação em seu sistema de CRM ou automatizar o envio de um e-mail de boas-vindas ao aluno.
Considerações Finais
Os Webhooks oferecem uma forma prática e eficiente de integrar a Cursology com outros sistemas, economizando tempo e garantindo que sua operação seja mais automatizada. Agora que você sabe como criar uma integração via Webhook, pode começar a otimizar o fluxo de dados entre a plataforma e outros sistemas.
Se precisar de mais ajuda ou tiver dúvidas sobre a configuração do Webhook, não hesite em entrar em contato com nosso suporte!