Formato JSON
I trigger sono rappresentati come oggetti JSON con i seguenti attributi.
| Nome | Digita | Sola lettura | Descrizione |
| nome | stringa | No | Il nome del trigger |
| abilitato | numero intero | No | Indica se il trigger è abilitato o meno |
| descrizione | stringa | No | La descrizione del trigger |
| definizione | oggetto | n | La definizione del trigger. Per maggiori dettagli, consultaDefinizioni di triggerdi seguito. |
Definizioni trigger
Nota: Le definizioni non sono modificabili nel trigger di aggiornamento.
Per descrizioni dettagliate di ciascun trigger, consultaCondizioni di trigger e informazioni di riferimento sulle azioni.
I trigger vengono definiti semplicemente usando JSON. Ogni trigger è un oggetto JSON con 3 chiavi:
| Chiavi di definizione trigger | Descrizione |
| evento | (Stringa JSON) Tipo di evento per il quale questo trigger viene attivato. Per un elenco di eventi, consulta Eventi di trigger. |
| condizione | (Elenco JSON) Condizione che deve essere soddisfatta affinché questo trigger esegua le sue azioni. Per maggiori dettagli, consulta Tipi di condizioni |
| azione | action (elenco JSON) Elenco di azioni da eseguire quando la condizione è soddisfatta. Per maggiori dettagli, consulta Azioni trigger. |
Eventi trigger
Puoi usare i seguenti eventi:
| Evento trigger | Descrizione |
| page_enter | Questo evento viene attivato quando un visitatore ha caricato il widget di chat. |
| chat_requested | Questo evento viene attivato quando un visitatore richiede una chat. |
| chat_message | Questo evento viene attivato quando un visitatore invia un messaggio di chat. |
Eventi condizionali
Puoi usare le condizioni seguenti:
| Tipo di condizione | Descrizione |
| oppure | Verifica che una qualsiasi delle condizioni sia soddisfatta |
| e | Verifica che tutte le condizioni siano soddisfatte |
Operatori di variabili di condizione
Puoi usare i seguenti operatori per le variabili di condizione. Gli operatori potrebbero non essere disponibili per variabili diverse.
| Operatore | Descrizione |
| eq | È uguale a |
| neq | Non uguale a |
| lt | Minore di |
| gt | Maggiore di |
| lte | Minore o uguale a |
| gte | Maggiore o uguale a |
| icontains | Contiene |
| nicontains | Non contiene |
| contiene | Contiene (con distinzione tra maiuscole e minuscole) |
| ncontains | Non contiene (maiuscole/minuscole) |
| regex | Corrispondenze di espressioni regolari (maiuscole/minuscole) |
| iregex | Espressione regolare |
Variabili di condizione
Puoi usare le seguenti variabili:
Variabili di data e ora
| Tipo | Descrizione |
| @hour_of_day | Ora del giorno (fuso orario UTC), da 0 a 23 |
| @giorno_della_settimana | Giorno della settimana. 0 = lunedì, 6 = domenica |
| @visitor_time_on_page | Numero di secondi in cui il visitatore è rimasto sulla pagina corrente |
| @visitor_time_on_site | Numero di secondi in cui il visitatore è rimasto sul tuo sito |
| stillOnSite | Ritardo (in secondi) prima della verifica della condizione successiva |
| stillOnPage | Ritardo (in secondi) prima della verifica della condizione successiva |
Posizione del visitatore
| Tipo | Descrizione |
| @ip_visitatore | Indirizzo IP del visitatore (xxx.xxx.xxx.xxx) |
| @visitor_hostname | Nome host dell’indirizzo IP del visitatore |
| @visitor_city | Città di provenienza del visitatore |
| @visitor_region | Regione da cui proviene il visitatore |
| @visitor_country_code | Codice Paese di due lettere del visitatore |
| @visitor_country_name | Paese di provenienza del visitatore |
Informazioni sulla visita precedente
| Tipo | Descrizione |
| @visitor_previous_visits | Numero di volte in cui il visitatore ha visitato in precedenza. Nuove visite = 0 |
| @visitor_previous_chats | Numero di volte in cui il visitatore ha chattato con gli agenti. Nuove chat = 0 |
Informazioni sulla pagina
| Tipo | Descrizione |
| @visitor_page_url | L’URL della pagina in cui si trova il visitatore |
| @visitor_page_title | Titolo della pagina in cui si trova il visitatore |
| @visitor_page_count | Numero di pagine visualizzate dal visitatore. Prima pagina = 1 |
| @referrer | L’URL del visitatore della pagina precedente era attivo |
Informazioni sui visitatori
| Tipo | Descrizione |
| @nome_visitatore | Nome del visitatore |
| @visitor_email | Email del visitatore |
| @visitor_referrer | URL referrer del visitatore (quando è entrato nel tuo sito) |
| @visitor_search_engine | Motore di ricerca di riferimento, se applicabile |
| @visitor_search_terms | Termine di ricerca di riferimento, se applicabile |
| @visitor_tags | Nome del tag (impostato dall’azione Imposta tag) |
| @visitor_triggered | "true" se il visitatore è stato attivato (impostato dall'azione Imposta attivato) |
| @visitor_department_id | Reparto visitatori (impostato dall’azione Imposta reparto visitatori o dall’API JavaScript) |
Software/computer visitatore
| Tipo | Descrizione |
| @visitor_user_agent | Stringa utente-agente del browser del visitatore |
| @visitor_browser | Browser del visitatore |
| @visitor_platform | Sistema operativo/piattaforma del visitatore |
Stati online
| Tipo | Descrizione |
| @account_status | Stato del tuo account (online/non al computer/offline) |
| @visitor_status | Stato del visitatore (online/inattivo/offline) |
Informazioni relative a Chat
| Tipo | Descrizione |
| @visitor_requesting_chat | "true" se il visitatore richiede la chat |
| @visitor_served | "true" se il visitatore è attualmente servito da agenti |
| @reparto | Reparto (nome) scelto dal visitatore nel modulo di richiesta chat |
| @visitor_served | "true" se il visitatore è attualmente servito da agenti |
| @mittente | Nome del mittente del messaggio |
| @tipo_mittente | 'agente' o 'visitatore' |
| @messaggio | Il messaggio che si sta inviando |
Azioni trigger
| Azione | Parametri | Descrizione |
| sendMessageToVisitor | Nome agente e messaggio (stringa) | Invia un messaggio al visitatore |
| setTriggered | Vero/falso (booleano) | Imposta il flag “triggered” del visitatore |
| attendi | Durata (in secondi) (numero) | Attende il numero di secondi specificato, quindi esegue l’azione successiva nell’elenco se il visitatore è ancora online |
| addTag | Nome tag (stringa) | Aggiunge un tag al visitatore, che è visibile nell’elenco visitatori del dashboard |
| removeTag | Nome tag (stringa) | Rimuove un tag dalla sessione del visitatore |
| banVisitor | Motivo (stringa) | Escludi visitatore con motivo |
| banIp | Motivo (stringa) | Escludi l’indirizzo IP del visitatore con motivo |
| setName | Nome del visitatore (stringa) | Imposta il nome del visitatore |
| setDepartment | ID reparto (numero) | Set è il reparto attuale del visitatore |
| setNote | Nota (stringa) | Imposta una nota per il visitatore, visibile nel dashboard e persistente |
| appendNote | Nota (stringa) | Aggiunge la nota alla fine della nota corrente del visitatore |
Ottieni tutti i trigger
GET /api/v2/triggers
Elenca tutti i trigger di un account.
Consentito per
Owner
Administrator
Uso di cURL
curl https://www.zopim.com/api/v2/triggers \
-v -u {indirizzo_email}:{password}
Esempio di risposta
HTTP/1.1 200 OK
Content-Type: application/json
[
{
"name" : "Trigger valido",
"enabled" : 1,
"description" : "Pagina inserimento visitatore"
},
{
"name" : "Trigger migliore",
"enabled" : 1,
"description" : "Chat richiesto dal visitatore"
}
]
Ottieni un trigger
GET /api/v2/triggers/{trigger_name}
Consente al proprietario/amministratore di un account di recuperare un trigger in base al nome.
Consentito per
Owner
Administrator
Uso di cURL
curl https://www.zopim.com/api/v2/triggers/{trigger_name} \
-v -u {indirizzo_email}:{password}
Esempio di risposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"name" : "Trigger valido",
"enabled" : 1,
"description" : "Chat richiesta dal visitatore",
}
Crea trigger
POST /api/v2/triggers
Consente al proprietario/amministratore di un account di aggiungere un trigger a un account.
Consentito per
Owner
Administrator
Uso di cURL
curl https://www.zopim.com/api/v2/triggers \
-d '{
"name" : "Trigger valido",
"enabled" : 1,
"description" : "Chat richiesto dal visitatore"
}' \
-v -u {indirizzo_email}:{password} \
-X POST -H "Content-Type: application/json"
Esempio di risposta
HTTP/1.1 201 Creato
Content-Type: application/json
{
"name" : "Trigger valido",
"enabled" : 1,
"description" : "Chat richiesta dal visitatore",
}
Indirizzamento dei messaggi a una pagina/directory specifica
Invia un messaggio automatico a un URL o a una directory specifici
curl https://www.zopim.com/api/v2/triggers \
-d '{
"name" : "Scarpa a righe",
"enabled" : 1,
"description" : "Invia codice sconto per scarpa Stripe",
"definizione" : {
"event" : "page_enter",
"condizione" : [
"e",
[
"icontains",
"@visitor_page_url",
"stripshoe"
],
[
"stillOnPage",
20
]
],
"azioni" : [
[
"sendMessageToVisitor",
"Timmy",
"Abbiamo un codice sconto per te! Usa DISCOUNT10 al prossimo pagamento"
]
]
}
}' \
-v -u {indirizzo_email}:{password} \
-X POST -H "Content-Type: application/json"
Per la configurazione dettagliata dei trigger, vai alla pagina Trigger dell’account
Aggiorna trigger
PUT /api/v2/triggers/{trigger_name}
Consente al proprietario/amministratore di un account di aggiornare i dati di un trigger.
Consentito per
Owner
Administrator
Uso di cURL
curl https://www.zopim.com/api/v2/triggers/{trigger_name} \
-d '{
"name" : "Miglior trigger",
"description" : "Il visitatore ha richiesto una nuova chat"
}' \
-v -u {indirizzo_email}:{password} \
-X PUT -H "Tipo di contenuto: application/json"
Esempio di risposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"name" : "Miglior trigger",
"enabled" : 1,
"description" : "Il visitatore ha richiesto una nuova chat",
}
Elimina trigger
DELETE /api/v2/triggers/{trigger_name}
Consente al proprietario/amministratore di un account di eliminare un trigger.
Consentito per
Owner
Administrator
Uso di cURL
curl https://www.zopim.com/api/v2/triggers/{trigger_name} \
-v -u {indirizzo_email}:{password} -X DELETE
Esempio di risposta
HTTP/1.1 204 OK
Content-Type: application/json
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.