# Fluxos da Sesami e Klaviyo

Integre o Sesami com o Klaviyo para potencializar o marketing avançado por e-mail e SMS para o seu negócio de agendamentos.

## O que é o Klaviyo?

O Klaviyo é uma plataforma de automação de marketing usada principalmente para marketing por e-mail e SMS. Como parceiros estratégicos do Sesami, o Klaviyo oferece ferramentas poderosas de comunicação com clientes para negócios baseados em agendamentos.

## Por que integrar o Sesami com o Klaviyo?

Você pode otimizar todas as interações com seus clientes alimentando os dados de eventos do Sesami no Klaviyo e acionando todas as comunicações (E-mail ou SMS) via Klaviyo. Para muitas empresas que já usam o Klaviyo para enviar confirmações de pedidos, mensagens de marketing por SMS e outras comunicações, enviar também confirmações de agendamento e lembretes de compromissos pelo Klaviyo cria uma experiência unificada para o cliente.

### Casos de uso comuns

**Fluxos de E-mail e SMS:**

* Fluxo de confirmação de agendamento
* Fluxo de remarcação de agendamento
* Fluxo de cancelamento de agendamento
* Fluxo de lembrete de agendamento (24 horas antes, ou em horário personalizado)
* Fluxo de conclusão de agendamento

**Integrações combinadas:**

* Solicite avaliações de clientes com plataformas de avaliação (Okendo, Yotpo, Trustpilot, etc.)
* Convide para ou acompanhe programas de fidelidade após o agendamento (LoyaltyLion, Swell, etc.)
* Personalize e-mails de agendamento (Limespot, Nosto, etc.)

## Como funciona

O Sesami usa **Sesami Flows** para enviar eventos de agendamento ao Klaviyo em tempo real. Quando um agendamento é criado, remarcado, cancelado ou concluído, o Sesami envia esses dados do evento para o Klaviyo como uma métrica personalizada. Depois, você cria Flows no Klaviyo que acionam mensagens de e-mail ou SMS com base nessas métricas.

### O fluxo de dados

1. O cliente agenda um compromisso no Sesami
2. O Flow do Sesami é acionado e envia dados do evento para o Klaviyo via webhook
3. O Klaviyo recebe o evento como uma métrica personalizada (por exemplo, "Sesami Appointment Created")
4. O Flow do Klaviyo é acionado com base nessa métrica
5. O cliente recebe um e-mail ou SMS com os detalhes do compromisso

## Instruções de configuração

### Etapa 1: Crie um Flow no Sesami

1. Abra **Sesami** no seu admin da Shopify
2. Acesse **Configurações > Flows**
3. Clique em **Criar Flow**

### Etapa 2: Escolha um preset do Klaviyo

Selecione entre os presets de Flow do Klaviyo disponíveis:

* **Evento Klaviyo, agendamento criado**
* **Evento Klaviyo, agendamento remarcado**
* **Evento Klaviyo, agendamento cancelado**
* **Evento Klaviyo, agendamento concluído**
* **Evento Klaviyo, lembrete de agendamento 24 horas antes**

{% hint style="info" %}
Você pode criar quantos Flows de lembrete forem necessários duplicando o preset de lembrete e alterando o horário do gatilho.
{% endhint %}

### Etapa 3: Revise as configurações do Flow

Revise as configurações gerais do Flow para entender as condições de gatilho e a configuração do webhook.

### Etapa 4: Obtenha sua Chave de API Privada do Klaviyo

{% hint style="warning" %}
**Importante**: A partir de 12 de junho de 2024, os Flows do Sesami usam a Chave de API Privada do Klaviyo (não a chave pública). Certifique-se de criar uma chave privada.
{% endhint %}

1. Faça login na sua **conta do Klaviyo**
2. Acesse **Configurações > Chaves de API**
3. Clique em **Criar Chave de API Privada**
4. Nomeie como "Integração Sesami" e escolha **Chave de Acesso Completo**
5. Copie a Chave de API Privada gerada

