Manual vizual pas cu pas

sem.chat documentație

Un manual SEMJAT bazat pe capturi de ecran, construit din fluxul real al tabloului de bord sem.chat. Fiecare ghid vă spune pe ce să faceți clic, ce ar trebui să se întâmple după clic, cum să îl testați, cum să îl depanați și ce să faceți în continuare.

Nu s-au găsit ghiduri potrivite. Încercați un cuvânt cheie mai scurt, cum ar fi widget, API, voce, facturare, webhook, WordPress, SendPulse sau programare.
Notă despre capturi de ecran: fiecare imagine din acest manual a fost capturată din aplicația reală sem.chat folosind un spațiu de lucru demo. Detaliile sensibile ale contului, datele clienților, cheile API, detaliile de plată și conținutul conversațiilor private sunt mascate înainte de publicare.
01

Noțiuni introductive

Creați contul, terminați integrarea, înțelegeți tabloul de bord, creați primul bot, testați-l în mod privat, instalați-l și alegeți planul potrivit.

/authÎnregistrare, probă și primul bot
Captură reală din spațiul de lucru demo sem.chat
1Începeți cu Înregistrare sau Conectare de pe site-ul sau aplicația publică.
2Verificați adresa de e-mail înainte de a vă baza pe notificări sau mesaje de facturare.
3Utilizați onboarding pentru a crea primul bot înainte de a deschide tabloul de bord.
/vedere de ansambluPrezentare generală după conectare
Captură reală din spațiul de lucru demo sem.chat
1Folosiți acțiuni rapide pentru a crea un bot, pentru a vedea roboți, pentru a deschide analize sau pentru a gestiona facturarea.
2Examinați roboții activi, conversations, minutele vocale și satisfacția înainte de a face modificări.
3Verificați activitatea recentă după fiecare test de configurare.
Prima lansare

Înscrieți-vă, începeți proba și înțelegeți tabloul de bord

Pentru ce este asta: Folosiți acest flux de lucru pentru un spațiu de lucru nou-nouț sau când vă înscrieți la un coechipier care nu a folosit niciodată sem.chat.

Înainte de a începe
  • Utilizați un e-mail de afaceri care poate primi e-mailuri de verificare și facturare.
  • Decideți cine ar trebui să dețină spațiul de lucru înainte de a invita restul echipei.
  • Păstrați un site de testare sigur sau o pagină de pregătire pregătită pentru instalarea widgetului.
1

Deschideți pagina de înregistrare a aplicației

Accesați aplicația.sem.chat/auth de pe site-ul butonul Conectare / Înregistrare.

Rezultat așteptat: Pagina de autentificare afișează opțiuni de conectare și de creare a contului.
2

Creați contul

Introduceți e-mailul de afaceri, creați parola și trimiteți formularul de înscriere.

Rezultat așteptat: Aplicația solicită verificarea sau trece la onboarding după ce contul este acceptat.
3

Verificați e-mailul

Deschideți e-mailul de verificare și faceți clic pe linkul de confirmare.

Rezultat așteptat: Contul poate primi mesaje de facturare, invitare, raportare și alertă.
4

Integrare completă

Introduceți numele companiei, descrieți obiectivul asistentului, alegeți o culoare de pornire și creați primul bot.

Rezultat așteptat: Spațiul de lucru se deschide cu o schiță de bot și o stare de probă activă.
5

Deschideți Prezentare generală

Faceți clic pe Prezentare generală în bara laterală din stânga.

Rezultat așteptat: Tabloul de bord afișează carduri usage, acțiuni rapide și activitate recentă.
6

Alegeți următoarea acțiune

Utilizați Creați un bot nou pentru configurare, Vizualizați toți roboții pentru management, Analytics pentru performanță sau Facturare pentru limitele planului.

Rezultat așteptat: Știți unde să continuați în funcție de starea spațiului de lucru.
Cum se testează: Creați un bot de testare privat și trimiteți un mesaj de testare înainte de a invita colegii de echipă. Confirmați modificările activității Prezentare generală după test.
ProblemăFix
E-mailul de verificare nu ajungeVerificați spamul, confirmați ortografia e-mailului, apoi solicitați un alt e-mail de verificare.
Tabloul de bord se deschide la FacturareSpațiul de lucru poate avea nevoie de o încercare sau un plan activ. Începeți proba sau alegeți planul corect înainte de configurare.
Un coechipier nu poate accesa spațiul de lucruInvitați-i din Setări, Echipa în loc să partajați datele de conectare ale proprietarului.

Ce să faci în continuare: Creați primul bot, testați-l în mod privat, apoi instalați widget-ul pe o pagină de pregătire.

Test de lansare privat

Creați primul test de bot privat înainte de a fi difuzat

Pentru ce este asta: Utilizați aceasta pentru a verifica urmărirea contului, a botului, a widget-ului și a istoricului înainte ca clienții să vadă asistentul.

Înainte de a începe
  • Pregătiți un exemplu de întrebare pentru client.
  • Pregătiți o pagină de testare sau o pagină de testare HTML locală.
  • Nu utilizați datele reale ale clienților la primul test.
1

Deschide My Bots

Faceți clic pe My Bots în bara laterală sau utilizați Vizualizați toți boții din Prezentare generală.

Rezultat așteptat: Puteți vedea botul creat în timpul integrării sau o stare goală cu un buton New Bot.
2

Deschideți generatorul de bot

Faceți clic pe Bot nou sau Editați pe botul existent.

Rezultat așteptat: Bot Builder se deschide cu elemente de bază, widget, cunoștințe, voce și comenzi de integrare.
3

Salvați botul o dată

Completați numele botului necesar și primul mesaj, apoi faceți clic pe Salvare.

Rezultat așteptat: Botul primește un ID valid și poate genera cod de încorporare.
4

Previzualizare privat

Utilizați panoul de previzualizare și adresați-vă exemplul de întrebare.

Rezultat așteptat: Răspunsul ar trebui să se potrivească cu instrucțiunile tale sau să dezvăluie ce cunoștințe lipsesc.
5

Instalați pe scenă

Deschideți Embed, copiați fragmentul HTML și inserați-l înainte de eticheta de închidere a corpului pe pagina de punere în scenă.

Rezultat așteptat: Widgetul apare în colțul configurat pe desktop și mobil.
6

Confirmați urmărirea

Deschideți Inbox sau Chat History după conversația de testare.

Rezultat așteptat: Conversația de testare apare cu botul, canalul și istoricul mesajelor corecte.
Cum se testează: Trimiteți un mesaj text și un test de voce dacă vocea este activată. Confirmați că ambele apar în Chat History.
ProblemăFix
Codul de încorporare nu este disponibilSalvați mai întâi botul. Dacă sincronizarea vocală este încă în așteptare, așteptați sincronizarea sau salvați din nou după ce câmpurile obligatorii sunt completate.
Widgetul arată botul greșitConfirmați că data-bot-id din fragment se potrivește cu ID-ul botului din modalul Embed.
Nicio conversație nu apare în istorieActualizați Chat History, confirmați că botul este activ și asigurați-vă că testul a avut loc pe widget-ul instalat, nu pe o pagină învechită.

Ce să faci în continuare: Treceți la Bot Builder configurarea și formarea cunoștințelor.

02

Creați și configurați un bot

Creați, editați, previzualizați, activați, transferați sau eliminați roboți din My Bots și Bot Builder.

/tabloul de bordMy Bots centru de control
Captură reală din spațiul de lucru demo sem.chat
1Faceți clic pe Bot nou pentru a începe un nou asistent.
2Utilizați Editați, Încorporați, Transferați, Activați sau Ștergeți pe fiecare card bot.
3Verificați starea activă și ora ultimei actualizări înainte de testare.
/bots/:id/editBot Builder fila noțiuni de bază
Captură reală din spațiul de lucru demo sem.chat
1Completați numele botului, avatarul, primul mesaj și instrucțiunile de sistem.
2Utilizați Previzualizare pentru a testa înainte de publicare.
3Salvați și sincronizați înainte de a copia codul de încorporare.
Creați bot

Creați un bot nou din My Bots

Pentru ce este asta: Utilizați acest flux de lucru atunci când o nouă marcă, site web, coadă de asistență sau campanie are nevoie de propriul asistent.

Înainte de a începe
  • Pregătiți numele botului, obiectivul, primul mesaj și două sau trei exemple de întrebări.
  • Colectați site-ul web public URL dacă intenționați să importați conținut.
  • Confirmați că planul permite numărul de roboți și funcții de voce/avatar de care aveți nevoie.
1

Deschide My Bots

Faceți clic pe My Bots în bara laterală.

Rezultat așteptat: Boții existenți și butonul New Bot sunt vizibile.
2

Faceți clic pe Bot nou

Porniți un bot nou de pe pagina My Bots.

Rezultat așteptat: Bot Builder se deschide cu un asistent de schiță.
3

Setați identitatea botului

Introduceți numele botului, încărcați sau alegeți un avatar și scrieți primul mesaj pe care îl vor vedea vizitatorii.

Rezultat așteptat: Panoul de previzualizare reflectă numele asistentului, avatarul și salutul.
4

Scrieți instrucțiuni de sistem

Descrieți ce ar trebui să facă botul, cum ar trebui să vorbească, ce ar trebui să evite și când ar trebui să ceară ajutor uman.

Rezultat așteptat: Asistentul are reguli clare de comportament înainte de a adăuga cunoștințe.
5

Adăugați cunoștințe de bază

Inserați informații esențiale despre companie, produs, asistență, prețuri și informații de contact în zona de cunoștințe.

Rezultat așteptat: Botul poate răspunde la întrebări obișnuite fără a avea nevoie încă de importul site-ului web.
6

Salvați botul

Faceți clic pe Salvare și așteptați confirmarea salvată sau sincronizată.

Rezultat așteptat: Botul are un ID stabil, previzualizarea poate fi testată și opțiunile de încorporare devin disponibile.
7

Previzualizează rezultatul

Puneți exemplele de întrebări pregătite în Previzualizare.

Rezultat așteptat: Răspunsurile ar trebui să urmeze instrucțiunile și să folosească cunoștințele pe care le-ați introdus.
8

Activați numai când este gata

Activați botul după trecerea testului privat.

Rezultat așteptat: Botul este pregătit pentru traficul prin widget sau canal.
Cum se testează: Pune cel puțin cinci întrebări realiste. Verificați dacă răspunsul este corect, dacă rămâne pe brand și dacă cere ajutor uman atunci când este necesar.
ProblemăFix
Răspunsul este prea genericAdăugați cunoștințe mai specifice și rescrieți instrucțiunile cu exemple de răspunsuri bune.
Botul refuză întrebările la care ar trebui să răspundăEliminați instrucțiunile prea stricte și adăugați cunoștințe de încredere pentru acel subiect.
Salvarea nu generează cod de încorporareVerificați câmpurile obligatorii și salvați din nou după terminarea sincronizării furnizorului de voce.

