Avvio rapido: documenti EasyLiveChat

§ 01Crea il tuo workspace.

Vai al dashboard demo su la pagina di accesso. Usa l'account proprietario pre-creato, o in produzione crea un nuovo workspace — scegli uno slug, diventa il tuo sottodominio (acme.livechattools.com).

Al primo accesso atterri nella casella di posta. Non ci sono ancora conversazioni reali — è ciò che risolve il passaggio due.

§ 02Incorpora il widget.

Incolla lo script loader prima del tag di chiusura </body> . Tutto qui — nessun componente React da montare, nessun plugin Vue da registrare.

HTMLapps/your-site/index.html

<script>
  window.LivechattoolsConfig = { tenant: 'acme' };
</script>
<script src="https://cdn.livechattools.com/widget-loader.js" async defer></script>

Sostituisci acme con il tuo slug del workspace. Lo script recupera il tema live dal tuo tenant — colori, copy, flag RTL e avatar — quindi i cambi di design non richiedono mai un re-deploy del tuo sito.

Identificare un visitatore

Se il visitatore è loggato nel tuo prodotto, passa al widget la sua identità per correlare le conversazioni EasyLiveChat con la tua tabella utenti:

JSwindow.LivechattoolsConfig — identificazione

window.LivechattoolsConfig = {
  tenant: 'acme',
  identify: {
    id:    'usr_28x91',          // your stable user id
    name:  'Mariam El-Sayed',
    email: 'mariam@example.com',
    locale: 'ar',
    attributes: {
      plan:        'pro',
      mrr_cents:   4900,
      signed_up:   '2024-11-04',
    },
  },
};

§ 03Invia la tua prima risposta.

Apri il tuo sito in una seconda scheda del browser, clicca sulla bolla e digita "Hello world". Il messaggio arriva nella casella della dashboard in tempo reale tramite un canale Socket.IO — sotto il secondo, senza fallback di polling.

Premi ⌘↩ su qualsiasi risposta agente per inviarla. Il visitatore vede il tuo messaggio apparire con un suono leggero e un punto di presenza che passa a "Typing…" mentre componi.

§ 04Invita il tuo team.

Da Impostazioni → Agents, clicca su Invita, e inserisci un'email e un ruolo. EasyLiveChat invia via email un link monouso; cliccandolo si imposta una password e il nuovo agente arriva direttamente nella casella. I ruoli impongono cosa possono vedere — i proprietari amministrano la fatturazione, gli admin gestiscono gli agenti, gli agenti rispondono.

bashPOST /api/tenant/agents — invita tramite la REST API

curl -X POST https://acme.livechattools.com/api/tenant/agents \
  -H "Authorization: Bearer $EASYLIVECHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "email":  "noor@acme.test",
        "name":   "Noor Al-Saadi",
        "role":   "ADMIN"
      }'

§ 05Imposta gli orari di lavoro.

Fuori orario il widget sostituisce il composer con un modulo offline. Le conversazioni continuano ad arrivare nella casella — vengono taggate offline per un follow-up pulito la mattina dopo. Configura le finestre dei giorni feriali in Impostazioni → Orari di lavoro, ognuna nel fuso orario locale del tuo tenant.

JSONProgramma di esempio — Dom–Gio, 09:00–18:00 Asia/Erbil

{
  "timezone": "Asia/Erbil",
  "schedule": {
    "sunday":    [{ "from": "09:00", "to": "18:00" }],
    "monday":    [{ "from": "09:00", "to": "18:00" }],
    "tuesday":   [{ "from": "09:00", "to": "18:00" }],
    "wednesday": [{ "from": "09:00", "to": "18:00" }],
    "thursday":  [{ "from": "09:00", "to": "18:00" }],
    "friday":    [],
    "saturday":  []
  },
  "offlineMessage": "We're back Sunday at 9. Leave a note — we will reply."
}

§ 06Dove andare dopo.

Questo articolo è stato utile?

Suggerisci una modifica ↗