Entenda os diferentes webhooks disponíveis na Klaviyo

O que você vai aprender

Saiba mais sobre as diferenças entre as soluções de webhook disponíveis no Klaviyo e quando você deve usar cada uma.

Antes de começar

O que são webhooks?

Webhooks permitem que a Klaviyo transmita informações ou “chame” outros aplicativos, ferramentas e servidores por meio de solicitações HTTP. Eles podem enviar informações sobre um evento que aconteceu (por exemplo, um pedido feito, um novo cliente que se inscreveu etc.) ou notificar seus sistemas externos de que o evento ocorreu.

Os webhooks são compostos por alguns componentes principais:

• Tópico
  O evento que faz um webhook ser acionado.
• Corpo (ou “o payload”)
  Os dados que o webhook envia.
• Cabeçalhos
  Um lugar para passar informações adicionais (como autenticação).
• URL de destino
  O ponto de extremidade que recebe a solicitação de webhook.

Webhooks de fluxo

Você pode adicionar webhooks em fluxos como uma ação. Quando um perfil chega a uma ação de webhook configurada como Live, a Klaviyo envia uma solicitação POST para a URL de destino com os dados que você inclui no payload. Isso pode incluir detalhes do perfil e, em um fluxo acionado por métrica, dados do evento que acionou o fluxo.

Você pode adicionar webhooks de fluxo a fluxos acionados por uma métrica, lista, segmento ou propriedade de data. Eventos relacionados a mensagens, como E-mail recebido, E-mail clicado ou E-mail marcado como spam, não podem ser usados como acionadores de fluxo.

Exemplos de casos de uso para webhooks de fluxo

Alguns exemplos de casos de uso em que os webhooks de fluxo seriam mais eficazes incluem:

• Envie uma mensagem ou solicitação POST que seja acionada com base na adição de um assinante a um segmento ou lista.
• Automatize a supressão quando um perfil entra em um segmento de não engajados.
• Envie uma mensagem de agradecimento personalizada por um serviço como o WhatsApp ou o Facebook Messenger quando os clientes fizerem uma compra.

Webhooks no Advanced Klaviyo Data Platform

Webhooks na Advanced Klaviyo Data Platform notificam sistemas externos em resposta a eventos, independentemente das etapas do fluxo. A Klaviyo cria o corpo da solicitação para você. Use esses webhooks quando quiser enviar uma carga útil de evento pré-criada para um sistema externo. Esse sistema deve ter um ponto de extremidade que possa receber e processar as solicitações.

Os webhooks do Advanced Klaviyo Data Platform oferecem suporte a uma variedade maior de tópicos do que os webhooks de fluxo, incluindo eventos relacionados a mensagens disponíveis pela API Get Events. Escolha métricas individuais como tópicos ao configurar seu webhook.

Os exemplos incluem:

• Eventos de e-mail (por exemplo, Received email, Clicked email, Marked email as spam)
• Eventos de SMS (por exemplo, Sent SMS, Received SMS)
• notificação push de eventos (por exemplo, Received push, Bounced push)
• Eventos de integrações (ou seja, eventos de integrações próprias criadas pela Klaviyo)
• Eventos de API (por exemplo, eventos sincronizados por meio das APIs da Klaviyo)

Isso inclui eventos relacionados a mensagens, como o evento cancelar inscrição mais antigo (um clique no link para cancelamento de inscrição de um e-mail), E-mail recebido ou E-mail clicado, que não podem ser usados como gatilhos de fluxo. Cancelar inscrição do marketing por e-mail é um evento separado que pode acionar um fluxo.

Além disso, os webhooks do Advanced Klaviyo Data Platform permitem que você se inscreva em vários acionadores de uma só vez, ao contrário dos webhooks de fluxo, que dependem de fluxos com um único acionador.

Exemplos de casos de uso de webhooks do Advanced Klaviyo Data Platform

• Sincronize eventos de clientes que cancelar inscrição no marketing por e-mail com sistemas externos.
• Reporte eventos de E-mail recebido ao software de central de atendimento para que os agentes possam ver o histórico de e-mails e atender melhor os clientes.
• Sincronize todos os envios, as aberturas e os cliques de e-mail em um data warehouse não compatível com a sincronização do data warehouse da Klaviyo.

Código

O código está incluído na Advanced Klaviyo Data Platform. Sua conta precisa ter acesso à Advanced Klaviyo Data Platform para usar essas funções acionadas por eventos. Consulte nosso guia de cobrança para saber como adicionar esse plano ou começar como cliente novo.

O código usa webhook para executar funções personalizadas em resposta a um acionador de evento. Você pode escrever Python ou JavaScript diretamente no editor da Klaviyo, e a Klaviyo gerencia a execução do código, o monitoramento e o registro.

Use o Código quando você tiver recursos de desenvolvimento para escrever funções personalizadas que são executadas em resposta a eventos. A Klaviyo hospeda as funções, então você não precisa hospedar seu próprio ponto de extremidade para receber o webhook de acionamento. Para enviar dados para outro sistema, seu código precisa se conectar à API ou ao serviço desse sistema.

Tanto os webhooks de Code quanto os webhooks da Advanced Klaviyo Data Platform permitem que você selecione métricas individuais como gatilhos.

Casos de uso do código de exemplo

• Use bibliotecas Python para ler dados de eventos e extrair valores, como uma cidade de reserva, para usar em lógica personalizada.
• Defina Propriedades do perfil personalizadas com base em metadados de eventos usando as APIs da Klaviyo.
• Chame um serviço de IA para criar uma mensagem personalizada para cada carrinho abandonado com base no perfil e nos itens no carrinho.

Recursos adicionais