Ce să faci în continuare: Configurați setările widgetului, adăugați cunoștințe despre site, apoi instalați botul.

Gestionați roboții

Editați, clonați fluxul de lucru, transferați, dezactivați sau ștergeți un bot

Pentru ce este asta: Utilizați acest flux de lucru atunci când un bot are nevoie de actualizări, modificări de proprietate, întrerupere temporară sau eliminare definitivă.

Înainte de a începe
  • Exportați orice conversație sau date de contact pe care trebuie să le păstrați înainte de a șterge un bot.
  • Confirmați că botul nu este încorporat pe un site web live înainte de a-l șterge sau de a-l transfera.
  • Spune-le colegilor de echipă înainte de a dezactiva un bot de producție.
1

Deschide My Bots

Găsiți cardul bot după nume sau stare.

Rezultat așteptat: Cardul arată starea curentă și acțiunile disponibile.
2

Faceți clic pe Editați

Deschideți generatorul de bot și faceți modificările necesare.

Rezultat așteptat: Editorul încarcă configurația curentă.
3

Salvați și retestați

Faceți clic pe Salvare după fiecare modificare de material, apoi rulați întrebări de previzualizare.

Rezultat așteptat: Configurația salvată este utilizată de previzualizarea și widgetul instalat.
4

Dezactivați temporar

Utilizați comutatorul activ dacă botul ar trebui să nu mai gestioneze vizitatorii deocamdată.

Rezultat așteptat: Botul nu mai difuzează trafic live, păstrând în același timp configurația.
5

Transferați proprietatea

Utilizați Transfer, introduceți e-mailul destinatarului și confirmați.

Rezultat așteptat: Contul selectat primește dreptul de proprietate conform fluxului de transfer al aplicației.
6

Ștergeți numai după verificări

Folosiți Delete, citiți avertismentul și confirmați numai când botul nu mai este necesar.

Rezultat așteptat: Botul și configurația aferentă sunt eliminate conform avertismentului.
Cum se testează: După editare, deschideți widgetul instalat și puneți întrebarea exactă care a motivat schimbarea. Confirmați că răspunsul live a fost schimbat.
ProblemăFix
Vechiul răspuns încă apareActualizați pagina site-ului web, confirmați că ați salvat botul corect și verificați dacă cunoștințele importate necesită o sincronizare.
Transferul eșueazăConfirmați că e-mailul destinatarului este valid și că contul de destinație poate accepta botul.
Ștergerea a fost făcută din greșealăOpriți înainte de confirmarea finală. Există avertismente de ștergere deoarece acțiunea poate elimina definitiv datele botului.

Ce să faci în continuare: Examinați analizele și istoricul după modificările live pentru a vă asigura că experiența vizitatorilor s-a îmbunătățit.

03

Instalați widgetul

Copiați codul de încorporare corect, instalați-l în contexte HTML, WordPress, React sau avansate SDK, apoi verificați comportamentul desktop și mobil.

Încorporați modalCopiați fragmentul de instalare a site-ului web
Captură reală din spațiul de lucru demo sem.chat
1Alegeți HTML, WordPress, React sau NPM/SDK în funcție de stiva site-ului.
2Copiați codul după ce botul este salvat și sincronizat.
3Lipiți fragmentul înainte de eticheta body de închidere sau în aspectul cadrului.
HTML instalați

Instalați widgetul pe un site web standard HTML

Pentru ce este asta: Utilizați acest lucru atunci când puteți edita șablonul de pagină, subsolul temei sau aspectul global HTML.

Înainte de a începe
  • Salvați mai întâi botul, astfel încât modalul de încorporare să aibă un ID de bot real.
  • Utilizați un loc de montaj înainte de producție.
  • Păstrați versiunea de script exactă și data-bot-id din modal.
1

Deschide My Bots

Găsiți botul pe care doriți să îl instalați și faceți clic pe Încorporați.

Rezultat așteptat: Modulul Embed se deschide cu file de instalare.
2

Selectează HTML

Alegeți fila HTML și faceți clic pe Copiere cod.

Rezultat așteptat: Scriptul widget este copiat cu ID-ul botului atașat.
3

Deschideți șablonul site-ului web

Editați subsolul global sau fișierul de aspect care se redă pe fiecare pagină în care ar trebui să apară widgetul.

Rezultat așteptat: Editați shell-ul site-ului partajat, nu o singură pagină izolată decât dacă este intenționat.
4

Lipiți înainte de a închide corpul

Lipiți fragmentul imediat înainte de eticheta body de închidere.

Rezultat așteptat: Scriptul se încarcă după conținutul paginii și poate monta containerul widget.
5

Publicați sau implementați

Salvați șablonul și implementați site-ul.

Rezultat așteptat: Scriptul widget este live pe paginile țintă.
6

Testați desktop și mobil

Deschideți site-ul într-o fereastră nouă de browser și într-o fereastră de vizualizare mobilă.

Rezultat așteptat: Widgetul apare în poziția configurată și se deschide fără erori de consolă.
Cum se testează: Trimiteți un mesaj de pe pagina live, apoi deschideți Inbox și Chat History pentru a confirma că conversația aparține botului corect.
ProblemăFix
Widgetul lipseșteConfirmați că codul este înaintea etichetei body de închidere, scripturile nu sunt blocate de către constructorul site-ului și botul este activ.
Apare un bot greșitCopiați din nou fragmentul și comparați data-bot-id cu botul dorit.
Widgetul se suprapune controalelor paginiiSchimbați poziția sau dimensiunea în Setările widgetului și testați din nou pe mobil.

Ce să faci în continuare: Ajustați setările widgetului și captarea clienților potențiali după instalare.

HTML încorpora
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Instalare platformă

Instalați în fluxuri WordPress, React sau voce avansată SDK

Pentru ce este asta: Utilizați acest lucru atunci când site-ul web este gestionat de un CMS, de o aplicație React sau de o integrare vocală personalizată.

Înainte de a începe
  • Aflați care stivă deține aspectul partajat.
  • Utilizați fragmentul exact afișat în sem.chat pentru botul selectat.
  • Pentru utilizarea avansată a SDK, confirmați că aveți cheia publică și ID-ul de asistent Vapi necesare.
1

Opțiunea WordPress

Utilizați Aspect, Editorul de teme, footer.php sau un plugin de încredere pentru anteturi și subsoluri.

Rezultat așteptat: Fragmentul este încărcat pe pagini publice WordPress.
2

Opțiunea React

Creați o componentă ChatWidget mică, adăugați scriptul în useEffect și redați-l în aspectul rădăcină.

Rezultat așteptat: Widgetul se încarcă o dată și se curăță dacă aspectul se demontează.
3

Opțiune avansată SDK

Folosiți fila NPM/SDK numai atunci când aveți nevoie de controale personalizate pentru apeluri vocale dincolo de widgetul implicit.

Rezultat așteptat: Aplicația dvs. controlează sesiunea vocală în timp ce sem.chat rămâne sursa configurată a asistentului.
4

Verificați ID-ul botului

Confirmați că codul instalat face referire la ID-ul botului din modalul Embed.

Rezultat așteptat: Widgetul live se conectează la asistentul dorit.
5

Verificați consola

Deschideți instrumentele de dezvoltare browser și reîncărcați.

Rezultat așteptat: Nu există erori de script blocat, container duplicat sau erori de rețea.
Cum se testează: Completați un mesaj de testare de pe site-ul instalat, apoi confirmați că apare în Inbox cu pagina așteptată URL.
ProblemăFix
React încarcă widget-uri duplicatGardiți inserarea scriptului cu un ref sau randați componenta numai în aspectul rădăcină.
WordPress dezactivează etichetele de scriptUtilizați un plugin de injectare de subsol sau un fișier temă care permite scripturi.
Apelul SDK nu poate începeVerificați cheia publică, ID-ul asistentului, permisiunile browserului și planificați accesul pentru voce.

Ce să faci în continuare: Treceți la Setări widget pentru a controla comportamentul, brandingul și captarea clienților potențiali.

WordPress fragment de subsol
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React componentă
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Voce avansată SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

Setări widget

Configurați modul, tema, dimensiunea, poziția, culoarea, marca, reacțiile, sunetul, consimțământul, captarea clienților potențiali, evaluările, e-mailul de urmărire și starea de activare.

Bot Builder / WidgetAspectul widgetului și comportamentul vizitatorilor
Captură reală din spațiul de lucru demo sem.chat
1Alegeți modul chat, voce sau hibrid.
2Setați tema, culoarea, poziția, dimensiunea, brandingul, consimțământul și sunetul.
3Configurați captarea clienților potențiali, evaluările, reacțiile și comportamentul de urmărire.
Comportamentul widgetului

Configurați comportamentul widget-ului orientat către vizitator

Pentru ce este asta: Utilizați acest lucru după prima instalare sau oricând widget-ul trebuie să se potrivească cu site-ul web și să capteze clienți potențiali mai buni.

Înainte de a începe
  • Instalați widget-ul pe o pagină de pregătire.
  • Aflați dacă vizitatorii ar trebui să înceapă cu chat, voce sau ambele.
  • Pregătiți consimțământul și copierea de captare a clienților potențiali, dacă este necesar pentru regiune.
1

Deschideți generatorul de bot

Deschideți My Bots, faceți clic pe Editați, apoi alegeți fila Widget.

Rezultat așteptat: Comenzile widget apar pentru botul selectat.
2

Alegeți modul

Selectați Chat, Voce sau Hybrid în funcție de experiența dorită de vizitator.

Rezultat așteptat: Previzualizarea se modifică pentru a afișa modul ales.
3

Setați aspectul

Alegeți tema, culoarea, dimensiunea, poziția butonului și opțiunile de branding.

Rezultat așteptat: Widgetul se potrivește cu site-ul fără a acoperi conținut important.
4

Activați comenzile pentru vizitatori

Activați sau dezactivați reacțiile, sunetul, evaluările și solicitările de consimțământ.

Rezultat așteptat: Vizitatorii văd doar comenzile pe care doriți să le folosească.
5

Configurați captarea clienților potențiali

Alegeți câmpurile obligatorii, câmpul de descriere opțional și când apare formularul.

Rezultat așteptat: Contactele sunt colectate înainte sau în timpul conversations, în funcție de configurația dvs.
6

Setați e-mailul de urmărire

Configurați comportamentul de e-mail de urmărire dacă planul dvs. îl include.

Rezultat așteptat: Vizitatorii pot primi mesaje ulterioare după rezolvarea conversations.
7

