Como Usar o Webhook da Albato

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.

Caso queira saber mais detalhes sobre como funciona um Webhook, recomendo a leitura do nosso artigo completo sobre o tema aqui.

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 uma automação que utilize esse método, precisamos criar a credencial de webhook. No nosso exemplo, vamos conectar ao serviço Mailchimp, porém dessa vez, usando o método de webhook ao contrário da conexão padrão.

Criando a conexão com o Webhook na Albato

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

Clique em Conectar App.

Escolha o serviço “webhook” e clique em adicionar credencial na parte inferior da janela.

Agora, adicione um nome único no campo referente que te ajude a encontrar essa conexão futuramente. Na Albato, é possível criar múltiplas conexões com Webhook para diferentes apps, por isso, um nome personalizado será muito útil aqui.

Recomendamos adicionar um traço e o nome do serviço, como na figura abaixo, e depois clique em próximo (na grande maioria das vezes, os campos Webhook Parameters e Headers ficam em branco, siga as instruções da plataforma de origem).

Agora que sua credencial foi criada, precisamos copiar a URL única gerada. É assim que o serviço externo, no nosso caso o Mailchimp, vai conseguir enviar os dados.

Logo que copiar o Webhook (URL), clique no botão de receber um webhook.

Em seguida, clique no botão, Aguardar o webhook.

Note que o botão muda de aparência quando estiver esperando pelo envio dos dados.

Em seguida, no serviço de origem (nesse caso o Mailchimp) vamos inserir a URL no campo de integração. Este ajuste irá variar entre cada aplicativo, caso tenha dúvidas, recomendamos conferir diretamente com o suporte deles sobre onde deve ser inserido o Webhook.

No Mailchimp, vá em All contacts e em Settings, logo clique para ver mais detalhes. Entre as opções, selecione webhooks.

Clique no botão Create New Webhook.

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 causar 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.

Agora, vamos criar ou atualizar um contato, para que a informação seja disparada e o Detector de Webhook que está aguardando o envio dos dados possa identificar quais serão os campos disponíveis para você usar nas suas integrações nessa conexão de webhooks.

Lembre-se 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, imediatamente (caso tenha mantido a página que recomendamos de espera de Webhook aberta) você verá o resultado e os campos detectados.

Exemplo.

Não recebi algum campo específico

Caso você não tenha recebido algum dos campos esperados, ou seja, o nome do campo não apareceu na listagem do Webhook, existem algumas possibilidades:

1. O aplicativo externo não envia essa informação por questões de segurança ou limitações.

2. O aplicativo externo não envia essa informação por padrão, mas podemos forçar a solicitação.

3. O campo não estava preenchido no exemplo de teste.

Nestes casos, o primeiro passo é descartar a terceira opção.

Verifique se, no exemplo que você enviou, o campo que esperava ver na Albato estava efetivamente preenchido e com valores válidos no aplicativo externo.

Caso não esteja, basta realizar um novo teste preenchendo corretamente esse campo.

Se você já validou que o campo estava preenchido, então vamos descartar a primeira opção forçando o pedido do campo.

Para isso:

Clique em Fechar na Albato.

Na seção Parâmetros do Webhook, insira os nomes dos campos que deseja receber, um por linha, exatamente como aparecem no aplicativo externo.

Exemplo:

Atenção ao formato dos campos

É muito importante se atentar ao formato dos campos no aplicativo externo, pois isso ajudará na configuração correta da etapa.

Normalmente, o próprio aplicativo informa o tipo do campo. Na maioria dos casos, eles serão:

• string;
• integer;
• number.

Esses são campos simples. Nesse caso, apenas adicionar o nome do campo, como no exemplo acima, será suficiente.

Campos em formato de array

Agora, se estivermos falando de campos em formato de array (string array ou object array), a situação muda um pouco.

Esses campos representam conjuntos de informações agrupadas.

Exemplo:

Suponha que no aplicativo externo exista um campo chamado endereco.

Dentro dele, há subcampos como:

• rua;
• cidade;
• número;
• CEP.

O payload seria dessa maneira:

{ "endereco": { "rua": "Av. Paulista", "numero": "1000", "cidade": "São Paulo", "cep": "01310-100" } }

Se você adicionar apenas o nome do campo endereco, não terá acesso direto aos dados internos desse agrupamento.

Nesse caso, é necessário definir o caminho completo do campo, da seguinte forma:

• endereco.cidade;
• endereco.rua.

Essa sintaxe está correta para objetos ou arrays simples.

Importante: essa abordagem funciona apenas para arrays/objetos simples.

Como ficaria na Albato

Na Albato, os campos devem ser configurados exatamente dessa maneira, respeitando o nome do campo principal e o nome do atributo interno, separados por ponto (.).

Após configurar essas etapas:

1. Salve a automação.

2. Clique novamente em Aguardar Webhook.

3. Faça o teste mais uma vez, disparando novamente a ação no aplicativo externo.

Se agora os campos desejados aparecerem, significa que a configuração funcionou corretamente.

Caso ainda não apareçam:

• Verifique se os nomes dos campos estão exatamente iguais aos do aplicativo externo.

• Confirme também o formato correto, especialmente no caso de arrays.

Se não tiver certeza sobre o nome do campo ou seu formato, o suporte do aplicativo externo também poderá ajudar nesse ponto.

Se, mesmo após todos esses testes, os dados ainda não aparecerem na Albato, é bem provável que o aplicativo externo realmente bloqueie o envio dessas informações, seja por limitações técnicas ou por questões de segurança.

Além disso, é importante destacar que arrays aninhados (arrays dentro de outros arrays) não são suportados pela Albato. Esse tipo de campo não pode ser processado e, infelizmente, não é possível acessar esses dados.

Criando sua automação

Pronto, a credencial estando configurada, agora você pode criar uma automação, usando este webhook do Mailchimp que criamos, e, por exemplo, enviar para uma planilha Google Sheets todos os inscritos.

Caso queira reproduzir este exemplo, basta seguir as orientações a seguir.

Lembrando que o mesmo se aplica para outros apps externos, uma vez configurado o Webhook, o uso na Albato será semelhante.

Para iniciar, crie uma nova automação:

Selecione como gatilho **Webhook, **o evento como “incoming webhook” e a credencial de webhook que acabamos de criar.

Em seguida, selecione o app para onde vai enviar os dados. Neste exemplo, vamos usar o Google Sheets com a ação Criar/Atualizar uma Linha:

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

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

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.

Agora você pode conectar qualquer serviço à Albato usando webhooks. Se tiver alguma dúvida, entre em contato com nosso suporte pelo chat.