# Flussi Sesami e Omnisend
Integra Sesami con Omnisend per alimentare email marketing avanzato e marketing SMS per la tua attività di prenotazioni.
## Che cos'è Omnisend?
Omnisend è una piattaforma di automazione del marketing specializzata nell'email marketing e nel marketing SMS per le attività di e-commerce. Fornisce 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 rivolte ai clienti inviando i dati degli eventi di Sesami a Omnisend e attivando tutte le comunicazioni (email o SMS) tramite Omnisend. Per molte attività che già utilizzano Omnisend per inviare conferme d'ordine, messaggi di marketing 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 appuntamento
* Flusso di riprogrammazione appuntamento
* Flusso di cancellazione appuntamento
* Flusso di promemoria appuntamento (24 ore prima, o con tempistica personalizzata)
* Flusso di completamento appuntamento
## Come funziona
Sesami usa **Sesami Flows** per inviare eventi di prenotazione a Omnisend in tempo reale. Quando un appuntamento viene creato, riprogrammato, annullato o completato, Sesami invia quei dati evento a Omnisend tramite webhook a un evento personalizzato che hai creato. Quindi crei flussi di lavoro 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. Sesami Flow attiva e invia i dati dell'evento a Omnisend tramite webhook
3. Omnisend riceve l'evento come evento personalizzato (ad es., "Appointment Created")
4. Il flusso di lavoro 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: Configurare Omnisend
#### Passaggio 1: Installa e collega Omnisend
1. Installa l'app **app Omnisend** dallo Shopify App Store
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 (chiave KPI)
1. In Omnisend, fai clic sul tuo **profilo**
2. Vai a **Impostazioni del negozio**
3. Fai clic su **Chiavi API** scheda
4. Fai clic su **Crea una Private API Key**
5. Assegnale il nome "Integrazione Sesami" (o simile)
6. Configura le autorizzazioni - seleziona quanto segue:
* **Campagne** - consente di scaricare report, elenchi di 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 ottenere 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, annullato, ecc.).
{% endhint %}
Per maggiori dettagli, consulta la [documentazione API di Omnisend](https://api-docs.omnisend.com/).
#### Passaggio 3: Crea eventi personalizzati in Omnisend
Per ogni tipo di evento dell'appuntamento che desideri monitorare, crea un evento personalizzato:
1. In Omnisend, vai a **Impostazioni del negozio > Eventi personalizzati**
2. Fai clic su **Crea evento personalizzato**
3. Configura l'evento:
* **Nome evento**: Scegli un nome descrittivo (ad es., "Appointment Created", "Appointment Rescheduled")
* **Nome di sistema**: Verrà generato automaticamente in base al nome dell'evento
* **Campi personalizzati dell'evento**: Definisci le proprietà della prenotazione che vuoi usare nelle tue email/SMS:
* `CustomerName` - Nome del cliente
* `ServiceName` - Nome del servizio prenotato
* `DateTimeInCustomerTimezone` - Data/ora dell'appuntamento
* `CustomerManagementLink` - Link per permettere al cliente di gestire la prenotazione
* `AppointmentID` - Identificatore univoco dell'appuntamento
* `TeamMember` - Nome del membro del personale assegnato
* Aggiungi altri campi secondo necessità
4. Aggiungi i campi **email** e **telefono** (obbligatori per l'invio dei messaggi)
5. Salva l'evento personalizzato
6. **Copia l'ID evento** - ti servirà per l'URL del webhook di Sesami Flow
{% hint style="info" %}
Ripeti questo processo per ogni tipo di evento che desideri monitorare (creato, riprogrammato, annullato, completato, promemoria).
{% endhint %}
Per istruzioni dettagliate, vedi [la documentazione degli eventi personalizzati di Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).
### Parte 2: Configurare i Flussi di Sesami
#### Passaggio 1: crea un Flusso in Sesami
1. Apri **Sesami** nell'Admin di Shopify
2. Vai a **Impostazioni > Flussi**
3. Fai clic su **Crea un Flusso**
#### Passaggio 2: Configura il trigger del Flow
1. Scegli il tuo evento trigger:
* Appuntamento creato
* Appuntamento riprogrammato
* Appuntamento annullato
* Appuntamento completato
* Promemoria basato sul tempo (ad es., 24 ore prima dell'appuntamento)
2. Configura eventuali condizioni aggiuntive se necessario
#### Passaggio 3: Aggiungi un'azione Webhook
1. Imposta **Azione** tipo su **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" (oppure configura la tempistica per i promemoria)
#### Passaggio 4: Configura le intestazioni del webhook
Nella sezione Headers 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 Body del webhook, associa i dati di 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 abilita il Flow
1. Assegna al tuo Flow un nome descrittivo (ad es., "Omnisend - Appointment Created")
2. **Salva** il Flusso
3. Abilita il Flow
Ripeti i passaggi 1-6 per ogni tipo di evento che desideri inviare a Omnisend.
### Parte 3: Crea flussi di lavoro in Omnisend
#### Passaggio 1: Crea un flusso di lavoro personalizzato
1. Accedi a **Omnisend**
2. Vai a **Automazione > Flussi di lavoro**
3. Fai clic su **Nuovo flusso di lavoro**
4. Seleziona **Crea flusso di lavoro personalizzato**
#### Passaggio 2: Configura il trigger
1. Per il trigger, seleziona il tuo evento personalizzato (ad es., "Appointment Created")
2. Il flusso di lavoro 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 flusso di lavoro
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 del tuo 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 di gestione della prenotazione
* `[[custom_event.TeamMember]]` - Membro del team assegnato
#### Passaggio 5: Configura impostazioni aggiuntive del flusso di lavoro
1. Imposta **Frequenza** regole (ad es., "Non riattivare il flusso di lavoro 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 flusso di lavoro
Una volta che hai progettato e testato il tuo flusso di lavoro, fai clic **Abilita** per renderlo attivo.
## Testare la tua integrazione
Prima di andare live, testa l'integrazione:
1. Crea una prenotazione di prova in Sesami
2. Controlla che l'evento appaia in Omnisend sotto **Impostazioni del negozio > Eventi personalizzati** (visualizza l'attività dell'evento)
3. Verifica che tutte le proprietà dell'appuntamento vengano compilate correttamente
4. Testa il tuo flusso di lavoro Omnisend per assicurarti che email/SMS vengano inviati correttamente
5. Rivedi il contenuto per assicurarti che tutti i campi personalizzati vengano visualizzati correttamente
{% hint style="success" %}
**Consiglio professionale**: Crea un indirizzo email e un numero di telefono di un cliente di prova, quindi effettua prenotazioni di prova per verificare l'esperienza cliente completa prima di abilitare i flussi di lavoro per i clienti reali.
{% endhint %}
## FAQ
Ho bisogno di una chiave API separata per ogni tipo di evento?
Sì, Omnisend richiede una chiave API univoca per ogni evento personalizzato che crei. Questo significa che se stai monitorando eventi di appuntamento creato, riprogrammato e annullato, avrai bisogno di tre chiavi API separate.
Posso usare Omnisend per gli SMS oltre che per le email?
Sì! Omnisend supporta sia l'email sia gli SMS. Assicurati di:
* Includere il campo `telefono` nel corpo del tuo webhook
* Avere gli SMS abilitati nel tuo account Omnisend
* Aver raccolto i numeri di telefono dei clienti con il consenso appropriato
* Configurare azioni SMS nei tuoi flussi di lavoro Omnisend
Per maggiori dettagli, vedi [la documentazione SMS di Omnisend](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).
E se avessi bisogno di più flussi di lavoro di promemoria?
Puoi creare più Flow 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.
Gli eventi non compaiono in Omnisend. Cosa dovrei controllare?
* Verifica che la tua chiave API di Omnisend sia corretta e abbia l'autorizzazione "Events" abilitata
* Assicurati che l'ID evento nel tuo URL webhook corrisponda al tuo evento personalizzato
* Controlla che il Flow sia abilitato in Sesami
* Verifica di aver effettuato una prenotazione di prova dopo aver configurato il Flow
* Esamina i log del Flusso di Sesami per vedere se il webhook è stato inviato correttamente
* Controlla l'attività dell'evento personalizzato in Omnisend (Impostazioni del negozio > Eventi personalizzati)
* Assicurati che tutti i campi obbligatori (email o telefono) siano inclusi nel corpo del webhook
Posso usare traduzioni per lingue diverse?
Sì! Omnisend supporta le traduzioni per campagne ed email automatizzate. Puoi creare versioni localizzate dei tuoi flussi di lavoro in base alle preferenze linguistiche del cliente. Vedi [la documentazione sulle traduzioni di Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).
## 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 ESP alternativa
* [Email di notifica](/it/notifiche/notification-emails.md) - Sistema di notifiche predefinito di 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/it/automazioni/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.