Sobre os webhooks

No marketing, ele ajuda a coordenar suas campanhas de marketing com outras ações em seu site e outros canais, como mensagens de texto e mala direta. Os webhooks são uma maneira de sincronizar a atividade do Mailchimp com aplicativos de terceiros.

Neste artigo, veremos como você pode criar um webhook no aplicativo Mailchimp.

Antes de começar

• Para usar webhooks, você deve estar no plano Standard ou Premium. Se estiver no plano Essentials ou Free, os usuários podem configurar o webhook e ver o recurso, mas serão solicitados a atualizar antes de ativar o ponto de jornada. Para alterar o tipo de plano, visite a página de planos em sua conta.
• Recomendamos webhooks para usuários familiarizados com a codificação personalizada. Se precisar de ajuda, entre em contato com o desenvolvedor ou contrate um Especialista em Mailchimp.
• Este artigo explica como adicionar webhooks no Mailchimp. Para saber mais sobre como trabalhar com webhooks, confira nosso guia de início rápido de webhooks.

Como funciona

Quando um contato executa uma ação específica no Mailchimp, como alcançar um determinado ponto em uma Jornada do Cliente ou atualizar um perfil, um webhook aciona um evento em um aplicativo de terceiros. O webhook envia uma solicitação HTTP para uma URL com instruções e detalhes sobre o evento. O aplicativo ou integração que monitora essa URL envia uma mensagem de texto para o contato ou executa alguma outra ação em um aplicativo de terceiros.

Definições

Veja alguns termos que você encontrará ao trabalhar com webhooks no Mailchimp.

• Webhooks
  Um webhook é uma solicitação HTTP que permite que um aplicativo envie informações para outro.

• Cabeçalhos
  Os cabeçalhos descrevem algo sobre a solicitação. Eles podem incluir quaisquer informações que o aplicativo receptor precisa ter para processar a solicitação. Muitos aplicativos pedem que os cabeçalhos contenham um tipo de chave ("Key") e um valor de chave ("Value").

• Tipo de conteúdo
  A opção de tipo de conteúdo permite escolher a linguagem de programação para o corpo da solicitação. Atualmente, o editor aceita apenas JSON e FormData.

• Carga
  A carga é o corpo da solicitação. O formato correto do corpo é determinado pelo aplicativo conectado ao webhook.

Webhooks como um ponto da Jornada do Cliente

Uma Jornada do Cliente é composta de pontos de partida, ações e regras específicas que você define com base em suas metas de marketing. Para construir sua jornada, você escolherá e organizará esses elementos em um mapa de jornada.

Veja como adicionar um webhook como ponto da Jornada do Cliente.

1. Clique em Automations (Automações)e, em seguida, clique em All Journeys (Todas as jornadas)__.
   
2. Clique no botão Create Journey (Criar jornada) ou clique em Finish Setup (Concluir configuração) ao lado de uma jornada existente.
3. Para adicionar um ponto da jornada, passe o mouse sobre o ícone de mais (+) na etapa em que deseja que o webhook ocorra.
4. Clique em Add a journey point (Adicionar um ponto de jornada).
   

5. Clique em Webhook.
   

6. No módulo criador de webhook, preencha os campos para configurar seu webhook. Os campos Webhook name (Nome do webhook), URL destination (Destino da URL), Username (Nome de usuário) e Password (Senha) são obrigatórios.

7. Depois de configurar seu webhook, clique em Save (Salvar) para adicioná-lo como um ponto de jornada.

Muito bem! Ao iniciar ou retomar a jornada, o webhook será acionado assim que o usuário chegar a esse ponto da jornada. O número de solicitações enviadas aparecerá no próprio ponto de jornada.

Webhooks como um ponto de contato do Gerenciador de Campanha

O Gerenciador de Campanha do Mailchimp é um planejador de campanhas de ponta a ponta. Defina um objetivo e organize tarefas, eventos, e-mails e webhooks a partir de um planejador centralizado.

Para adicionar um webhook como um ponto de contato do Gerenciador de Campanha, siga estas etapas:

1. Clique em Campaigns (Campanhas) e, então, clique em Campaign Manager (Gerenciador de Campanha).
   

2. Clique no botão Create campaign (Criar campanha) ou clique na campanha ativa à qual deseja adicionar um ponto de contato de webhook.

3. Clique no menu suspenso Add touchpoint (Adicionar ponto de contato) e, em seguida, clique em Webhook.

4. No módulo criador de webhook, preencha os campos para configurar e agendar seu webhook.

   O público selecionado durante a configuração da campanha é usado por padrão. Se você não quiser acionar uma ação de webhook para todo o seu público, selecione um segmento ou etiqueta existente do seu público na seção Segment or Tag (Segmento ou etiqueta) do módulo.

5. Após configurar seu webhook e definir uma data e hora, clique em Schedule webhook (Agendar webhook) para adicioná-lo como um ponto de contato da campanha.

Excelente! Você pode visualizar seu ponto de contato do webhook em seu calendário e, após a data e hora agendadas, ele será exibido como concluído.

Configuração do webhook de público

Para enviar atualizações sobre seu público para outro aplicativo, você pode configurar um webhook de público. Os webhooks podem enviar uma solicitação para a URL de sua escolha quando atualizações específicas acontecem no público, como quando alguém se inscreve ou quando um perfil é atualizado.

Veja como adicionar um webhook a seu público.

1. Clique em Audience (Público) e, em seguida, clique em Audience dashboard (Painel de controle do público)__.
   
2. Se você tiver mais de um público, clique no menu suspenso Current audience (Público atual) e escolha aquele com o qual gostaria de trabalhar.
3. Clique no menu suspenso Manage Audience (Gerenciar público) e escolha Settings (Configurações).

4. Clique em Webhooks.
   

5. Clique em Create New Webhook (Criar novo webhook).

6. Insira uma Callback URL (URL de retorno de chamada). Essa é a URL para a qual o webhook envia solicitações.

7. Marque todas as ações para as quais você deseja acionar um webhook. Aqui estão as opções disponíveis:

   • Inscrições
   • Cancelamentos de assinatura
   • Atualizações de perfil
   • Endereço removido
   • E-mail alterado
   • Envio de campanha

8. Você também pode optar por enviar atualizações apenas quando uma alteração for feita por um assinante, por um administrador de conta ou por meio da API.

9. Clique em Save (Salvar).

Pronto! Quando uma das ações selecionadas ocorrer, o webhook enviará uma solicitação para a URL que você inseriu.