Salvați și testați

Faceți clic pe Salvare, reîncărcați pagina de pregătire și deschideți widgetul.

Rezultat așteptat: Widgetul live se potrivește cu setările salvate.
Cum se testează: Deschideți widgetul pe desktop și mobil, trimiteți un formular de client potențial, lăsați o evaluare și confirmați că contactul și conversația sunt înregistrate.
ProblemăFix
Culoarea nu s-a actualizatSalvați botul, reîmprospătați site-ul și confirmați că widgetul instalat folosește același ID de bot.
Câmpurile de lead lipsescConfirmați că capturarea lead-ului este activată și este îndeplinită condiția de declanșare selectată.
Vizitatorii nu pot folosi voceaVerificați setările de voce, permisiunea microfonului browserului, accesul la plan și limitele pentru minutele vocale.

Ce să faci în continuare: Adăugați setări de voce/avatar și surse de cunoștințe înainte de lansarea producției.

05

Voce și avatare

Selectați voci stoc, configurați modul și limitele de voce, citiți transcrieri, clonați voci, atribuiți voci clonate și gestionați avatarele stoc sau personalizate.

Bot Builder / VoceVoce, limite, transcrieri și avatare
Captură reală din spațiul de lucru demo sem.chat
1Alegeți o voce stoc sau o voce clonată salvată.
2Setați limite pentru minutele vocale și salvați transcrierea.
3Alegeți avataruri stoc sau încărcați un avatar personalizat dacă planul o permite.
Configurare voce

Configurați apeluri vocale și transcrieri

Pentru ce este asta: Utilizați acest lucru atunci când vizitatorii ar trebui să vorbească cu botul în loc să tasteze doar.

Înainte de a începe
  • Confirmați că planul include minute de voce și opțiunile dorite pentru voce/avatar.
  • Utilizați un mediu de browser silențios pentru testare.
  • Pregătiți o întrebare realistă de asistență sau de vânzări pentru a fi testată vocal.
1

Deschide Setările Voice

Deschideți generatorul de bot și selectați zona Voce sau Voce și avatare.

Rezultat așteptat: Comenzile vocale și selecția curentă a vocii sunt vizibile.
2

Selectați o voce de stoc

Previzualizați vocile disponibile, alegeți cea mai potrivită și salvați selecția.

Rezultat așteptat: Botul folosește vocea aleasă pentru apeluri.
3

Configurați modul voce

Utilizați Setări widget pentru a alege Voce sau Hibrid când vocea ar trebui să fie disponibilă pentru vizitatori.

Rezultat așteptat: Vizitatorii văd o opțiune vocală în widget.
4

Setați limite de voce

Definiți limitele pentru fiecare utilizator sau spațiul de lucru, dacă sunt disponibile.

Rezultat așteptat: Apelurile lungi sau repetate nu pot consuma mai multe minute decât cele prevăzute.
5

Activați transcrierile

Activați salvarea transcripției dacă aveți nevoie de examinare a apelurilor în istoric.

Rezultat așteptat: Apelurile vocale creează transcrieri care pot fi citite după sesiune.
6

Testați un apel

Deschideți widgetul, permiteți accesul la microfon, începeți un apel și puneți întrebarea pregătită.

Rezultat așteptat: Botul răspunde prin voce și apelul se termină curat.
7

Citiți transcrierea

Deschideți Chat History și găsiți conversația vocală.

Rezultat așteptat: Transcrierea arată ce au spus vizitatorul și botul.
Cum se testează: Finalizați un apel scurt și confirmați că sunt înregistrate minutele vocale, transcrierea și modul de conversație.
ProblemăFix
Browserul blochează microfonulPermiteți permisiunea microfonului în browser și reîncărcați pagina.
Opțiunea de voce este blocatăDeschideți Facturare și confirmați că planul spațiului de lucru include funcții vocale.
Transcrierea este goalăConfirmați că salvarea transcripției este activată și apelul sa încheiat normal.

Ce să faci în continuare: Adăugați sau îmbunătățiți cunoștințele, astfel încât răspunsurile vocale să fie corecte.

Clonarea vocii și avatarul

Clonează o voce și atribuie un avatar personalizat

Pentru ce este asta: Folosiți-l atunci când asistentul are nevoie de o experiență de voce de marcă sau de avatar vorbitor.

Înainte de a începe
  • Folosiți numai sunet și imagini pe care aveți permisiunea de a le utiliza.
  • Înregistrați mostre de voce curată cu zgomot de fundal scăzut.
  • Confirmați limitele planului pentru vocile clonate și avatarele personalizate.
1

Deschideți Clonarea vocii

Faceți clic pe Clonează voce din zona Voce.

Rezultat așteptat: Fereastra de dialog de încărcare arată cerințele de exemplu acceptate.
2

Încărcați mostre

Încărcați una până la cinci înregistrări clare și trimiteți cererea de clonare.

Rezultat așteptat: Vocea clonată apare după procesare sau dialogul arată următoarea cerință.
3

Atribuiți vocea clonată

Selectați vocea clonată în selectorul de voce și salvați.

Rezultat așteptat: Apelurile viitoare folosesc vocea clonata.
4

Alegeți un avatar stoc

Alegeți un avatar inclus dacă nu este necesară încărcarea avatarului personalizat.

Rezultat așteptat: Experiența vocală are o identitate vizuală.
5

Încărcați un avatar personalizat

Încărcați o imagine clară a feței sau un videoclip scurt dacă planul dvs. acceptă acest lucru.

Rezultat așteptat: Avatarul este procesat și devine disponibil pentru selecție.
6

Rulați o previzualizare completă

Porniți un apel vocal și confirmați împreună vocea, avatarul și comportamentul de transcriere.

Rezultat așteptat: Experiența vizitatorului se potrivește cu marca configurată.
Cum se testează: Puneți o întrebare scurtă cu vocea clonată selectată și confirmați că apelul folosește vocea/avatarul așteptat.
ProblemăFix
Calitatea clonelor este slabăÎnregistrați mostre mai curate cu un singur difuzor, volum stabil și fără muzică.
Încărcarea avatarului personalizat nu este disponibilăVerificați Facturarea pentru limitele de avatare în funcție de plan.
Vocea veche încă mai joacăSalvați botul după ce ați selectat noua voce și reîncărcați pagina widget.

Ce să faci în continuare: Treceți la Cunoștințe și date, astfel încât experiența vocală să aibă răspunsuri precise.

06

Cunoștințe și date

Adăugați cunoștințe manuale, importați conținutul site-ului web, aplicați rezultatele accesării cu crawlere, sincronizați conținutul importat, adăugați feeduri de produse URLs, reîmprospătați sau eliminați feedurile și verificați răspunsurile cu întrebări de testare.

Bot Builder / CunoștințeSurse de cunoștințe și testarea răspunsurilor
Captură reală din spațiul de lucru demo sem.chat
1Adăugați cunoștințe manuale pentru politici, prețuri și reguli de marcă.
2Importați paginile site-ului web și aplicați rezultatele accesării cu crawlere.
3Adăugați fluxuri de produse și sincronizați-le atunci când inventarul se modifică.
Surse de cunoștințe

Antrenați botul cu cunoștințe manuale, importul site-ului web și fluxurile de produse

Pentru ce este asta: Utilizați acest lucru ori de câte ori asistentul oferă răspunsuri incomplete sau are nevoie de informații noi despre produse, politici sau site-uri web.

Înainte de a începe
  • Pregătiți URLs sursă și flux de produse URLs.
  • Decideți ce pagini nu trebuie importate, cum ar fi paginile de administrare sau cele private.
  • Creați întrebări de test pentru fiecare subiect pe care îl adăugați.
1

Deschide Cunoașterea

Deschideți Bot Builder și alegeți fila Cunoștințe sau Date.

Rezultat așteptat: Cunoștințele manuale, importul site-ului web și instrumentele de alimentare cu produse sunt vizibile.
2

Adăugați cunoștințe manuale

Lipiți fapte concise, politici, prețuri, detalii de contact și note de stil de răspuns.

Rezultat așteptat: Botul are o sursă imediată de încredere pentru răspunsuri cu prioritate ridicată.
3

Importați conținutul site-ului web

Lipiți site-ul web public URL și începeți accesarea cu crawlere/import.

Rezultat așteptat: Rezultatele accesării cu crawlere arată paginile descoperite sau starea importului.
4

Examinați și aplicați rezultatele

Păstrați paginile utile, eliminați paginile irelevante, apoi aplicați conținutul selectat.

Rezultat așteptat: Doar conținutul site-ului web aprobat intră în baza de cunoștințe.
5

Adăugați feed de produse URLs

Inserați Google Merchant Center sau feedurile acceptate URL și importați.

Rezultat așteptat: Produsele, prețurile, disponibilitatea și atributele devin disponibile pentru bot.
6

Actualizați sau eliminați fluxurile

Utilizați reîmprospătarea când datele din catalog se modifică și eliminați fluxurile care nu mai sunt utilizate.

Rezultat așteptat: Botul evită datele de produs învechite sau duplicate.
7

Salvați și sincronizați

Salvați botul și așteptați finalizarea sincronizării.

Rezultat așteptat: Cele mai recente cunoștințe sunt utilizate de previzualizarea și răspunsurile widget live.
8

Pune întrebări de verificare

Pune o întrebare de test pentru fiecare sursă adăugată.

Rezultat așteptat: Răspunsul citează sau reflectă cu acuratețe conținutul actualizat.
Cum se testează: Puneți întrebări despre prețuri, returnări, disponibilitate, informații despre companie și subiecte neacceptate. Confirmați că botul răspunde la subiecte cunoscute și nu inventează detalii necunoscute.
ProblemăFix
Crawlerul importă pagini irelevanteEliminați acele pagini din rezultatele selectate și adăugați instrucțiuni manuale mai clare.
Prețurile produselor sunt învechiteReîmprospătați fluxul și confirmați că fluxul URL conține valorile curente.
Botul inventează răspunsuriAdăugați o regulă conform căreia botul ar trebui să spună că nu este sigur și să ofere sprijin uman atunci când lipsesc cunoștințele.

Ce să faci în continuare: Reveniți la Previzualizare, testați din nou, apoi instalați sau actualizați widgetul.

07

Inbox, Live Support, Istoric, Contacte

Gestionați zilnic conversations, revendicați solicitările de asistență live, controlul manual înapoi la AI, exportați istoricul, gestionați contactele și sincronizați contactele cu SendPulse.

