Entendendo webhooks em fluxos

O que você vai aprender

Saiba mais sobre webhooks em fluxos e como eles enviam informações da Klaviyo para suas ferramentas e aplicativos de terceiros. É importante observar que configurar webhooks pode ser complexo. É recomendável ter conhecimento de desenvolvimento ou recursos de desenvolvimento para concluir essa configuração corretamente. Se você está procurando essas instruções de desenvolvimento, saiba como adicionar uma ação de webhook a um fluxo.

O que são webhooks?

De forma simples, os webhooks criam uma maneira abrangente de fazer com que todas as suas ferramentas de marketing e dados conversem entre si. Como exemplo, vamos imaginar como funcionam o banco online e a proteção contra fraude no seu cartão de crédito. Se alguém usar seu cartão de forma fraudulenta, essa transação é registrada no varejista e, em seguida, enviada ao seu banco, que então a analisa e avisa você por telefone ou e-mail quando há algum problema com o seu cartão. Essa compra acionou uma série de sistemas para se comunicar, movimentar esses dados e, por fim, alertar você. Esses sistemas provavelmente estão usando webhook para repassar esses dados. webhook:

• Permita que seu aplicativo transmita informações ou "chame" outros aplicativos, ferramentas e servidores por meio de uma solicitação HTTP.
• Envie informações sobre um evento que ocorreu (por exemplo, um pedido feito, um novo cliente inscrito etc.).
• Você pode avisar ao seu sistema que um evento aconteceu ou notificar você sobre esse evento.

Essas informações do evento serão entregues da forma e no lugar que você escolher. Em outras palavras, os webhook oferecem formas valiosas de compartilhar dados e informações do Klaviyo com suas outras ferramentas de marketing, da maneira que você achar melhor.

Principais componentes de webhooks

Os webhooks são compostos por algumas partes:

• Disparo
  O evento que faz um webhook ser acionado
• Mensagem (ou "o payload")
  O que o webhook envia, como os principais detalhes sobre o evento de acionamento, a URL para onde a mensagem é enviada ou a URL do sistema que recebe a mensagem
• Cabeçalhos
  Um lugar para passar informações adicionais (como autenticação)

Webhooks em fluxos

No momento, os Webhooks estão disponíveis apenas em fluxos e são enviados quando um fluxo chega a um determinado estágio ou etapa. Em seguida, o webhook enviará uma solicitação POST com dados sobre o evento ou destinatário que acionou o fluxo.

É importante observar que apenas um evento pode iniciar o envio do webhook. Quando um assinante atende aos critérios de acionamento, o webhook será disparado, enviando a mensagem para a URL designada. Além disso, você só pode enviar webhook a partir de eventos acionados por fluxo, ou seja, eventos que podem ser usados como acionadores de um fluxo. Por exemplo, não é possível enviar um webhook a partir de uma alteração em uma Propriedades do perfil, pois um fluxo não pode ser acionado diretamente por alterações no perfil.
Exemplos de eventos no Klaviyo incluem:

• Pedido Realizado
• Checkout Iniciado
• Inscrição na Lista

Casos de uso de webhook

É fundamental entender os gatilhos de fluxo que podem gerar webhooks, bem como alguns casos de uso práticos de como implementá-los com seus outros aplicativos.

Os exemplos incluem:

• Enviar uma mensagem para reengajar clientes inativos.
• Enviar uma mensagem no aniversário dos seus clientes e dar a eles um presente na forma de pontos de fidelidade.
• Enviar o webhook sempre que um novo assinante entrar nas suas listas. Você pode enviar os dados de perfil dele para outra plataforma.
• Enviar uma pesquisa de NPS para um cliente para saber mais sobre seus assinantes.
• Enviar uma mensagem ou solicitação POST que é acionada com base na adição de um assinante a um segmento ou lista. No entanto, observe que não oferecemos suporte ao evento "Received Email" como gatilho de fluxo.

Exemplo do mundo real

Você decide conectar a Klaviyo à sua ferramenta de mala direta para poder se comunicar com os clientes online e por correio. Seu novo cliente Shah foi ao seu site e comprou alguns itens da sua loja e-commerce. Você quer enviar para o Shah um catálogo impresso de toda a sua coleção no futuro.

É aqui que o webhook pode conectar essas experiências. Você já teria sua loja e-commerce integrada à Klaviyo. Na Klaviyo, você configura um fluxo para disparar com base no evento Pedido feito. Em seguida, você nos forneceria o webhook da ferramenta de e-mail direto e incluiria detalhes como o nome e o endereço do cliente, além do que ele pediu na mensagem (ou seja, a carga útil).

