# Integrazione di Klaviyo L'integrazione Klaviyo consente di collegare il chatbot Botpress con Klaviyo, una piattaforma leader per i dati dei clienti e l'automazione del marketing. Con questa integrazione, il vostro chatbot può creare lead, aggiornare le informazioni sui clienti e iscrivere i profili al marketing via SMS e via e-mail. ## Azioni disponibili ### Crea profilo Crea il profilo di un nuovo cliente in Klaviyo. Questa azione consente di aggiungere nuovi contatti al database di Klaviyo con informazioni complete sul profilo. **Campi richiesti - O **indirizzo e-mail** O **numero di telefono** (in formato E.164 come +15005550006) **Campi opzionali:** - **Nome** e **cognome** - **Organizzazione** e **titolo di lavoro** - **Locale** (nel formato IETF BCP 47 come en-US, fr-FR) - **Localizzazione** (dettagli dell'indirizzo, comprese le linee dell'indirizzo, la città, il paese, la regione, il codice postale) - **Proprietà personalizzate** (coppie chiave-valore per la memorizzazione di dati aggiuntivi del profilo) **Restituisce il profilo creato con il suo ID Klaviyo univoco. ### Aggiornamento del profilo Aggiorna il profilo di un cliente esistente in Klaviyo utilizzando l'ID univoco del profilo. Questa azione consente di modificare qualsiasi informazione del profilo dopo la sua creazione. **Campi richiesti - **Identificativo del profilo** (l'identificativo univoco Klaviyo del profilo da aggiornare) **Campi facoltativi:** - **Indirizzo e-mail** (aggiorna l'e-mail del profilo) - **Numero di telefono** (in formato E.164) - **Nome** e **cognome** - **Organizzazione** e **titolo di lavoro** - **Locale** (nel formato IETF BCP 47) - **Localizzazione** (informazioni complete sull'indirizzo) - **Proprietà personalizzate** (coppie chiave-valore) **Restituisce il profilo aggiornato con tutte le informazioni correnti. ### Ottieni profilo Recupera il profilo di un cliente specifico da Klaviyo utilizzando il suo ID univoco. Questa azione è utile per cercare informazioni sui singoli clienti. **Campi richiesti - **Identificativo del profilo** (l'identificativo univoco di Klaviyo del profilo da recuperare) **Output:** Restituisce le informazioni complete del profilo, compresi ID, e-mail, telefono, nome e tutti gli altri dati memorizzati. ### Ottieni profili Cerca e recupera più profili di clienti da Klaviyo utilizzando filtri e opzioni di ordinamento. Questa azione è perfetta per trovare gruppi di clienti in base a criteri specifici. **Opzioni filtro:** - Campo del filtro:** Scegliere tra `id`, `email`, `numero di telefono`, `id esterno`, `creato` o `aggiornato`. - **Operatore del filtro:** Utilizzare operatori di confronto come `equals`, `contains`, `greater-than`, `less-than`, `starts-with`, `ends-with`. - **Valore del filtro:** Il valore da cercare (supporta stringhe e date) **Paginazione e ordinamento:** - **Dimensione pagina:** Numero di profili da restituire (1-100, default: 20) - **Ordinamento:** Ordinamento per qualsiasi campo con ordine decrescente opzionale (prefisso con `-`) **Casi d'uso di esempio:** - Trovare tutti i profili creati dopo una data specifica - Ricerca di profili con indirizzi e-mail contenenti un dominio - Ottenere profili ordinati per data di creazione (prima i più recenti) **Restituisce un array di profili che corrispondono ai criteri impostati. ### Sottoscrivi profili Sottoscrive più profili di clienti a liste di marketing via e-mail e/o SMS in Klaviyo. Questa azione elabora le sottoscrizioni in modo asincrono e può gestire fino a 1.000 profili contemporaneamente. **Campi richiesti - Sottoscrizioni di profili:** Array di profili con informazioni sul consenso - ID profilo** (o email/telefono per l'identificazione) - **Consenso email:** Booleano che indica il consenso per l'email marketing - **Consenso SMS:** Booleano che indica il consenso per il marketing via SMS **Campi opzionali:** - **List ID:** Lista specifica di Klaviyo a cui aggiungere i profili sottoscritti - **Importazione storica:** Booleano per importare i profili storici **Note importanti:** - Massimo 1.000 profili per richiesta - È richiesto almeno un profilo - I flag di consenso determinano a quali canali di marketing il profilo sarà abbonato - L'operazione viene elaborata in maniera asincrona da Klaviyo **Restituisce un booleano di successo che indica se il lavoro di sottoscrizione è stato pianificato con successo.
Creare incredibili esperienze di agenti AI.
