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?O que são webhooks?
Em termos simples, os webhooks criam 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 webhooks para transmitir esses dados.
Os webhooks permitem que seu aplicativo passe informações ou "chame" outros aplicativos, ferramentas e servidores por meio de solicitação HTTP. Os webhooks enviam informações sobre um evento que ocorreu (por exemplo, um pedido feito, um novo cliente inscrito etc.). Os webhooks podem informar ao seu 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, os webhooks oferecem maneiras valiosas de compartilhar dados e informações da Klaviyo com outras ferramentas e marketing, da maneira que o senhor achar melhor.
O senhor não deve usar webhooks para inscrever perfis em novas listas.
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
No momento, os webhooks só estão disponíveis nos fluxos e são enviados quando um fluxo atinge um determinado estágio ou etapa. 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 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 a partir de uma alteração de propriedade de perfil, pois um fluxo não pode ser acionado diretamente a partir de alterações de 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 de 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 desistentes
- Enviar uma mensagem no aniversário de seus clientes e dar-lhes um presente na forma de pontos de fidelidade
- Enviar o webhook sempre que um novo assinante entrar em suas listas. O senhor pode enviar os dados do perfil deles para o seu CDP ou CRM, de modo que sempre tenha um registro completo dos assinantes em sua conta
- Enviar a um cliente uma pesquisa NPS para saber mais sobre seus assinantes
- Envio de uma mensagem ou solicitação POST que é acionada com base na adição de um assinante a um segmento ou lista (por exemplo, um cliente que faz um pedido). No entanto, observe que não oferecemos suporte ao evento "Received Email" " como um acionador de fluxo
Exemplo do mundo real
O senhor decide conectar o 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 de 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á deve ter sua loja de comércio eletrônico integrada ao 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 mala direta e incluiria detalhes como o nome do cliente, o endereço e o que ele pediu 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?
Os webhooks não se destinam a ser uma sincronização bidirecional de dados. Isso significa que, embora o senhor possa conectar outras plataformas à Klaviyo para enviar dados de nós para elas, não é possível passar dados de volta para a Klaviyo. As informações fluirão da Klaviyo para os sistemas ou aplicativos designados aos quais o senhor se conectou, mas não poderão fluir para o outro lado. Os webhooks, ao contrário das APIs, só funcionarão dessa maneira 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. A Klaviyo fornecerá a estrutura para conectar os dados de seus fluxos a uma plataforma, mas o valor final dependerá do destino dessas informações depois que saírem da Klaviyo e do que elas potencialmente podem gerar. Portanto, a 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 do webhook em um fluxo acionado por evento, as variáveis disponíveis são conectadas ao evento original que acionou o fluxo (ou seja como nos e-mails de fluxo). Por exemplo, se o senhor tiver um fluxo de carrinho abandonado acionado pelo evento Checkout iniciado, poderá usar variáveis dinâmicas desse evento na carga útil dos webhooks. 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 seus webhooks, é importante considerar o que os fluxos podem suportar para 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 fortemente que um recurso de desenvolvimento configure webhooks para garantir que os eventos certos sejam enviados da 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. Sugerimos que o senhor reveja nosso guia How to Add a Webhook Action to a Flow (Como adicionar uma ação de webhook a um fluxo ) para se certificar de que configurou corretamente a ação.
Requisitos e considerações sobre os webhooks do Klaviyo
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 da Klaviyo com outros sistemas ou aplicativos de marketing externos. Se estiver pronto para configurar seus webhooks, o senhor pode ler nosso guia de documentação para desenvolvedores sobre Como adicionar uma ação de webhook a um fluxo.
Recursos adicionais