Webhook é uma forma de notificação de informações, enviadas quando um evento ocorre, ou seja, é uma forma de receber informações de um sistema passivamente.

O Omie fornece esse recurso e para trabalhar com ele você precisa ter um Endpoint, que é um endereço que receberá as notificações quando os eventos configurados no seu aplicativo Omie ocorrerem.

Se você ainda não possui um Endpoint próprio, existem diversas ferramentas disponíveis na internet para realização de testes.

Durante o exemplo apresentado neste artigo, iremos utilizar a ferramenta RequestBin.

Inicialmente, vamos configurar um endereço (URL) de um endpoint para realização do teste.

1) Acesse a página da ferramenta RequestBin e então, clique sobre a opção “Create Request Bin”, conforme destacado na imagem abaixo:

2) Realize o login no site:

3) Na próxima tela, será apresentado a URL do seu Endpoint de testes (1).

Para copiar o Endpoint, clique sobre o ícone de papel ao lado da URL (2), dessa forma não será preciso digitar o endereço do Endpoint no momento da configuração:

4) Agora que já temos o Endpoint criado, vamos ativar o Webhook. 🚀

1) Após realizar login no Omie, abra uma nova guia no seu navegador e clique no link abaixo para acessar a Área do Desenvolvedor:

2) Na tela inicial do Developer, clique na opção "Aplicativos":

3) Na tela seguinte, localize o aplicativo de interesse e clique sobre ele para expandir as informações sobre ele — como Webhooks configurados e credenciais:

4) Agora, clique na opção "⚙️ Adicionar novo webhook":

5) Cole a URL do Endpoint criado:

6) Em seguida, será exibido a listagem com os Webhooks disponíveis.

Basta ativar os Webhooks referentes as notificações que deseja receber (1) e, então, ao final da seleção, role até o final da página e clique em "Salvar" (2):

7) Após salvar as alterações, o Omie enviará uma notificação de teste para o RequestBin, onde poderemos confirmar que já está ocorrendo a comunicação entre os sistemas:

8) Podemos, então, iniciar o teste com o Webhook ativado.

1) Neste exemplo de teste, ativamos o Webhook "produto.alterado".

Então, vamos modificar uma informação de um Produto cadastrado no Omie (1) e salvar a alteração (2):

2) Em seguida, o Webhook sobre a atualização será disparado pelo aplicativo Omie, notificando o Endpoint de destino. Se você seguiu nosso passo a passo anterior, receberá o evento em seu Endpoint de testes.
​
Você conseguirá visualizar o evento, na página do Endpoint de teste configurado nos passos anteriores:

3) Ao seguir este artigo, você aprendeu a configurar, ativar e testar Webhooks no Omie.

Com essas informações, você está pronto para explorar e integrar Webhooks em seus próprios projetos, otimizando ainda mais suas operações! 🚀