/inboxFlux de lucru pentru conversații în Mesaje primite
Captură reală din spațiul de lucru demo sem.chat
1Filtrați după bot sau canal.
2Deschideți o conversație și răspundeți ca om atunci când este necesar.
3Utilizați cu atenție comenzile de traducere, rezolvare și transfer.
/live-supportControlul transferului de suport live
Captură reală din spațiul de lucru demo sem.chat
1Solicitați rapid transferul de așteptare.
2Răspundeți ca agent sau predați conversația înapoi către AI.
3Rezolvați când vizitatorul nu mai are nevoie de ajutor uman.
/chat-istorieIstoricul conversațiilor și exporturi
Captură reală din spațiul de lucru demo sem.chat
1Căutați după vizitator, bot, canal sau dată.
2Deschideți transcrierile complete pentru sesiunile de text și voce.
3Exportați CSV sau JSON atunci când este necesar.
/contacteContacte și SendPulse export
Captură reală din spațiul de lucru demo sem.chat
1Filtrați contactele după bot sau sursă.
2Deschideți detaliile de contact și contextul conversației.
3Exportați sau sincronizați contactele selectate în SendPulse.
Răspuns inbox

Deschideți o conversație și trimiteți un răspuns uman

Pentru ce este asta: Utilizați acest lucru atunci când un operator trebuie să răspundă unui client de la sem.chat în loc să lase AI să continue singur.

Înainte de a începe
  • Confirmați că operatorul are acces la bot sau la spațiul de lucru.
  • Citiți conversația înainte de a răspunde.
  • Aflați dacă vizitatorul se așteaptă la aceeași limbă.
1

Deschide Inbox

Faceți clic pe Inbox în bara laterală.

Rezultat așteptat: conversations recente apar cu bot, canal, vizitator, stare și ora.
2

Filtrați dacă este necesar

Folosiți filtre de canal, bot, necitite sau de stare pentru a găsi conversația.

Rezultat așteptat: Lista se restrânge la setul de conversații de care aveți nevoie.
3

Deschide conversația

Faceți clic pe rândul vizitator.

Rezultat așteptat: Firul complet, informațiile despre vizitatori și comenzile de răspuns sunt vizibile.
4

Traduceți dacă este necesar

Utilizați comenzile de traducere atunci când limba vizitatorului diferă de limba agentului.

Rezultat așteptat: Agentul poate înțelege și răspunde în mod corespunzător.
5

Trimiteți un răspuns

Scrie răspunsul uman și trimite-l.

Rezultat așteptat: Mesajul este adăugat în fir ca răspuns de agent/om.
6

Rezolvați sau păstrați deschis

Rezolvați conversația dacă este completă sau lăsați-o deschisă pentru urmărire.

Rezultat așteptat: Starea căsuței de e-mail se potrivește cu starea reală a clientului.
Cum se testează: Trimiteți un răspuns de test sigur la o conversație de testare și confirmați că apare în widget-ul vizitatorului și Chat History.
ProblemăFix
Răspunsul nu poate fi trimisVerificați starea rețelei, starea conversației și dacă a fost solicitat asistență live.
Limbajul vizitatorului este greșitUtilizați traducerea sau actualizați setările de limbă bot înainte de a răspunde.
Conversația nu este în InboxCăutați Chat History și confirmați că testul widget a folosit botul corect.

Ce să faci în continuare: Utilizați Live Support pentru cozile de transfer active și Chat History pentru audituri.

Suport live

Revendicați, răspundeți, predați înapoi AI și rezolvați o transferare

Pentru ce este asta: Utilizați acest lucru atunci când AI solicită unui om sau un vizitator are nevoie în mod explicit de un agent.

Înainte de a începe
  • Aveți un agent disponibil înainte de a activa asistența live.
  • Definiți când AI ar trebui să solicite transferul în instrucțiunile botului.
  • Păstrați setările de notificare activate pentru alertele de transfer.
1

Deschide Live Support

Faceți clic pe Live Support în bara laterală.

Rezultat așteptat: Așteptarea și transferul activ conversations sunt vizibile.
2

Revendicați cererea

Faceți clic pe Revendicați în conversația în așteptare.

Rezultat așteptat: Alți agenți pot vedea că conversația este gestionată în mod activ.
3

Citiți contextul

Deschideți mesajele și detaliile vizitatorilor înainte de a răspunde.

Rezultat așteptat: Agentul înțelege de ce a avut loc transferul.
4

Trimiteți răspunsul uman

Răspundeți clar și mențineți threadul actualizat.

Rezultat așteptat: Vizitatorul primește un răspuns uman.
5

Înapoi la AI, dacă este cazul

Folosiți mâna înapoi când se răspunde la problemă și AI poate continua.

Rezultat așteptat: AI reia gestionarea conversației.
6

Rezolvați când ați terminat

Faceți clic pe Rezolvare după ce vizitatorul nu mai are nevoie de ajutor.

Rezultat așteptat: Transferul este închis și eliminat din coada activă.
Cum se testează: Creați un transfer de testare, revendicați-l, răspundeți o dată, returnați-l și confirmați modificările de stare în Live Support și Chat History.
ProblemăFix
Agenții ratează cereriActivați notificările browser/e-mail/push și adăugați un proces pentru proprietatea în coadă.
AI continuă să preia controlul prea devremeAjustați instrucțiunile și regulile de transfer, astfel încât controlul uman să rămână activ până când este rezolvat sau returnat.
CRM extern nu este sincronizatUtilizați webhook-uri sau sondaje din secțiunea Rețete pentru dezvoltatori.

Ce să faci în continuare: Conectați CRM/webhooks dacă echipele de asistență lucrează în afara sem.chat.

Istoric și contacte

Căutați, exportați și utilizați înregistrările de conversație/contact

Pentru ce este asta: Folosiți-l pentru audituri, examinare potențială, export CSV și sincronizare SendPulse.

Înainte de a începe
  • Decideți dacă aveți nevoie de conversations, persoane de contact sau ambele.
  • Aplicați intervalul de date corect înainte de a exporta.
  • Nu exportați mai multe date personale decât este necesar.
1

Deschide Chat History

Faceți clic pe Chat History în bara laterală.

Rezultat așteptat: Filtrele de conversație, statisticile și lista de transcriere sunt vizibile.
2

Căutați și filtrați

Filtrați după bot, canal, mod, vizitator sau interval de date.

Rezultat așteptat: Numai conversations care se potrivesc rămân vizibile.
3

Deschideți o transcriere

Faceți clic pe o conversație pentru a citi firul de mesaje complet.

Rezultat așteptat: Contextul complet, detaliile de contact și metadatele conversației sunt vizibile.
4

Exportați conversations

Faceți clic pe Export și alegeți formatul necesar, dacă este disponibil.

Rezultat așteptat: Exportul conține datele de conversație filtrate.
5

Deschideți Contacte

Faceți clic pe Contacte în bara laterală.

Rezultat așteptat: Înregistrările de clienți potențiali/contact apar cu sursa, botul și starea.
6

Filtrați și exportați contacte

Căutați contacte, selectați înregistrările dorite, apoi exportați sau sincronizați cu SendPulse.

Rezultat așteptat: Contactele selectate sunt disponibile în afara sem.chat în funcție de acțiunea aleasă.
Cum se testează: Exportați un mic CSV filtrat și deschideți-l local pentru a confirma că coloanele și intervalul de date sunt corecte.
ProblemăFix
Contact lipsește din AgendăConfirmați că capturarea clienților potențiali este activată și vizitatorul a trimis formularul.
Exportul este prea mareRestrângeți intervalul de date sau filtrul bot înainte de a exporta.
Sincronizarea SendPulse nu este disponibilăConectați mai întâi SendPulse în Integrations, apoi reveniți la Contacte.

Ce să faci în continuare: Examinați Analytics pentru a înțelege tendințele de performanță după rularea operațiunilor.

08

Canale și integrări

Conectați Slack, Facebook, Instagram, WhatsApp, Telegram prin BotFather, acreditări manuale, link-uri alternative chat, integrări SendPulse, SendPulse_ și _0_SEMCHAT.

/integrariCanale, CRM și conexiuni de e-mail
Captură reală din spațiul de lucru demo sem.chat
1Alegeți canalul sau cardul de integrare CRM.
2Urmați pașii OAuth sau acreditările pentru fiecare furnizor.
3Deconectați sau retestați integrările de pe aceeași pagină.
Conectați canale

Conectați un canal de mesagerie sau integrarea CRM

Pentru ce este asta: Utilizați acest lucru atunci când sem.chat ar trebui să primească conversations în afara widget-ului site-ului web sau să trimită persoane de contact către alte instrumente.

Înainte de a începe
  • Aveți acces de administrator la platforma externă.
  • Aflați ce bot ar trebui să primească mesaje de canal.
  • Utilizați canale de testare înainte de a conecta conturile de producție.
1

Integrari deschise

Faceți clic pe Integrații în bara laterală.

Rezultat așteptat: Canalele disponibile, instrumentele CRM, SendPulse și opțiunile widget pentru site-ul web sunt vizibile.
2

Alegeți integrarea

Faceți clic pe Conectare pe Slack, Canale meta, Telegram, SendPulse, CRM sau acreditările manuale.

Rezultat așteptat: Se deschide dialogul de configurare sau fluxul OAuth.
3

Configurare completă a furnizorului

Pentru canalele OAuth, aprobați permisiunile solicitate. Pentru canalele manuale, inserați simbolul, secretul, ID-ul contului sau webhook-ul necesar URL.

Rezultat așteptat: sem.chat stochează conexiunea și arată integrarea ca fiind conectată.
4

Atribuiți botul

Alegeți ce bot ar trebui să gestioneze mesajele de pe canalul respectiv atunci când dialogul vă solicită.

Rezultat așteptat: Mesajele primite sunt direcționate către asistentul corect.
5

Testează canalul

Trimiteți un mesaj de testare de pe canalul extern.

Rezultat așteptat: Mesajul apare în Inbox sau Chat History sub canalul corect.
6

Deconectați-vă dacă este necesar

Folosiți Deconectați de pe cardul de integrare atunci când canalul ar trebui să se oprească.

Rezultat așteptat: sem.chat nu mai primește sau trimite prin acea integrare.
Cum se testează: Trimiteți un mesaj de testare prin canalul conectat și confirmați răspunsul botului, rândul Inbox și înregistrarea istoricului.
ProblemăFix
Jetonul Telegram eșueazăCreați sau resetați jetonul în BotFather și lipiți-l din nou.
Mesajele Slack nu sosescVerificați sfera aplicației, abonamentul la eveniment URL, simbolul bot, secretul de semnare și calitatea de membru al canalului.
Conexiunea metacanalului eșueazăConfirmați că contul Facebook/Instagram/WhatsApp are permisiuni de administrator și are nevoie de acces comercial.
Sincronizarea SendPulse eșueazăReconectați SendPulse și confirmați că câmpurile de contact sunt mapate.

