> 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/es/automatizaciones/sesami-flows-and-omnisend.md).

# Sesami Flows y Omnisend

Integra Sesami con Omnisend para potenciar el marketing avanzado por correo electrónico y SMS para tu negocio de reservas.

## ¿Qué es Omnisend?

Omnisend es una plataforma de automatización de marketing especializada en email y marketing por SMS para negocios de comercio electrónico. Ofrece un conjunto de herramientas y funciones diseñadas para ayudar a los negocios de comercio electrónico a interactuar con sus clientes, aumentar las ventas y mejorar la eficiencia general del marketing.

## ¿Por qué integrar Sesami con Omnisend?

Puedes optimizar todas tus interacciones con los clientes enviando los datos de eventos de Sesami a Omnisend y activando todas las comunicaciones (email o SMS) a través de Omnisend. Para muchas empresas que ya usan Omnisend para enviar confirmaciones de pedidos, mensajes de marketing por SMS y otras comunicaciones, enviar también las confirmaciones de reservas y los recordatorios de citas a través de Omnisend crea una experiencia unificada para el cliente.

### Casos de uso comunes

**Flujos de trabajo de email y SMS:**

* Flujo de confirmación de cita
* Flujo de reprogramación de cita
* Flujo de cancelación de cita
* Flujo de recordatorio de cita (24 horas antes, o con un horario personalizado)
* Flujo de finalización de cita

## Cómo funciona

Sesami usa **Sesami Flows** para enviar eventos de reserva a Omnisend en tiempo real. Cuando se crea, reprograma, registra, inicia, cancela o marca como no presentada una cita, Sesami envía esos datos del evento a Omnisend a través de un webhook hacia un evento personalizado que has creado. Luego creas flujos de trabajo en Omnisend que activan mensajes de email o SMS basados en estos eventos personalizados.

### El flujo de los datos

1. El cliente reserva una cita en Sesami
2. Sesami Flow se activa y envía los datos del evento a Omnisend mediante un webhook
3. Omnisend recibe el evento como un evento personalizado (por ejemplo, "Cita creada")
4. El flujo de trabajo de Omnisend se activa en función de ese evento
5. El cliente recibe un email o SMS con los detalles de la cita

## Instrucciones de configuración

### Parte 1: Configura Omnisend

#### Paso 1: Instala y conecta Omnisend

1. Instala la **app de Omnisend** desde la Shopify App Store
2. Sigue los pasos de configuración de la app para conectar tu tienda
3. Completa el proceso de incorporación de Omnisend

#### Paso 2: Crea una clave API (KPI Key)

1. En Omnisend, haz clic en tu **pestaña de perfil**
2. Navega a **Configuración de la tienda**
3. Haz clic en **API Keys** pestaña
4. Haz clic en **Create Private API Key**
5. Nómbrala "Sesami Integration" (o algo similar)
6. Configura los permisos: selecciona lo siguiente:
   * **Campañas** - permite descargar informes, listas de destinatarios
   * **Contactos** - permite crear, editar, descargar y eliminar suscriptores
   * **Pedidos** - permite crear, editar, descargar y eliminar pedidos
   * **Productos** - permite crear, editar, descargar y eliminar productos
   * **Carritos** - permite crear, editar, descargar y eliminar carritos
   * **Eventos** - permite obtener y activar eventos personalizados (**Obligatorio**)
7. Copia la clave API generada y guárdala de forma segura

{% hint style="warning" %}
**Importante**: Necesitarás una clave API separada para cada tipo de evento único (cita creada, reprogramada, cancelada, etc.).
{% endhint %}

