Prendi pieno controllo della tua Live Chat grazie alle potenti JS API
Raccogli i dati dei tuoi utenti e traccia i loro componenti sulla tua piattaforma o sito
Se vuoi controllare la grafica e i comportamenti della tua live chat programmaticamente
Perfetto per essere notificati quando qualcuno interagisce con la tua Live Chat
Se vuoi autenticare i tuoi utenti automaticamente, controlla il codice qui sotto
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
user_id: "USER_ID", // Optional
name: "USER_NAME",
email: "USER_EMAIL",
});
Raccogli i dati degli utenti automaticamente ogni volta che usano la tua app, così quando lo snippet JS di Customerly viene caricato, aggiorneremo tutti i dati dei tuoi clienti
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
user_id: "USER_ID", // Optional
name: "USER_NAME",
email: "USER_EMAIL",
// Add your custom attributes of the user you want to track
attributes: {
created_at: 1384902000, // Add dates as Unix timestamp
license_expire_at: 1603490400 // Add any other attribute here with value_key:value
}
});
Se gestisci utenti che gestiscono diverse aziende o progetti all'interno della tua piattaforma, potresti voler utilizzare le aziende per monitorarli. Quando l'utente cambia azienda nella tua piattaforma, passa le aziende relative a Customerly come mostrato di seguito e le seguiremo
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
user_id: "USER_ID", // Optional
name: "USER_NAME",
email: "USER_EMAIL",
// Company Properties can be added here as you wish
company: {
company_id: "COMPANY_ID", // Your internal ID of the company or project
name: "COMPANY_NAME", // The name of the user's project or company
// Add another property here that you might need to track
// The format should follow:
// - property_name: property_value
license_expire_at: 1603490400
}
});
Se vuoi aggiornare qualsiasi valore nei tuoi dettagli utente, potresti voler chiamare la funzione update() e passare lo stesso dizionario della funzione load().
customerly.update({...}) // Same value as load
Se i tuoi utenti aggiornano una proprietà nella tua piattaforma dovrai chiamare questa funzione per aggiornarla anche a Customerly
customerly.attribute("plan", "unlimited")
Il fondamento di una grande automazione del marketing inizia dal monitoraggio del comportamento degli utenti sulla tua piattaforma. Tieni traccia degli eventi per le azioni più importanti sulla tua app o sul tuo sito web
customerly.event("subscribed")
Se vuoi disconnettere il tuo utente nel messenger, puoi farlo in qualsiasi momento con il codice qui sotto
customerly.logout()
Con alcune modifiche all'API JS Live Chat puoi controllare ancora di più il comportamento della live chat. Apri e chiudi come desideri e molto altro ancora
La live chat rileva automaticamente le impostazioni internazionali dell'utente e adatta la sua lingua per impostazione predefinita a una delle lingue multiple. Se vuoi forzare la lingua principale che selezioni nella tua dashboard, aggiungi l'opzione autodetectLocale e usa false
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
autodetectLocale: false
});
Per mostrare la live chat, se in precedenza avevi nascosto con il visibile: false di cui sopra, puoi utilizzare la funzione show()
customerly.show()
Per nascondere la live chat in determinate azioni, puoi utilizzare la funzione hide()
customerly.hide()
Potresti voler nascondere la live chat su determinate pagine, puoi farlo aggiungendo l'opzione visibile con il valore booleano. Accettiamo valori veri o falsi
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
visible: false
});
Se vuoi nascondere la live chat solo sul cellulare, puoi farlo aggiungendo l'opzione visibileSuMobile
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
visibleOnMobile: false
});
Per aprire la home page della live chat, puoi utilizzare il metodo open(). Questo simulerà un clic sulla bolla della live chat. Questo è super utile se vuoi connettere la tua live chat aperta al tuo pulsante personalizzato
customerly.open()
Se desideri aprire la live chat con un messaggio di chat precompilato puoi utilizzare la seguente funzione
customerly.sendNewMessage("Hey team, I need an Enterprise plan for my project, can you help?");
Se vuoi chiudere la live chat in modo programmatico mentre è aperta, ecco come puoi farlo
customerly.close()
Se vuoi la live chat a destra, usa la direzione: "destra", altrimenti usa "sinistra".
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
direction: "right | left",
position: {
desktop: {
bottom: 50,
side: 50
},
mobile: {
bottom: 30,
side: 30
}
}
});
Se vuoi cambiare il colore di base della tua live chat, puoi personalizzarlo qui. Accettiamo tutti i codici HEX
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
accentColor: "#ffffff"
});
Se vuoi cambiare il colore di contrasto della tua live chat, puoi personalizzarlo qui. Accettiamo tutti i codici HEX
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
contrastColor: "#000000"
});
Per impostazione predefinita, la live chat offre un'icona a forma di clip per allegare file alla conversazione. Se desideri nascondere la funzionalità degli allegati, puoi utilizzare l'opzione attachmentsAvailable e impostarla su false
customerly.load({
app_id: "YOUR_CUSTOMERLY_ID",
// Custom options
attachmentsAvailable: false
});
Se vuoi monitorare una conversione PPC ogni volta che qualcuno apre una live chat, o forse vuoi personalizzare il comportamento della tua live chat, usa i callback della live chat
La onChatOpened verrà attivata quando il client apre la finestra di chat. Ideale se si desidera controllare l'icona della live chat dopo aver aperto la finestra di chat (per controllare la finestra di chat, fare riferimento al tutorial qui).
customerly.onChatOpened = function( ) { … };
La onChatClosed verrà attivata quando il client chiude la finestra di chat. Ideale se vuoi nascondere l'icona della live chat dopo aver chiuso la finestra di chat (per chiudere la finestra di chat fai riferimento al tutorial qui).
customerly.onChatClosed = function( ) { … };
Se desideri essere avvisato dalla live chat quando qualcuno istanzia una nuova conversazione con te e lascia la sua email, puoi utilizzare la onLeadGenerated .
La funzione restituisce:
- email: email del lead inserita nella live chat (se presente, altrimenti sarà nulla).
customerly.onLeadGenerated = function( ) { … };
La onNewConversation verrà attivata quando un utente o un lead avvia una nuova conversazione. Ideale se vuoi monitorare in Google Analytics o altro servizio di analisi che utilizzi le pagine con più conversazioni aperte.
La funzione restituisce:
- messaggio: una stringa contenente il messaggio appena inviato.
- allegati: un elenco di dizionari con il contenuto degli allegati aggiunti al messaggio
customerly.onNewConversation = function( ) { … };
La onProfilingQuestionAsked verrà attivata quando una delle domande di profilazione è stata mostrata al visitatore.
La funzione restituisce:
- attributo: l'attributo per la relativa domanda posta
customerly.onProfilingQuestionAsked = function( ) { … };
La onProfilingQuestionAnswered verrà attivata quando il lead risponde a una qualsiasi delle domande di profilazione.
La funzione restituisce:
- attributo: l'attributo per la relativa domanda posta
- valore: la risposta lasciata dal lead
customerly.onProfilingQuestionAnswered = function( ) { … };
La onRealtimeVideoAnswered verrà attivata quando il client risponde a una chat video in tempo reale
customerly.onRealtimeVideoAnswered = function( ) { … };
La onRealtimeVideoRejected verrà attivata quando il client rifiuta una chat video in tempo reale
customerly.onRealtimeVideoRejected = function( ) { … };
La onHelpCenterArticleOpened verrà attivata quando il cliente apre un articolo del Centro assistenza all'interno del widget della live chat.
La funzione restituisce:
- articolo: l'articolo aperto dal cliente.
Il payload dell'articolo consiste in:
- Conto : Conto
- corpo: stringa
- Collezione : Collezione
- creato_a: numero
- descrizione: stringa
- knowledge_base_article_id: numero
- lumaca: stringa
- titolo: stringa
- aggiornato_a: numero
customerly.onHelpCenterArticleOpened = function( ) { … };
Tieni traccia di ogni volta che i tuoi utenti o visitatori ricevono un trigger di chat per comprendere le prestazioni dei tuoi messaggi.
customerly.onTriggerFired = function(triggerId) { … };