---
title: "Como fazer a integração com o Recurly"
description: "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:"
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/115005082207"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/115005082207.md"
locale: "pt-br"
category: "Integrações"
section: "Recurly"
updated: "2025-07-30"
---

# 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.

1. 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.

2. Acesse **integrações > Credenciais de API**.

3. Copie a chave de API privada em **Chave de API padrão** para usar mais tarde.




![Default API Key section in Recurly with private API key blurred out](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0841d1ca32e6651a9e87a9b34e94971c12eea94-1668x454.jpg?auto=format)

**📝 Note:** 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.

1. 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**. 




![Private API Keys in Recurly showing Default API Key blurred out and Add Private API Key with gray background at the bottom](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/5c3158171eced03aff03deebcdba6f20ffe9f8db-1698x920.jpg?auto=format)

**📝 Note:** A Recurly só vai gerar 5 chaves de API privadas para integrar com aplicativos de terceiros.

1. Se você criou uma nova chave de API, copie-a para usar na sua conta Klaviyo.

2. Na sua conta da Klaviyo, selecione a aba **Integrações**.

3. 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**.

4. 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.



![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/a13b8ed2767023b34bc30ce1cc4948e17ef83f6a-1542x1060.png?auto=format)

5. 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.

1. No Klaviyo, clique no menu suspenso **Análises** e selecione **Métrica**.

2. Procure por **Issued Invoice** com o ícone do Recurly, clique no nome da métrica e selecione a guia **Feed de atividades**.



![Page showing list of Issued Invoice via Recurly metrics in Klaviyo with timestamps](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/7db87fcbd683ad92b858dbbc9b11257420d25e58-1000x581.jpg?auto=format)

3. 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.

4. Para comparar os totais de pagamento, volte para **Análises > Métricas** e abra **Pago com sucesso** com o ícone do Recurly.

5. 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**.

6. 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.

7. 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.

8. 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.




![Metrics tab in Klaviyo filtered by Recurly with metrics such as Failed Payment and Issues Invoice](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9c7829de22c9b6561e3a49f20262e87f4fd9ea8b-1676x590.jpg?auto=format)

### 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](https://help.klaviyo.com/hc/pt-br/articles/115002774932.md)
  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](https://help.klaviyo.com/hc/pt-br/articles/115005237908.md)
  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](https://help.klaviyo.com/hc/pt-br/articles/360030696012.md)
  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. 
