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

# Flussi Sesami e Omnisend

Integra Sesami con Omnisend per potenziare l'email marketing e l'SMS marketing avanzati per la tua attività di prenotazioni.

## Cos'è Omnisend?

Omnisend è una piattaforma di marketing automation specializzata nell'email marketing e nell'SMS marketing per le attività di e-commerce. Offre una suite di strumenti e funzionalità progettati per aiutare le attività di e-commerce a coinvolgere i propri clienti, aumentare le vendite e migliorare l'efficienza complessiva del marketing.

## Perché integrare Sesami con Omnisend?

Puoi semplificare tutte le interazioni con i clienti facendo confluire i dati degli eventi di Sesami in Omnisend e attivando tutte le comunicazioni (email o SMS) tramite Omnisend. Per molte aziende che già usano Omnisend per inviare conferme d'ordine, messaggi di marketing via SMS e altre comunicazioni, inviare anche le conferme di prenotazione e i promemoria degli appuntamenti tramite Omnisend crea un'esperienza cliente unificata.

### Casi d'uso comuni

**Flussi di lavoro email e SMS:**

* Flusso di conferma dell'appuntamento
* Flusso di riprogrammazione dell'appuntamento
* Flusso di cancellazione dell'appuntamento
* Flusso di promemoria dell'appuntamento (24 ore prima, o a un orario personalizzato)
* Flusso di completamento dell'appuntamento

## Come funziona

Sesami utilizza **Sesami Flows** per inviare eventi di prenotazione a Omnisend in tempo reale. Quando un appuntamento viene creato, riprogrammato, registrato, avviato, cancellato o contrassegnato come no-show, Sesami invia i dati di quell'evento a Omnisend tramite webhook verso un evento personalizzato che hai creato. Quindi crei workflow in Omnisend che attivano messaggi email o SMS in base a questi eventi personalizzati.

### Il flusso dei dati

1. Il cliente prenota un appuntamento in Sesami
2. Il Flusso Sesami si attiva e invia i dati dell'evento a Omnisend tramite webhook
3. Omnisend riceve l'evento come evento personalizzato (ad es. "Appuntamento creato")
4. Il workflow di Omnisend si attiva in base a quell'evento
5. Il cliente riceve un'email o un SMS con i dettagli dell'appuntamento

## Istruzioni di configurazione

### Parte 1: Configura Omnisend

#### Passaggio 1: Installa e collega Omnisend

1. Installa l' **app Omnisend** dall'App Store di Shopify
2. Segui i passaggi di configurazione dell'app per collegare il tuo negozio
3. Completa il processo di onboarding di Omnisend

#### Passaggio 2: Crea una chiave API (KPI Key)

1. In Omnisend, fai clic sulla tua **scheda profilo**
2. Vai a **Impostazioni negozio**
3. Fai clic su **Chiavi API** scheda
4. Fai clic su **Crea chiave API privata**
5. Assegna il nome "Sesami Integration" (o simile)
6. Configura le autorizzazioni - seleziona quanto segue:
   * **Campagne**  - consente di scaricare report, elenchi dei destinatari
   * **Contatti**  - consente di creare, modificare, scaricare, eliminare iscritti
   * **Ordini**  - consente di creare, modificare, scaricare, eliminare ordini
   * **Prodotti**  - consente di creare, modificare, scaricare, eliminare prodotti
   * **Carrelli**  - consente di creare, modificare, scaricare, eliminare carrelli
   * **Eventi**  - consente di recuperare e attivare eventi personalizzati (**Obbligatorio**)
7. Copia la chiave API generata e conservala in modo sicuro

{% hint style="warning" %}
**Importante**: Ti servirà una chiave API separata per ogni tipo di evento univoco (appuntamento creato, riprogrammato, cancellato, ecc.).
{% endhint %}

