Compreensão de 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 a configuração de webhooks pode ser complexa. É recomendável que o senhor tenha conhecimento ou recursos de desenvolvimento para concluir corretamente essa configuração. Se o senhor estiver procurando essas instruções de desenvolvimento, saiba como adicionar uma ação de webhook a um fluxo.

O que são webhooks?

Em termos simples, o webhook cria uma maneira abrangente de todas as suas ferramentas de marketing e dados se comunicarem entre si. Como exemplo, vamos imaginar como funcionam os serviços bancários on-line e a proteção contra fraudes em seu cartão de crédito. Se alguém usar seu cartão de forma fraudulenta, a transação será registrada no varejista e enviada ao seu banco, que a analisará e alertará o senhor por telefone ou e-mail quando houver algum problema com seu cartão. Essa compra fez com que uma série de sistemas se comunicasse, movimentasse esses dados e, por fim, alertasse o senhor. Provavelmente, esses sistemas estão usando webhook para transmitir esses dados. webhook:

• Permite que seu aplicativo passe informações ou "chame" outros aplicativos, ferramentas e servidores por meio de solicitação HTTP.
• Enviar informações sobre um evento que ocorreu (por exemplo, um pedido feito, um novo cliente que se inscreveu, etc.).
• Pode informar ao sistema que um evento ocorreu ou notificar o senhor sobre esse evento.

Essas informações do evento serão entregues da maneira e no local que o senhor escolher. Em outras palavras, o webhook oferece maneiras valiosas de compartilhar dados e informações do site Klaviyo para outras ferramentas e marketing da maneira que o senhor achar melhor.

Principais componentes dos webhooks

Os webhooks são compostos de algumas partes:

• Gatilho
  O evento que faz com que um webhook seja acionado
• Mensagem (ou "a carga útil")
  O que o webhook envia, como detalhes importantes sobre o URL do evento de acionamento para o qual a mensagem é enviada ou o URL do sistema que recebe a mensagem
• Cabeçalhos
  Um local para passar informações adicionais (como autenticação)

Webhooks em fluxos

Atualmente, o webhook só está disponível no fluxo e é enviado quando um fluxo alcança um determinado estágio ou etapa. O site webhook enviará então uma solicitação POST com dados sobre o evento ou Destinatários que acionaram o fluxo.

É importante observar que somente um evento pode iniciar o envio do webhook. Quando um assinante atender aos critérios de acionamento, o webhook será acionado, enviando a mensagem para o URL designado. Além disso, o senhor só pode enviar webhooks de eventos acionados por fluxo, ou seja, eventos que podem ser usados como acionadores de fluxo. Por exemplo, o senhor não pode enviar um webhook de uma Propriedades do perfil mudando, pois um fluxo não pode ser acionado diretamente de mudanças no perfil.
Exemplos de eventos no Klaviyo incluem:

• Pedido feito
• Início do checkout
• Inscrito na lista

casos de uso de webhooks

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

Os exemplos incluem:

• Envio de uma mensagem para reengajar clientes antigos.
• Enviar uma mensagem no aniversário de seu cliente e dar a ele um presente na forma de pontos de fidelidade.
• Enviar o webhook sempre que um novo assinante entrar em sua lista. O senhor pode enviar os dados do perfil deles para outra plataforma.
• Enviar a um cliente uma pesquisa NPS para saber mais sobre seu assinante.
• Envio de 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 acionador de fluxo.

Exemplo do mundo real

O senhor decide conectar o site Klaviyo à sua ferramenta de mala direta para poder se comunicar com os clientes on-line e por correio. Seu novo cliente Shah acessou seu site e comprou alguns itens da sua loja de comércio eletrônico. O senhor deseja enviar à Shah um catálogo impresso de toda a sua coleção no futuro.

É aqui que o webhook pode unir essas experiências. O senhor já teria o comércio eletrônico da sua loja integrado em Klaviyo. No Klaviyo, o senhor configura um fluxo para ser acionado com base no evento Placed Order. Em seguida, o senhor nos forneceria o webhook da ferramenta de e-mail direto e incluiria detalhes como o nome do cliente, o endereço e o que ele solicitou na mensagem (ou seja, o payload).

