> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Usar o Klaviyo

O Klaviyo pode enviar os seus e-mails e SMS de assinatura nos seus próprios modelos e idiomas, e nós avisamos a ele o que aconteceu. Quando uma assinatura começa, é renovada, pausada, falha ou é cancelada, enviamos ao Klaviyo um evento com a assinatura, os produtos e as datas dela. Você cria a mensagem como um fluxo no Klaviyo.

É útil se o seu marketing já vive no Klaviyo e você quer que as mensagens de assinatura tenham a mesma aparência e o mesmo tom do resto, ou se quer adicionar SMS às suas mensagens de assinatura.

## Conectar a sua conta do Klaviyo

1. No Klaviyo (cujos menus aparecem em inglês), vá em **Settings > Account > API keys** e crie uma **Private API key**. **Full Access** funciona. Se escolher **Custom**, defina **Events** como **Full** e **Accounts** como **Read**. Uma chave **Read-Only** não pode enviar eventos. O Klaviyo não permite alterar o acesso de uma chave depois de criada, então, se você escolheu a errada, crie uma nova.
2. Vá em [**Supr Bundles & Subscriptions > Configurações > Integrações > Klaviyo**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/klaviyo). Cole a chave em **Chave de API privada** e clique em **Conectar**.

A página mostra **Conectado** com o nome da sua conta do Klaviyo. Nada muda para os seus clientes ainda: continuamos enviando todos os e-mails até você escolher outra coisa.

## Envie primeiro um evento de teste

Em **Testar um evento**, escolha uma notificação e uma assinatura, ou use a nossa assinatura de exemplo, e clique em **Enviar evento de teste**.

O teste vai para o e-mail de contato da sua loja, não para um cliente, e é marcado com `test: true` para que você possa mantê-lo fora de um fluxo ativo. Ele funciona enquanto ainda estamos enviando os e-mails dos seus clientes, então você pode criar os seus fluxos primeiro e trocar o remetente depois.

Uma métrica aparece no Klaviyo assim que o primeiro evento chega, e é para isso que serve o teste. O Klaviyo leva alguns segundos, então recarregue se ela não aparecer de imediato.

## Crie um fluxo para cada evento

No Klaviyo, crie um fluxo e escolha uma **Metric** como gatilho. Cada notificação chega como uma métrica própria (os nomes das métricas ficam em inglês, como o Klaviyo as mostra):

| Métrica no Klaviyo | Enviada quando |
|---|---|
| Subscription Started | Uma assinatura é iniciada |
| Subscription Restarted | Uma assinatura é reativada |
| Subscription Paused | Uma assinatura é pausada |
| Subscription Cancelled | Uma assinatura é cancelada |
| Subscription Renewed | Uma assinatura é renovada com sucesso |
| Subscription Updated | Uma assinatura é alterada |
| Subscription Next Order Date Changed | A data do próximo pedido é alterada |
| Subscription Renewing Soon | Antes de uma assinatura ser renovada, com a antecedência que você escolher |
| Subscription Price Changed | O preço de uma assinatura muda |
| Subscription Item Out Of Stock | Um item de uma renovação próxima está sem estoque |
| Subscription Failed | Uma assinatura falha |
| Subscription Payment Failed | Uma renovação falha por causa do pagamento do cliente, que precisa corrigir o cartão |
| Subscription Renewal Failed | Uma renovação falha por um motivo que o cliente não pode corrigir |
| Subscription Pause Reminder | Alguns dias depois de uma assinatura ser pausada |
| Subscription Pause Win-Back | Um cliente com a assinatura pausada recebe uma oferta para voltar |
| Subscription Resuming Soon | Alguns dias antes de uma assinatura pausada ser retomada sozinha |
| Subscription Auto Resumed | Uma assinatura pausada é retomada sozinha |
| Subscription Auto Cancelled | Uma assinatura pausada é cancelada após o limite de pausa |
| Subscription Win-Back 1, 2 and 3 | 14, 30 e 60 dias depois de uma assinatura ser cancelada |
| Subscription Box Revealed | O conteúdo de uma box de assinatura é revelado, na data que você definir para essa box |

