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

Os webhooks e o código do CDP fazem parte do Klaviyo CDP. O CDP não está incluído no aplicativo de marketing padrão do Klaviyo, e é necessária uma assinatura do CDP para acessar a funcionalidade associada. Acesse nosso guia de faturamento para saber mais sobre como adicionar essa funcionalidade ao seu plano ou começar ausá-la se o senhor for um novo cliente.

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. 

Webhooks no Klaviyo CDP 

Os webhooks no Klaviyo CDP permitem que o senhor notifique sistemas externos em resposta a eventos, sem depender de uma série de etapas que levam à ação do webhook. Os webhooks do CDP não exigem que o senhor construa ou especifique manualmente o corpo da solicitação do webhook. Se o senhor quiser notificar seus sistemas externos sobre a ocorrência de um evento sem nenhum desenvolvimento personalizado, os webhooks do Klaviyo CDP são mais eficazes. 

Os webhooks do CDP também oferecem suporte a uma variedade maior de tópicos para acionar a solicitação e permitem que o senhor envie informações em resposta a qualquer evento que possa ser consultado por meio da API Get Events.

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, os webhooks do CDP permitem que o senhor assine vários acionadores de uma só vez, ao contrário dos webhooks de fluxo, que dependem de fluxos de acionador único.

Exemplos de casos de uso para webhooks do CDP

• 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 no Klaviyo CDP. Ele não está incluído no aplicativo de marketing padrão da Klaviyo, e é necessária uma assinatura do CDP para acessar a funcionalidade associada. Acesse nosso guia de faturamento 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 sobre webhooks no CDP. O senhor pode selecionar métricas individuais para atuar como tópico em vez de todos os eventos de integração ou 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 os webhooks nos fluxos
Entenda os webhooks no Klaviyo CDP
Introdução ao código