### Etapa 5: Adicione sua chave de API ao Flow

1. Nas configurações do seu Flow do Sesami, encontre o placeholder `KLAVIYO_PRIVATE_API_KEY`
2. Substitua-o pela sua verdadeira Chave de API Privada do Klaviyo
3. **Salvar** o Flow

Pronto! Repita estas etapas para cada evento do Klaviyo que você quiser enviar ao Klaviyo.

## Propriedades de evento disponíveis

Quando o Sesami envia dados de agendamento para o Klaviyo, as seguintes propriedades são incluídas e podem ser usadas nos seus modelos de e-mail ou SMS do Klaviyo:

| Propriedade                            | Valor de exemplo                   | Descrição                                   |
| -------------------------------------- | ---------------------------------- | ------------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55           | ID único do agendamento                     |
| `{{ event.datetime }}`                 | 29 de julho de 2022 às 16:30       | Data e hora do agendamento                  |
| `{{ event.order_id }}`                 | 4447608111157                      | ID do pedido do Shopify                     |
| `{{ event.quantity }}`                 | 1                                  | Número de agendamentos                      |
| `{{ event.service_name }}`             | Remoção de tatuagem                | Nome do serviço                             |
| `{{ event.service_description }}`      | Por favor, chegue 15 minutos antes | Instruções do serviço                       |
| `{{ event.service_duration }}`         | 30                                 | Duração em minutos                          |
| `{{ event.service_price }}`            | 149                                | Preço do serviço                            |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA              | Local do serviço                            |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>...      | URL da imagem do serviço                    |
| `{{ event.team_member }}`              | David                              | Nome do membro da equipe atribuído          |
| `{{ event.team_member_description }}`  | David tem dez anos de experiência  | Biografia do membro da equipe               |
| `{{ event.team_member_email }}`        | <david@email.com>                  | E-mail do membro da equipe                  |
| `{{ event.team_member_phone }}`        | 0000000000                         | Telefone do membro da equipe                |
| `{{ event.variant_title }}`            | 30 minutos                         | Título da variante do produto               |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>         | Link para o cliente gerenciar o agendamento |
| `{{ event.line_item_properties }}`     | Pares de pergunta/resposta         | Respostas do formulário personalizado       |

## Configurando Flows no Klaviyo

Depois que o Sesami estiver enviando eventos para o Klaviyo, você precisa criar Flows no Klaviyo para enviar comunicações aos clientes.

### Etapa 1: Crie um Flow no Klaviyo

1. Faça login em **Klaviyo**
2. Acesse **Flows**
3. Clique em **Criar Flow**

### Etapa 2: Escolha um gatilho de Métrica

1. Selecione **Métrica** como seu tipo de gatilho
2. Pesquise por "Sesami" no menu suspenso de métricas
3. Escolha a métrica apropriada:
   * **Sesami Appointment Created**
   * **Sesami Appointment Rescheduled**
   * **Sesami Appointment Canceled**
   * **Sesami Appointment Completed**
   * **Sesami Appointment Reminder**

### Etapa 3: Adicione uma ação de E-mail ou SMS

1. Clique em **Adicionar ação**
2. Escolha **E-mail** ou **SMS**
3. Desenhe seu modelo de mensagem

### Etapa 4: Use as propriedades do evento no seu modelo

Ao editar o conteúdo do seu e-mail ou SMS, você pode acessar todas as propriedades relacionadas ao agendamento usando a sintaxe mostrada na tabela acima. Por exemplo:

* `{{ event.datetime }}` - Mostra a data e a hora do agendamento
* `{{ event.service_name }}` - Mostra o nome do serviço
* `{{ event.team_member }}` - Mostra o membro da equipe atribuído
* `{{ event.customer_management_link }}` - Fornece um link para os clientes remarcarem ou cancelarem