Ce să faci în continuare: Documentați proprietatea canalului pentru echipă și monitorizați Inbox după lansare.

09

Programare

Creați tipuri de evenimente, configurați disponibilitatea, conectați calendare, gestionați rezervările, creați linkuri unice, configurați e-mailuri de rezervare, revizuiți analizele, setați evenimente plătite și testați linkuri publice de rezervare.

/programareProgramarea spațiului de lucru
Captură reală din spațiul de lucru demo sem.chat
1Utilizați filele pentru Tipuri de evenimente, Rezervări, Analytics, Linkuri unice, Calendare, E-mailuri și Setări.
2Editați, copiați, încorporați, activați sau întrerupeți tipurile de evenimente.
3Copiați linkul public și rulați un test privat de rezervare.
Editor de evenimenteConfigurare tip eveniment
Captură reală din spațiul de lucru demo sem.chat
1Introduceți numele, descrierea, durata, locația și bufferele.
2Setați disponibilitatea, ferestrele de rezervare, întrebările, opțiunile pentru evenimente plătite și regulile de anulare.
3Salvați evenimentul înainte de a partaja linkul.
/carte/:nume utilizator/:eventSlugPagina publică de rezervare
Captură reală din spațiul de lucru demo sem.chat
1Vizitatorii aleg o dată din pagina de rezervare publică.
2Vizitatorii aleg un interval orar disponibil.
3Vizitatorii confirmă rezervarea și primesc e-mailuri de confirmare.
Tipul evenimentului

Creați un tip de eveniment și publicați un link de rezervare

Pentru ce este asta: Folosiți-l atunci când vizitatorii ar trebui să rezerve demonstrații, consultări, apeluri de vânzări, sesiuni de integrare sau de asistență.

Înainte de a începe
  • Alegeți numele evenimentului, durata, tipul întâlnirii și proprietarul.
  • Setați fusul orar și disponibilitatea înainte de a partaja linkurile.
  • Conectați calendarele dacă rezervarea dublă contează.
1

Deschideți Programare

Faceți clic pe Programare în bara laterală.

Rezultat așteptat: Spațiul de lucru de programare arată file pentru tipuri de evenimente, rezervări, analize, linkuri unice, calendare, e-mailuri și setări.
2

Creați un tip de eveniment

Faceți clic pe Creare, apoi adăugați numele, descrierea, durata, locația, bufferul și regulile de rezervare.

Rezultat așteptat: Evenimentul are suficiente informații publice pentru ca vizitatorii să-l înțeleagă.
3

Setați disponibilitatea

Configurați orele săptămânale, înlocuirile de date, ferestrele de notificare și fereastra de rezervare.

Rezultat așteptat: Vizitatorii văd doar momentele pe care ești dispus să le oferi.
4

Adăugați întrebări

Adăugați întrebări necesare, cum ar fi telefon, companie, site web sau obiectiv de întâlnire.

Rezultat așteptat: Rezervările colectează contextul de care are nevoie echipa ta înainte de apel.
5

Conectați calendare

Deschideți Calendare și conectați Google, Outlook sau iCal dacă este disponibil.

Rezultat așteptat: Orele aglomerate pot fi blocate, iar rezervările confirmate pot fi scrise în calendar.
6

Setați e-mailuri și mementouri

Deschideți E-mailuri și configurați mesajele de confirmare, memento, anulare și reprogramare.

Rezultat așteptat: Vizitatorii primesc o comunicare corectă de rezervare.
7

Distribuiți și testați linkul public

Copiați linkul evenimentului, deschideți-l într-o fereastră privată, alegeți un slot și finalizați o rezervare de test.

Rezultat așteptat: Rezervarea apare în fila Rezervări și sunt trimise mesaje de confirmare.
Cum se testează: Finalizați o rezervare de test, o reprogramare și o anulare. Confirmați că fiecare eveniment apare în Programare și calendare conectate.
ProblemăFix
Nu apare niciun timp pe pagina publicăVerificați fusul orar, disponibilitatea săptămânală, suprascrierile de date, fereastra de notificare și conflictele de calendar conectate.
Lipsește e-mailul de rezervareVerificați setările de e-mail și dosarul de spam, apoi trimiteți o altă rezervare de probă.
Plata eșuează la evenimentul plătitConfirmați că setările de integrare de facturare/plată și moneda sunt valide înainte de publicare.

Ce să faci în continuare: Încorporați linkuri de rezervare în bot, site web sau e-mailuri ulterioare.

Programare avansată

Folosiți linkuri unice, analize, încorporare și evenimente plătite

Pentru ce este asta: Utilizați acest lucru atunci când programarea necesită disponibilitate temporară, raportare, rezervare încorporată sau plată.

Înainte de a începe
  • Creați mai întâi cel puțin un tip de eveniment.
  • Conectați calendarele înainte de a utiliza intens linkurile unice.
  • Definiți politica de rambursare/anulare înainte de a activa evenimentele plătite.
1

Creați o legătură unică

Deschide Link-uri unice, selectează sloturile sau regulile oferite, apoi generează linkul.

Rezultat așteptat: Destinatarul poate rezerva doar din disponibilitatea selectată.
2

Încorporați programarea

Utilizați opțiunea de încorporare a cardului de eveniment dacă fluxul de rezervare ar trebui să apară pe site-ul dvs. web.

Rezultat așteptat: Interfața de utilizare pentru rezervare poate fi plasată în pagina în care vizitatorii efectuează conversia.
3

Examinați analizele de programare

Deschideți Analytics în cadrul Programării.

Rezultat așteptat: Puteți vedea rezervările, tendințele de finalizare și performanța de tip eveniment.
4

Activați evenimentele plătite

Deschideți editorul de evenimente, setați prețul, moneda și comportamentul de plată.

Rezultat așteptat: Vizitatorii trebuie să finalizeze pasul de plată în conformitate cu configurarea evenimentului.
5

Audit rezervări

Deschideți Rezervările și examinați intrările viitoare, finalizate, anulate și reprogramate.

Rezultat așteptat: Echipa poate gestiona prezența și urmărirea.
Cum se testează: Rezervați prin pagina publică și printr-o pagină încorporată dacă este utilizată. Confirmați că ambele creează același tip de înregistrare de rezervare.
ProblemăFix
Legătura unică expune sloturi greșiteRegenerați legătura cu un set de sloturi mai mic sau un interval de date mai strict.
Rezervarea încorporată este prea restrânsăPlasați încorporarea într-un container de conținut mai larg și verificați aspectul mobil.
Analytics par golCreați sau așteptați rezervări reale; analizele depind de înregistrările rezervărilor.

Ce să faci în continuare: Conectați rezultatele programării la Rapoarte și Analytics.

10

Analize și rapoarte

Alegeți intervale de date, utilizați date personalizate, citiți valorile principale, exportați CSV, examinați tendințele privind satisfacția și conversațiile, configurați rapoartele prin e-mail și verificați livrarea.

/analiticaTabloul de bord Analytics
Captură reală din spațiul de lucru demo sem.chat
1Alegeți intervale de date sau date personalizate.
2Citiți valorile de conversație, satisfacție, limbă, canal și conversie.
3Exportați CSV pentru analiză offline.
Setări / RapoarteConfigurarea raportului prin e-mail
Captură reală din spațiul de lucru demo sem.chat
1Alegeți cadența raportului zilnic, săptămânal sau lunar.
2Adăugați destinatarii raportului.
3Trimiteți un raport instantaneu pentru livrarea de testare.
Analiză statistică

Citiți analize și exportați date de performanță

Pentru ce este asta: Utilizați aceasta pentru recenzii săptămânale, verificări de lansare, evaluarea calității suportului și analiza conversiilor.

Înainte de a începe
  • Alegeți intervalul de date înainte de a citi valorile.
  • Aflați ce bot sau canal evaluați.
  • Excludeți datele de testare private atunci când raportați performanța producției.
1

Deschideți Analytics

Faceți clic pe Analytics în bara laterală.

Rezultat așteptat: Valorile tabloului de bord și panourile de diagrame sunt vizibile.
2

Alege intervalul de date

Selectați astăzi, 7 zile, 30 de zile sau date personalizate.

Rezultat așteptat: Toate graficele se actualizează la perioada selectată.
3

Citiți valorile de bază

Examinați conversations, minute vocale, satisfacție, conversie și mixul de canale.

Rezultat așteptat: Înțelegeți volumul și calitatea interacțiunilor cu clienții.
4

Examinați tendințele

Priviți tendințele conversațiilor, schimbările de satisfacție, întrebările de top și modelele de limbă/canal.

Rezultat așteptat: Puteți identifica unde să îmbunătățiți instrucțiunile botului sau personalul.
5

Exportați CSV

Utilizați Export CSV atunci când echipa are nevoie de analiză de foi de calcul.

Rezultat așteptat: CSV conține intervalul de date și valorile selectate.
6

Transformă constatările în schimbări

Actualizați instrucțiunile botului, cunoștințele, setările widgetului sau acoperirea asistenței pe baza datelor.

Rezultat așteptat: Analizele conduc la îmbunătățiri concrete ale produselor.
Cum se testează: Exportați o mică dată personalizată CSV și verificați că intervalul de date și valorile se potrivesc cu ceea ce arată tabloul de bord.
ProblemăFix
Valorile par prea mariVerificați dacă punerea în scenă/testul conversations sunt incluse în intervalul de date selectat.
Satisfacția este goalăActivați evaluările în Setările widgetului și așteptați ca vizitatorii să lase evaluări.
Minutele vocale nu se potrivesc cu așteptărileConfirmați că modul vocal este activat numai pentru roboții vizați.

Ce să faci în continuare: Programați rapoarte prin e-mail pentru vizibilitate recurentă.

Rapoarte

Configurați rapoarte recurente prin e-mail și livrarea testului

Pentru ce este asta: Utilizați acest lucru atunci când proprietarii, managerii sau clienții au nevoie de rezumate automate ale performanței.

Înainte de a începe
  • Decideți cine ar trebui să primească rapoarte.
  • Utilizați adrese de e-mail verificate.
  • Alegeți o cadență care se potrivește cu ritmurile de revizuire a afacerilor.
1

Deschide Setări, apoi Rapoarte

Accesați Setări și selectați fila Rapoarte sau utilizați redirecționarea Rapoarte dacă este disponibilă.

Rezultat așteptat: Cadena raportului, destinatarii și istoricul sunt vizibile.
2

Alegeți cadența

Activați rapoarte zilnice, săptămânale sau lunare.

Rezultat așteptat: Programul de raportare este stocat pentru spațiul de lucru.
3

Adăugați destinatari

Introduceți adresele de e-mail care ar trebui să primească rapoarte.

Rezultat așteptat: Rapoartele sunt trimise părților interesate corecte.
4