Per ulteriori dettagli, consulta [la documentazione API di Omnisend](https://api-docs.omnisend.com/).

#### Passaggio 3: Crea eventi personalizzati in Omnisend

Per ogni tipo di evento appuntamento che desideri monitorare, crea un evento personalizzato:

1. In Omnisend, vai a **Impostazioni negozio > Eventi personalizzati**
2. Fai clic su **Crea evento personalizzato**
3. Configura l'evento:
   * **Nome evento**: Scegli un nome descrittivo (ad es. "Appuntamento creato", "Appuntamento riprogrammato")
   * **Nome di sistema**: Verrà generato automaticamente in base al nome dell'evento
   * **Campi personalizzati dell'evento**: Definisci le proprietà della prenotazione che desideri usare nelle tue email/SMS:
     * `CustomerName`  - Nome del cliente
     * `ServiceName`  - Nome del servizio prenotato
     * `DateTimeInCustomerTimezone`  - Data/ora dell'appuntamento
     * `CustomerManagementLink`  - Link per il cliente per gestire la prenotazione
     * `AppointmentID`  - Identificativo univoco dell'appuntamento
     * `TeamMember`  - Nome del membro del personale assegnato
     * Aggiungi altri campi secondo necessità
4. Aggiungi cliente **email** e **telefono** campi (necessari per l'invio dei messaggi)
5. Salva l'evento personalizzato
6. **Copia l'ID evento**  - ti servirà per l'URL del webhook del Flusso Sesami

{% hint style="info" %}
Ripeti questo processo per ogni tipo di evento che desideri monitorare (creato, riprogrammato, cancellato, completato, promemoria).
{% endhint %}

Per istruzioni dettagliate, consulta [la documentazione sugli eventi personalizzati di Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).

### Parte 2: Configura i Flussi Sesami

#### Passaggio 1: Crea un Flusso in Sesami

1. Apri il [portale di amministrazione di Sesami](https://help.sesami.co/admin/sesami-admin-portal)
2. Vai a **Flussi**
3. Fai clic su **Crea Flusso**

#### Passaggio 2: Configura il trigger del Flusso

1. Scegli l'evento trigger:
   * Appuntamento creato
   * Appuntamento riprogrammato
   * Cliente registrato
   * Appuntamento iniziato
   * Appuntamento cancellato
   * Mancata presentazione
2. Imposta **Quando** a **Immediatamente**, oppure a un orario prima o dopo l'evento (ad es. 24 ore prima dell'appuntamento per un promemoria)
3. Configura eventuali condizioni aggiuntive, se necessario

#### Passaggio 3: Aggiungi un'azione webhook

1. Imposta **Azione** di tipo **Webhook**
2. Configura il webhook:
   * **URL di destinazione**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Sostituisci `[EVENT_ID]` con l'ID evento che hai copiato da Omnisend
   * **Quando**: Imposta su "Immediatamente" (o configura la tempistica per i promemoria)

#### Passaggio 4: Configura le intestazioni del webhook

Nella sezione Intestazioni del webhook, aggiungi:

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

Sostituisci `YOUR_OMNISEND_API_KEY` con la chiave API effettiva che hai creato in Omnisend.

#### Passaggio 5: Configura il corpo del webhook

Nella sezione Corpo del webhook, associa i dati della prenotazione di Sesami ai tuoi campi personalizzati di Omnisend:

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

{% hint style="info" %}
I nomi dei campi in `"fields"` devono corrispondere esattamente ai campi personalizzati che hai definito nel tuo evento personalizzato di Omnisend.
{% endhint %}

#### Passaggio 6: Salva e attiva il Flusso

1. Assegna al tuo Flusso un nome descrittivo (ad es. "Omnisend - Appuntamento creato")
2. **Salva** il Flusso
3. Attiva il Flusso

Ripeti i passaggi 1-6 per ogni tipo di evento che desideri inviare a Omnisend.

### Parte 3: Crea workflow in Omnisend

#### Passaggio 1: Crea un workflow personalizzato

1. Accedi a **Omnisend**
2. Vai a **Automazione > Workflow**
3. Fai clic su **Nuovo workflow**
4. Seleziona **Crea workflow personalizzato**

#### Passaggio 2: Configura il trigger

1. Per il trigger, seleziona il tuo evento personalizzato (ad es. "Appuntamento creato")
2. Il workflow si attiverà ogni volta che Sesami invia dati a questo evento

#### Passaggio 3: Aggiungi azioni Email o SMS

1. Fai clic su **Aggiungi azione** nel workflow
2. Scegli **Email** o **SMS**
3. Progetta il tuo modello di messaggio

#### Passaggio 4: Usa i campi personalizzati nel tuo modello

Quando modifichi il contenuto della tua email o SMS, puoi accedere alle proprietà della prenotazione usando la sintassi dei campi personalizzati:

* `[[custom_event.CustomerName]]`  - Nome del cliente
* `[[custom_event.ServiceName]]`  - Nome del servizio
* `[[custom_event.DateTimeInCustomerTimezone]]`  - Data/ora dell'appuntamento
* `[[custom_event.CustomerManagementLink]]`  - Link per la gestione della prenotazione
* `[[custom_event.TeamMember]]`  - Membro del team assegnato

#### Passaggio 5: Configura impostazioni aggiuntive del workflow

1. Imposta **Frequenza** regole (ad es. "Non riattivare il workflow per i contatti che sono già stati in questa automazione")
2. Aggiungi **Condizioni di uscita** se necessario
3. Configura eventuali ritardi temporali o suddivisioni condizionali

#### Passaggio 6: Attiva il workflow

Dopo aver progettato e testato il tuo workflow, fai clic su **Attiva** per renderlo attivo.

## Test dell'integrazione

Prima di andare live, testa l'integrazione:

1. Crea una prenotazione di prova in Sesami
2. Verifica che l'evento appaia in Omnisend sotto **Impostazioni negozio > Eventi personalizzati** (visualizza l'attività dell'evento)
3. Verifica che tutte le proprietà dell'appuntamento vengano compilate correttamente
4. Testa il tuo workflow di Omnisend per assicurarti che email/SMS vengano inviate correttamente
5. Controlla il contenuto per assicurarti che tutti i campi personalizzati vengano visualizzati correttamente

{% hint style="success" %}
**Suggerimento**: Crea un indirizzo email e un numero di telefono di test per il cliente, quindi effettua prenotazioni di prova per verificare l'esperienza completa del cliente prima di attivare i workflow per i clienti reali.
{% endhint %}

## FAQ

<details>

<summary>Ho bisogno di una chiave API separata per ogni tipo di evento?</summary>

Sì, Omnisend richiede una chiave API univoca per ogni evento personalizzato che crei. Ciò significa che, se monitori gli eventi di appuntamento creato, riprogrammato e cancellato, ti serviranno tre chiavi API separate.

</details>

<details>

<summary>Posso usare Omnisend sia per gli SMS che per le email?</summary>

Sì! Omnisend supporta sia le email che gli SMS. Assicurati di:

* Includi il `telefono` campo nel corpo del webhook
* Avere gli SMS abilitati nel tuo account Omnisend
* Aver raccolto i numeri di telefono dei clienti con il consenso appropriato
* Configurare le azioni SMS nei tuoi workflow di Omnisend

Per ulteriori dettagli, consulta [la documentazione SMS di Omnisend](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>E se avessi bisogno di più workflow di promemoria?</summary>

Puoi creare più Flussi di promemoria in Sesami, ciascuno con tempistiche diverse:

* 7 giorni prima dell'appuntamento
* 24 ore prima dell'appuntamento
* 2 ore prima dell'appuntamento

Ciascuno può inviare allo stesso evento personalizzato di Omnisend, oppure puoi creare eventi personalizzati separati per diverse tempistiche di promemoria.

</details>

<details>

<summary>Gli eventi non vengono visualizzati in Omnisend. Cosa dovrei controllare?</summary>

* Verifica che la tua chiave API di Omnisend sia corretta e che l'autorizzazione "Eventi" sia abilitata
* Assicurati che l'ID evento nell'URL del webhook corrisponda al tuo evento personalizzato
* Controlla che il Flusso sia attivato in Sesami
* Verifica di aver effettuato una prenotazione di prova dopo aver configurato il Flusso
* Controlla i registri del Flusso Sesami per vedere se il webhook è stato inviato con successo
* Controlla l'attività dell'evento personalizzato in Omnisend (Impostazioni negozio > Eventi personalizzati)
* Assicurati che tutti i campi richiesti (email o telefono) siano inclusi nel corpo del webhook

</details>

<details>

<summary>Posso usare traduzioni per lingue diverse?</summary>

Sì! Omnisend supporta le traduzioni per le campagne e le email automatiche. Puoi creare versioni localizzate dei tuoi workflow in base alle preferenze linguistiche dei clienti. Consulta [la documentazione sulle traduzioni di Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Correlati

* [Sesami Flows](/it/automazioni/sesami-flows.md)  - Panoramica del sistema di automazione di Sesami
* [Azioni Email e Webhook](/it/automazioni/email-and-webhook-as-action-types.md)  - Comprendere i tipi di azione
* [Sesami Flows e Klaviyo](/it/automazioni/sesami-flows-and-klaviyo.md)  - Integrazione alternativa con ESP
* [Email di notifica](/it/notifiche/notification-emails.md)  - Sistema di notifica predefinito di 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/it/automazioni/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.
