> 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/apps-integrations/klaviyo/klaviyo-app.md).

# App Klaviyo

A app Klaviyo envia as suas reservas Sesami para o Klaviyo à medida que acontecem. Cada evento de reserva aparece no perfil Klaviyo do cliente, pronto para acionar fluxos de email e SMS e para criar segmentos.

## O que pode fazer

* **Confirmações e atualizações de reserva** — email ou SMS no momento em que uma reserva é feita, reagendada ou cancelada
* **Acompanhamentos após o check-in** — pedidos de avaliação, recomendações de produtos ou uma oferta de nova reserva
* **Recuperação de clientes** — contacte após um cancelamento ou uma ausência com uma forma fácil de voltar a reservar
* **Segmentos** — agrupe clientes consoante a forma como reservam: clientes recorrentes, clientes inativos, clientes que reservaram mas nunca fizeram check-in
* **Relatórios de receita** — Reserva criada inclui o valor da reserva, para que o Klaviyo possa atribuir receita aos seus fluxos

{% hint style="info" %}
A app Klaviyo está incluída em **Sesami Pro e superior**. Veja [sesami.co/pricing](https://sesami.co/pricing) para ver os planos.
{% endhint %}

## Instalar a app

Pode instalar a partir de qualquer um dos lados:

* **A partir do Klaviyo:** abra a app Sesami no Klaviyo App Marketplace e clique em **Instalar**. Inicie sessão no Sesami se lhe for pedido, aprove as permissões da app e, em seguida, aprove a ligação no Klaviyo.
* **A partir do Sesami:** vá a **Portal de administração do Sesami > Apps**, instale a app **Klaviyo** , abra-a e clique em **Ligar ao Klaviyo**. Inicie sessão no Klaviyo e aprove a ligação.

Depois de ligado, a app abre em **Eventos de reserva**.

## Escolher quais eventos enviar

1. Na app Klaviyo, clique em **Adicionar evento**
2. Escolha um evento:

| Evento                      | Enviado quando                                 |
| --------------------------- | ---------------------------------------------- |
| **Reserva criada**          | Uma reserva é feita, online ou pela sua equipa |
| **Reserva atualizada**      | Qualquer detalhe de uma reserva é alterado     |
| **Reserva cancelada**       | Uma reserva é cancelada                        |
| **Reserva reagendada**      | Uma reserva é movida para uma nova hora        |
| **Check-in da reserva**     | Um cliente faz check-in para a sua reserva     |
| **Reserva sem comparência** | Uma reserva é marcada como não comparecida     |

3. Escolher **Enviar teste** para enviar imediatamente um evento de teste. O Klaviyo só lista uma métrica depois de receber uma, por isso um teste permite-lhe começar a criar fluxos de imediato.

Adicione tantos eventos quantos precisar. Cada um mostra o seu estado na lista: quando foi enviado pela última vez, que está à espera do seu primeiro evento, ou porque falhou a última entrega.

{% hint style="info" %}
**Os lembretes de reserva**  são enviados pelos Sesami Flows: use os emails de lembrete incorporados do Sesami, ou o [predefinido de lembrete do Klaviyo](https://help.sesami.co/pt/automacoes/sesami-flows-and-klaviyo.md) para os enviar através do Klaviyo, por exemplo, 24 horas antes da visita.
{% endhint %}

{% hint style="info" %}
Os eventos são associados aos perfis Klaviyo pelo endereço de email do cliente. As reservas sem email do cliente são ignoradas, e o evento mostra o motivo na lista.
{% endhint %}

## Criar um fluxo no Klaviyo

1. No Klaviyo, vá a **Fluxos > Criar fluxo > Criar o seu próprio**
2. Escolher **Métrica** como acionador e escolha o evento Sesami, por exemplo **Reserva criada**. Os eventos Sesami mostram o logótipo do Sesami.
3. Adicione uma ação de email ou SMS e desenhe a mensagem
4. Use os detalhes da reserva no seu modelo, por exemplo `{{ event.service_name }}` ou `{{ event.datetime }}`

{% hint style="success" %}
**Marque as mensagens de reserva como transacionais.** As confirmações e os avisos de alteração são transacionais, não de marketing. Nas definições de mensagem do fluxo, defina o tipo de mensagem como **Transacional** e desative **Smart Sending** , para que todos os clientes as recebam.
{% endhint %}

## Detalhes da reserva que pode usar

Cada evento de reserva inclui estas propriedades. Use-as em modelos como `{{ event.<property> }}`:

| Propriedade                     | Exemplo                                | Descrição                                                       |
| ------------------------------- | -------------------------------------- | --------------------------------------------------------------- |
| `service_name`                  | Massagem de tecido profundo            | O serviço reservado                                             |
| `variant_title`                 | 60 minutos                             | A opção escolhida                                               |
| `datetime`                      | 24 de outubro de 2026 às 10:44         | Data e hora no local                                            |
| `datetime_in_customer_timezone` | 24 de outubro de 2026 às 7:44          | Data e hora no fuso horário do cliente                          |
| `start_time`, `end_time`        | 2026-10-24T14:44:00Z                   | Início e fim em UTC, para filtros e lógica baseada no tempo     |
| `service_duration`              | 60                                     | Duração em minutos                                              |
| `service_description`           | Por favor, chegue 10 minutos mais cedo | Descrição do serviço                                            |
| `service_image_url`             | <https://cdn.shopify.com/…>            | A imagem do serviço                                             |
| `service_price`, `currency`     | 100, USD                               | Preço da reserva e moeda                                        |
| `location`, `location_address`  | SoHo, 123 Main St, Nova Iorque         | Onde está a reserva                                             |
| `resources`                     | Anna, Sala 2                           | Os recursos atribuídos: membros da equipa, salas ou equipamento |
| `quantity`                      | 1                                      | Número de lugares reservados                                    |
| `status`                        | confirmado                             | Estado da reserva                                               |
| `order_name`                    | #1001                                  | A encomenda da Shopify, quando existir                          |
| `customer_management_link`      | https\://…                             | Ligação para o cliente gerir a sua reserva                      |
| `line_item_properties`          | pares de nome e valor                  | Respostas ao seu formulário de reserva                          |
| `booking_id`                    | 6ad9a8cc…                              | O ID da reserva Sesami                                          |

O nome e o apelido do cliente são adicionados ao respetivo perfil Klaviyo, por isso também pode usar `{{ first_name }}` nas mensagens.

## Alterar o seu plano

Se a sua loja mudar para um plano abaixo do Pro, a app mantém a sua ligação ao Klaviyo e os eventos escolhidos, mas pausa o envio. Cada evento mostra **Pausado** na lista. Voltar a Pro ou superior retoma o envio em poucos minutos, sem necessidade de configurar novamente.

## Remover um evento ou desligar

* **Remover um evento:** clique em **Remover** ao lado dele. Os fluxos acionados por ele deixam de ser executados para novas reservas até que o volte a adicionar. A métrica e o seu histórico permanecem no Klaviyo.
* **Desligar o Klaviyo:** na app, abra **Definições > Desligar o Klaviyo**. O Sesami deixa de enviar eventos e limpa os eventos escolhidos. As métricas e perfis já existentes no Klaviyo permanecem lá.

## Migrar de Sesami Flows

Se enviar eventos para o Klaviyo com os [predefinições Klaviyo do Sesami Flows](https://help.sesami.co/pt/automacoes/sesami-flows-and-klaviyo.md), a app é a substituição mais simples: sem chave de API, e os detalhes da reserva são preenchidos por si. A maioria dos nomes das propriedades mantém-se igual (`service_name`, `variant_title`, `customer_management_link` e mais), por isso os modelos são transferidos com poucas alterações.

1. Instale a app e adicione os eventos que utiliza
2. Em cada fluxo do Klaviyo, mude o acionador para a nova métrica, por exemplo de **Agendamento do Sesami criado** para **Reserva criada**
3. Desative os Sesami Flows que esses eventos substituem (criado, reagendado, cancelado, check-in, não comparecimento), para que os clientes não recebam mensagens duas vezes
4. Mantenha os seus **fluxos de lembrete** ativos: os lembretes antes da visita continuam a vir do Sesami Flows

## Relacionado

* [Klaviyo](https://help.sesami.co/pt/apps-integrations/klaviyo.md) — comparação entre a app Klaviyo e o Sesami Flows, e quando usar cada um
* [Sesami Flows e Klaviyo](https://help.sesami.co/pt/automacoes/sesami-flows-and-klaviyo.md) — a configuração baseada em Fluxos com a sua própria chave de API do Klaviyo
* [Sesami Flows](https://help.sesami.co/pt/automacoes/sesami-flows.md) — as automações incorporadas do Sesami
* [Emails de notificação](https://help.sesami.co/pt/notificacoes/notification-emails.md) — as notificações por email incorporadas do Sesami
* [Clientes](https://help.sesami.co/pt/apps-integrations/shopify/customers.md) — como os dados dos clientes fluem entre o Sesami, a Shopify e o Klaviyo


---

# 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/apps-integrations/klaviyo/klaviyo-app.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.
