Como criar integrações com sites usando o método webhooks

Como criar integrações com sites usando o método webhooks
6/7/2022
·
3 min. leitura

Embora a Albato tenha centenas de integrações nativas na sua plataforma, existem outros serviços dos quais podemos nos conectar usando o método de webhook. Muitos serviços já oferecem esse recurso que dado uma determinada atividade/ação no site de origem ele envia os dados para um serviço de destino, como por exemplo a Albato.

Antes de criar a integração, precisamos criar a credencial de webhook e no nosso exemplo vou conectar ao serviço Mailchimp e ele posteriormente será usado como origem das informações na nossa integração.

Vá para a tela principal da Albato e no menu superior clique em “Apps"

Clique em “Conectar App”

todos app.png

Escolha o serviço “webhook” e clique em adicionar credencial na parte inferior da janela
Captura de Tela 2022-11-04 às 12.45.49.png

Agora, vai ser super importante você dar um nome significativo, isto é capaz de diferenciar entre as credenciais de webhook, eu costumo a adicionar um traço e o nome do serviço, como na figura abaixo e depois clique em próximo (na sua grande maioria das vezes os campos “Webook Parameters” e “Headers” ficam em branco, siga as instruções da plataforma de origem)

Captura de Tela 2022-11-04 às 12.46.43.png

Agora que sua credencial foi criada, precisamos copiar a url única, que é assim que o serviço que envia, no nosso caso Mailchimp, vai conseguir enviar os dados. Além disso, clique no botão de receber um webhook.

Captura de Tela 2022-11-04 às 12.48.13.png

Clique no botão, “Aguardar o webhook” note que o botão muda de aparência quando estiver “escutando” e esperando pelo envio dos dados.

Captura de Tela 2022-11-04 às 12.48.43.png

Em seguida, vá no serviço de origem e vamos preencher a URL no campo de integração. Embora diferentes serviços essa configuração possa usar outros termos, o princípio é o mesmo. No Mailchim, vá em “All contacts” e em “Settings” e clique para ver o dropdown, nele selecione “webhooks”

Captura de Tela 2022-11-04 às 13.11.47.png

Clique no botão “Create New Webhook”

Captura de Tela 2022-11-04 às 13.13.07.png

E em seguida, cole a URL única da sua credencial da Albato que você copiou no campo “Callback URL” e selecione as ações que vão causas o disparo, no nosso exemplo quando um email for inscrito na lista ele dispara a informação para a Albato. Não esqueça de clicar no botão de salvar.

Captura de Tela 2022-11-04 às 13.14.54.png

Agora, vamos criar ou atualizar um contato, para que a informação seja disparada e o Apanhador de Webhook que está aguardando o envio dos dados possa apreender quais serão os campos disponíveis para você usar nas suas integrações nessa conexão de webhooks. Lembre que o status deve ser de inscrito, pois foi essa a opção que selecionamos na configuração do envio de webhook no Mailchimp.

Voltando ao site da Albato, em breve você vê o resultado do aprendizado, todos os campos na figura estarão disponíveis para suas integrações.

Captura de Tela 2022-11-04 às 13.15.45.png

Pronto, a credencial estando configurada, agora você pode criar uma integração, usando a origem a credencial de webhook do Mailchimp que criamos e você pode por exemplo enviar para um planilha google sheets todos os inscritos.

Vamos lá, crie uma nova integração. Escolha a opção “Novo”:

todos1.png

Selecione o serviço, o evento “incoming webhook” e a credencial de webhook que acabamos de criar.

Captura de Tela 2022-11-04 às 13.16.45.png

Em seguida, selecione o serviço para onde vai enviar os dados, google sheets com a ação “New sheet row” a sua credencial, a planilha (spreadsheet) e a aba da planilha. Clique em próximo.

Captura de Tela 2022-11-04 às 13.20.03.png

Mapeie os campos do Mailchimp (webhook) para as colunas da planilha, ao terminar clique em próximo no final do popup.

Captura de Tela 2022-11-04 às 13.37.35.png

Agora selecione se quer verificação ou não de duplicatas e clique em próximo

Captura de Tela 2022-11-04 às 13.21.11.png

Pronto, sua integração foi criada. Clique no botão executar e agora quando um email for inscrito na lista do Mailchimp, os dados mapeados serão preenchidos automaticamente na planilha que você escolheu.

Captura de Tela 2022-11-04 às 13.21.31.png