# Sesami Flows y Omnisend

Integra Sesami con Omnisend para impulsar 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 que se especializa en marketing por correo electrónico y 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 simplificar todas tus interacciones de cara al cliente enviando los datos de eventos de Sesami a Omnisend y activando todas las comunicaciones (correo electrónico 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 recordatorios de citas a través de Omnisend crea una experiencia unificada para el cliente.

### Casos de uso comunes

**Flujos de trabajo de correo electrónico 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 horario personalizado)
* Flujo de finalización de cita

## Cómo funciona

Sesami utiliza **Sesami Flows** para enviar eventos de reservas a Omnisend en tiempo real. Cuando se crea, reprograma, cancela o completa una cita, Sesami envía esos datos del evento a Omnisend mediante un webhook a un evento personalizado que hayas creado. Luego creas flujos de trabajo en Omnisend que activan mensajes de correo electrónico o SMS basados en estos eventos personalizados.

### El flujo de datos

1. El cliente reserva una cita en Sesami
2. Los disparadores de Sesami Flow envían los datos del evento a Omnisend mediante webhook
3. Omnisend recibe el evento como un evento personalizado (p. ej., "Cita creada")
4. El flujo de trabajo de Omnisend se activa en función de ese evento
5. El cliente recibe un correo electrónico 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 **Aplicación de Omnisend** desde la Shopify App Store
2. Sigue los pasos de configuración de la aplicación para conectar tu tienda
3. Completa el proceso de incorporación de Omnisend

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

1. En Omnisend, haz clic en tu **pestaña de perfil**
2. Ve a **Configuración de la tienda**
3. Haz clic en **Clave API** pestaña
4. Haz clic en **Crear clave privada de API**
5. Nómbrala "Integración con Sesami" (o algo similar)
6. Configura los permisos: selecciona los siguientes:
   * **Campañas** - permite descargar informes y 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 (**Requerido**)
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 [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 seguir, 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 (p. ej., "Cita creada", "Cita reprogramada")
   * **Nombre del sistema**: Se generará automáticamente a partir del nombre del evento
   * **Campos personalizados del evento**: Define las propiedades de la reserva que quieres usar en tus correos electrónicos/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 **correo electrónico** y **teléfono** campos (requeridos 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 seguir (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 los Flujos de Sesami

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

1. Abre **Sesami** en tu panel de administración de Shopify
2. Ve a **Configuración > Flujos**
3. Haz clic en **Crear un flujo**

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

1. Elige tu evento disparador:
   * Cita creada
   * Cita reprogramada
   * Cita cancelada
   * Cita completada
   * Recordatorio basado en tiempo (p. ej., 24 horas antes de la cita)
2. Configura cualquier condición adicional si es necesario

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

1. Establece **Acción** tipo en **Webhook**
2. Configura el webhook:
   * **URL de destino**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Reemplaza `[EVENT_ID]` con el ID del evento que copiaste de Omnisend
   * **Cuando**: Establece en "Inmediatamente" (o configura el tiempo para los recordatorios)

#### Paso 4: Configura las cabeceras del webhook

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

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

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

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

En la sección Cuerpo del webhook, asigna los datos de la 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 los campos en `"fields"` deben coincidir exactamente con los campos personalizados que definiste en tu evento personalizado de Omnisend.
{% endhint %}

#### Paso 6: Guarda y habilita el flujo

1. Dale a tu flujo un nombre descriptivo (p. ej., "Omnisend - Cita creada")
2. **Guardar** el flujo
3. Habilita el flujo

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. Ve 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 (p. ej., "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 correo electrónico o SMS

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

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

Al editar el contenido de tu correo electrónico o SMS, puedes acceder a las propiedades de la reserva usando la sintaxis de campo personalizado:

* `[[custom_event.CustomerName]]` - Nombre del cliente
* `[[custom_event.ServiceName]]` - Nombre del servicio
* `[[custom_event.DateTimeInCustomerTimezone]]` - Fecha/hora de la cita
* `[[custom_event.CustomerManagementLink]]` - Enlace de gestión de reservas
* `[[custom_event.TeamMember]]` - Miembro del equipo asignado

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

1. Establece **Frecuencia** reglas (p. ej., "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 temporal 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 **Habilitar** para ponerlo en vivo.

## Prueba de tu integración

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

1. Crea una reserva de prueba en Sesami
2. Comprueba que el evento aparezca en Omnisend bajo **Configuración de la tienda > Eventos personalizados** (ver la actividad del evento)
3. Verifica que todas las propiedades de la cita se estén rellenando correctamente
4. Prueba tu flujo de trabajo de Omnisend para asegurarte de que los correos electrónicos/SMS se envíen 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 correo electrónico y un número de teléfono de cliente de prueba, luego realiza reservas de prueba para verificar la experiencia completa del cliente antes de habilitar 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 haciendo seguimiento de eventos de cita creada, reprogramada y cancelada, necesitarás tres claves API separadas.

</details>

<details>

<summary>¿Puedo usar Omnisend para SMS además de correo electrónico?</summary>

¡Sí! Omnisend admite tanto correo electrónico como SMS. Asegúrate de:

* Incluye el `teléfono` campo en el cuerpo de tu webhook
* Tener los SMS habilitados en tu cuenta de Omnisend
* Haber recopilado los números de teléfono de los 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 trabajo de recordatorio?</summary>

Puedes crear varios Flujos de recordatorio en Sesami, cada uno con diferente temporización:

* 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 tiempos de recordatorio.

</details>

<details>

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

* Verifica que tu clave API de Omnisend sea correcta y 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 flujo esté habilitado en Sesami
* Verifica que hayas hecho una reserva de prueba después de configurar el flujo
* Revisa los registros del flujo de Sesami 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 requeridos (correo electrónico 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 correos electrónicos automatizados. Puedes crear versiones localizadas de tus flujos de trabajo según las preferencias de idioma de los clientes. Consulta [la documentación de traducción de Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Relacionado

* [Sesami Flows](/es/automatizaciones/sesami-flows.md) - Descripción general del sistema de automatización de Sesami
* [Acciones de correo electrónico y webhook](/es/automatizaciones/email-and-webhook-as-action-types.md) - Comprensión de los tipos de acción
* [Sesami Flows y Klaviyo](/es/automatizaciones/sesami-flows-and-klaviyo.md) - Integración alternativa de ESP
* [Correos electrónicos de notificación](/es/notificaciones/notification-emails.md) - Sistema de notificaciones predeterminado de 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/es/automatizaciones/sesami-flows-and-omnisend.md?ask=<question>
```

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.
