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?

Os webhooks permitem que o Klaviyo transmita informações ou "chame" outros aplicativos, ferramentas e servidores por meio de solicitações HTTP. Elas podem enviar informações sobre um evento que já aconteceu (por exemplo, um pedido feito, um novo cliente 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).

Webhooks de fluxo

Você pode adicionar webhooks em fluxos como uma ação que ocorre quando o fluxo chega a uma determinada etapa ou passo. Quando um fluxo chega à ação de webhook, uma solicitação POST é enviada com dados sobre o evento ou o destinatário que acionou o fluxo, com base em como você constrói o payload.

Webhooks de fluxo só podem ser enviados com base em eventos acionados por fluxo (ou seja, eventos que podem ser usados como gatilho de fluxo). Além disso, webhooks de fluxo não oferecem suporte a eventos relacionados a mensagens (por exemplo, E-mail recebido, E-mail clicado, E-mail marcado como spam), já que os fluxos normalmente terminam com o recebimento da mensagem.

Exemplos de casos de uso para webhooks de fluxo

Alguns exemplos de casos de uso em que 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 meio de um serviço como WhatsApp ou Facebook Messenger quando os clientes comprarem.

Webhooks no Advanced Klaviyo Data Platform

Os webhook no Advanced Klaviyo Data Platform permitem notificar sistemas externos em resposta a eventos, sem depender de uma série de etapas que levam até a ação de webhook. Os webhook do Advanced Klaviyo Data Platform não exigem que você construa ou especifique manualmente o corpo da solicitação de webhook. Se você quiser notificar seus sistemas externos de que um evento ocorreu sem nenhum desenvolvimento personalizado, os webhook no Advanced Klaviyo Data Platform são mais eficazes.

Os webhooks do Advanced Klaviyo Data Platform também oferecem suporte a uma gama mais ampla de tópicos para acionar a solicitação e permitem que você envie informações em resposta a qualquer evento que possa ser consultado pela API Get Events.

como:

• 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 Cancelar inscrição, E-mail recebido ou E-mail clicado que não são compatíveis com webhooks de 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 cancelar inscrição de clientes 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 Code é um recurso incluído no Advanced Klaviyo Data Platform da Klaviyo. Ele não está incluído no aplicativo de marketing padrão da Klaviyo, e é necessária uma assinatura do Advanced Klaviyo Data Platform para acessar a funcionalidade associada. Consulte nosso guia de cobrança para saber mais sobre como adicionar essa funcionalidade ao seu plano ou conferir os primeiros passos se você for um cliente novo.

O código usa webhooks para permitir a execução de funções personalizadas em resposta a um acionamento de evento. Você pode escrever código diretamente no editor da Klaviyo, e a Klaviyo gerencia a execução do código, o monitoramento e os registros.

Se você quiser enviar solicitações aos seus sistemas externos sem hospedar um ponto de extremidade HTTP público, você pode usar o Code. Além disso, se você quiser executar funções personalizadas em resposta a um evento, use o Code em vez das outras soluções de webhook disponíveis no Klaviyo.

O código também oferece mais granularidade com disparos por evento do que com webhook no Advanced Klaviyo Data Platform. Você pode selecionar métricas individuais para atuar como o tópico, em vez de todos os eventos de integração ou de API.

Casos de uso do código de exemplo

• Importe bibliotecas JSON do Python para analisar cargas úteis de eventos e extrair algo.
• Defina Propriedades do perfil personalizadas com base em metadados de eventos usando as APIs da Klaviyo.
• Importe bibliotecas do chatGPT e crie uma mensagem personalizada para cada carrinho abandonado com base no perfil e nos itens do carrinho.

Recursos adicionais