### Etapa 5: Coloque seu Flow no ar

Depois de desenhar sua mensagem e testá-la, defina seu Flow como **Ao vivo** para começar a enviar mensagens automatizadas.

{% hint style="info" %}
**Marque seus Flows do Klaviyo como transacionais.** Confirmações de agendamento, lembretes, avisos de remarcação/cancelamento e comunicações semelhantes de agendamento são transacionais — não de marketing. Marcar essas mensagens como transacionais no Klaviyo garante que elas sejam enviadas a todos os clientes, independentemente do consentimento de marketing, e mantém a entregabilidade do seu marketing limpa.

No Klaviyo, abra a ação de mensagem do Flow, vá para **Opções adicionais**, e desative **Envio inteligente** e defina o tipo de mensagem como **Transacional**.
{% endhint %}

## Testando sua integração

Antes de entrar no ar, teste a integração:

1. Crie uma reserva de teste no Sesami
2. Verifique se o evento aparece no **Feed de atividade** ou **Métricas**
3. Verifique se todas as propriedades do agendamento estão sendo preenchidas corretamente
4. Teste seu Flow do Klaviyo para garantir que os e-mails/SMS sejam enviados corretamente
5. Revise o conteúdo para garantir que todas as propriedades dinâmicas sejam exibidas corretamente

{% hint style="success" %}
**Dica de ouro**: Crie um endereço de e-mail de cliente de teste e faça reservas de teste para verificar a experiência completa do cliente antes de ativar os Flows para clientes reais.
{% endhint %}

## Perguntas frequentes

<details>

<summary>E se eu precisar configurar mais de um fluxo de lembrete?</summary>

Você pode criar quantos fluxos de lembrete quiser criando novos Flows usando o preset de lembrete do Klaviyo e alterando o horário do gatilho na configuração do Flow. Por exemplo, você poderia enviar lembretes em:

* 7 dias antes do agendamento
* 24 horas antes do agendamento
* 2 horas antes do agendamento

</details>

<details>

<summary>Posso usar o Klaviyo para SMS além de e-mail?</summary>

Sim! O Klaviyo suporta e-mail e SMS. Desde que você tenha o SMS ativado na sua conta do Klaviyo e tenha coletado números de telefone de clientes com consentimento, você pode usar ações de SMS nos seus Flows do Klaviyo.

</details>

<details>

<summary>O que aconteceu com a exigência da chave de API pública?</summary>

A partir de 12 de junho de 2024, o Sesami atualizou todos os presets de Flow para usar a Chave de API Privada do Klaviyo em vez da chave pública, acompanhando os requisitos de API atualizados do Klaviyo. Sempre use uma chave privada ao configurar novas integrações.

</details>

<details>

<summary>Os eventos não estão aparecendo no Klaviyo. O que devo verificar?</summary>

* Verifique se sua Chave de API Privada do Klaviyo está correta e tem Acesso Completo
* Certifique-se de que o Flow esteja ativado no Sesami
* Verifique se você fez uma reserva de teste após configurar o Flow
* Revise os logs do Flow do Sesami para ver se o webhook foi enviado com sucesso
* Verifique o Feed de Atividade do Klaviyo para ver se os eventos estão sendo recebidos

</details>

## Relacionado

* [Sesami Flows](/pt-br/automacoes/sesami-flows.md) - Visão geral do sistema de automação do Sesami
* [Ações de E-mail e Webhook](/pt-br/automacoes/email-and-webhook-as-action-types.md) - Entendendo os tipos de ação
* [Visão geral da integração com o Klaviyo](/pt-br/apps-integrations/klaviyo.md) - Padrões gerais do Klaviyo
* [E-mails de notificação](/pt-br/notificacoes/notification-emails.md) - Sistema de notificações padrão do Sesami


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sesami.co/pt-br/automacoes/sesami-flows-and-klaviyo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
