Como fazer a integração com o Recurly
O que você vai aprender
Saiba como integrar o Recurly com a Klaviyo para personalizar e segmentar e-mails com base em dados de fatura e pagamento dos seus clientes. A Klaviyo sincroniza os seguintes dados da Recurly:
- Quando uma fatura é emitida e os itens incluídos em cada fatura
- Informações de pagamento para quando um cliente falha no pagamento, é reembolsado ou paga com sucesso
- Propriedades do perfil associadas às informações do Recurly
Integrar a Recurly com a Klaviyo.
Você precisa de permissão para gerenciar integrações no Klaviyo e de acesso de desenvolvedor ou administrador no Recurly para recuperar sua chave de API privada.
- Para integrar o Recurly ao Klaviyo, você vai precisar da sua chave de API do Recurly. Então, comece fazendo login na sua conta do Recurly.
- Acesse integrações > Credenciais de API.
- Copie a chave de API privada em Chave de API padrão para usar mais tarde.

As chaves de API privadas, como sua chave padrão usada aqui, devem ser tratadas como senhas; mantenha-as em um local seguro e nunca as exponha ao público.
- Se a sua chave de API padrão já estiver em uso com outra integração de terceiros, você pode gerar uma nova chave de API privada para a integração do Klaviyo clicando em Adicionar chave de API privada.

A Recurly só vai gerar 5 chaves de API privadas para integrar com aplicativos de terceiros.
- Se você criou uma nova chave de API, copie-a para usar na sua conta Klaviyo.
- Na sua conta da Klaviyo, selecione a aba Integrações.
- Clique em Explorar apps para abrir o marketplace de apps em uma nova guia. Procure por Recurly, selecione o cartão e depois clique em Instalar.
- Insira seu subdomínio do Recurly e a chave de API que você copiou anteriormente e, em seguida, clique em Conectar ao Recurly. Por exemplo, insira “yoursubdomain” em https://yoursubdomain.recurly.com.

- Se a integração for bem-sucedida, uma mensagem de sucesso vai aparecer e seus dados históricos vão começar a sincronizar. Você pode acompanhar o progresso da sincronização na aba Dados da sua integração Recurly.
Monitore a sincronização do Recurly
A Klaviyo importa faturas e pagamentos dos últimos 1.825 dias (cerca de 5 anos) quando você conecta a Recurly. As novas faturas e pagamentos são sincronizados a cada 5 minutos, aproximadamente. Faturas e pagamentos de contas da Recurly sem um endereço de e-mail válido são ignorados.
- No Klaviyo, clique no menu suspenso Análises e selecione Métrica.
- Procure por Issued Invoice com o ícone do Recurly, clique no nome da métrica e selecione a guia Feed de atividades.

- Se a sua integração começou a sincronizar dados, você vai começar a ver eventos de Issued Invoice, com o ícone do Recurly, adicionados a este feed de atividades.
- Para comparar os totais de pagamento, volte para Análises > Métricas e abra Pago com sucesso com o ícone do Recurly.
- Na aba Gráfico, escolha um Intervalo de datas que inclua o dia que você quer verificar. Defina Ver por como Diário e Medição como Total.
- Compare o total desse dia com o número de pagamentos bem-sucedidos no Recurly na mesma data. Espere a sincronização histórica terminar antes de verificar datas anteriores.
- Se os totais forem diferentes, verifique se a sincronização foi concluída, se os pagamentos têm endereços de e-mail de cliente válidos e se as suas contas do Klaviyo e do Recurly usam o mesmo fuso horário.
- Para verificar a configuração de fuso horário na Klaviyo:
- Clique no nome da sua conta no canto inferior esquerdo.
- Selecione Configurações.
- Selecione Conta e role a tela até Fuso horário.
Dados sincronizados do Recurly para a Klaviyo
Métricas
A Recurly sincroniza as seguintes métricas com o Klaviyo:
- Pagamento com falha
Registrado sempre que um pagamento feito pelo Recurly é marcado como falho. - Fatura emitida
Registrada sempre que uma fatura é emitida para um cliente pelo Recurly. - Produto pedido
Registrado para itens em uma fatura quando um cliente faz um pagamento bem-sucedido pelo Recurly. Um pagamento pode gerar vários eventos de Produto pedido. - Pagamento reembolsado
Registrado quando você reembolsa um pagamento pelo Recurly. - Pago com sucesso
Registrado sempre que um cliente paga uma fatura com sucesso pelo Recurly.

Propriedades do perfil
As seguintes propriedades são sincronizadas do Recurly para os perfis da Klaviyo:
- Código da conta Recurly
- Data de validade do cartão Recurly
- Códigos de Plano do Recurly
- Planos do Recurly
Planos do Recurly e Códigos de plano do Recurly são preenchidos a partir de assinaturas com atividade quando os dados de pagamento são sincronizados. Data de vencimento do cartão do Recurly é preenchida quando os detalhes de cobrança incluem o mês e o ano de vencimento.
Resultado
Você terminou de integrar o Recurly ao Klaviyo e verificou os dados sincronizados. Agora, você pode personalizar e segmentar e-mails com base nos dados de fatura e pagamento dos seus clientes.
Recursos adicionais
- Introdução aos fluxos
Aprenda a usar fluxos (também conhecidos como automações ou campanhas drip) para criar comunicações personalizadas e automatizadas, e veja como ativar seu primeiro fluxo na Klaviyo.
- Introdução aos segmentos
Saiba como criar e usar segmentos no Klaviyo, que são uma ferramenta poderosa para entender seu público e enviar mensagens segmentadas.
- Como funciona a troca de informações entre a Klaviyo e os aplicativos
Saiba quais tipos de dados são trocados entre a Klaviyo e aplicativos externos e onde esses dados ficam na sua conta da Klaviyo. Quando você integra um aplicativo de terceiros à Klaviyo, as duas plataformas trocam informações. A maior parte da troca de dados com a Klaviyo é unidirecional; os dados são importados para a sua conta da Klaviyo para que você possa aproveitar um amplo conjunto de dados dos seus clientes na Klaviyo.