Agora, toda vez que alguém (como Shah) fizer um pedido, um evento poderá iniciar o envio de um catálogo impresso para o endereço dessa pessoa. O evento de compra do webhook fará com que informações sejam enviadas para sua ferramenta de mala direta em potencial tempo real diretamente do Klaviyo (ou seja, a mensagem ou o payload).

O que os webhooks da Klaviyo não podem fazer?

Os webhooks não foram feitos para uma sincronização bidirecional de dados. Isso significa que, embora você possa conectar outras plataformas ao Klaviyo para enviar dados daqui para elas, não é possível enviar dados de volta ao Klaviyo. As informações fluirão do Klaviyo para os sistemas ou aplicativos designados aos quais você se conectou, mas não fluirão no sentido contrário. Os webhooks, ao contrário das APIs, só funcionarão dessa forma unidirecional.

Também é importante considerar os eventos que você escolhe para acionar suas informações, com que frequência isso vai acontecer e para onde esses dados vão, no fim, no seu sistema. A Klaviyo vai fornecer a estrutura para conectar os dados dos seus fluxos a uma plataforma, mas o valor final depende de para onde essas informações vão depois de sair da Klaviyo e do que elas podem acionar. Por isso, a Klaviyo só pode monitorar se o webhook está funcionando, e não para onde os dados estão indo ou o que eles estão fazendo depois que saem do nosso sistema.

Por fim, é importante considerar os dados que a Klaviyo pode e não pode enviar por meio de um webhook. A Klaviyo não pode enviar certos pontos de dados por meio de um webhook devido à forma como os acionadores do nosso fluxo funcionam. Por exemplo, não podemos enviar dados de engajamento de abertura de e-mail toda vez que um assinante abre um e-mail, pois você não pode acionar um fluxo com base em aberturas.

Da mesma forma, embora você possa usar variáveis dinâmicas baseadas em eventos na carga útil do webhook em um fluxo acionado por evento, as variáveis disponíveis estão vinculadas ao evento original que acionou o fluxo (ou seja, assim como nos e-mails do fluxo). Por exemplo, se você tiver um fluxo de carrinho abandonado acionado pelo evento Iniciou checkout, você poderá usar variáveis dinâmicas desse evento na carga útil do webhook. Mas, se no mesmo fluxo você também estiver usando um filtro de fluxo ou uma divisão usando uma métrica Adicionado ao carrinho, você não poderá incluir esses dados adicionais na carga útil do webhook.

Por isso, ao configurar seus webhooks, é importante considerar quais pontos de dados os fluxos podem oferecer suporte e o que você quer alcançar com a configuração do seu webhook.

No momento, códigos de cupom, feeds da web e feeds de produtos não são compatíveis em webhooks de fluxo.

Quem deve configurar webhooks?

Conforme observado acima, os sistemas que você conecta à Klaviyo, a maneira como as informações ou os dados são organizados e quais dados ou informações você decide capturar ficam totalmente a seu critério.

Com isso em mente, recomendamos fortemente um recurso de desenvolvimento para configurar webhook e garantir que os eventos certos sejam enviados da Klaviyo e postados corretamente no seu aplicativo. A Klaviyo também vai fornecer erros se algum webhook falhar. No entanto, talvez não consigamos diagnosticar problemas mais profundos na configuração do webhook ou como os dados são postados no seu aplicativo.

Requisitos e considerações

Além de garantir que você tenha um recurso de desenvolvimento para configurar corretamente seu webhook e testá-lo no seu sistema associado, o Klaviyo tem alguns requisitos importantes para usar essa funcionalidade:

• Somente funções de usuário que tenham acesso para criar fluxos podem configurar webhook no Klaviyo. Isso inclui as funções de Gerente, Administrador e Proprietário.
• Para maior segurança, a autenticação em duas etapas deve ser ativada na sua conta para usar webhook ou adicionar novas ações de webhook em um fluxo existente.

Tudo pronto para configurar?

Os webhooks oferecem mecanismos avançados para comunicar dados do Klaviyo para seus outros sistemas ou aplicativos externos. Se você estiver pronto para configurar seus webhooks, leia nosso guia de documentação para desenvolvedores em Como adicionar uma ação de webhook a um fluxo.

Recursos adicionais