# Zapier
Guida alla creazione di una integrazione in Zapier ed esempi.
# Introduzione
Zapier è un prodotto che consente agli utenti finali di integrare le applicazioni Web ed automatizzare i flussi di lavoro. Permette di connettere diverse applicazioni web tra loro attraverso gli “ZAP”, che possono essere personalizzati a seconda delle esigenze dell'utente. Zapier funziona quindi come un ponte tra diverse applicazioni, consentendo di automatizzare i processi aziendali e di risparmiare tempo prezioso.
***Le pagine seguenti mostrano come configurare l'integrazione con vtenext all'interno di Zapier e successivamente mostra 2 esempi di utilizzo.***
# Nuova integrazione
##### **Come creare un'integrazione con vtenext in Zapier**
**1.** Come prima cosa è necessario andare su [https://developer.zapier.com/](https://developer.zapier.com/) effettuare l'accesso con le proprie credenziali Zapier, e cliccare su "Start a Zapier Integration"
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688997649695.png)
**2.** E' poi necessario compilare tutti i campi che la schermata di Zapier ci chiede.
**Esempio:**
**Name**: vtenext
**Description**: Integra vtenext con Zapier
**Audience**: Private
**Role**: I have no affiliation with...
**Category**: CRM
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688998674505.png)
**3.** Dopo un messaggio di salvataggio eseguito e creazione avvenuta con successo, sarà possibile configurare il tipo di Autenticazione
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688998892622.png)
Dovrà essere selezionato BASIC AUTH e conseguentemente clicchiamo su SAVE
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688998997284.png)
**STEP 1:** lasciare vuoto e cliccare su CONTINUE
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1688999648720.png)
**STEP 2:** inserire nel test, il metodo post e configurare l'url la seguente stringa **https://VTE-URL/restapi/v1/vtews/listtypes** (dove VTE-URL è l'indirizzo assoluto della vostra installazione vtenext)
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689002049644.png)
**STEP 3:** è giunto il momento di testare l'autenticazione, cliccando sul bottone azzurro "Sign In" e cliccando infine su **SAVE & FINISH.**
**ATTENZIONE: la password da usare è l'accesskey dell'utente vtenext, che trovate nelle preferenze dell'utente stesso.**
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-07/image-1689003982494.png)
**4. Creazione di un trigger**
Questo passaggio è opzionale, è necessario solamente se si vogliono scatenare azioni lato Zapier quando in vtenext si verifica una qualche condizione (ad esempio alla creazione di un Lead o da qualsiasi altra condizione scatenata da un processo).
Aggiungiamo quindi un trigger come segue:
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691677394684.png)
Cliccando sul pulsante CREATE A TRIGGER, verrà presentata una schermata con alcuni campi da compilare. Tali campi andranno gestiti in base a ciò che si vuole ottenere dal trigger stesso (nell'esempio si tratta di intercettare la creazione di un nuovo Lead).
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691677670950.png)
Una volta compilati tutti i campi, cliccare su **SAVE & CONTINUE** in fondo alla pagina sulla destra.
Subito dopo comparirà la seguente pagina, dove sarà necessario cliccare su **API CONFIGURATION** per creare un web hook.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691677894652.png)
Allo **STEP 1** vanno scelti i seguenti parametri:
**SUBSCRIBE**
- REST Hook (è sufficiente selezionarlo)
- POST (si seleziona dal menu a tendina la voce POST e poi si scrive il web hook seguente, sostituendo VTE-URL con il corretto indirizzo del proprio crm)
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691680316892.png)
```
https://VTE-URL/restapi/v1/vtews/zapier.subscribe
{"module":"Leads","hookUrl":"{{bundle.targetUrl}}","zapid":"{{bundle.meta.zap.id}}"}
```
In questo codice, è possibile sostituire Leads con il modulo che si desidera configurare.
Continuando la configurazione, scrollando in basso la pagina, troviamo l'opzione **UNSUBSCRIBE**, che dovrà essere configurata col seguente codice
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691680531292.png)
```
https://labs2.vtecrm.net:8443/restapi/v1/vtews/zapier.unsubscribe
{{bundle.subscribeData.id}}
```
Continuando sul parametro **PERFORM LIST**, si dovrà configurare il seguente codice
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691681473958.png)
```
https://VTE-URL/restapi/v1/vtews/zapier.perform_list
Leads
```
Infine su **PAGINATION** non c'è nulla da configurare e si clicca su **SAVE API Request & Continue**.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691681817484.png)
Allo **STEP 2** della configurazione del Trigger, **non va configurato nulla**.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691682003664.png)
Allo **STEP 3** della configurazione del Trigger, è necessario **lasciare vuoto** il campo presente in quel blocco.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691682110724.png)
**5. Creazione di azioni**
Anche in questo caso, questo passaggio è opzionale, serve solamente se si vogliono scatenare azioni lato vtenext quando Zapier verifica le condizioni impostate. Le azioni eseguibili in vtenext sono: ricerca di un record, creazione, modifica o cancellazione.
E' possibile inoltre creare solamente le azioni necessarie alla propria integrazione.
**I. Azione Ricerca**
Sulla colonna di sinistra, va cliccata la voce **ACTIONS** e subito dopo sul bottone **ADD ACTION** presente invece sulla destra.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691682308455.png)
Si aprirà la seguente schermata che andrà compilata come mostrato
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691682571573.png)
Finito di compilare i campi come mostrato nella precedente immagine, sarà possibile cliccare su **SAVE AND CONTINUE**. In questo modo si potrà passare alla TAB successiva per configurare l'**INPUT DESIGNER**.
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691760259231.png)
In questa schermata, si dovrà cliccare su **ADD** e scegliere **INPUT FIELD** e comparirà la schermata di configurazione successiva
[](https://usermanual.vtenext.com/uploads/images/gallery/2023-08/image-1691760482484.png)
Inserire le variabili indicate negli appositi campi e cliccare dunque sul pulsante **SAVE** e si passa alla **TAB di API CONFIGURATION**
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-07/image-1691761672586.png)
In questa schermata dovranno essere inserite le variabili come mostrato, chiaramente al posto di VTE-URL andrà inserito l'indirizzo completo della vostra installazione vtenext. Infine cliccare su **SAVE API REQUEST & CONTINUE**.
```
https://VTE-URL/restapi/v1/vtews/zapier.search
SELECT id FROM Leads WHERE email='{{bundle.inputData.email}}';
```
Nello STEP 2, fase TEST di questa pagina, andrà inserito un indirizzo email per effettuare alcuni test di connessione (l'indirizzo dovrà essere valido ed esistente).
Alla TAB OUTPUT invece, è necessario:
1. utilizzare la risposta dai dati del test
2. generare definizioni dei campi di output
3. impostare il tipo appropriato per i campi
Infine cliccare su SAVE **OUTPUT & FINISH** in basso a destra.
**II. Azione Crea**
Cliccare sempre **ADD ACTION** per creare una nuova azione e compilare la prima schermata come segue:
**[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-145655.png)**
Cliccare **SAVE AND CONTINUE** e passare alla TAB successiva per configurare l'**INPUT DESIGNER**, in cui va aggiunto un nuovo **INPUT FIELD** configurato come segue:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/2024-04-11-15-36-developer-zapier-com.png)
Cliccare su **SAVE** e passare al tab **API Configuration** e configurare i parametri nello **STEP 1** nel seguente modo:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-153934.png)
```
https://VTE-URL/restapi/v1/vtews/zapier.create
module = Leads
data = {{bundle.inputData.dataField}}
```
Ovviamente VTE-URL va sostituito con l'indirizzo completo della vostra installazione vtenext, mentre il termine "Leads" può essere sostituito con un altro modulo, se si desidera creare una entità diversa in vtenext (ad esempio Contacts o Accounts). Infine cliccare su **SAVE API REQUEST & CONTINUE**.
Nello **STEP 2**, per effettuare un test di creazione lead scegliere "**Raw**" e sostituire il codice presente con il seguente:
```json
{
"inputData": {
"dataField": {
"firstname":"Test lead",
"lastname":"Zapier",
"phone":"123456789",
"company":"Test Company Zapier"
}
},
"authData": {},
"environment": {},
"subscribeData": {},
"cleanedRequest": {
"url": "https://example.com/hook-request-origin",
"method": "POST",
"body": {},
"headers": {
"Content-Type": "application/json"
}
}
}
```
e cliccare su T**est Your Request**, che dovrebbe dare esito positivo e un Lead con nome "Test Lead" e cognome "Zapier" dovrebbe essersi creato nella vostra installazione vtenext. Cliccare **Finish Testing & Continue**.
Nello STEP 3 cliccare su **Use Response from Test Data** e poi **Generate Output Field Definitions** per mappare automaticamente i campi restituiti. Cliccare infine su **Save Output & Finish.**
**III. Azione Aggiorna**
Cliccare sempre **ADD ACTION** per creare una nuova azione e compilare la prima schermata come segue:
**[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-155651.png)**
Nella schermata di **INPUT DESIGNER** creare 2 campi di tipo **Input Field**, con le seguenti caratteristiche:
1. Key = id, Label = ID, Type = String, Required = yes
2. Key = dataField, Label = dataField, Type = Dictionary, Required = no
Una volta creati avremo quindi i seguenti campi:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-155841.png)
Passare quindi al tab **API Configuration** e configurare i parametri nello **STEP 1** nel seguente modo:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-160149.png)
```
https://VTE-URL/restapi/v1/vtews/zapier.update
id = {{bundle.inputData.id}}
data = {{bundle.inputData.dataField}}
```
Sostituendo VTE-URL con l'indirizzo completo della vostra installazione vtenext. Infine cliccare su **SAVE API REQUEST & CONTINUE**.
Nello **STEP 2**, per effettuare un test di modifica lead scegliere "**Raw**" e sostituire il codice presente con il seguente:
```json
{
"inputData": {
"id": "2x53",
"dataField": {
"phone":"556677"
}
},
"authData": {},
"environment": {},
"subscribeData": {},
"cleanedRequest": {
"url": "https://example.com/hook-request-origin",
"method": "POST",
"body": {},
"headers": {
"Content-Type": "application/json"
}
}
}
```
e sostituendo il "53" a riga 3 con l'ID di un lead presente in vtenext:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-160633.png)
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-160758.png)
Cliccando su **Test Your Request** dovreste ottenere un risultato come il seguente:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-161033.png)
Infine nello **STEP 3** cliccare sempre su **Use Response from Test Data** e poi **Generate Output Field Definitions** per mappare automaticamente i campi restituiti. Cliccare infine su **Save Output & Finish.**
**IV. Azione Elimina**
Cliccare sempre **ADD ACTION** per creare una nuova azione e compilare la prima schermata come segue:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-162620.png)
Nella schermata di **INPUT DESIGNER** creare un campo di tipo Input Field, con le seguenti caratteristiche:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/2024-04-11-16-27-developer-zapier-com.png)
Passare quindi al tab **API Configuration** e configurare i parametri nello **STEP 1** nel seguente modo:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-162822.png)
```
https://VTE-URL/restapi/v1/vtews/zapier.delete
id = {{bundle.inputData.id}}
```
Sostituendo VTE-URL con l'indirizzo completo della vostra installazione vtenext. Infine cliccare su **SAVE API REQUEST & CONTINUE**.
Nello **STEP 2** inserire come valore di test l'ID del Lead che si vuole eliminare in formato webservice, quindi del tipo "2xCRMID", ad esempio:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-163208.png)
In questa azione non è necessario configurare lo **STEP 3** relativo all'output.
**Congratulazioni! La creazione dell'integrazione è completa.**
Si può ora passare a configurare degli specifici *ZAP* per compiere le azioni che si desiderano.
# Creazione di uno Zap
##### **Come creare degli ZAP di esempio**
**Esempio 1 - Trigger da vtenext e azione in Zapier**
in questo esempio proviamo ad inviare un'email alla creazione di un lead in vtenext:
1. Andare su [https://zapier.com/app/dashboard](https://zapier.com/app/dashboard)
2. Cliccare su **Create**
3. Trigger: vtenext, event = new lead, account = utilizzare un account valido
4. Effettuare un test, si dovrebbe ottenere un Lead, cliccare su **Continue with selected record**
5. Aggiungere una azione, ad esempio **Email by Zapier** -> **Send Outbound Email**
6. In questa azione configurare i campi ad esempio:
- To: indirizzo email a cui inviare l'email
- Subject: Lead Creato + variabili o campi che si desiderano aggiungere
- Body: Testo dell'email con eventuali variabili
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-164935.png)
Cliccare su **Continue** e verificare di aver ricevuto l'email. Cliccare infine su **PUBLISH** e verificare che lo Zap sia attivo.
Ora, per scatenare il trigger da vtenext è necessario creare un processo al cui interno ci sarà l'azione che invia il record a Zapier.
Nel caso più semplice, il processo può avere questo flusso:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-02/pJAimage.png)
E una delle azioni sarà di tipo "Chiama Web service esterno", e va usato il webservice che si è creato in automatico, e configurato come segue:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-02/image.png)
Nel campo **Corpo grezzo** va indicata la seguente stringa:
```
$sdk:vte_json_record($1-crmid)
```
dove $1-crmid è il record gestito dal processo da inviare a Zapier
*oppure*
```
$sdk:vte_json_field_string($1-crmid, firstname, lastname, phone, ...)
```
Per mandare solo alcuni campi, potete scegliere quelli che più vi interessano.
Una volta attivato il processo, quando l'azione di invio a Zapier viene eseguita, Zapier riceverà il record e su di esso eseguirà l'azione che è stata configurata nello Zap.
**ATTENZIONE: se viene disattivato lo zap e ricreato, va modificato il processo per usare il nuovo ws**
---
**Esempio 2 - Trigger da Zapier e azione in vtenext**
In questo esempio proveremo a creare un lead in vtenext, quando un'email viene mandata ad un indirizzo di Zapier:
1. Andare su [https://zapier.com/app/dashboard](https://zapier.com/app/dashboard)
2. Cliccare su **Create**
3. Trigger: **Email by Zapier** ->**New Inbound Email**
4. Configurare un prefisso per la casella di posta, ad esempio:
5. Inviare una email a quell'indirizzo e verificare che Zapier la riceva
6. Creare una azione: Vtenext -> **Create Lead**
7. Usare l'account opportuno e configurare i campi da inviare a vtenext, ricordandosi di mappare tutti i campi obbligatori, ad esempio:
[](https://usermanual.vtenext.com/uploads/images/gallery/2024-04/screenshot-20240411-170647.png)
8. Fare un test per verificare che il lead venga creato correttamente in vtenext.
Cliccare infine su **PUBLISH**.
A questo punto, inviando delle email a quell'indirizzo di Zapier configurato, si creano lead in vtenext.
Questi sono solamente alcuni esempi che l'integrazione con Zapier può fare, potete provare e collegare trigger e azioni nel modo che volete! Si pensi solamente che, utilizzando i flussi di Zapier, è possibile creare processi complessi, come cercare un record in vtenext e in quel caso aggiornarlo estraendo parti di testo dal corpo dell'email. Ma è solo un esempio che vi fa capire la potenza dello strumento.