Trimiteți raport instantaneu

Faceți clic pe Trimiteți acum sau pe o acțiune echivalentă de raport instantaneu.

Rezultat așteptat: Un e-mail de raport este trimis imediat pentru verificare.
5

Examinați istoricul raportului

Verificați panoul istoric după trimiterea rapoartelor.

Rezultat așteptat: Puteți confirma starea și momentul livrării.
Cum se testează: Trimiteți un raport instantaneu unui destinatar de testare și confirmați primirea și formatarea.
ProblemăFix
E-mailul de raportare nu ajungeVerificați ortografia destinatarului, dosarul de spam și starea istoricului raportați.
Oamenii greșiți primesc rapoarteActualizați destinatarii și salvați înainte de următoarea trimitere programată.
Conținutul raportului pare zgomotosAjustați așteptările pentru intervalul de date și utilizați Analytics pentru o examinare manuală mai profundă.

Ce să faci în continuare: Utilizați cadența de raportare ca ritm de operare pentru îmbunătățirile botului.

11

Facturare, echipă, securitate, setări, afiliat

Începeți sau faceți upgrade la planuri, gestionați portalul de facturare, invitați colegii de echipă, setați roluri, editați profilul/limbajul, configurați notificările, activați 2FA, utilizați acțiunile din zona de pericol și rulați fluxul de lucru afiliat.

/facturarePlanificare și controale de facturare
Captură reală din spațiul de lucru demo sem.chat
1Examinați planul actual, starea de încercare și limitele usage.
2Comparați caracteristicile planului înainte de a face upgrade.
3Deschideți portalul de facturare pentru facturi, metode de plată, anulare sau reactivare.
/setariSetări, echipă și securitate
Captură reală din spațiul de lucru demo sem.chat
1Utilizați General pentru profil și limbă.
2Utilizați Echipa pentru invitații și roluri.
3Utilizați Securitate pentru cheile 2FA, API și acțiunile din zona de pericol.
/afiliatControalele programului de afiliere
Captură reală din spațiul de lucru demo sem.chat
1Alăturați-vă programului pentru a crea un link de recomandare.
2Copiați linkul de recomandare pentru campanii.
3Setați e-mailul de plată și solicitați plăți eligibile.
Facturare

Porniți, actualizați, anulați sau reactivați un plan

Pentru ce este asta: Folosiți-l atunci când spațiul de lucru necesită activare de probă, mai multe limite, facturi, actualizări de plată sau modificări de abonament.

Înainte de a începe
  • Proprietarul contului sau administratorul de facturare ar trebui să efectueze acțiuni de facturare.
  • Confirmați care funcții sunt bazate pe plan: voce, voci clonate, avatare personalizate, API, echipă, CRM și canale.
  • Utilizați portalul de facturare securizat pentru modificarea metodei de plată și a facturii.
1

Deschideți Facturare

Faceți clic pe Facturare în bara laterală.

Rezultat așteptat: Planul actual, starea de încercare, limitele usage și cardurile de plan sunt vizibile.
2

Comparați planurile

Examinați limitele chat, voce, echipă, API, avatar, integrare, programare și asistență.

Rezultat așteptat: Știți care plan deblochează funcția necesară.
3

Alegeți intervalul de facturare

Selectați lunar sau anual dacă comutatorul este disponibil.

Rezultat așteptat: Actualizarea prețurilor și a economiilor pentru intervalul selectat.
4

Faceți upgrade sau începeți plata

Alegeți planul dorit și finalizați plata.

Rezultat așteptat: Abonamentul devine activ după confirmarea plății.
5

Deschideți portalul clienților

Utilizați portalul de facturare pentru metoda de plată, facturi, anulare sau reactivare.

Rezultat așteptat: Acțiunile sensibile de facturare au loc în portalul furnizorului securizat.
6

Verificați accesul la funcții

Reveniți la funcția care a fost blocată și reîncărcați aplicația.

Rezultat așteptat: Funcția deblocată este acum disponibilă dacă planul o include.
Cum se testează: După actualizare, deschideți caracteristica blocată anterior, cum ar fi clonarea vocală sau tastele API și confirmați că blocarea a dispărut.
ProblemăFix
Funcția rămâne blocată după upgradeActualizați aplicația, așteptați un moment pentru sincronizarea abonamentului, apoi verificați din nou Facturare.
Checkout a fost anulatReveniți la Facturare și începeți din nou finalizarea comenzii; nu au loc modificări de plan după o finalizare a comenzii.
Aveți nevoie de factură sau de schimbare a carduluiDeschideți portalul clienților în loc să editați detaliile de plată în interiorul aplicației.

Ce să faci în continuare: Invitați colegi de echipă și asigurați contul de proprietar.

Echipa si securitate

Invitați colegi de echipă, setați roluri, editați profilul, activați 2FA și gestionați setările

Pentru ce este asta: Utilizați acest lucru atunci când spațiul de lucru trece de la configurarea individuală la operarea în echipă.

Înainte de a începe
  • Cunoașteți rolul fiecărui coechipier înainte de a trimite invitații.
  • Utilizați accesul cu cel mai mic privilegiu: proprietar, administrator, editor, vizualizator.
  • Pregătiți o aplicație de autentificare pentru 2FA.
1

Deschide Setări

Faceți clic pe Setări în bara laterală.

Rezultat așteptat: General, notificări, echipă, rapoarte, dezvoltatori, securitate și filele asociate sunt vizibile.
2

Editați profilul și limba

Actualizați numele afișat, informațiile de profil și limba preferată în general.

Rezultat așteptat: Aplicația identifică corect utilizatorul și folosește limba aleasă acolo unde este disponibilă.
3

Invitați membrii echipei

Deschideți Echipa, introduceți un e-mail, alegeți un rol și trimiteți invitația.

Rezultat așteptat: Coechipierul primește un link de invitație și apare ca în așteptare până când este acceptat.
4

Setați permisiunile pentru rol

Folosiți Owner pentru control deplin, Admin pentru management, Editor pentru modificări de conținut și Viewer pentru acces numai în citire.

Rezultat așteptat: Fiecare utilizator are acces adecvat responsabilității sale.
5

Configurați notificările

Alegeți notificări prin e-mail, browser, push, live-support, facturare și raportare.

Rezultat așteptat: Oamenii potriviți primesc alerte fără zgomot inutil.
6

Activați 2FA

Deschideți Securitate, activați autentificarea cu doi factori, scanați codul și stocați detaliile de recuperare.

Rezultat așteptat: Contul necesită un al doilea factor după autentificarea prin parolă.
7

Utilizați cu atenție acțiunile din zona periculoasă

Exportați datele necesare și confirmați widget-urile/integrările active înainte de acțiunile distructive ale contului.

Rezultat așteptat: Spațiul de lucru evită pierderea accidentală a datelor.
Cum se testează: Invitați un coechipier de testare, acceptați invitația într-un browser separat și confirmați că rolul expune doar caracteristicile dorite.
ProblemăFix
E-mailul de invitație lipseșteVerificați spamul, retrimiteți invitația și verificați adresa.
Coechipierul vede prea multeReduceți-le rolul și revizuiți setările de acces la bot.
Configurarea 2FA eșueazăVerificați ora dispozitivului, rescanați codul QR și stocați detaliile de recuperare înainte de a vă baza pe el.

Ce să faci în continuare: Configurați cheile API numai pentru utilizatorii și serviciile care au nevoie de ele.

Afiliat

Alăturați-vă afiliatului, copiați linkul de recomandare, setați e-mailul de plată și solicitați plata

Pentru ce este asta: Utilizați acest lucru atunci când un partener sau un client dorește să recomande noi utilizatori sem.chat și să urmărească activitatea comisioanelor.

Înainte de a începe
  • Utilizați contul care ar trebui să dețină atribuirea de recomandare.
  • Pregătiți e-mailul de plată înainte de a solicita plata.
  • Verificați regulile programului înainte de a publica campanii de recomandare.
1

Deschideți Afiliat

Faceți clic pe Afiliat în bara laterală sau deschideți fila afiliat din Setări, dacă este conectat acolo.

Rezultat așteptat: Pagina programului de afiliere afișează zonele de înscriere, recomandare, plăți și istoric.
2

Alăturați-vă programului

Faceți clic pe Alăturați-vă dacă contul nu s-a alăturat încă.

Rezultat așteptat: Se creează un cod de recomandare și un link de recomandare.
3

Copiați linkul de recomandare

Copiați linkul unic și utilizați-l în conținut, campanii sau mesaje ale partenerilor.

Rezultat așteptat: Înscrierile prin link pot fi atribuite contului de afiliat.
4

Setați e-mailul de plată

Introdu e-mailul de plată și salvează-l.

Rezultat așteptat: Plățile eligibile pot fi direcționate corect.
5

Examinați recomandările și comisioanele

Verificați lista de recomandare, starea comisiilor și istoricul plăților.

Rezultat așteptat: Știți ce este în așteptare, eligibil sau deja plătit.
6

Solicitați plata

Faceți clic pe Solicitați plată când sunt îndeplinite regulile și minimele programului.

Rezultat așteptat: Solicitarea de plată este înregistrată pentru procesare.
Cum se testează: Deschideți linkul de recomandare într-un browser privat și confirmați că ajunge în fluxul de înscriere așteptat cu urmărirea recomandărilor.
ProblemăFix
Linkul de recomandare lipseșteAlăturați-vă mai întâi la program sau reîmprospătați pagina de afiliat după înscriere.
Solicitarea de plată indisponibilăVerificați pragul minim de plată, starea comisionului eligibil și e-mailul de plată.
Recomandarea nu a fost atribuităConfirmați că vizitatorul a folosit linkul de recomandare exact și nu a eliminat parametrii de urmărire.

Ce să faci în continuare: Utilizați Analytics și Rapoarte pentru a monitoriza impactul clienților referiți, dacă este cazul.

12

Notificări și App Updates

Examinați alertele, marcați notificările ca citite, filtrați evenimentele importante și utilizați actualizările aplicației pentru a înțelege noile modificări ale produselor.

/notificăriCentru de notificare
Captură reală din spațiul de lucru demo sem.chat
1Utilizați Marcarea tuturor ca citite după ce ați examinat alertele necitite.
2Filtrați după necitite, facturare, asistență live sau evenimente de sistem.
3Deschideți caracteristica aferentă după ce ați citit alerta.
/app-updatesFeed de actualizări ale aplicației
Captură reală din spațiul de lucru demo sem.chat
1Citiți notele de lansare pentru noi funcții și remedieri.
2Folosiți detalii pentru a instrui colegii de echipă înainte de schimbările fluxului de lucru.
3Verificați actualizările după ce observați schimbări în UI sau comportament.
Notificări