Todo evento traz a assinatura, os produtos, os totais, a data do próximo pedido e um link para o portal do cliente. Use os campos no seu modelo do Klaviyo, por exemplo `{{ event.customerPortalUrl }}` para o link de gerenciamento da assinatura ou `{{ event.linesSummary }}` para uma lista legível do que há nela. Para mostrar cada produto com a imagem e o preço, percorra `event.lines` em um loop.

Os kits de assinatura estão incluídos. Cada linha de produto informa a qual kit pertence e se é um produto que o cliente comprou ou uma recompensa, para que um fluxo possa tratar um brinde de forma diferente do pacote.

## Escolha quem envia os e-mails aos seus clientes

Em **Quem envia os e-mails aos clientes**, escolha uma opção:

- **Supr Bundles & Subscriptions**: continuamos enviando todos os e-mails aos clientes. Este é o padrão.
- **Klaviyo**: paramos de enviar e-mails aos clientes e enviamos os eventos ao Klaviyo.
- **Escolher por notificação**: marque as que o Klaviyo deve enviar, e continuamos enviando as demais.

Clique em **Salvar**. Quando a mudança passa e-mails ao Klaviyo, o app pede que você confirme e lista os e-mails que deixam de vir de nós.

**Crie e ative o fluxo antes de passar um e-mail.** O Klaviyo aceita os nossos eventos com ou sem um fluxo escutando, então um cliente não recebe nada até que o fluxo dessa métrica esteja ativo.

Depois que um e-mail passa pelo Klaviyo, **Configurações > Notificações** mostra **Enviado pelo Klaviyo** ao lado dele, e o modelo dele ali não é o que o cliente recebe. Altere a mensagem no Klaviyo.

### Manter os nossos e-mails e também enviar todos os eventos

Ative **Também enviar ao Klaviyo os eventos que não passamos para ele**. Continuamos enviando esses e-mails nós mesmos, e cada um também chega ao Klaviyo como um evento, para você marcar clientes, criar segmentos ou fazer um acompanhamento lá. O cliente recebe o nosso e-mail e o que o seu fluxo enviar. Esses e-mails mostram **Também enviado para o Klaviyo** em **Configurações > Notificações**.

Um e-mail para o cliente tem um único remetente. Se o Omnisend já envia um e-mail, o Klaviyo não pode enviá-lo também, e a página informa quais são. O espelhamento não é afetado: os dois podem receber os eventos.

## Bom saber

- Cada e-mail para o cliente tem um único remetente, nós ou o Klaviyo. Com **Também enviar ao Klaviyo os eventos que não passamos para ele** ativado, um fluxo que você criar com esses eventos também pode enviar uma mensagem própria.
- As notificações para a equipe e as opções **Enviar uma cópia para mim** continuam vindo de nós nos dois casos.
- Uma notificação desativada em **Configurações > Notificações** fica desativada em todo lugar, inclusive no Klaviyo. Ative-a ali primeiro. Veja [Notificações](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/notifications-h8mmnz/).
- Se o Klaviyo rejeitar um evento, por exemplo porque a chave foi excluída, enviamos ao cliente o nosso próprio e-mail para que ninguém fique sem nada. A página do Klaviyo então mostra **O Klaviyo rejeitou o último evento** com um botão **Verificar a chave novamente**.
- Os eventos que enviamos passam a fazer parte da sua conta do Klaviyo, que você controla. Se um cliente pedir que os dados dele sejam apagados, remova-o no Klaviyo e também na Shopify. Apagá-lo na Shopify não o remove do Klaviyo.

## Desconectar

Clique em **Desconectar** na página do Klaviyo. Excluímos a sua chave e voltamos a enviar nós mesmos os e-mails dos seus clientes. Os fluxos do Klaviyo criados com esses eventos deixam de recebê-los.