# Sesami Flows e Omnisend
Integre o Sesami com o Omnisend para potenciar marketing avançado por e-mail e SMS para o seu negócio de reservas.
## O que é o Omnisend?
O Omnisend é uma plataforma de automação de marketing especializada em marketing por e-mail e SMS para negócios de comércio eletrónico. Fornece um conjunto de ferramentas e funcionalidades concebidas para ajudar negócios de comércio eletrónico a envolver os seus clientes, aumentar as vendas e melhorar a eficiência global do marketing.
## Por que integrar o Sesami com o Omnisend?
Pode simplificar todas as suas interações com o cliente ao enviar dados de eventos do Sesami para o Omnisend e acionar todas as comunicações (e-mail ou SMS) através do Omnisend. Para muitas empresas que já utilizam o Omnisend para enviar confirmações de encomenda, mensagens de marketing por SMS e outras comunicações, enviar também as confirmações de reserva e lembretes de compromissos através do Omnisend cria uma experiência de cliente unificada.
### Casos de uso comuns
**Fluxos de trabalho 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 horário personalizado)
* Fluxo de conclusão de agendamento
## Como funciona
O Sesami usa **Sesami Flows** para enviar eventos de reserva para o Omnisend em tempo real. Quando um compromisso é criado, reagendado, cancelado ou concluído, o Sesami envia esses dados do evento para o Omnisend através de webhook para um evento personalizado que criou. Depois, cria fluxos de trabalho no Omnisend que acionam mensagens de e-mail ou SMS com base nesses eventos personalizados.
### O fluxo de dados
1. O cliente agenda um compromisso no Sesami
2. O Sesami Flow aciona e envia dados do evento para o Omnisend através de 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 agendamento
## Instruções de configuração
### Parte 1: Configurar o Omnisend
#### Passo 1: Instalar e ligar o Omnisend
1. Instale a **aplicação Omnisend** da Shopify App Store
2. Siga os passos de configuração da aplicação para ligar a sua loja
3. Conclua o processo de integração inicial do Omnisend
#### Passo 2: Criar uma chave de API (chave KPI)
1. No Omnisend, clique no seu **separador de perfil**
2. Navegue até **Definições da loja**
3. Clique em **Chaves de API** separador
4. Clique em **Criar Chave de API Privada**
5. Dê-lhe o nome "Integração Sesami" (ou semelhante)
6. Configure as permissões - selecione o seguinte:
* **Campanhas** - permite descarregar relatórios, listas de destinatários
* **Contactos** - permite criar, editar, descarregar, eliminar subscritores
* **Encomendas** - permite criar, editar, descarregar, eliminar encomendas
* **Produtos** - permite criar, editar, descarregar, eliminar produtos
* **Carrinhos** - permite criar, editar, descarregar, eliminar carrinhos
* **Eventos** - permite obter e acionar eventos personalizados (**Obrigatório**)
7. Copie a chave de API gerada e guarde-a em segurança
{% hint style="warning" %}
**Importante**: Vai precisar de uma chave de API separada para cada tipo de evento único (compromisso criado, reagendado, cancelado, etc.).
{% endhint %}
Para mais detalhes, consulte [Documentação da API do Omnisend](https://api-docs.omnisend.com/).
#### Passo 3: Criar eventos personalizados no Omnisend
Para cada tipo de evento de compromisso que pretende acompanhar, crie um evento personalizado:
1. No Omnisend, navegue até **Definiçõ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**: Este será gerado automaticamente com base no nome do evento
* **Campos personalizados do evento**: Defina as propriedades da reserva que pretende usar nos seus e-mails/SMS:
* `NomeDoCliente` - Nome do cliente
* `NomeDoServiço` - Nome do serviço reservado
* `DataHoraNoFusoHorárioDoCliente` - Data/hora do compromisso
* `LinkDeGestãoDoCliente` - Ligação para o cliente gerir a reserva
* `IDDoCompromisso` - Identificador único do compromisso
* `MembroDaEquipa` - Nome do colaborador atribuído
* Adicione outros campos conforme necessário
4. Adicionar cliente **e-mail** e **telefone** campos (obrigatórios para enviar mensagens)
5. Guarde o evento personalizado
6. **Copie o ID do evento** - vai precisar disto para o URL do webhook do Sesami Flow
{% hint style="info" %}
Repita este processo para cada tipo de evento que pretende acompanhar (criado, reagendado, cancelado, concluído, lembrete).
{% endhint %}
Para instruções detalhadas, consulte [documentação de eventos personalizados do Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).
### Parte 2: Configurar os Sesami Flows
#### Passo 1: Crie um Flow no Sesami
1. Abra **Sesami** no seu Admin da Shopify
2. Navegue até **Configurações > Flows**
3. Clique em **Criar um Flow**
#### Passo 2: Configurar o acionador do Flow
1. Escolha o seu evento acionador:
* Compromisso criado
* Compromisso reagendado
* Compromisso cancelado
* Compromisso concluído
* Lembrete baseado no tempo (por exemplo, 24 horas antes do compromisso)
2. Configure quaisquer condições adicionais, se necessário
#### Passo 3: Adicionar uma ação de webhook
1. Defina **Ação** tipo para **Webhook**
2. Configure o webhook:
* **URL de destino**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
* Substitua `[EVENT_ID]` pelo ID do evento que copiou do Omnisend
* **Quando**: Defina como "Imediatamente" (ou configure o tempo para lembretes)
#### Passo 4: Configurar os cabeçalhos do webhook
Na secção Headers do webhook, adicione:
```json
{
"Content-Type": "application/json",
"X-API-KEY": "YOUR_OMNISEND_API_KEY"
}
```
Substitua `YOUR_OMNISEND_API_KEY` pela chave de API real que criou no Omnisend.
#### Passo 5: Configurar o corpo do webhook
Na secção Body do webhook, mapeie os dados de reserva 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 definiu no seu evento personalizado do Omnisend.
{% endhint %}
#### Passo 6: Guardar e ativar o Flow
1. Dê ao seu Flow um nome descritivo (por exemplo, "Omnisend - Compromisso Criado")
2. **Guardar** o Flow
3. Ative o Flow
Repita os passos 1-6 para cada tipo de evento que pretende enviar para o Omnisend.
### Parte 3: Criar fluxos de trabalho no Omnisend
#### Passo 1: Criar um fluxo de trabalho personalizado
1. Faça login em **Omnisend**
2. Navegue até **Automação > Fluxos de trabalho**
3. Clique em **Novo fluxo de trabalho**
4. Selecione **Criar fluxo de trabalho personalizado**
#### Passo 2: Configurar o acionador
1. Para o acionador, selecione o seu evento personalizado (por exemplo, "Compromisso Criado")
2. O fluxo de trabalho será acionado sempre que o Sesami enviar dados para este evento
#### Passo 3: Adicionar ações de e-mail ou SMS
1. Clique em **Adicionar ação** no fluxo de trabalho
2. Escolha **Email** ou **SMS**
3. Desenhe o modelo da sua mensagem
#### Passo 4: Usar campos personalizados no seu modelo
Ao editar o conteúdo do seu e-mail ou SMS, pode aceder às propriedades da reserva 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]]` - Ligação de gestão da reserva
* `[[custom_event.TeamMember]]` - Membro da equipa atribuído
#### Passo 5: Configurar definições adicionais do fluxo de trabalho
1. Defina **Frequência** regras (por exemplo, "Não voltar a acionar o fluxo de trabalho para contactos que já estiveram nesta automação")
2. Adicionar **Condições de saída** se necessário
3. Configure quaisquer atrasos temporais ou divisões condicionais
#### Passo 6: Ativar o fluxo de trabalho
Depois de ter concebido e testado o seu fluxo de trabalho, clique **Ativar** para o colocar em funcionamento.
## 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 **Definiçõ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 o seu fluxo de trabalho do Omnisend para garantir que os e-mails/SMS são enviados corretamente
5. Reveja o conteúdo para garantir que todos os campos personalizados são apresentados corretamente
{% hint style="success" %}
**Dica profissional**: Crie um endereço de e-mail e um número de telefone de cliente de teste 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 %}
## FAQ
Preciso de uma chave de API separada para cada tipo de evento?
Sim, o Omnisend requer uma chave de API única para cada evento personalizado que criar. Isto significa que, se estiver a acompanhar eventos de compromisso criado, reagendado e cancelado, vai precisar de três chaves de API separadas.
Posso usar o Omnisend para SMS, bem como para e-mail?
Sim! O Omnisend suporta tanto e-mail como SMS. Certifique-se de que:
* Inclui o campo `telefone` no corpo do seu webhook
* Tem SMS ativado na sua conta Omnisend
* Recolheu números de telefone dos clientes com o consentimento adequado
* Configura ações de SMS nos seus fluxos de trabalho do Omnisend
Para mais detalhes, consulte [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?
Pode criar vários Flows de lembrete no Sesami, cada um com tempos diferentes:
* 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 pode criar eventos personalizados separados para diferentes tempos de lembrete.
Os eventos não estão a aparecer no Omnisend. O que devo verificar?
* Verifique se a sua chave de API do Omnisend está correta e se tem a permissão "Events" ativada
* Certifique-se de que o ID do evento no URL do seu webhook corresponde ao seu evento personalizado
* Verifique se o Flow está ativado no Sesami
* Verifique se fez uma reserva de teste depois de configurar o Flow
* Revise os logs do Flow do Sesami para ver se o webhook foi enviado com sucesso
* Verifique a atividade do evento personalizado no Omnisend (Definições da loja > Eventos personalizados)
* Certifique-se de que todos os campos obrigatórios (e-mail ou telefone) estão incluídos no corpo do webhook
Posso usar traduções para diferentes idiomas?
Sim! O Omnisend suporta traduções para campanhas e e-mails automatizados. Pode criar versões localizadas dos seus fluxos de trabalho com base nas preferências de idioma do cliente. Consulte [documentação de tradução do Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).
## Relacionado
* [Sesami Flows](/pt/automatizacoes/sesami-flows.md) - Visão geral do sistema de automação do Sesami
* [Ações de E-mail e Webhook](/pt/automatizacoes/email-and-webhook-as-action-types.md) - Entendendo os tipos de ação
* [Sesami Flows e Klaviyo](/pt/automatizacoes/sesami-flows-and-klaviyo.md) - Integração ESP alternativa
* [E-mails de notificação](/pt/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/automatizacoes/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.