Examinați notificările și acționați în funcție de alerte

Pentru ce este asta: Utilizați acest lucru atunci când aplicația raportează transferuri, starea de facturare, evenimente de sistem, livrare de rapoarte sau activitate importantă în spațiul de lucru.

Înainte de a începe
  • Asigurați-vă că preferințele de notificare sunt setate în Setări.
  • Aveți o acoperire de asistență live dacă sunt activate alertele de transfer.
  • Examinați alertele necitite înainte de a le marca ca fiind citite.
1

Deschideți Notificări

Faceți clic pe Notificări în bara laterală sau intrarea de notificare din antetul aplicației.

Rezultat așteptat: Centrul de notificare listează alertele recente.
2

Filtrați alertele

Utilizați filtre necitite sau de categorii pentru a vă concentra pe facturare, asistență live, bot, rapoarte sau evenimente de sistem.

Rezultat așteptat: Numai alertele care se potrivesc rămân vizibile.
3

Deschide pagina aferentă

Faceți clic pe alerta sau utilizați contextul acesteia pentru a deschide Facturare, Live Support, Rapoarte sau botul relevant.

Rezultat așteptat: Acționați în funcție de notificare în loc să o citiți.
4

Mark a citit

Marcați o singură alertă ca citită sau utilizați Marcarea tuturor ca citite după examinare.

Rezultat așteptat: Scăderile de număr necitite și articolele examinate nu mai sunt evidențiate.
5

Ajustați preferințele

Deschideți Setări, Notificări dacă sosesc prea multe sau prea puține alerte.

Rezultat așteptat: Fluxul de notificări corespunde nevoilor echipei.
Cum se testează: Creați un eveniment de testare sigur, cum ar fi o solicitare de asistență live sau un raport instantaneu, apoi confirmați ca notificarea apare și poate fi marcată ca citită.
ProblemăFix
Nu sosește nicio notificareVerificați preferințele de notificare Setări, permisiunea browserului și dacă evenimentul a avut loc într-adevăr.
Prea multe alerteDezactivează categoriile zgomotoase sau trimite-le doar membrilor responsabili ai echipei.
Numărul necitite pare blocatReîmprospătați aplicația după ce ați marcat toate citite și confirmați că filtrele nu ascund elementele necitite.

Ce să faci în continuare: Examinați App Updates când se schimbă comportamentul sau apar comenzi noi.

Actualizări ale aplicației

Utilizați actualizările aplicației pentru a înțelege modificările produselor

Pentru ce este asta: Utilizați acest lucru atunci când colegii de echipă trebuie să învețe ce s-a schimbat înainte de a utiliza o nouă funcție.

Înainte de a începe
  • Deschideți actualizările după lansările majore sau când interfața de utilizare se schimbă.
  • Partajați note de actualizare relevante cu utilizatorii de asistență și vânzări.
  • Retestați fluxurile de lucru critice după modificări majore.
1

Deschide App Updates

Faceți clic pe App Updates în bara laterală.

Rezultat așteptat: Fluxul de actualizare afișează noi funcții, remedieri și note de lansare.
2

Citiți cea mai recentă actualizare

Deschideți cel mai recent card de actualizare sau vizualizarea de detalii.

Rezultat așteptat: Vedeți ce s-a schimbat și ce flux de lucru afectează.
3

Mapați modificarea fluxului dvs. de lucru

Identificați dacă actualizarea afectează roboții, widget-ul, asistența, programarea, facturarea sau dezvoltatorii.

Rezultat așteptat: Membrii echipei potriviți știu ce să verifice.
4

Retestați căile critice

Dacă actualizarea afectează un flux de lucru de producție, repetați pașii manuali relevanți din această documentație.

Rezultat așteptat: Echipa confirmă că fluxul de lucru modificat încă funcționează.
5

Distribuie intern

Trimiteți rezumatul actualizării utilizatorilor care dețin zona afectată.

Rezultat așteptat: Adoptarea echipei este mai ușoară și întrebările de asistență scad.
Cum se testează: După o actualizare relevantă, repetați ghidul pentru caracteristica afectată și confirmați că capturile de ecran sau numele pașilor se potrivesc în continuare.
ProblemăFix
Actualizarea menționează o funcție blocatăDeschideți Facturare pentru a confirma dacă planul actual îl include.
Echipa a ratat o schimbareAdăugați App Updates recenzie pentru lansare sau rutine operaționale săptămânale.
Documentația pare învechită după o actualizareUtilizați Ghidul inginerului pentru a actualiza capturile de ecran și pașii.

Ce să faci în continuare: Păstrați documentația publică la zi pe măsură ce funcțiile evoluează.

13

Rețete pentru dezvoltatori

Generați chei API, utilizați autentificarea x-api-key, apelați punctele finale bazate pe acțiuni, conectați suportul live la un CRM, înregistrați webhook-uri, verificați semnăturile și încorporați widgetul în cod.

Setări / DezvoltatoriTaste API, pornire rapidă și file usage
Captură reală din spațiul de lucru demo sem.chat
1Generați și revocați cheile API din fila Chei API.
2Utilizați Quick Start pentru primele exemple de bucle.
3Examinați utilizarea înainte de a activa automatizarea pentru volum mare.
API pornire rapidă

Generați o cheie API și efectuați primele apeluri API

Pentru ce este asta: Utilizați acest lucru pentru scripturi de raportare, aplicații personalizate, punți CRM, asistență live externă sau automatizare.

Înainte de a începe
  • Utilizați un mediu pe partea de server. Nu expuneți cheile API în browser JavaScript.
  • Generați o cheie separată pentru fiecare integrare.
  • Copiați cheia imediat, deoarece secretele sunt afișate o dată.
1

Deschideți dezvoltatori

Deschide Setări și selectează Dezvoltatori sau folosește redirecționarea dezvoltatorilor, dacă este disponibilă.

Rezultat așteptat: Filele API Chei, Quick Start, Documentație și Utilizare sunt vizibile.
2

Generați o cheie

Faceți clic pe Generare cheie, acordați-i o etichetă clară și copiați-o imediat.

Rezultat așteptat: Cheia începe cu sk_live_ și este disponibilă pentru solicitările de pe partea serverului.
3

Trimite antet x-api-key

Includeți x-api-key în fiecare solicitare publică API.

Rezultat așteptat: Publicul API poate autentifica solicitarea și o poate extinde către proprietar.
4

Listați roboții

Apelați action=list-bots pentru a găsi ID-ul botului de care aveți nevoie.

Rezultat așteptat: Răspunsul returnează ID-urile botului, numele, starea activă și rezumatul configurației.
5

Trimiteți un mesaj chat

POST acțiune chat cu botId și mesaj.

Rezultat așteptat: Răspunsul returnează răspunsul, modelul și informațiile usage.
6

Verificați usage

Apelați la acțiune=usage înainte de a rula lucrări de mare volum.

Rezultat așteptat: Cunoașteți planul actual și starea usage înainte de rularea automatizării.
7

Rotiți tastele atunci când este necesar

Revocați cheile neutilizate și generați altele noi pentru furnizorii sau serviciile modificate.

Rezultat așteptat: Serviciile vechi nu pot continua să folosească acreditările învechite.
Cum se testează: Rulați list-bots și chat dintr-un terminal local sau un mediu server, apoi confirmați că conversația apare în Chat History dacă a fost trimis chat.
ProblemăFix
401 sau răspuns neautorizatVerificați ortografia x-api-key, copiați cheia completă și confirmați că nu a fost revocată.
Botul nu a fost găsitFolosiți din nou list-bots și confirmați că botul aparține proprietarului cheii API.
Problemă CORS în browserMutați apelul API în backend; Cheile API sunt destinate utilizării pe partea serverului.

Ce să faci în continuare: Utilizați /api-docs pentru referință focalizată la punctul final și păstrați această pagină ca ghid pentru fluxul de lucru.

Listați roboții
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
Trimiteți un mesaj chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
Suport live CRM pod

Sondați sau trimiteți cererile de asistență live într-un CRM

Pentru ce este asta: Utilizați acest lucru atunci când agenții lucrează în alt sistem, dar sem.chat primește conversația vizitatorului.

Înainte de a începe
  • Creați o cheie dedicată API numită pentru puntea CRM.
  • Decideți dacă sondajele sau webhook-urile se potrivesc infrastructurii dvs.
  • Asigurați-vă că CRM stochează ID-uri de conversație pentru răspunsuri/rezoluții viitoare.
1

Listați transferurile în așteptare

GET action=live-support-list cu status=requested sau status=all.

Rezultat așteptat: CRM primește conversations deschis care necesită atenție umană.
2

Preluați mesaje

GET action=live-support-messages cu conversationId.

Rezultat așteptat: CRM are context complet și detalii despre vizitator.
3

Revendicați înainte de a răspunde

POST action=live-support-claim.

Rezultat așteptat: sem.chat marchează conversația ca fiind gestionată în mod activ.
4

Trimiteți răspunsul agentului

POST action=live-support-reply cu conversationId, mesaj și agentName.

Rezultat așteptat: Vizitatorul primește răspunsul uman și actualizările firului.
5

Rezolvați sau dați înapoi

POST acțiune=live-support-resolve cu rezoluție rezolvată sau returnare.

Rezultat așteptat: Conversația iese din coada de așteptare sau AI reia controlul.
6

Starea înregistrării în CRM

Stocați cea mai recentă stare de transfer, ID-ul mesajului și marcajele de timp.

Rezultat așteptat: CRM și sem.chat rămân auditabile.
Cum se testează: Creați o transferare sigură, oglindiți-l în CRM, răspundeți de pe punte și confirmați actualizările firului de discuție al vizitatorilor.
ProblemăFix
Duplicați bilete CRMFolosiți conversationId ca cheie de idempotitate în puntea dvs. CRM.
Răspunsurile sosesc din ordineStocați marcajele de timp ale mesajelor și evitați răspunsurile simultane de la mai multe sisteme.
AI răspunde în timp ce agentul lucreazăRevendicați mai întâi transferul și returnați numai când agentul a terminat.

Ce să faci în continuare: Înregistrați webhook-uri dacă sondarea este prea lentă sau prea scumpă.

Webhook-uri

Înregistrați webhook-urile și verificați X-SemChat-Signature

Pentru ce este asta: Utilizați acest lucru atunci când sistemul dvs. are nevoie de evenimente în timp real pentru transferuri, mesaje și actualizări de rezoluție.

Înainte de a începe
  • Webhook URL trebuie să fie HTTPS și accesibil de pe internetul public.
  • Stocați imediat secretul webhook; se arată o dată.
  • Verificați semnăturile înainte de procesarea evenimentelor.
1

Înregistrați webhook-ul

