# Fluxos da Sesami e Omnisend
Integre o Sesami com o Omnisend para impulsionar o marketing avançado por email e SMS para o seu negócio de agendamentos.
## O que é o Omnisend?
O Omnisend é uma plataforma de automação de marketing especializada em marketing por email e SMS para empresas de e-commerce. Ele oferece um conjunto de ferramentas e recursos projetados para ajudar empresas de e-commerce a interagir com seus clientes, aumentar as vendas e melhorar a eficiência geral do marketing.
## Por que integrar o Sesami com o Omnisend?
Você pode simplificar todas as interações com seus clientes alimentando os dados de eventos do Sesami no Omnisend e disparando todas as comunicações (Email ou SMS) via Omnisend. Para muitas empresas que já usam o Omnisend 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 Omnisend cria uma experiência unificada para o cliente.
### Casos de uso comuns
**Fluxos de trabalho de Email 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
## Como funciona
O Sesami usa **Sesami Flows** para enviar eventos de agendamento ao Omnisend em tempo real. Quando um compromisso é criado, reagendado, cancelado ou concluído, o Sesami envia esses dados do evento ao Omnisend via webhook para um evento personalizado que você criou. Em seguida, você cria fluxos de trabalho no Omnisend que disparam mensagens de email ou SMS com base nesses eventos personalizados.
### O fluxo de dados
1. O cliente agenda um compromisso no Sesami
2. O fluxo do Sesami dispara e envia os dados do evento ao Omnisend via webhook
3. O Omnisend recebe o evento como um evento personalizado (por exemplo, "Compromisso Criado")
4. O fluxo de trabalho do Omnisend é acionado com base nesse evento
5. O cliente recebe um e-mail ou SMS com os detalhes do compromisso
## Instruções de configuração
### Parte 1: Configure o Omnisend
#### Passo 1: Instale e conecte o Omnisend
1. Instale o **app Omnisend** na Shopify App Store
2. Siga as etapas de configuração do app para conectar sua loja
3. Conclua o processo de onboarding do Omnisend
#### Passo 2: Crie uma chave de API (KPI Key)
1. No Omnisend, clique na sua **aba de perfil**
2. Acesse **Configurações da loja**
3. Clique na aba **Chaves de API** aba
4. Clique em **Criar Chave de API Privada**
5. Nomeie como "Integração Sesami" (ou similar)
6. Configure as permissões - selecione o seguinte:
* **Campanhas** - permite baixar relatórios, listas de destinatários
* **Contatos** - permite criar, editar, baixar e excluir assinantes
* **Pedidos** - permite criar, editar, baixar e excluir pedidos
* **Produtos** - permite criar, editar, baixar e excluir produtos
* **Carrinhos** - permite criar, editar, baixar e excluir carrinhos
* **Eventos** - permite obter e disparar eventos personalizados (**Obrigatório**)
7. Copie a chave de API gerada e armazene-a com segurança
{% hint style="warning" %}
**Importante**: Você precisará de uma chave de API separada para cada tipo de evento exclusivo (compromisso criado, reagendado, cancelado etc.).
{% endhint %}
Para mais detalhes, consulte [a documentação da API do Omnisend](https://api-docs.omnisend.com/).
#### Passo 3: Crie eventos personalizados no Omnisend
Para cada tipo de evento de compromisso que você deseja rastrear, crie um evento personalizado:
1. No Omnisend, navegue até **Configurações da loja > Eventos personalizados**
2. Clique em **Criar evento personalizado**
3. Configure o evento:
* **Nome do evento**: Escolha um nome descritivo (por exemplo, "Compromisso Criado", "Compromisso Reagendado")
* **Nome do sistema**: Será gerado automaticamente com base no nome do evento
* **Campos personalizados do evento**: Defina as propriedades do agendamento que você deseja usar em seus emails/SMS:
* `CustomerName` - Nome do cliente
* `ServiceName` - Nome do serviço agendado
* `DateTimeInCustomerTimezone` - Data/hora do compromisso
* `CustomerManagementLink` - Link para o cliente gerenciar o agendamento
* `AppointmentID` - Identificador exclusivo do compromisso
* `TeamMember` - Nome do membro da equipe atribuído
* Adicione outros campos conforme necessário
4. Adicionar cliente **email** e **phone** campos (obrigatórios para enviar mensagens)
5. Salve o evento personalizado
6. **Copie o Event ID** - você precisará dele para a URL do webhook do fluxo do Sesami
{% hint style="info" %}
Repita esse processo para cada tipo de evento que você deseja rastrear (criado, reagendado, cancelado, concluído, lembrete).
{% endhint %}
Para instruções detalhadas, consulte [a documentação de eventos personalizados do Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).
### Parte 2: Configure os fluxos do Sesami
#### 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**
#### Passo 2: Configure o gatilho do fluxo
1. Escolha o evento de gatilho:
* Compromisso criado
* Compromisso reagendado
* Compromisso cancelado
* Compromisso concluído
* Lembrete com base no tempo (por exemplo, 24 horas antes do compromisso)
2. Configure quaisquer condições adicionais, se necessário
#### Passo 3: Adicione uma ação de Webhook
1. Defina **Ação** tipo como **Webhook**
2. Configure o webhook:
* **URL de destino**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
* Substitua `[EVENT_ID]` pelo Event ID que você copiou do Omnisend
* **Quando**: Defina como "Imediatamente" (ou configure o timing para lembretes)
#### Passo 4: Configure os cabeçalhos do webhook
Na seção de cabeçalhos do webhook, adicione:
```json
{
"Content-Type": "application/json",
"X-API-KEY": "SUA_CHAVE_DE_API_DO_OMNISEND"
}
```
Substitua `SUA_CHAVE_DE_API_DO_OMNISEND` pela chave de API real que você criou no Omnisend.
#### Passo 5: Configure o corpo do webhook
Na seção Corpo do webhook, mapeie os dados de agendamento do Sesami para os seus campos personalizados do Omnisend:
```json
{
"fields": {
"CustomerName": "{{CustomerName}}",
"ServiceName": "{{ServiceName}}",
"DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
"CustomerManagementLink": "{{CustomerManagementLink}}",
"AppointmentID": "{{AppointmentID}}",
"TeamMember": "{{TeamMember}}"
},
"email": "{{CustomerEmail}}",
"phone": "{{CustomerPhone}}"
}
```
{% hint style="info" %}
Os nomes dos campos em `"fields"` devem corresponder exatamente aos campos personalizados que você definiu no seu evento personalizado do Omnisend.
{% endhint %}
#### Passo 6: Salve e ative o fluxo
1. Dê ao seu fluxo um nome descritivo (por exemplo, "Omnisend - Compromisso Criado")
2. **Salvar** o Flow
3. Ative o fluxo
Repita as etapas 1 a 6 para cada tipo de evento que você deseja enviar ao Omnisend.
### Parte 3: Crie fluxos de trabalho no Omnisend
#### Passo 1: Crie um fluxo de trabalho personalizado
1. Faça login em **Omnisend**
2. Acesse **Automação > Fluxos de trabalho**
3. Clique em **Novo fluxo de trabalho**
4. Selecione **Criar fluxo de trabalho personalizado**
#### Passo 2: Configure o gatilho
1. Para o gatilho, selecione seu evento personalizado (por exemplo, "Compromisso Criado")
2. O fluxo de trabalho será acionado sempre que o Sesami enviar dados para esse evento
#### Passo 3: Adicione ações de Email ou SMS
1. Clique em **Adicionar ação** no fluxo de trabalho
2. Escolha **E-mail** ou **SMS**
3. Desenhe seu modelo de mensagem
#### Passo 4: Use campos personalizados no seu modelo
Ao editar o conteúdo do seu email ou SMS, você pode acessar as propriedades do agendamento usando a sintaxe de campo personalizado:
* `[[custom_event.CustomerName]]` - Nome do cliente
* `[[custom_event.ServiceName]]` - Nome do serviço
* `[[custom_event.DateTimeInCustomerTimezone]]` - Data/hora do compromisso
* `[[custom_event.CustomerManagementLink]]` - Link de gerenciamento do agendamento
* `[[custom_event.TeamMember]]` - Membro da equipe atribuído
#### Passo 5: Configure definições adicionais do fluxo de trabalho
1. Defina **Frequência** regras (por exemplo, "Não reativar o fluxo de trabalho para contatos que já estiveram nesta automação")
2. Adicionar **Condições de saída** se necessário
3. Configure quaisquer atrasos de tempo ou divisões condicionais
#### Passo 6: Ative o fluxo de trabalho
Depois de criar e testar seu fluxo de trabalho, clique **Ative** para colocá-lo no ar.
## 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 Omnisend em **Configurações da loja > Eventos personalizados** (ver a atividade do evento)
3. Verifique se todas as propriedades do agendamento estão sendo preenchidas corretamente
4. Teste seu fluxo de trabalho do Omnisend para garantir que os emails/SMS sejam enviados corretamente
5. Revise o conteúdo para garantir que todos os campos personalizados sejam exibidos corretamente
{% hint style="success" %}
**Dica de ouro**: Crie um endereço de email e um número de telefone de teste para o cliente e, em seguida, faça reservas de teste para verificar a experiência completa do cliente antes de ativar os fluxos de trabalho para clientes reais.
{% endhint %}
## Perguntas frequentes
Preciso de uma chave de API separada para cada tipo de evento?
Sim, o Omnisend exige uma chave de API exclusiva para cada evento personalizado que você criar. Isso significa que, se você estiver acompanhando eventos de compromisso criado, reagendado e cancelado, precisará de três chaves de API separadas.
Posso usar o Omnisend para SMS além de email?
Sim! O Omnisend oferece suporte tanto a email quanto a SMS. Certifique-se de:
* Inclua o `phone` campo no corpo do webhook
* Ter SMS ativado na sua conta do Omnisend
* Ter coletado números de telefone dos clientes com o consentimento adequado
* Configurar ações de SMS nos seus fluxos de trabalho do Omnisend
Para mais detalhes, consulte [a documentação de SMS do Omnisend](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).
E se eu precisar de vários fluxos de trabalho de lembrete?
Você pode criar vários fluxos de lembrete no Sesami, cada um com um timing diferente:
* 7 dias antes do agendamento
* 24 horas antes do agendamento
* 2 horas antes do agendamento
Cada um pode enviar para o mesmo evento personalizado do Omnisend, ou você pode criar eventos personalizados separados para diferentes horários de lembrete.
Os eventos não estão aparecendo no Omnisend. O que devo verificar?
* Verifique se sua chave de API do Omnisend está correta e tem a permissão "Events" ativada
* Certifique-se de que o Event ID na URL do webhook corresponda ao seu evento personalizado
* Verifique se o fluxo está ativado no Sesami
* Confirme se você fez uma reserva de teste depois de configurar o fluxo
* Revise os logs do Flow do Sesami para ver se o webhook foi enviado com sucesso
* Verifique a atividade do evento personalizado no Omnisend (Configurações da loja > Eventos personalizados)
* Certifique-se de que todos os campos obrigatórios (email ou phone) estejam incluídos no corpo do webhook
Posso usar traduções para diferentes idiomas?
Sim! O Omnisend oferece suporte a traduções para campanhas e emails automatizados. Você pode criar versões localizadas dos seus fluxos de trabalho com base nas preferências de idioma dos clientes. Veja [a documentação de tradução do Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).
## 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
* [Sesami Flows e Klaviyo](/pt-br/automacoes/sesami-flows-and-klaviyo.md) - Integração alternativa de ESP
* [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-omnisend.md?ask=
```
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.