Entenda os diferentes webhooks disponíveis no Klaviyo

Você vai aprender 

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

Antes de começar

O que são webhooks?

Os webhooks permitem que o Klaviyo passe informações ou "chame" outros aplicativos, ferramentas e servidores por meio de solicitações HTTP. Eles podem enviar informações sobre um evento que ocorreu (por exemplo, um pedido feito, um novo cliente inscrito etc.) ou notificar seus sistemas externos de que o evento ocorreu.

Os webhooks são feitos de alguns componentes principais:

• Tópico
  O evento que faz com que um webhook seja acionado.
• Corpo (ou "a carga útil")
  Os dados que o webhook envia.
• Cabeçalhos
  Um local para passar informações adicionais (como autenticação).

Webhooks de fluxo

O senhor pode adicionar webhooks em fluxos como uma ação que ocorre quando o fluxo atinge um determinado estágio ou etapa. Quando um fluxo chega à ação do webhook, uma solicitação POST é enviada com dados sobre o evento ou o destinatário que acionou o fluxo, com base em como o senhor constrói a carga útil. 

Os webhooks de fluxo só podem ser enviados com base em eventos acionados por fluxo (ou seja, eventos que podem ser usados como acionadores de fluxo). Além disso, os webhooks de fluxo não são compatíveis com eventos relacionados a mensagens (por exemplo, e-mail recebido, e-mail clicado, e-mail marcado como spam), pois os fluxos geralmente terminam com o recebimento da mensagem. 

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 as supressões quando um perfil entrar em um segmento não engajado. 
• Envie uma mensagem de agradecimento personalizada por meio de um serviço como o Whatsapp ou o Facebook messenger quando os clientes comprarem. 

webhook na plataforma de dados avançada do Klaviyo 

O webhook na Advanced Klaviyo Data Platform permite que o senhor notifique sistemas externos em resposta a eventos, sem depender de uma série de etapas que levem à ação webhook. O webhook avançado da Klaviyo Data Platform não exige que o senhor construa ou especifique manualmente o corpo da solicitação webhook. Se o senhor quiser notificar seus sistemas externos sobre a ocorrência de um evento sem nenhum desenvolvimento personalizado, o webhook na Advanced Klaviyo Data Platform é mais eficaz. 

O webhook avançado da Klaviyo Data Platform também suporta uma gama mais ampla de tópicos para acionar a solicitação e permite que o senhor envie informações em resposta a qualquer evento que possa ser consultado por meio do Get Events API.

Isso inclui:

• Eventos de e-mail (por exemplo, e-mail recebido, e-mail clicado, e-mail marcado como spam)
• Eventos de SMS (por exemplo, SMS enviado, SMS recebido)
• Eventos de notificação por push (por exemplo, Received push, Bounced push)
• Eventos de integrações (ou seja, eventos de integrações primárias criadas pela Klaviyo)
• Eventos de API (por exemplo, eventos sincronizados por meio das APIs da Klaviyo)

Isso inclui eventos relacionados a mensagens, como Unsubscribed (Cancelamento de inscrição), Received email (E-mail recebido) ou Clicked email (E-mail clicado ), que não são compatíveis com webhooks de fluxo.

Além disso, o webhook do Advanced Klaviyo Data Platform permite que o senhor se inscreva em vários acionadores ao mesmo tempo, ao contrário do webhook do fluxo, que depende do fluxo de acionador único.

Exemplos de casos de uso do webhook avançado da Klaviyo Data Platform

• Sincronizar os eventos não inscritos dos clientes com sistemas externos.
• Informe eventos de e-mails recebidos ao software de help desk para que os agentes possam ver o histórico de e-mails e atender melhor aos clientes.
• Sincronizar todos os envios, aberturas e cliques de e-mail em um data warehouse que não seja compatível com a sincronização do data warehouse do Klaviyo.

Código 

O código é um recurso incluído em Klaviyo Advanced Klaviyo Data Platform. Ele não está incluído no aplicativo de marketing padrão do Klaviyoe é necessária uma assinatura da Advanced Klaviyo Data Platform para acessar a funcionalidade associada. Acesse nosso guia de cobrança para saber mais sobre como adicionar essa funcionalidade ao seu plano ou comece a usá-la se o senhor for um novo cliente.

O código aproveita os webhooks para permitir a execução de funções personalizadas em resposta a um acionador de evento. O senhor pode escrever o código diretamente no editor do Klaviyo, e o Klaviyo gerencia a execução, o monitoramento e o registro do código.

Se quiser enviar solicitações para seus sistemas externos sem hospedar um endpoint HTTP público, o senhor pode usar o Code. Além disso, se o senhor quiser executar funções personalizadas em resposta à ocorrência de um evento, deverá usar o Code em vez das outras soluções de webhook disponíveis no Klaviyo. 

O código também oferece suporte a mais granularidade com acionadores de eventos por meio de webhook na Advanced Klaviyo Data Platform. O senhor pode selecionar uma métrica individual para atuar como tópico em vez de todas as integrações ou eventos do API.

Exemplo de casos de uso do código 

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

Recursos adicionais 

Entenda o webhook no fluxo
Entenda o webhook no Advanced Klaviyo Data Platform
Guia de introdução com código