> 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/automacoes/sesami-flows-and-klaviyo.md).

# Fluxos Sesami e Klaviyo

Integre o Sesami com o Klaviyo para impulsionar 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 marketing por 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 simplificar todas as suas interações com os clientes enviando os dados de eventos do Sesami para o 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 confirmações de agendamento e lembretes de compromisso também 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 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 agendamento ao Klaviyo em tempo real. Quando um agendamento é criado, reagendado, cancelado ou concluído, o Sesami envia os dados desse 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 dos dados

1. O cliente agenda um compromisso no Sesami
2. O Flow do Sesami é 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 Flow do Klaviyo é 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

### Passo 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**

### Passo 2: Escolha uma predefinição do Klaviyo

Selecione entre as predefinições 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 a predefinição de lembrete e alterando o horário do gatilho.
{% endhint %}

<figure><img src="https://2464016170-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>

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

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

{% hint style="warning" %}
**Importante**: A partir de 12 de junho de 2024, os Sesami Flows usam a Chave Privada de API 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 Privada de API**
4. Nomeie-a "Sesami Integration" e escolha **Chave de Acesso Total**
5. **Copie a Chave Privada de API gerada**

<div><figure><img src="https://2464016170-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://2464016170-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>

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

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

<figure><img src="https://2464016170-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>

### Passo 6: Crie e teste um agendamento

1. Crie um agendamento de teste no Sesami para conectar o Sesami ao Klaviyo e enviar os dados do evento.<br>
2. Assim 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 Flow do Sesami 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.
* Não compareceu → Marque o agendamento como Não Compareceu.
  {% endhint %}

## Configurando Flows no Klaviyo

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

### Passo 1: Crie um Flow no Klaviyo

1. Faça login no **Klaviyo**
2. Navegue até **Flows**
3. Clique em **Criar Flow** e depois **Crie o seu próprio**

<figure><img src="https://2464016170-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>

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

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

<div><figure><img src="https://2464016170-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://2464016170-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>

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

1. Clique em **Adicionar Ação**
2. Escolha **E-mail** ou **SMS**
3. Desenhe o modelo da sua mensagem

### Passo 4: Use 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 que os clientes reagendem ou cancelem

### Passo 5: Coloque seu Flow no ar

Depois de ter desenhado sua mensagem e testado-a, defina seu Flow como **Ativo** para começar a enviar mensagens automatizadas.

{% hint style="info" %}
**Marque seus Flows do Klaviyo como transacionais.** Confirmações de agendamento, lembretes, avisos de reagendamento/cancelamento e comunicações semelhantes de agendamento são transacionais — não marketing. Marcá-las como transacionais no Klaviyo garante que 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 **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 um agendamento 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 profissional**: Crie um endereço de e-mail de teste para o cliente e faça agendamentos 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 ao 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 mais cedo | 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 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 a predefinição 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 tanto a e-mail quanto a 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 o requisito da chave pública de API?</summary>

A partir de 12 de junho de 2024, o Sesami atualizou todas as predefinições de Flow para usar a Chave Privada de API do Klaviyo em vez da chave pública, acompanhando os requisitos de API atualizados do Klaviyo. Use sempre 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 a sua Chave Privada de API do Klaviyo está correta e tem Acesso Total
* Certifique-se de que o Flow está ativado no Sesami
* Verifique se você fez um agendamento de teste após configurar o Flow
* Revise os registros 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/automacoes/sesami-flows.md) - Visão geral do sistema de automação do Sesami
* [Ações de E-mail e Webhook](/pt/automacoes/email-and-webhook-as-action-types.md) - Entendendo os tipos de ação
* [Visão geral da integração com o Klaviyo](/pt/apps-integrations/klaviyo.md) - Padrões gerais do Klaviyo
* [E-mails de notificação](/pt/notificacoes/notification-emails.md) - Sistema de notificações 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.