> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/pt-br/automacoes/sesami-flows-and-klaviyo.md).

# Fluxos do 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?

Klaviyo é uma plataforma de automação de marketing usada principalmente para marketing por e-mail e SMS. Como parceiros estratégicos da 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 simplificar 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 compromisso 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 reagendamento 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:**

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

## Como funciona

O Sesami usa **Sesami Flows** para enviar eventos de reserva ao Klaviyo em tempo real. Quando um agendamento é criado, reagendado, cancelado ou concluído, o Sesami envia esses dados de evento ao Klaviyo como uma métrica personalizada. Em seguida, 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 Sesami Flow é acionado e envia os dados do evento ao Klaviyo via webhook
3. O Klaviyo recebe o evento como uma métrica personalizada (por exemplo, "Sesami Appointment Created")
4. O Klaviyo Flow é acionado com base nessa métrica
5. O cliente recebe um e-mail ou SMS com os detalhes do agendamento

## Instruções de configuração

### Etapa 1: Crie um Flow no Sesami

1. Abra o [Portal de administração do Sesami](https://help.sesami.co/admin/sesami-admin-portal)
2. Navegue até **Flows**
3. Clique em **Criar Flow**

### Etapa 2: Escolha um preset do Klaviyo

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

* **evento do Klaviyo, agendamento criado**
* **evento do Klaviyo, agendamento reagendado**
* **evento do Klaviyo, agendamento cancelado**
* **evento do Klaviyo, agendamento concluído**
* **evento do 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 %}

<figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FuxdHvTIRYlwCWGpBwGIH%2FScreenshot%202026-08-27%20at%2013.33.08.png?alt=media&amp;token=2071f95d-dbf7-4dcf-a786-e0d1c0e5434d" alt=""><figcaption></figcaption></figure>

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

Revise as configurações gerais do Flow para entender as condições de acionamento 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 Sesami Flows 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. Navegue até **Configurações > Chaves de API**
3. Clique em **Criar Chave de API Privada**
4. Nomeie como "Sesami Integration" e escolha **Chave de Acesso Total**
5. **Copie a Chave de API Privada gerada**

<div><figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJQQrLNJF0Wc1v55x5pw6%2FScreenshot%202026-08-27%20at%2013.37.52.png?alt=media&amp;token=2482f74f-2bd7-416a-b74c-e617cbd40076" alt=""><figcaption></figcaption></figure> <figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FtDaqzIIZt1JaRJaFN2Zo%2FScreenshot%202026-08-27%20at%2013.43.28.png?alt=media&amp;token=bdf7fd77-bbd9-4867-aa5c-dd62512056bf" alt=""><figcaption></figcaption></figure></div>

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

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

<figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi5oTyjoqq0PXgNihjLCt%2FScreenshot%202026-08-27%20at%2013.46.46.png?alt=media&amp;token=cf59b1ba-62f8-4910-aef2-a545e114fd05" alt=""><figcaption></figcaption></figure>

### Etapa 6: Crie e teste uma reserva

1. Crie um agendamento de teste no Sesami para conectar o Sesami ao Klaviyo e enviar os dados do evento.<br>
2. Depois que o teste for concluído, o evento correspondente e suas propriedades ficarão disponíveis no Klaviyo. Em seguida, você pode continuar com as próximas etapas da configuração do Flow no Klaviyo.

{% hint style="info" %}
**Observação:** Criar um agendamento de teste é necessário para estabelecer a conexão entre o Sesami Flow recém-configurado e a API do Klaviyo.

A ação de teste deve corresponder ao gatilho do Flow:

* Agendamento criado → Crie um novo agendamento de teste.
* Agendamento reagendado → Reagende um agendamento existente.
* Cliente fez check-in → Faça o check-in do cliente para o agendamento.
* Agendamento iniciado → Aguarde o início do agendamento.
* Agendamento cancelado → Cancele um agendamento existente.
* No Show → Marque o agendamento como No Show.
  {% endhint %}

## 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 no **Klaviyo**
2. Navegue até **Flows**
3. Clique em **Criar Flow** e então **Crie o seu próprio**

<figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgF1uw6IQslc07hlOzuBD%2FScreenshot%202026-08-27%20at%2014.23.17.png?alt=media&amp;token=daee427d-8831-4abc-979c-0f87e44b10ff" alt=""><figcaption></figcaption></figure>

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

1. Selecione **Métrica** como seu tipo de gatilho&#x20;
2. Clique em API
3. Encontre "Sesami" e escolha a métrica apropriada.

<div><figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FdeylxlHLsqqiXcWoO3pb%2FScreenshot%202026-08-27%20at%2014.26.23.png?alt=media&amp;token=8c59d1a1-ec7f-413b-ae5c-b61baf23116c" alt=""><figcaption></figcaption></figure> <figure><img src="https://3937878330-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5XGdGYX0ttyeANtcq58A%2FScreenshot%202026-08-27%20at%2014.30.23.png?alt=media&amp;token=c9c3fb06-9ad7-4f05-bc2b-9b6aa25f767f" alt=""><figcaption></figcaption></figure></div>

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

1. Clique em **Adicionar ação**
2. Escolha **E-mail** ou **SMS**
3. Crie o modelo da sua 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 designado
* `{{ event.customer_management_link }}` - Fornece um link para que os clientes reagendem ou cancelem

### Etapa 5: Coloque seu Flow no ar

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

{% hint style="info" %}
**Marque seus Flows do Klaviyo como transacionais.** Confirmações de reserva, lembretes, avisos de reagendamento/cancelamento e comunicações semelhantes de agendamento são transacionais — não de marketing. Marcar esses conteúdos como transacionais no Klaviyo garante que sejam enviados 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 **Smart Sending** 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 atividades** 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 profissional**: Crie um endereço de e-mail de teste de cliente e faça reservas de teste para verificar a experiência completa do cliente antes de ativar os Flows para clientes reais.
{% endhint %}

## 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 exclusivo 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 reservas                      |
| `{{ 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 designado      |
| `{{ 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 a reserva |
| `{{ event.line_item_properties }}`     | Pares de pergunta/resposta         | Respostas de formulário personalizado   |

## Perguntas frequentes

<details>

<summary>E se eu precisar definir 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 oferece suporte a e-mail e SMS. Desde que você tenha 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 atualizados da API 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 total
* Certifique-se de que o Flow está ativado no Sesami
* Verifique se você fez uma reserva de teste depois de configurar o Flow
* Revise os logs do Sesami Flow para ver se o webhook foi enviado com sucesso
* Verifique o Feed de atividades 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 da 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ção padrão do Sesami


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.