Como Utilizar o Enviar Webhook

Introdução

Um webhook é um método para um aplicativo fornecer informações em tempo real a outros aplicativos. Ele funciona como uma notificação automática enviada de um sistema para outro sempre que um evento específico ocorre. Na Reportana, o bloco Enviar Webhook permite que sua automação envie dados para outros sistemas, facilitando a criação de experiências personalizadas e fluxos de trabalho complexos.

Utilidade

1. O bloco Enviar Webhook serve para integrar a Reportana com qualquer outro sistema que possua suporte a webhooks, como plataformas de e-commerce, de checkout, de pagamento, ERPs e outras plataformas.

2. Essa funcionalidade permite:

   • Envio de Dados para Sistemas Externos: Inicie comunicações com plataformas externas (e-commerce, ERPs, CRMs etc.) por meio de URLs de webhook ou APIs, notificando eventos ocorridos na automação.
   • Realização de Requisições HTTP: Suporta métodos como POST e GET, viabilizando integrações com serviços online.
   • Captura e Utilize Respostas: Armazena as respostas das APIs (ex: em JSON) em variáveis internas (como "payload.response_json"), possibilitando uso posterior para personalização e construção de lógicas avançadas nos fluxos automatizados.

Como Funciona

1. O bloco Enviar Webhook é uma funcionalidade avançada e está disponível exclusivamente para os clientes do plano Enterprise+ da Reportana. Para acessá-lo vá em Marketing > Automações e clique em +Criar.

2. Em seguida, selecione o gatilho a ser utilizado na sua automação, neste exemplo usaremos o gatilho Pedido Criado.

3. No editor de automações, arraste e solte o bloco Enviar Webhook para o fluxo da sua automação.

4. Ao clicar para editar o bloco, você precisará definir a URL do sistema externo que receberá os dados.

5. Selecione o método de requisição HTTP desejado, como POST, por exemplo. O método POST é comumente usado para enviar dados para criação ou atualização de recursos em um sistema externo.

6. Você pode configurar o bloco Enviar Webhook para armazenar a resposta recebida do sistema externo em uma variável específica, como payload.response_json. Essa resposta pode então ser utilizada nas etapas subsequentes da automação, por exemplo, para informar o cliente sobre o resultado da requisição.

7. Após configurar o bloco, conecte-o ao restante do seu fluxo de automação, as saídas disponíveis são:

   • Próxima Etapa: seguirá pelo fluxo independente da ação que ocorrer no bloco.
   • Sucesso: seguirá apenas se o envio do webook retornar sucesso.
   • Erro: seguirá apenas se o envio do webhook retornar erro

8. Quando estiver tudo configurado, salve a automação e realize a ativação.

Como Testar o Bloco

1. Para garantir que o bloco Enviar Webhook está enviando os dados corretamente, é altamente recomendável realizar testes. Uma ferramenta útil para isso é o webhook.site.

2. Vá para o site https://webhook.site/ e copie a URL exclusiva que ele gera ("Your unique URL").

3. Na sua automação da Reportana, cole essa URL no campo "URL" do bloco "Enviar Webhook" e selecione o método POST.

4. Utilize o ambiente de testes da Reportana (dentro da automação) para disparar o evento que aciona a automação.

5. Volte para o webhook.site. Você verá em tempo real toda a estrutura dos dados enviados pela Reportana, permitindo verificar se as informações estão corretas e no formato esperado.