Agora, toda vez que alguém (como Shah) faz um pedido, um evento pode iniciar um catálogo impresso a ser enviado para o endereço do senhor. O evento de compra do webhook solicitará que as informações sejam enviadas para sua ferramenta de mala direta em tempo real diretamente do Klaviyo (ou seja, a mensagem ou payload).

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

O webhook não se destina a ser uma sincronização bidirecional de dados. Isso significa que, embora o senhor possa conectar outras plataformas a Klaviyo para enviar dados de nós para elas, não pode passar dados de volta para Klaviyo. As informações fluirão do site Klaviyo para os sistemas ou aplicativos designados aos quais o senhor se conectou, mas não poderão fluir para o outro lado. Ao contrário do API, o webhook só funcionará dessa forma unidirecional.

Também é importante considerar os eventos que o senhor escolhe para solicitar suas informações, a frequência com que isso ocorrerá e para onde esses dados irão no sistema. Klaviyo fornecerá a estrutura para conectar seus dados de fluxo a uma plataforma, mas o valor final depende do destino dessas informações após saírem do site Klaviyo e do que elas potencialmente podem indicar. Portanto, o Klaviyo só pode monitorar se o webhook está funcionando e não para onde os dados estão indo ou o que estão fazendo depois que saem do nosso sistema.

Por fim, é importante considerar os dados que o Klaviyo pode ou não enviar por meio de um webhook. O Klaviyo não pode enviar determinados pontos de dados por meio de um webhook com base na forma como nossos acionadores de fluxo funcionam. Por exemplo, não podemos enviar dados de engajamento de abertura de e-mail para cada vez que um assinante abre um e-mail, pois o senhor não pode acionar um fluxo com base em aberturas.

Da mesma forma, embora o senhor possa usar variáveis dinâmicas baseadas em eventos na carga útil do site webhook em um fluxo acionado por evento, as variáveis disponíveis são conectadas ao evento original que acionou o fluxo (ou seja, exatamente como no fluxo E-mail). Por exemplo, se o senhor tiver um fluxo de carrinho abandonado acionado pelo evento Started checkout, poderá usar variáveis dinâmicas desse evento na carga do webhook. Mas, se no mesmo fluxo o senhor também estiver usando um filtro de fluxo ou uma divisão usando uma métrica Added to Cart, não poderá incluir esses dados adicionais na carga do webhook.

Portanto, ao configurar o webhook, é importante considerar o que o fluxo pode suportar para os pontos de dados e o que o senhor deseja alcançar na configuração do webhook.

Atualmente, não há suporte para códigos de cupom, feeds da Web e feeds de produtos nos webhooks de fluxo.

Quem deve configurar webhooks?

Conforme mencionado acima, os sistemas que o senhor conecta à Klaviyo, a maneira como as informações ou os dados são empacotados e quais dados ou informações o senhor escolhe obter ficam totalmente a seu critério.

Com isso em mente, recomendamos enfaticamente que um recurso de desenvolvimento configure o webhook para garantir que os eventos corretos sejam enviados de Klaviyo e publicados corretamente em seu aplicativo. O Klaviyo também fornecerá erros ao senhor se algum webhook falhar. No entanto, talvez não consigamos diagnosticar problemas mais profundos com a configuração do webhook ou com a forma como os dados são postados no aplicativo. 

Requisitos e considerações

Além de garantir que o senhor tenha um recurso de desenvolvedor para configurar adequadamente o webhook e testá-lo no sistema que o acompanha, a Klaviyo tem alguns requisitos essenciais para usar essa funcionalidade:

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

O senhor está pronto para se preparar?

Os Webooks fornecem mecanismos poderosos para a comunicação de dados do Klaviyo com outros sistemas ou aplicativos externos. Se estiver pronto para configurar seu webhook, o senhor pode ler nosso guia de documentação do desenvolvedor sobre Como adicionar uma ação webhook a um fluxo.

Recursos adicionais

• Compreensão dos acionadores e filtros de fluxo
• Como visualizar a configuração de um acionador de fluxo
• Como adicionar uma ação de webhook a um fluxo