Skip to content

Recurly

A Recurly é uma plataforma de gerenciamento de assinaturas e faturamento. A plataforma integrada da Recurly simplifica a automação do ciclo de vida da assinatura em escala, permitindo que as equipes gerenciem e otimizem a experiência do assinante—desde o teste de novos planos, ofertas e promoções até o gerenciamento de métodos de pagamento, integrações e insights.

Essa integração é mantida pela Recurly.

Sobre a integração

A integração entre a Recurly e a Braze simplifica o processo de compartilhamento de dados de assinatura com a Braze, permitindo a comunicação direcionada com os clientes.

  • Use os eventos do ciclo de vida da assinatura da Recurly (por exemplo, renovações, pausas ou cancelamentos de assinatura) na Braze para disparar campanhas e comunicações personalizadas.
  • Aproveite os dados de assinatura da Recurly (por exemplo, planos de assinatura, complementos ou status) para criar e gerenciar usuários da empresa, Segments e Canvas para executar campanhas e comunicações específicas de coorte.
  • Envie dados da Recurly diretamente para a Braze, possibilitando casos de uso adicionais de envio de mensagens e reduzindo os custos indiretos de desenvolvimento.

Consulte a documentação da Recurly para saber mais sobre como usar a Recurly com a Braze.

Pré-requisitos

Requisito Descrição
Conta da Recurly Para aproveitar essa parceria, é necessário ter um plano de assinatura Elite da Recurly com a Feature Flag da Braze ativada. A ativação de faturas de crédito na sua plataforma da Recurly também é necessária.
Chave da API REST da Braze Uma chave da API REST da Braze com permissões users.track.

Isso pode ser criado no dashboard da Braze em Configurações > Chaves de API. Como a Recurly usa apenas o endpoint users.track, recomendamos o provisionamento de uma chave específica da Recurly somente com essa permissão.
Endpoint REST da Braze Sua URL de endpoint REST. Seu endpoint dependerá da URL da Braze para sua instância.

Integração

Antes de começar, verifique se você tem contas ativas na Braze e na Recurly.

Conectar a Recurly à Braze

  1. Na Recurly, acesse Integrations > Braze. Ao navegar pela primeira vez na página de configuração da integração da Braze na Recurly, a interface solicitará que você conecte os dois sistemas.

  2. Forneça as seguintes credenciais:

  • Instance URL: O endpoint REST da Braze da instância para a qual você está provisionado.
  • API Key (Identifier): A chave da API REST da Braze que a Recurly deve usar ao enviar solicitações à Braze.

Lembre-se de copiar a URL da sua instância da Braze. Por exemplo, sua URL pode ter a seguinte aparência:

1

<https://dashboard-03.braze.com/dashboard/app_usage?locale=en>
  1. Depois de inserir suas credenciais, clique em Connect.

Usando essa integração

Identificadores suportados

A Recurly usa o account_code de uma conta como external_id na Braze. Por isso, o account_code das suas contas da Recurly deve corresponder ao external_id do seu usuário da Braze.

Eventos personalizados

Para um engajamento eficaz do cliente, você deve configurar eventos personalizados na Braze para receber eventos disparados pela Recurly. Inclua cada evento da Recurly para obter uma integração completa dos dados. Esses eventos também podem ser rastreados na análise de dados da Braze. Uma vez configurados, esses eventos personalizados podem ser usados para segmentar usuários ou personalizar o envio de mensagens.

Evento personalizado da Braze Evento da Recurly
Recurly New Subscription Disparado quando uma assinatura é criada
Recurly Renewed Subscription Disparado quando uma assinatura é renovada
Recurly Updated Subscription Disparado quando os atributos de uma assinatura mudam (mudança de plano, mudança de preço ou mudança de quantidade)
Recurly Canceled Subscription Disparado quando uma assinatura é cancelada
Recurly Reactivated Subscription Disparado quando uma assinatura cancelada é reativada
Recurly Paused Subscription Disparado quando uma assinatura é definida para ser pausada
Recurly Resumed Subscription Disparado quando a pausa de uma assinatura é removida
Recurly Subscription Expired Disparado quando uma assinatura expira
Recurly Invoice Created Disparado quando uma fatura é criada
Recurly Successful Payment Disparado quando uma fatura é cobrada com sucesso
Recurly Refund Issued Disparado quando um reembolso é emitido
Recurly Failed Recurring Payment Disparado quando uma fatura falha para uma renovação de assinatura

Loteamento e limite de taxa

Como a Recurly usa o endpoint /users/track da Braze, a integração está sujeita aos limites de taxa padrão da Braze de 50.000 solicitações por minuto.

A Recurly agrupa determinados eventos do ciclo de vida da assinatura em chamadas únicas à API da Braze para reduzir o número de solicitações.

  • A Recurly agrupa e envia várias assinaturas criadas ao mesmo tempo em uma única solicitação.
  • A Recurly agrupa várias renovações simultâneas de uma conta em uma única solicitação.
  • A Recurly envia eventos do ciclo de vida da assinatura do mesmo modelo em uma única solicitação. Por exemplo, uma fatura recém-criada com um pagamento resulta em uma solicitação de API contendo os eventos personalizados Recurly Invoice Created e Recurly Successful Payment.

Os lotes são enviados à Braze em grupos de até 75 eventos por vez. Por exemplo, se 100 assinaturas fossem criadas de uma vez, a Recurly faria duas solicitações de API para a Braze. Consulte como agrupar solicitações de rastreamento de usuários em lote para obter detalhes.
New Stuff!