Os webhooks são uma óptima forma de transmitir informações de forma automatizada. Eles podem ajudar na sua marketing e permitem-lhe criar novos canais de comunicação. Vamos discutir como pode implementá-los em várias ferramentas e funções e também porque é que precisa deles.

Mas primeiro: se está a tentar melhorar as capacidades de marketing das suas aplicações existentes, nós podemos ajudá-lo. Já ajudámos inúmeros clientes a atualizar as suas comunicações de marketing. Consulte os nossos serviços e estudos de caso e ver se podemos oferecer-lhe algo de que necessita.

O que é um webhook?

Os webhooks são mensagens automatizadas que permitem a comunicação direta de aplicações com base em parâmetros pré-determinados. Estes parâmetros podem ser definidos com determinadas acções realizadas por um utilizador. Estas acções executam uma função de retorno de chamada baseada em HTTP, criando uma comunicação entre 2 APIs. Os clientes que receberem o webhook receberão instantaneamente algum tipo de notificação ou alerta.

Esta é uma forma alternativa de enviar informações quando um participante (um cliente, por exemplo) se envolve numa determinada ação. Por exemplo, pode utilizar um webhook para enviar dados para as suas notificações noutras plataformas, como o Slack, para obter dados de eventos mensuráveis.

Então, o que é um webhook versus um API? Os Webhooks são semelhantes às APIs (Application Programming Interface - Interface de Programação de Aplicações), mas recuperam dados em vez de os consultar (como no polling). As APIs utilizam HTTP para obter dados e definir estruturas de resposta. Neste processo de polling, um pedido HTTP é enviado em intervalos regulares até que a API do servidor envie os dados relevantes. Com os hooks, a API cliente fornece um URL único à API do servidor, especificando quais os eventos a registar.

A diferença entre os dois é que os webhooks dispensam a necessidade de sondagem e automatizam a transferência de dados. Também são óptimos para cargas úteis leves e específicas. Além disso, podem oferecer maior flexibilidade, eficiência e processamento de dados em tempo real.

Assim, se vir um ícone de webhook numa aplicação à sua escolha, deve testá-lo para os seus processos de marketing.

Porque é que os deve usar para o marketing?

Os ganchos podem ser implementados numa vasta gama de ferramentas de marketing. Abordaremos a forma de o fazer mais adiante, mas, por agora, é necessário compreendê-los como um meio de acompanhar e automatizar os objectivos de marketing.

É claro que é preciso ter cuidado com estas ferramentas, pois pode criar uma má experiência para o utilizador se for feita de forma incorrecta. O spam de webhook pode ser um incómodo para os clientes.

Como criar um Webhook

A configuração de um hook pode ser diferente para cada plataforma e é por isso que nos vamos concentrar em alguns passos comuns que surgem em vários procedimentos. O processo genérico para criar um webhook é o seguinte.

• Identificar o evento: Certifique-se de que sabe para onde está a conduzir o seu cliente e como o medir.
• Verifique a sua plataforma: Se a sua plataforma não tiver um sistema de webhook incorporado, poderá precisar de um fornecedor.
• Escolher um fornecedor: Existem fornecedores terceiros que pode utilizar se a plataforma escolhida não tiver um sistema incorporado.
• Configurar o endereço do recetor: Parte disto é decidir o URL do ponto final para o remetente do webhook. Este pode ser um endereço no seu servidor ou um URL de terceiros.
• Definir medidas de segurança: Certifique-se de que o servidor é seguro antes de o configurar.
• Detalhes da carga útil: É aqui que decide quais os dados que o hook vai enviar. Isto pode decidir a qualidade da informação que irá receber, por isso tenha cuidado ao definir os parâmetros.
• Julgamento: Enviar dados de teste para verificar se o gancho está a funcionar como pretendido.
• Monitorização e correção de erros: Nesta fase, deve implementar um mecanismo de repetição no caso de o primeiro processamento falhar, para que possa voltar a ser ativado. É importante testar frequentemente as aplicações de webhook.
• Otimização: Execute os testes e veja o que pode ser melhorado. Deve também proteger os seus dados com um SSL e limitar o tamanho da carga útil para garantir um funcionamento ótimo.

Como criar um URL de webhook

A forma de criar um webhook pode variar consoante a plataforma que está a utilizar. Os mais comuns são os webhooks do Slack e do Github, portanto, começaremos com eles.

Para obter um Webhook do Slack URL tem de criar uma aplicação Slack para utilização na área restrita, ativar os ganchos de entrada, aceder às definições e clicar em Adicionar novo Webhook ao espaço de trabalho, e agora pode fazer um pedido de publicação HTTP. É possível inserir uma mensagem em texto como no exemplo abaixo:

Em seguida, é possível instalar a formatação avançada para componentes mais elaborados. Existem vários kits que o Slack fornece e que devem ser consultados.

Para GitHubPara aceder à página principal do sítio Web, navegue até à página principal do sítio Web e, no repositório, selecione Definições. Clique em "Definições", que é realçado por um contorno laranja escuro, e selecione Webhooks. Pode Adicionar um gancho e, em seguida, em "URL de carga útil", introduza o URL do qual gostaria de receber cargas úteis. Agora, application/json atuará diretamente como a carga JSON e adicionará o corpo da solicitação POST.

application/x-www-form-urlencoded enviará o payload JSON como um parâmetro de formulário chamado payload.
Opcionalmente, em "Secret", introduza uma cadeia de caracteres para utilizar como chave secreta. Deve escolher uma cadeia de texto aleatória com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações de entrada apenas àquelas originárias de GitHub.

Vá a "Que eventos gostaria de ativar este webhook?" e selecione os eventos que pretende. Agora você pode tornar os ganchos que deseja "ativos" imediatamente. Depois de o criar, o GitHub envia um evento de ping para o testar.

Aplicações de marketing com capacidades de gancho

A Webhook do Discord pode ajudá-lo a enviar mensagens para a sua comunidade com facilidade. Pode ser ótimo para manter a sua comunidade informada ou actualizada através do seu servidor Discord. Pode fazê-lo através de aplicações de terceiros como o gitlab:

• Selecione o seu canal Discord.
• Selecione Editar canal.
• Verifique as suas integrações.
• Crie um Webhook ou selecione "Ver Webhooks" e, em seguida, escolha Novo Webhook.
• Crie um bot que irá publicar a mensagem.
• Agora é possível copiar o URL de um campo de URL do WEBHOOK.
• Selecione Guardar.

Veja como criar um webhook da Shopify:

• Aceda ao painel de administração da Shopify.
• Selecione "Definições".
• Aceder a "Notificações".
• Localize a secção "Webhooks".
• Clique em "Criar um Webhook".
• Defina um evento que accionará o webhook. Pode encontrá-lo no menu pendente.
• Insira uma URL para a qual a Shopify enviará o webhook.

Para criar um webhook do Mailchimp:

• Tem de ir para Webhooks.
• Selecione "Adicionar um Webhook".
• Determine os eventos que pretende ouvir na secção "Acionar eventos".
• Vá para o campo "Publicar no URL".
• Defina um URL de retorno de chamada que a sua aplicação pode utilizar para aceitar o gancho de entrada.
• Defina uma descrição se quiser.
• Clique em Criar Webhook.