Para más detalles, revisa [la documentación de la API de Omnisend](https://api-docs.omnisend.com/).

#### Paso 3: Crea eventos personalizados en Omnisend

Para cada tipo de evento de cita que quieras rastrear, crea un evento personalizado:

1. En Omnisend, navega a **Configuración de la tienda > Eventos personalizados**
2. Haz clic en **Crear evento personalizado**
3. Configura el evento:
   * **Nombre del evento**: Elige un nombre descriptivo (por ejemplo, "Cita creada", "Cita reprogramada")
   * **Nombre del sistema**: Se generará automáticamente según el nombre del evento
   * **Campos personalizados del evento**: Define las propiedades de la reserva que quieres usar en tus emails/SMS:
     * `CustomerName` - Nombre del cliente
     * `ServiceName` - Nombre del servicio reservado
     * `DateTimeInCustomerTimezone` - Fecha/hora de la cita
     * `CustomerManagementLink` - Enlace para que el cliente gestione la reserva
     * `AppointmentID` - Identificador único de la cita
     * `TeamMember` - Nombre del miembro del personal asignado
     * Añade otros campos según sea necesario
4. Añadir cliente **email** y **teléfono** campos (obligatorios para enviar mensajes)
5. Guarda el evento personalizado
6. **Copia el ID del evento** - lo necesitarás para la URL del webhook de Sesami Flow

{% hint style="info" %}
Repite este proceso para cada tipo de evento que quieras rastrear (creado, reprogramado, cancelado, completado, recordatorio).
{% endhint %}

Para instrucciones detalladas, consulta [la documentación de eventos personalizados de Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).

### Parte 2: Configura Sesami Flows

#### Paso 1: Crea un Flow en Sesami

1. Abre el [Portal de administración de Sesami](https://help.sesami.co/admin/sesami-admin-portal)
2. Navega a **Flows**
3. Haz clic en **Crear Flow**

#### Paso 2: Configura el disparador del Flow

1. Elige tu evento desencadenante:
   * Cita creada
   * Cita reprogramada
   * El cliente se registró
   * Cita iniciada
   * Cita cancelada
   * No asistió
2. Configura **Cuándo** a **Inmediatamente**, o a un momento antes o después del evento (por ejemplo, 24 horas antes de la cita para un recordatorio)
3. Configura cualquier condición adicional si es necesario

#### Paso 3: Añade una acción de Webhook

1. Configura **Acción** tipo a **Webhook**
2. Configura el webhook:
   * **URL de destino**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Reemplaza `[EVENT_ID]` por el ID del evento que copiaste de Omnisend
   * **Cuándo**: Configúralo en "Inmediatamente" (o configura el horario para los recordatorios)

#### Paso 4: Configura los encabezados del webhook

En la sección de Encabezados del webhook, añade:

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "YOUR_OMNISEND_API_KEY"
}
```

Reemplaza `YOUR_OMNISEND_API_KEY` con la clave API real que creaste en Omnisend.

#### Paso 5: Configura el cuerpo del webhook

En la sección Body del webhook, asigna los datos de reserva de Sesami a tus campos personalizados de Omnisend:

```json
{
  "fields": {
    "CustomerName": "{{CustomerName}}",
    "ServiceName": "{{ServiceName}}",
    "DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
    "CustomerManagementLink": "{{CustomerManagementLink}}",
    "AppointmentID": "{{AppointmentID}}",
    "TeamMember": "{{TeamMember}}"
  },
  "email": "{{CustomerEmail}}",
  "phone": "{{CustomerPhone}}"
}
```

{% hint style="info" %}
Los nombres de campo en `"fields"` deben coincidir exactamente con los campos personalizados que definiste en tu evento personalizado de Omnisend.
{% endhint %}

#### Paso 6: Guarda y activa el Flow

1. Dale a tu Flow un nombre descriptivo (por ejemplo, "Omnisend - Cita creada")
2. **Guardar** el Flow
3. Activa el Flow

Repite los pasos 1-6 para cada tipo de evento que quieras enviar a Omnisend.

### Parte 3: Crea flujos de trabajo en Omnisend

#### Paso 1: Crea un flujo de trabajo personalizado

1. Inicia sesión en **Omnisend**
2. Navega a **Automatización > Flujos de trabajo**
3. Haz clic en **Nuevo flujo de trabajo**
4. Selecciona **Crear flujo de trabajo personalizado**

#### Paso 2: Configura el disparador

1. Para el disparador, selecciona tu evento personalizado (por ejemplo, "Cita creada")
2. El flujo de trabajo se activará cada vez que Sesami envíe datos a este evento

#### Paso 3: Añade acciones de Email o SMS

1. Haz clic en **Añadir acción** en el flujo de trabajo
2. Elige **Email** o **SMS**
3. Diseña tu plantilla de mensaje

#### Paso 4: Usa campos personalizados en tu plantilla

Al editar el contenido de tu email o SMS, puedes acceder a las propiedades de la reserva usando la sintaxis de campos personalizados:

* `[[custom_event.CustomerName]]` - Nombre del cliente
* `[[custom_event.ServiceName]]` - Nombre del servicio
* `[[custom_event.DateTimeInCustomerTimezone]]` - Fecha/hora de la cita
* `[[custom_event.CustomerManagementLink]]` - Enlace para gestionar la reserva
* `[[custom_event.TeamMember]]` - Miembro del equipo asignado

#### Paso 5: Configura ajustes adicionales del flujo de trabajo

1. Configura **Frecuencia** reglas (por ejemplo, "No volver a activar el flujo de trabajo para contactos que ya hayan estado en esta automatización")
2. Añadir **Condiciones de salida** si es necesario
3. Configura cualquier retraso de tiempo o división condicional

#### Paso 6: Activa el flujo de trabajo

Una vez que hayas diseñado y probado tu flujo de trabajo, haz clic en **Activar** para ponerlo en funcionamiento.

## Prueba de tu integración

Antes de ponerlo en marcha, prueba la integración:

1. Crea una reserva de prueba en Sesami
2. Comprueba que el evento aparezca en Omnisend en **Configuración de la tienda > Eventos personalizados** (ver la actividad del evento)
3. Verifica que todas las propiedades de la cita se estén completando correctamente
4. Prueba tu flujo de trabajo de Omnisend para asegurarte de que los emails/SMS se envían correctamente
5. Revisa el contenido para asegurarte de que todos los campos personalizados se muestren correctamente

{% hint style="success" %}
**Consejo profesional**: Crea una dirección de email y un número de teléfono de cliente de prueba, y luego haz reservas de prueba para verificar la experiencia completa del cliente antes de activar los flujos de trabajo para clientes reales.
{% endhint %}

## Preguntas frecuentes

<details>

<summary>¿Necesito una clave API separada para cada tipo de evento?</summary>

Sí, Omnisend requiere una clave API única para cada evento personalizado que crees. Esto significa que si estás rastreando eventos de cita creada, reprogramada y cancelada, necesitarás tres claves API separadas.

</details>

<details>

<summary>¿Puedo usar Omnisend para SMS además de email?</summary>

¡Sí! Omnisend admite tanto email como SMS. Asegúrate de:

* Incluir el `teléfono` campo en el cuerpo de tu webhook
* Tener SMS habilitado en tu cuenta de Omnisend
* Haber recopilado números de teléfono de clientes con el consentimiento adecuado
* Configurar acciones de SMS en tus flujos de trabajo de Omnisend

Para más detalles, consulta [la documentación de SMS de Omnisend](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>¿Qué pasa si necesito varios flujos de recordatorio?</summary>

Puedes crear varios Flows de recordatorio en Sesami, cada uno con un horario diferente:

* 7 días antes de la cita
* 24 horas antes de la cita
* 2 horas antes de la cita

Cada uno puede enviar al mismo evento personalizado de Omnisend, o puedes crear eventos personalizados separados para diferentes horarios de recordatorio.

</details>

<details>

<summary>Los eventos no aparecen en Omnisend. ¿Qué debo revisar?</summary>

* Verifica que tu clave API de Omnisend sea correcta y que tenga habilitado el permiso "Events"
* Asegúrate de que el ID del evento en la URL de tu webhook coincida con tu evento personalizado
* Comprueba que el Flow esté activado en Sesami
* Verifica que hayas hecho una reserva de prueba después de configurar el Flow
* Revisa los registros de Sesami Flow para ver si el webhook se envió correctamente
* Comprueba la actividad del evento personalizado en Omnisend (Configuración de la tienda > Eventos personalizados)
* Asegúrate de que todos los campos obligatorios (email o teléfono) estén incluidos en el cuerpo del webhook

</details>

<details>

<summary>¿Puedo usar traducciones para diferentes idiomas?</summary>

¡Sí! Omnisend admite traducciones para campañas y emails automatizados. Puedes crear versiones localizadas de tus flujos de trabajo según las preferencias de idioma del cliente. Consulta [la documentación de traducciones de Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Relacionado

* [Sesami Flows](https://help.sesami.co/es/automatizaciones/sesami-flows.md) - Resumen del sistema de automatización de Sesami
* [Acciones de Email y Webhook](https://help.sesami.co/es/automatizaciones/email-and-webhook-as-action-types.md) - Entender los tipos de acción
* [Sesami Flows y Klaviyo](https://help.sesami.co/es/automatizaciones/sesami-flows-and-klaviyo.md) - Integración alternativa de ESP
* [Emails de notificación](https://help.sesami.co/es/notificaciones/notification-emails.md) - Sistema de notificación predeterminado de 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/es/automatizaciones/sesami-flows-and-omnisend.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.