POST acțiune webhook-register cu adresa URL și evenimente.

Rezultat așteptat: Răspunsul include detalii despre webhook și un secret de semnare unic.
2

Păstrați secretul

Salvați secretul în mediul server sau managerul secret.

Rezultat așteptat: Livrările viitoare pot fi verificate.
3

Verificați semnătura

Citiți X-SemChat-Signature și comparați-l cu un HMAC SHA-256 peste corpul cererii brute.

Rezultat așteptat: Sunt acceptate doar livrări sem.chat autentice.
4

Gestionați reîncercările idempotent

Utilizați ID-ul evenimentului sau ID-ul conversației/mesajului pentru a evita procesarea dublată.

Rezultat așteptat: Reîncercările nu creează înregistrări CRM duplicate.
5

Listați webhook-uri

GET acțiune webhook-list pentru a audita punctele finale configurate.

Rezultat așteptat: Puteți vedea URL-uri, evenimente, starea activată și starea de livrare recentă.
6

Ștergeți webhook-urile învechite

POST acțiune webhook-delete cu ID-ul webhook.

Rezultat așteptat: Punctele finale vechi nu mai primesc evenimente.
Cum se testează: Înregistrați un punct final de testare, declanșați un eveniment de asistență live, verificați semnătura și confirmați că handlerul returnează 2xx.
ProblemăFix
Semnătura nu se potriveșteUtilizați corpul brut, nu analizat JSON și confirmați secretul webhook corect.
Webhook nu primește niciun evenimentConfirmați că lista de evenimente include evenimentul pe care îl testați și punctul final este HTTPS.
Webhook expirăRecunoașteți rapid și procesați munca lungă în mod asincron.

Ce să faci în continuare: Conectați inginerii la /api-docs pentru detalii și exemple ale punctelor finale.

Înregistrați webhook
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Verificați semnătura webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Harta punctelor finale

Utilizați corect publicul bazat pe acțiuni API

Pentru ce este asta: Utilizați acest lucru atunci când alegeți acțiunea potrivită pentru o caracteristică.

Înainte de a începe
  • Fiecare solicitare folosește aceeași funcție public-api URL.
  • Acțiunile GET folosesc parametri de interogare. Acțiunile POST folosesc corpul JSON.
  • Trimiteți x-api-key pentru toate solicitările.
Cum se testează: Apelați usage și list-bots ca test de fum după orice modificare a cheii API sau a punctului final.
ProblemăFix
Nepotrivirea metodeiUtilizați metoda prezentată în tabelul punctelor finale. Unele acțiuni sunt doar GET sau numai POST.
Lipsește valoarea necesarăVerificați botId, conversationId, id-ul webhook și ortografia acțiunii.

Ce să faci în continuare: Utilizați Quick Start pentru primele solicitări, apoi /api-docs pentru referința completă.

MetodaAcțiuneScop
GETlist-botsListați toți roboții disponibili pentru proprietarul cheii API.
GETget-botPreluați o configurație de bot după ID-ul botului.
POSTchatTrimiteți un mesaj vizitator unui bot și returnați răspunsul AI.
GETconversationsListați conversations recente pentru un bot, până la 100 de înregistrări.
GETusagePlan de returnare, credite, număr de bot, conversations și cheie API usage.
GETlive-support-listLista conversations în așteptare sau gestionată de un agent uman.
GETlive-support-messagesPreluați un thread de transfer cu mesaje și informații despre vizitatori.
POSTlive-support-replyTrimiteți un răspuns uman-agent dintr-un sistem extern.
POSTlive-support-claimRevendicați o conversație de transfer în așteptare.
POSTlive-support-resolveRezolvați transferul sau returnați controlul către AI.
POSTwebhook-registerÎnregistrați un punct final de webhook HTTPS.
GETwebhook-listListați înregistrările webhook fără a returna secrete.
POSTwebhook-deleteȘtergeți o înregistrare webhook prin ID.
14

Ghid inginer: Adăugați caracteristici

Adăugați rute, navigare în tabloul de bord, setări pentru generatorul de bot, tabele/funcții/migrări Supabase, documente API, documentație publică, verificări SEO și verificare locală.

Flux de lucru cu funcția aplicației

Adăugați o rută a aplicației, o pagină, un element de navigare și o intrare în documente

Pentru ce este asta: Utilizați acest lucru atunci când adăugați o nouă funcție de tablou de bord orientată către clienți.

Înainte de a începe
  • Creați o ramură înainte de editare.
  • Identificați dacă caracteristica aparține depozitului de aplicație sau depozitului public sem.chat frontend.
  • Inspectați rutele existente, bara laterală, i18n și modelele de setări înainte de a adăuga o nouă structură.
1

Adăugați traseul

Actualizați src/App.tsx cu o rută protejată pentru paginile clienților sau o rută publică numai atunci când pagina trebuie să fie publică.

Rezultat așteptat: URL se rezolvă în aplicație fără a apăsa NotFound.
2

Creați sau actualizați componenta paginii

Utilizați modele de pagină existente, încărcarea datelor, stările goale, stările de încărcare și permisiunile.

Rezultat așteptat: Caracteristica se comportă în mod consecvent cu tabloul de bord.
3

Adăugați navigare în tabloul de bord

Actualizați bara laterală/sursa de navigare cu etichetă, pictogramă, traseu și porți de plan, dacă este necesar.

Rezultat așteptat: Utilizatorii pot descoperi noua pagină din shell-ul aplicației.
4

Adăugați fila sau setarea pentru generatorul de bot

Dacă caracteristica aparține unui bot, adăugați-o în filele Bot Builder și păstrați-o prin fluxurile de salvare existente.

Rezultat așteptat: Configurația specifică botului este salvată cu bot, nu blocată în starea locală.
5

Adăugați Supabase modificări de schemă/funcție

Creați migrări pentru tabele/politici și funcții de margine pentru lucrul pe server.

Rezultat așteptat: Comportamentul bazei de date și al serverului poate fi implementat în mod repetat.
6

Actualizați forma API dacă este publică

Adăugați sau extindeți gestionarea acțiunilor în supabase/functions/public-api/index.ts și documentați comportamentul x-api-key.

Rezultat așteptat: Integrările pot folosi funcția în siguranță.
7

Actualizați documentele aplicației și documentația publică

Actualizați documentele pentru dezvoltatori în aplicație și această pagină /documentație cu capturi de ecran și pași clic cu clic.

Rezultat așteptat: Utilizatorii și inginerii văd caracteristica în ambele locuri.
8

Efectuați verificări

Rulați teste/construcții de aplicații, optimizator SEO pe site-ul public, verificări ale sitemapului și verificarea browserului.

Rezultat așteptat: Funcția funcționează local, iar site-ul public rămâne accesabil cu crawlere.
Cum se testează: Deschideți noua rută, utilizați caracteristica cap la cap, inspectați erorile de consolă/rețea și verificați orice modificări ale bazei de date din interfața de utilizare.
ProblemăFix
Ruta funcționează, dar navigarea nu evidențiazăVerificați potrivirea rutelor din bara laterală și căile de redirecționare.
Datele funcționează local, dar nu sunt implementateConfirmați migrarea, politicile RLS și variabilele de mediu ale funcției de margine.
Documente publice lipsesc din harta site-uluiRulați optimizatorul SEO și inspectați sitemap.xml pentru URL canonic.

Ce să faci în continuare: Capturați sau regenerați capturi de ecran ale documentației ori de câte ori se schimbă interfața de utilizare.

Flux de lucru de întreținere a documentelor

Actualizați această pagină de documentație publică după modificările produsului

Pentru ce este asta: Utilizați acest lucru atunci când se modifică capturile de ecran, fluxurile de lucru, comportamentul API sau navigarea.

Înainte de a începe
  • Utilizați numai date demonstrative sigure.
  • Nu expuneți niciodată clienți reali, e-mailuri, detalii de plată, chei API sau conversations private.
  • Actualizați mai întâi manualul în engleză, apoi reîmprospătați fiecare pagină de documentație localizată înainte de verificările SEO.
1

Audiați traseul schimbat

Deschideți ruta aplicației și identificați ce s-a schimbat vizual și procedural.

Rezultat așteptat: Știți ce rânduri de ghid, captură de ecran și depanare necesită modificări.
2

Capturați sau generați o captură de ecran sigură

Utilizați un spațiu de lucru demonstrativ și mascați secretele înainte de a salva activele WebP sub active/documentație.

Rezultat așteptat: Captura de ecran este corectă și sigură de publicat.
3

Actualizați ghidul

Editați secțiunile relevante Pentru ce este, Înainte de a începe, Pași, Rezultate așteptate, Test, Depanare și Următorul.

Rezultat așteptat: Ghidul le spune utilizatorilor ce să facă clic și ce ar trebui să se întâmple după fiecare clic.
4

Actualizați navigarea dacă este necesar

Adăugați secțiunea la TOC, selectorul de secțiuni mobile și indexul vizual dacă este o pagină majoră.

Rezultat așteptat: Cititorii pot găsi rapid noul conținut.
5

Rulați instrumentele SEO

Rulați node tools/seo-optimize-static-pages.js și node tools/seo-optimize-static-pages.js --check.

Rezultat așteptat: Ieșirea canonică, metadatele, harta site-ului și roboții rămân corecte.
6

Rulați curățarea și verificările diferențelor

Rulați node tools/static-translation-cleanup.js --audit și git diff --check.

Rezultat așteptat: Traducerile statice și spațiile albe sunt curate.
7

Verificare browser

Serviți site-ul local și testați/documentația pe desktop și mobil.

Rezultat așteptat: Imaginile se încarcă, căutarea funcționează, butoanele de copiere funcționează, evidențierea TOC și aspectul nu se suprapune cu bannerul cookie-urilor.
Cum se testează: Căutați numele de caracteristică schimbat pe /documentație și confirmați că apare blocul de ghidare corect.
ProblemăFix
Markerii capturii de ecran se deplasează pe mobilPăstrați marcatorii în interiorul imaginii capturii de ecran sau utilizați coordonatele markerului receptiv.
Căutarea ratează noul ghidAdăugați cuvinte cheie utile la titlul de date și includeți termenii exacti de produs pe care utilizatorii îi caută.
Documentația localizată devine depășităDupă editarea manualului în engleză, reîmprospătați fiecare pagină de documentație localizată, rulați din nou optimizatorul SEO și confirmați că sitemap.xml include fiecare URL de documentație.

Ce să faci în continuare: Realizați împreună modificările paginii de documente, materialelor, linkurilor antet/subsol, .htaccess și harta site-ului.

Aveți nevoie de referința concentrată API?

Pagina mai veche /api-docs rămâne disponibilă pentru detaliile API la nivel de punct final.

Deschideți API Documente