Início rápido - documentos do EasyLiveChat

§ 01Crie o seu workspace.

Vá até ao painel demo em a página de login. Use a conta proprietária pré-criada, ou em produção crie um novo workspace — escolha um slug, esse será o seu subdomínio (acme.livechattools.com).

No primeiro login chega à caixa de entrada. Ainda não há conversas reais — é o que o passo dois resolve.

§ 02Incorpore o widget.

Cole o script loader antes da tag de fecho </body> . É tudo — sem componente React para montar, sem plugin Vue para registar.

HTMLapps/your-site/index.html

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

Substitua acme pelo seu próprio slug de workspace. O script obtém o tema ao vivo do seu tenant — cores, copy, flag RTL e avatar — pelo que alterações de design nunca exigem um re-deploy do seu site.

Identificar um visitante

Se o visitante está autenticado no seu produto, entregue ao widget a identidade dele para correlacionar conversas EasyLiveChat com a sua tabela de utilizadores:

JSwindow.LivechattoolsConfig — identificação

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',
    },
  },
};

§ 03Envie a sua primeira resposta.

Abra o seu site numa segunda aba do browser, clique na bolha e escreva "Hello world". A mensagem chega à caixa do painel em tempo real através de um canal Socket.IO — abaixo do segundo, sem fallback de polling.

Pressione ⌘↩ em qualquer resposta de agente para enviá-la. O visitante vê a sua mensagem aparecer com um som suave e um ponto de presença que muda para "Typing…" enquanto compõe.

§ 04Convide a sua equipa.

Em Definições → Agentes, clique em Convidar, e introduza um email e função. A EasyLiveChat envia um link de uso único por email; clicando define-se uma palavra-passe e o novo agente chega diretamente à caixa. As funções impõem o que veem — owners administram faturação, admins gerem agentes, agentes respondem.

bashPOST /api/tenant/agents — convidar via 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"
      }'

§ 05Defina horas de trabalho.

Fora de horas o widget troca o composer por um formulário offline. As conversas continuam a chegar à sua caixa — são etiquetadas como offline para um seguimento limpo na manhã seguinte. Configure janelas de dias de semana em Definições → Horas de trabalho, cada um no fuso horário local do seu tenant.

JSONHorário de exemplo — Dom–Qui, 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."
}

§ 06Para onde ir a seguir.

Este artigo foi útil?

Sugerir uma edição ↗