Podręcznik SEMJAT oparty na zrzutach ekranu zbudowany na podstawie rzeczywistego przepływu panelu sem.chat. W każdym przewodniku dowiesz się, co kliknąć, co powinno się wydarzyć po kliknięciu, jak to przetestować, jak rozwiązać problem i co dalej robić.
Nie znaleziono pasujących przewodników. Wypróbuj krótsze słowo kluczowe, takie jak widżet, API, głos, płatności, webhook, WordPress, SendPulse lub harmonogram.
Uwaga dotycząca zrzutów ekranu: każdy obraz w tym podręczniku został przechwycony z prawdziwej aplikacji sem.chat przy użyciu demonstracyjnego obszaru roboczego. Wrażliwe dane konta, dane klientów, klucze API, informacje o płatnościach i treści prywatnych rozmów są maskowane przed publikacją.
01
Pierwsze kroki
Utwórz konto, zakończ wdrażanie, zapoznaj się z dashboardem, utwórz pierwszego bota, przetestuj go prywatnie, zainstaluj i wybierz odpowiedni plan.
/autorRejestracja, wersja próbna i pierwszy bot
1Zacznij od opcji Zarejestruj się lub Zaloguj się z publicznej witryny lub aplikacji.
2Zanim skorzystasz z powiadomień lub wiadomości rozliczeniowych, zweryfikuj adres e-mail.
3Użyj onboardingu, aby utworzyć pierwszego bota przed otwarciem dashboardu.
/przeglądPrzegląd po zalogowaniu
1Skorzystaj z szybkich akcji, aby utworzyć bota, przeglądać boty, otwierać statystyki lub zarządzać rozliczeniami.
2Przed wprowadzeniem zmian przejrzyj aktywne boty, conversations, minuty rozmów głosowych i poziom zadowolenia.
3Sprawdź ostatnią aktywność po każdym teście konfiguracji.
Pierwsze uruchomienie
Zarejestruj się, rozpocznij okres próbny i poznaj pulpit nawigacyjny
Do czego to służy: Użyj tego przepływu pracy w przypadku zupełnie nowego obszaru roboczego lub podczas wdrażania członka zespołu, który nigdy nie korzystał z sem.chat.
Zanim zaczniesz
Użyj firmowego adresu e-mail, na który możesz otrzymywać e-maile weryfikacyjne i rozliczeniowe.
Zanim zaprosisz resztę zespołu, zdecyduj, kto powinien być właścicielem obszaru roboczego.
Przygotuj bezpieczną witrynę testową lub stronę testową do instalacji widgetu.
1
Otwórz stronę rejestracji aplikacji
Przejdź do aplikacji.sem.chat/auth ze strony internetowej Przycisk Zaloguj / Zarejestruj się.
Oczekiwany wynik: Strona uwierzytelniania pokazuje opcje logowania i tworzenia konta.
2
Utwórz konto
Wpisz firmowy adres e-mail, utwórz hasło i wyślij formularz rejestracyjny.
Oczekiwany wynik: Aplikacja prosi o weryfikację lub przechodzi do onboardingu po zaakceptowaniu konta.
3
Zweryfikuj adres e-mail
Otwórz e-mail weryfikacyjny i kliknij link potwierdzający.
Oczekiwany wynik: Konto może odbierać wiadomości rozliczeniowe, zaproszenia, raporty i alerty.
4
Zakończ wdrażanie
Wpisz nazwę firmy, opisz cel asystenta, wybierz kolor początkowy i utwórz pierwszego bota.
Oczekiwany wynik: Zostanie otwarty obszar roboczy z wersją roboczą bota i aktywnym stanem próbnym.
5
Otwórz Przegląd
Kliknij Przegląd na lewym pasku bocznym.
Oczekiwany wynik: Panel pokazuje karty usage, szybkie akcje i ostatnią aktywność.
6
Wybierz następną akcję
Użyj opcji Utwórz nowego bota do konfiguracji, Wyświetl wszystkie boty do zarządzania, Analizy pod kątem wydajności lub Rozliczenia w celu ograniczenia planu.
Oczekiwany wynik: Wiesz, gdzie kontynuować, na podstawie stanu obszaru roboczego.
Jak to przetestować: Utwórz jednego prywatnego bota testowego i wyślij wiadomość testową przed zaproszeniem członków zespołu. Potwierdź zmiany w działaniu Przeglądu po teście.
Problem
Napraw
E-mail weryfikacyjny nie dociera
Sprawdź spam, potwierdź pisownię e-maila, a następnie poproś o kolejny e-mail weryfikacyjny.
Panel otwiera się na stronie Rozliczenia
Obszar roboczy może wymagać aktywnej wersji próbnej lub planu. Rozpocznij okres próbny lub wybierz odpowiedni plan przed konfiguracją.
Członek zespołu nie może uzyskać dostępu do obszaru roboczego
Zaproś ich z Ustawienia, Zespół, zamiast udostępniać login właściciela.
Co dalej: Utwórz pierwszego bota, przetestuj go prywatnie, a następnie zainstaluj widżet na stronie testowej.
Prywatny test uruchomienia
Utwórz pierwszy prywatny test bota przed rozpoczęciem transmisji na żywo
Do czego to służy: Użyj tego, aby zweryfikować śledzenie konta, bota, widżetu i historii, zanim klienci zobaczą asystenta.
Zanim zaczniesz
Przygotuj jedno przykładowe pytanie klienta.
Przygotuj stronę testową lub lokalną stronę testową HTML.
Nie używaj w pierwszym teście prawdziwych danych klienta.
1
Otwórz My Bots
Kliknij My Bots na pasku bocznym lub użyj opcji Wyświetl wszystkie boty z przeglądu.
Oczekiwany wynik: Możesz zobaczyć bota utworzonego podczas onboardingu lub jego pusty stan za pomocą przycisku Nowy bot.
2
Otwórz narzędzie do tworzenia botów
Kliknij Nowy bot lub Edytuj na istniejącym bocie.
Oczekiwany wynik: Otwiera się Bot Builder z elementami sterującymi Podstawy, Widżet, Wiedza, Głos i integracja.
3
Zapisz bota raz
Wpisz wymaganą nazwę bota i pierwszą wiadomość, a następnie kliknij Zapisz.
Oczekiwany wynik: Bot otrzymuje ważny identyfikator i może wygenerować kod do osadzenia.
4
Podgląd prywatnie
Skorzystaj z panelu podglądu i zadaj przykładowe pytanie.
Oczekiwany wynik: Odpowiedź powinna być zgodna z instrukcją lub ujawnić, jakiej wiedzy brakuje.
5
Zainstaluj na etapie testowania
Otwórz opcję Osadź, skopiuj fragment kodu HTML i wklej go przed zamykającym tagiem treści na stronie testowej.
Oczekiwany wynik: Widżet pojawia się w skonfigurowanym rogu na komputerze stacjonarnym i telefonie komórkowym.
6
Potwierdź śledzenie
Po rozmowie testowej otwórz skrzynkę odbiorczą lub Chat History.
Oczekiwany wynik: Pojawi się rozmowa testowa z właściwym botem, kanałem i historią wiadomości.
Jak to przetestować: Wyślij jedną wiadomość tekstową i jeden test głosowy, jeśli głos jest włączony. Potwierdź, że oba pojawiają się w Chat History.
Problem
Napraw
Kod osadzania jest niedostępny
Najpierw zapisz bota. Jeśli synchronizacja głosu nadal oczekuje na synchronizację, poczekaj na synchronizację lub zapisz ponownie po wypełnieniu wymaganych pól.
Widget pokazuje nieprawidłowego bota
Potwierdź, że data-bot-id we fragmencie kodu jest zgodny z identyfikatorem bota z modułu Embed.
W historii nie pojawia się żadna rozmowa
Odśwież Chat History, potwierdź, że bot jest aktywny i upewnij się, że test został przeprowadzony na zainstalowanym widżecie, a nie na nieaktualnej stronie.
Co dalej: Przejdź do Bot Builder konfiguracji i szkolenia merytorycznego.
02
Utwórz i skonfiguruj bota
Twórz, edytuj, przeglądaj, aktywuj, przenoś lub usuwaj boty z My Bots i Bot Builder.
/panel kontrolnyMy Bots centrum kontroli
1Kliknij Nowy bot, aby uruchomić nowego asystenta.
2Użyj opcji Edytuj, Osadź, Przenieś, Aktywuj lub Usuń na każdej karcie bota.
3Przed testowaniem sprawdź stan aktywny i czas ostatniej aktualizacji.
/boty/:id/edytujBot Builder karta podstawy
1Wpisz nazwę bota, awatar, pierwszą wiadomość i instrukcje systemowe.
2Użyj podglądu, aby przetestować przed publikacją.
3Zapisz i zsynchronizuj przed skopiowaniem kodu do osadzenia.
Utwórz bota
Utwórz nowego bota z My Bots
Do czego to służy: Użyj tego przepływu pracy, gdy nowa marka, witryna internetowa, kolejka pomocy lub kampania potrzebuje własnego asystenta.
Zanim zaczniesz
Przygotuj nazwę bota, cel, pierwszą wiadomość i dwa lub trzy przykładowe pytania.
Jeśli planujesz importować zawartość, zbierz publiczną witrynę internetową URL.
Potwierdź, że plan pozwala na liczbę botów i funkcji głosowych/awatarów, których potrzebujesz.
1
Otwórz My Bots
Kliknij My Bots na pasku bocznym.
Oczekiwany wynik: Widoczne są istniejące boty i przycisk Nowy bot.
2
Kliknij Nowy bot
Uruchom nowego bota na stronie My Bots.
Oczekiwany wynik: Bot Builder otwiera się z asystentem wersji roboczej.
3
Ustaw tożsamość bota
Wpisz nazwę bota, prześlij lub wybierz awatar i napisz pierwszą wiadomość, którą zobaczą odwiedzający.
Oczekiwany wynik: Panel podglądu odzwierciedla nazwę asystenta, awatar i powitanie.
4
Napisz instrukcje systemowe
Opisz, co bot powinien robić, jak powinien mówić, czego powinien unikać i kiedy powinien prosić o pomoc człowieka.
Oczekiwany wynik: Asystent ma jasne zasady zachowania przed dodaniem wiedzy.
5
Dodaj podstawową wiedzę
Wklej niezbędne informacje o firmie, produkcie, wsparciu, cenach i kontakcie do obszaru wiedzy.
Oczekiwany wynik: Bot może odpowiadać na często zadawane pytania bez konieczności importowania strony internetowej.
6
Zapisz bota
Kliknij Zapisz i poczekaj na potwierdzenie zapisania lub zsynchronizowania.
Oczekiwany wynik: Bot ma stabilny identyfikator, można przetestować podgląd i stają się dostępne opcje osadzania.
7
Podgląd wyniku
Zadaj przygotowane przykładowe pytania w Podglądzie.
Oczekiwany wynik: Odpowiedzi powinny być zgodne z instrukcją i wykorzystywać wprowadzoną wiedzę.
8
Aktywuj tylko wtedy, gdy będziesz gotowy
Włącz bota jako aktywnego po przejściu testu prywatnego.
Oczekiwany wynik: Bot jest gotowy na ruch widżetów lub kanałów.
Jak to przetestować: Zadaj co najmniej pięć realistycznych pytań. Sprawdź, czy odpowiedź jest prawidłowa, czy pozostaje związana z marką i czy w razie potrzeby prosi o pomoc człowieka.
Problem
Napraw
Odpowiedź jest zbyt ogólna
Dodaj bardziej szczegółową wiedzę i przepisz instrukcje, podając przykłady dobrych odpowiedzi.
Bot odrzuca pytania, na które powinien odpowiedzieć
Usuń zbyt rygorystyczne instrukcje i dodaj zaufaną wiedzę na ten temat.
Zapisz nie generuje kodu do osadzania
Sprawdź wymagane pola i zapisz ponownie po zakończeniu synchronizacji dostawcy usług głosowych.
Co dalej: Skonfiguruj ustawienia widgetu, dodaj wiedzę o witrynie, a następnie zainstaluj bota.
Zarządzaj botami
Edytuj, klonuj przepływ pracy, przenieś, dezaktywuj lub usuń bota
Do czego to służy: Użyj tego przepływu pracy, gdy bot potrzebuje aktualizacji, zmiany właściciela, tymczasowego wstrzymania lub trwałego usunięcia.
Zanim zaczniesz
Wyeksportuj wszystkie rozmowy lub dane kontaktowe, które musisz zachować przed usunięciem bota.
Przed usunięciem lub przeniesieniem upewnij się, że bot nie jest osadzony w działającej witrynie internetowej.
Poinformuj członków drużyny przed dezaktywacją bota produkcyjnego.
1
Otwórz My Bots
Znajdź kartę bota według nazwy lub statusu.
Oczekiwany wynik: Karta pokazuje aktualny stan i dostępne akcje.
2
Kliknij Edytuj
Otwórz narzędzie do tworzenia botów i wprowadź wymagane zmiany.
Kliknij Zapisz po każdej istotnej zmianie, a następnie uruchom pytania podglądu.
Oczekiwany wynik: Zapisana konfiguracja jest wykorzystywana przez podgląd i zainstalowany widget.
4
Dezaktywuj tymczasowo
Użyj aktywnego przełącznika, jeśli bot powinien na razie przestać obsługiwać gości.
Oczekiwany wynik: Bot przestaje obsługiwać ruch na żywo, zachowując konfigurację.
5
Przenieś własność
Użyj opcji Transfer, wprowadź adres e-mail odbiorcy i potwierdź.
Oczekiwany wynik: Wybrane konto otrzymuje własność zgodnie z procesem przenoszenia aplikacji.
6
Usuń dopiero po sprawdzeniu
Użyj opcji Usuń, przeczytaj ostrzeżenie i potwierdź tylko wtedy, gdy bot nie będzie już potrzebny.
Oczekiwany wynik: Zgodnie z ostrzeżeniem bot i powiązana konfiguracja zostały usunięte.
Jak to przetestować: Po edycji otwórz zainstalowany widget i zadaj dokładne pytanie, które było przyczyną zmiany. Potwierdź zmianę odpowiedzi na żywo.
Problem
Napraw
Stara odpowiedź nadal się pojawia
Odśwież stronę serwisu, potwierdź, że zapisałeś prawidłowego bota i sprawdź, czy zaimportowana wiedza wymaga synchronizacji.
Transfer nie powiódł się
Potwierdź, że adres e-mail odbiorcy jest prawidłowy i że konto docelowe może zaakceptować bota.
Kliknięcie przycisku Usuń zostało omyłkowe
Zatrzymaj się przed ostatecznym potwierdzeniem. Istnieją ostrzeżenia o usunięciu, ponieważ akcja może trwale usunąć dane bota.
Co dalej: Przejrzyj statystyki i historię po wprowadzonych zmianach, aby upewnić się, że poprawiło się doświadczenie odwiedzających.
03
Zainstaluj widget
Skopiuj poprawny kod do osadzenia, zainstaluj go w kontekstach HTML, WordPress, React lub zaawansowanych SDK, a następnie sprawdź działanie na komputerach stacjonarnych i urządzeniach mobilnych.
Osadź moduł modalnySkopiuj fragment kodu instalacyjnego witryny internetowej
1Wybierz HTML, WordPress, React lub NPM/SDK w zależności od stosu witryny.
2Skopiuj kod po zapisaniu i zsynchronizowaniu bota.
3Wklej fragment kodu przed znacznikiem zamykającym lub w układzie frameworka.
HTML instalacja
Zainstaluj widget na standardowej stronie internetowej HTML
Do czego to służy: Użyj tej opcji, jeśli możesz edytować szablon strony, stopkę motywu lub układ globalny HTML.
Zanim zaczniesz
Najpierw zapisz bota, aby moduł osadzania miał prawdziwy identyfikator bota.
Przed rozpoczęciem produkcji użyj miejsca tymczasowego.
Zachowaj dokładną wersję skryptu i data-bot-id z modalu.
1
Otwórz My Bots
Znajdź bota, którego chcesz zainstalować i kliknij Osadź.
Oczekiwany wynik: Otworzy się moduł Embed z zakładkami instalacyjnymi.
2
Wybierz HTML
Wybierz zakładkę HTML i kliknij Kopiuj kod.
Oczekiwany wynik: Skrypt widgetu zostanie skopiowany z dołączonym identyfikatorem bota.
3
Otwórz szablon strony internetowej
Edytuj globalny plik stopki lub układu, który będzie wyświetlany na każdej stronie, na której powinien pojawić się widżet.
Oczekiwany wynik: Edytujesz udostępnioną powłokę witryny, a nie pojedynczą izolowaną stronę, chyba że jest to zamierzone.
4
Wklej przed zamknięciem korpusu
Wklej fragment bezpośrednio przed zamykającym tagiem treści.
Oczekiwany wynik: Skrypt ładuje się po zawartości strony i może zamontować kontener widgetów.
5
Opublikuj lub wdróż
Zapisz szablon i wdróż witrynę.
Oczekiwany wynik: Skrypt widgetu jest aktywny na stronach docelowych.
6
Przetestuj komputer stacjonarny i mobilny
Otwórz witrynę w nowym oknie przeglądarki i w mobilnym widoku.
Oczekiwany wynik: Widżet pojawia się w skonfigurowanej pozycji i otwiera się bez błędów konsoli.
Jak to przetestować: Wyślij wiadomość z aktywnej strony, a następnie otwórz skrzynkę odbiorczą i Chat History, aby potwierdzić, że rozmowa należy do właściwego bota.
Problem
Napraw
Brak widgetu
Upewnij się, że kod znajduje się przed zamykającym tagiem treści, narzędzie do tworzenia witryny nie blokuje skryptów i bot jest aktywny.
Pojawia się nieprawidłowy bot
Skopiuj fragment ponownie i porównaj data-bot-id z żądanym botem.
Widżet nakłada się na elementy sterujące strony
Zmień pozycję lub rozmiar w Ustawieniach widgetu i przetestuj ponownie na urządzeniu mobilnym.
Co dalej: Dostosuj ustawienia widgetu i przechwytywanie leadów po instalacji.
Zainstaluj w WordPress, React lub zaawansowanych przepływach głosowych SDK
Do czego to służy: Użyj tej opcji, jeśli witryna jest zarządzana przez CMS, aplikację React lub niestandardową integrację głosową.
Zanim zaczniesz
Dowiedz się, który stos jest właścicielem udostępnionego układu.
Użyj dokładnie fragmentu pokazanego w sem.chat dla wybranego bota.
W przypadku zaawansowanego korzystania z SDK potwierdź, że masz wymagany klucz publiczny Vapi i identyfikator asystenta.
1
Opcja WordPress
Użyj Wyglądu, Edytora motywów, footer.php lub zaufanej wtyczki nagłówków i stopek.
Oczekiwany wynik: Fragment jest ładowany na publicznych stronach WordPress.
2
Opcja React
Utwórz mały komponent ChatWidget, dołącz skrypt w useEffect i wyrenderuj go w układzie głównym.
Oczekiwany wynik: Widżet ładuje się raz i jest czyszczony, jeśli układ zostanie odmontowany.
3
Zaawansowana opcja SDK
Używaj karty NPM/SDK tylko wtedy, gdy potrzebujesz niestandardowej kontroli połączeń głosowych poza domyślnym widżetem.
Oczekiwany wynik: Twoja aplikacja kontroluje sesję głosową, podczas gdy sem.chat pozostaje skonfigurowanym źródłem asystenta.
4
Zweryfikuj identyfikator bota
Potwierdź, że zainstalowany kod odwołuje się do identyfikatora bota z modułu Embed.
Oczekiwany wynik: Widżet na żywo łączy się z zamierzonym asystentem.
5
Sprawdź konsolę
Otwórz narzędzia programistyczne przeglądarki i załaduj ponownie.
Oczekiwany wynik: Nie ma żadnych blokowanych skryptów, duplikatów kontenerów ani błędów sieciowych.
Jak to przetestować: Wypełnij jedną wiadomość testową z zainstalowanej witryny, a następnie potwierdź, że pojawia się w skrzynce odbiorczej z oczekiwaną stroną URL.
Problem
Napraw
React ładuje zduplikowane widżety
Chroń wstawianie skryptu za pomocą ref lub renderuj komponent tylko w układzie głównym.
WordPress usuwa znaczniki skryptu
Użyj wtyczki do wstrzykiwania stopki lub pliku motywu, który umożliwia skrypty.
Nie można rozpocząć połączenia SDK
Sprawdź klucz publiczny, identyfikator asystenta, uprawnienia przeglądarki i zaplanuj dostęp do głosu.
Co dalej: Przejdź do Ustawień widżetu, aby kontrolować zachowanie, budowanie marki i pozyskiwanie potencjalnych klientów.
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
Ustawienia widgetu
Skonfiguruj tryb, motyw, rozmiar, pozycję, kolor, branding, reakcje, dźwięk, zgodę, pozyskiwanie potencjalnych klientów, oceny, e-maile uzupełniające i stan aktywacji.
Bot Builder / WidżetWygląd widgetu i zachowanie odwiedzających
1Wybierz chat, tryb głosowy lub hybrydowy.
2Ustaw motyw, kolor, pozycję, rozmiar, branding, zgodę i dźwięk.
3Skonfiguruj pozyskiwanie potencjalnych klientów, oceny, reakcje i dalsze zachowania.
Zachowanie widgetu
Skonfiguruj zachowanie widgetu widocznego dla odwiedzających
Do czego to służy: Użyj tej opcji po pierwszej instalacji lub w dowolnym momencie, gdy widżet musi pasować do witryny i pozyskiwać lepszych potencjalnych klientów.
Zanim zaczniesz
Zainstaluj widżet na stronie tymczasowej.
Dowiedz się, czy odwiedzający powinni zaczynać od chat, głosu, czy obu.
Przygotuj kopię zgody i przechwytywania leadów, jeśli jest to wymagane w regionie.
1
Otwórz narzędzie do tworzenia botów
Otwórz My Bots, kliknij Edytuj, a następnie wybierz kartę Widżet.
Oczekiwany wynik: Pojawią się elementy sterujące widgetami dla wybranego bota.
2
Wybierz tryb
Wybierz Czat, Głos lub Hybrydowy, w zależności od tego, jakiego doświadczenia potrzebujesz.
Oczekiwany wynik: Podgląd zmienia się, pokazując wybrany tryb.
3
Ustaw wygląd
Wybierz motyw, kolor, rozmiar, położenie przycisku i opcje brandingu.
Oczekiwany wynik: Widżet dopasowuje się do witryny, nie zasłaniając ważnych treści.
4
Włącz kontrolę gości
Włącz lub wyłącz reakcje, dźwięki, oceny i monity o zgodę.
Oczekiwany wynik: Odwiedzający widzą tylko te elementy sterujące, których chcesz, aby używały.
5
Skonfiguruj przechwytywanie leadów
Wybierz wymagane pola, opcjonalne pole opisu oraz moment pojawienia się formularza.
Oczekiwany wynik: Kontakty są zbierane przed lub w trakcie conversations, zgodnie z Twoją konfiguracją.
6
Ustaw e-mail uzupełniający
Skonfiguruj zachowanie kolejnych wiadomości e-mail, jeśli Twój plan je uwzględnia.
Oczekiwany wynik: Odwiedzający mogą otrzymywać wiadomości uzupełniające po rozwiązaniu problemu conversations.
7
Zapisz i przetestuj
Kliknij Zapisz, załaduj ponownie stronę testową i otwórz widżet.
Oczekiwany wynik: Widżet na żywo odpowiada zapisanym ustawieniom.
Jak to przetestować: Otwórz widżet na komputerze i telefonie komórkowym, prześlij formularz kontaktowy, zostaw ocenę i potwierdź, że kontakt i rozmowa zostały nagrane.
Problem
Napraw
Kolor nie został zaktualizowany
Zapisz bota, odśwież witrynę i potwierdź, że zainstalowany widget używa tego samego identyfikatora bota.
Brakuje pól wiodących
Upewnij się, że przechwytywanie leadów jest włączone i spełniony jest wybrany warunek wyzwalający.
Odwiedzający nie mogą używać głosu
Sprawdź ustawienia głosu, uprawnienia do mikrofonu w przeglądarce, dostęp do planu i limity minut rozmów.
Co dalej: Dodaj ustawienia głosu/awatara i źródła wiedzy przed uruchomieniem produkcji.
05
Głos i awatary
Wybierz standardowe głosy, skonfiguruj tryb głosu i limity, czytaj transkrypcje, klonuj głosy, przypisz sklonowane głosy i zarządzaj podstawowymi lub niestandardowymi awatarami.
Bot Builder / GłosGłos, limity, transkrypcje i awatary
1Wybierz głos podstawowy lub zapisany sklonowany głos.
2Ustaw limity minut rozmów i zapisywanie transkrypcji.
3Wybierz standardowe awatary lub prześlij niestandardowy awatar, jeśli pozwala na to plan.
Konfiguracja głosu
Skonfiguruj połączenia głosowe i transkrypcje
Do czego to służy: Użyj tej opcji, gdy odwiedzający powinni porozmawiać z botem, a nie tylko pisać.
Zanim zaczniesz
Potwierdź, że plan obejmuje minuty rozmów i żądane opcje głosu/awatara.
Do testowania użyj cichego środowiska przeglądarki.
Przygotuj jedno realistyczne pytanie dotyczące wsparcia lub sprzedaży, które możesz przetestować głosowo.
1
Otwórz ustawienia głosu
Otwórz narzędzie do tworzenia botów i wybierz obszar Głos lub Głos i awatary.
Oczekiwany wynik: Widoczne są elementy sterujące głosowe i bieżący wybór głosu.
2
Wybierz głos podstawowy
Wyświetl podgląd dostępnych głosów, wybierz najlepsze dopasowanie i zapisz wybór.
Oczekiwany wynik: Bot wykorzystuje wybrany głos do rozmów.
3
Skonfiguruj tryb głosowy
Użyj Ustawień widżetu, aby wybrać opcję Głosową lub Hybrydową, gdy głos powinien być dostępny dla odwiedzających.
Oczekiwany wynik: Odwiedzający widzą w widżecie opcję głosową.
4
Ustaw limity głosu
Zdefiniuj limity na użytkownika lub obszar roboczy, jeśli są dostępne.
Oczekiwany wynik: Długie lub powtarzające się połączenia nie mogą zająć więcej minut niż zamierzono.
5
Włącz transkrypcje
Włącz zapisywanie transkrypcji, jeśli potrzebujesz przeglądu rozmów w historii.
Oczekiwany wynik: Połączenia głosowe tworzą czytelne transkrypcje po sesji.
6
Przetestuj połączenie
Otwórz widżet, zezwól na dostęp do mikrofonu, rozpocznij rozmowę i zadaj przygotowane pytanie.
Oczekiwany wynik: Bot odpowiada głosowo i połączenie kończy się czysto.
7
Przeczytaj transkrypcję
Otwórz Chat History i znajdź rozmowę głosową.
Oczekiwany wynik: Transkrypcja pokazuje, co powiedział odwiedzający i bot.
Jak to przetestować: Wykonaj jedno krótkie połączenie i potwierdź, że minuty rozmów, transkrypcja i tryb rozmowy zostały nagrane.
Problem
Napraw
Przeglądarka blokuje mikrofon
Zezwól na uprawnienia mikrofonu w przeglądarce i załaduj ponownie stronę.
Opcja głosowa jest zablokowana
Otwórz Rozliczenia i potwierdź, że plan przestrzeni roboczej obejmuje funkcje głosowe.
Transkrypcja jest pusta
Upewnij się, że zapisywanie transkrypcji jest włączone i połączenie zakończyło się normalnie.
Co dalej: Dodaj lub doprecyzuj wiedzę, aby odpowiedzi głosowe były dokładne.
Klon głosu i awatar
Sklonuj głos i przypisz niestandardowy awatar
Do czego to służy: Użyj tej opcji, gdy asystent potrzebuje markowego głosu lub mówiącego awatara.
Zanim zaczniesz
Używaj tylko plików audio i obrazów, na których użycie masz pozwolenie.
Nagrywaj czyste próbki głosu z niskim poziomem hałasu w tle.
Potwierdź limity planu dotyczące sklonowanych głosów i niestandardowych awatarów.
1
Otwórz klonowanie głosu
Kliknij opcję Klonuj głos w obszarze Głos.
Oczekiwany wynik: Okno przesyłania pokazuje zaakceptowane przykładowe wymagania.
2
Prześlij próbki
Prześlij od jednego do pięciu wyraźnych nagrań i prześlij prośbę o klonowanie.
Oczekiwany wynik: Sklonowany głos pojawia się po przetworzeniu lub w oknie dialogowym pojawia się kolejne wymaganie.
3
Przypisz sklonowany głos
Wybierz sklonowany głos w selektorze głosu i zapisz.
Oczekiwany wynik: W przyszłych połączeniach będzie używany sklonowany głos.
4
Wybierz standardowy awatar
Wybierz dołączony awatar, jeśli przesyłanie niestandardowego awatara nie jest potrzebne.
Oczekiwany wynik: Doświadczenie głosowe ma tożsamość wizualną.
5
Prześlij niestandardowy awatar
Prześlij wyraźny obraz twarzy lub krótki film, jeśli Twój plan to umożliwia.
Oczekiwany wynik: Awatar jest przetwarzany i staje się dostępny do wyboru.
6
Uruchom pełny podgląd
Rozpocznij połączenie głosowe i wspólnie potwierdź zachowanie głosu, awatara i transkrypcji.
Oczekiwany wynik: Doświadczenie gościa odpowiada skonfigurowanej marce.
Jak to przetestować: Zadaj krótkie pytanie, wybierając sklonowany głos i potwierdź, że połączenie wykorzystuje oczekiwany głos/awatar.
Problem
Napraw
Jakość klonów jest słaba
Nagrywaj czystsze próbki za pomocą jednego głośnika, ze stabilną głośnością i bez muzyki.
Przesyłanie niestandardowego awatara jest niedostępne
Sprawdź rozliczenia pod kątem limitów awatarów objętych planem.
Stary głos nadal gra
Zapisz bota po wybraniu nowego głosu i ponownie załaduj stronę widżetu.
Co dalej: Przejdź do Wiedzy i danych, aby funkcja głosowa zawierała dokładne odpowiedzi.
06
Wiedza i dane
Dodaj wiedzę ręczną, importuj zawartość witryny, zastosuj wyniki indeksowania, synchronizuj zaimportowaną treść, dodaj plik danych o produktach URL, odświeżaj lub usuwaj kanały i weryfikuj odpowiedzi za pomocą pytań testowych.
Bot Builder / WiedzaŹródła wiedzy i testowanie odpowiedzi
1Dodaj ręczną wiedzę na temat zasad, cen i reguł marki.
2Importuj strony internetowe i zastosuj wyniki indeksowania.
3Dodawaj kanały produktowe i synchronizuj je, gdy zmieni się stan zapasów.
Źródła wiedzy
Szkoluj bota, korzystając z wiedzy ręcznej, importu stron internetowych i kanałów produktowych
Do czego to służy: Użyj tej opcji, gdy asystent udziela niekompletnych odpowiedzi lub potrzebuje świeżych informacji o produkcie, zasadach lub witrynie internetowej.
Zanim zaczniesz
Przygotuj źródło URL i plik danych o produktach URL.
Zdecyduj, które strony nie powinny być importowane, np. strony administracyjne lub prywatne.
Utwórz pytania testowe dla każdego dodanego tematu.
1
Otwarta Wiedza
Otwórz Bot Builder i wybierz zakładkę Wiedza lub Dane.
Oczekiwany wynik: Widoczna jest wiedza ręczna, import strony internetowej i narzędzia do podawania produktów.
2
Dodaj wiedzę manualną
Wklej zwięzłe fakty, zasady, ceny, dane kontaktowe i uwagi dotyczące stylu odpowiedzi.
Oczekiwany wynik: Bot ma bezpośrednie, zaufane źródło odpowiedzi o wysokim priorytecie.
3
Importuj zawartość witryny
Wklej publiczną witrynę internetową URL i rozpocznij przeszukiwanie/importowanie.
Oczekiwany wynik: Wyniki indeksowania pokazują odkryte strony lub stan importu.
4
Przejrzyj i zastosuj wyniki
Zachowaj przydatne strony, usuń nieistotne strony, a następnie zastosuj wybraną treść.
Oczekiwany wynik: Do bazy wiedzy trafiają wyłącznie zatwierdzone treści stron internetowych.
5
Dodaj plik danych o produktach URLs
Wklej Google Merchant Center lub obsługiwany kanał URL i zaimportuj.
Oczekiwany wynik: Produkty, ceny, dostępność i atrybuty stają się dostępne dla bota.
6
Odśwież lub usuń kanały
Użyj odświeżania, gdy zmienią się dane katalogu i usuń kanały, które nie są już używane.
Oczekiwany wynik: Bot unika nieaktualnych lub zduplikowanych danych produktów.
7
Zapisz i zsynchronizuj
Zapisz bota i poczekaj na zakończenie synchronizacji.
Oczekiwany wynik: Najnowsza wiedza jest wykorzystywana w podglądzie i odpowiedziach na żywo widżetów.
8
Zadawaj pytania weryfikacyjne
Zadaj jedno pytanie testowe na każde dodane źródło.
Oczekiwany wynik: Odpowiedź dokładnie cytuje lub odzwierciedla zaktualizowaną treść.
Jak to przetestować: Zadawaj pytania dotyczące cen, zwrotów, dostępności, informacji o firmie i nieobsługiwanych tematów. Upewnij się, że bot odpowiada na znane tematy i nie wymyśla nieznanych szczegółów.
Problem
Napraw
Robot indeksujący importuje nieistotne strony
Usuń te strony z wybranych wyników i dodaj jaśniejsze instrukcje ręczne.
Ceny produktów są nieaktualne
Odśwież kanał i potwierdź, że sam kanał URL zawiera aktualne wartości.
Bot wymyśla odpowiedzi
Dodaj regułę, że bot powinien powiedzieć, że nie jest pewien i zaoferować wsparcie człowieka, gdy brakuje wiedzy.
Co dalej: Wróć do podglądu, przetestuj ponownie, a następnie zainstaluj lub zaktualizuj widżet.
07
Skrzynka odbiorcza, Live Support, Historia, Kontakty
Obsługuj codziennie conversations, odbieraj prośby o wsparcie na żywo, przekaż kontrolę z powrotem do AI, eksportuj historię, zarządzaj kontaktami i synchronizuj kontakty z SendPulse.
/skrzynka odbiorczaPrzebieg konwersacji w skrzynce odbiorczej
1Filtruj według bota lub kanału.
2Otwórz rozmowę i w razie potrzeby odpowiadaj jak człowiek.
3Ostrożnie używaj elementów sterujących tłumaczeniem, rozstrzyganiem i przekazywaniem.
/wsparcie na żywoKontrola przekazywania wsparcia na żywo
1Szybko żądaj oczekujących przekazania.
2Odpowiedz jako agent lub przekaż rozmowę z powrotem do AI.
3Rozwiąż problem, gdy odwiedzający nie potrzebuje już pomocy człowieka.
/chat-historiaHistoria rozmów i eksport
1Szukaj według gościa, bota, kanału lub daty.
2Otwórz pełne transkrypcje sesji tekstowych i głosowych.
3W razie potrzeby eksportuj CSV lub JSON.
/kontaktyEksport kontaktów i SendPulse
1Filtruj kontakty według bota lub źródła.
2Otwórz dane kontaktowe i kontekst rozmowy.
3Eksportuj lub synchronizuj wybrane kontakty z SendPulse.
Odpowiedź w skrzynce odbiorczej
Otwórz rozmowę i wyślij ludzką odpowiedź
Do czego to służy: Użyj tej opcji, gdy operator musi odpowiedzieć klientowi z sem.chat, zamiast pozwolić sztucznej inteligencji działać samodzielnie.
Zanim zaczniesz
Upewnij się, że operator ma dostęp do bota lub obszaru roboczego.
Przeczytaj rozmowę zanim odpowiesz.
Dowiedz się, czy odwiedzający oczekuje tego samego języka.
1
Otwórz skrzynkę odbiorczą
Kliknij opcję Skrzynka odbiorcza na pasku bocznym.
Oczekiwany wynik: Ostatnie conversations pojawiają się z botem, kanałem, gościem, statusem i godziną.
2
W razie potrzeby przefiltruj
Użyj filtrów kanału, bota, nieprzeczytanych lub statusu, aby znaleźć rozmowę.
Oczekiwany wynik: Lista zawęża się do potrzebnego zestawu konwersacji.
3
Otwórz rozmowę
Kliknij wiersz gościa.
Oczekiwany wynik: Widoczny jest cały wątek, informacje o gościach i elementy sterujące odpowiedziami.
4
Przetłumacz w razie potrzeby
Użyj kontroli tłumaczenia, gdy język gościa różni się od języka agenta.
Oczekiwany wynik: Agent może zrozumieć i odpowiednio odpowiedzieć.
5
Wyślij odpowiedź
Zapisz odpowiedź człowieka i wyślij ją.
Oczekiwany wynik: Wiadomość zostanie dodana do wątku jako odpowiedź agenta/człowieka.
6
Rozwiąż problem lub pozostaw otwarty
Zakończ rozmowę, jeśli została zakończona, lub pozostaw ją otwartą do dalszych działań.
Oczekiwany wynik: Stan skrzynki odbiorczej odpowiada rzeczywistemu stanowi klienta.
Jak to przetestować: Wyślij bezpieczną odpowiedź testową na rozmowę testową i potwierdź, że pojawia się ona w widżecie gościa i Chat History.
Problem
Napraw
Odpowiedź nie została wysłana
Sprawdź stan sieci, status rozmowy i czy zgłoszono wsparcie na żywo.
Język gościa jest nieprawidłowy
Zanim odpowiesz, użyj tłumaczenia lub zaktualizuj ustawienia języka bota.
Rozmowy nie ma w skrzynce odbiorczej
Wyszukaj Chat History i potwierdź, że w teście widżetu użyto prawidłowego bota.
Co dalej: Użyj Live Support dla aktywnych kolejek przekazania i Chat History dla audytów.
Wsparcie na żywo
Złóż wniosek, odpowiedz, zwróć AI i rozpatrz przekazanie
Do czego to służy: Użyj tej opcji, gdy sztuczna inteligencja prosi człowieka lub odwiedzający wyraźnie potrzebuje agenta.
Zanim zaczniesz
Zanim włączysz wsparcie na żywo, przygotuj agenta.
Zdefiniuj, kiedy sztuczna inteligencja powinna zażądać przekazania w instrukcjach bota.
Pozostaw włączone ustawienia powiadomień dla alertów o przekazaniu.
1
Otwórz Live Support
Kliknij Live Support na pasku bocznym.
Oczekiwany wynik: Widoczne są oczekiwania i aktywne przekazanie conversations.
2
Zgłoś żądanie
Kliknij opcję Odbierz w oczekującej rozmowie.
Oczekiwany wynik: Inni agenci widzą, że rozmowa jest aktywnie obsługiwana.
3
Przeczytaj kontekst
Zanim odpowiesz, otwórz wiadomości i dane gości.
Oczekiwany wynik: Agent rozumie, dlaczego doszło do przekazania.
4
Wyślij ludzką odpowiedź
Odpowiadaj wyraźnie i na bieżąco aktualizuj wątek.
Oczekiwany wynik: Gość otrzymuje ludzką odpowiedź.
5
Jeśli to konieczne, zwróć sprawę AI
Użyj funkcji zwrotu, gdy problem zostanie rozwiązany, a sztuczna inteligencja będzie mogła kontynuować.
Oczekiwany wynik: AI wznawia prowadzenie rozmowy.
6
Rozwiąż po zakończeniu
Kliknij Rozwiąż, gdy odwiedzający nie będzie już potrzebować pomocy.
Oczekiwany wynik: Przekazanie zostaje zamknięte i usunięte z aktywnej kolejki.
Jak to przetestować: Utwórz przekazanie testowe, odbierz je, odpowiedz raz, oddaj i potwierdź zmiany statusu w Live Support i Chat History.
Problem
Napraw
Agenci przegapiają prośby
Włącz powiadomienia w przeglądarce/e-mailu/push i dodaj proces własności kolejki.
AI zbyt szybko przejmuje kontrolę
Dostosuj instrukcje i zasady przekazywania, aby kontrola człowieka pozostała aktywna do czasu rozwiązania lub zwrotu.
Zewnętrzny CRM nie jest zsynchronizowany
Użyj webhooków lub ankiet z sekcji Przepisy dla programistów.
Co dalej: Połącz CRM/webhooks, jeśli zespoły pomocy technicznej pracują poza sem.chat.
Historia i kontakty
Wyszukuj, eksportuj i korzystaj z zapisów rozmów/kontaktów
Do czego to służy: Użyj tego do audytów, przeglądu potencjalnych klientów, eksportu CSV i synchronizacji SendPulse.
Zanim zaczniesz
Zdecyduj, czy potrzebujesz conversations, kontaktów, czy obu.
Przed eksportem zastosuj prawidłowy zakres dat.
Nie eksportuj więcej danych osobowych, niż jest to konieczne.
1
Otwórz Chat History
Kliknij Chat History na pasku bocznym.
Oczekiwany wynik: Widoczne są filtry rozmów, statystyki i lista transkrypcji.
2
Szukaj i filtruj
Filtruj według bota, kanału, trybu, gościa lub zakresu dat.
Oczekiwany wynik: Widoczne pozostaną tylko pasujące elementy conversations.
3
Otwórz transkrypcję
Kliknij rozmowę, aby przeczytać cały wątek wiadomości.
Oczekiwany wynik: Widoczny jest pełny kontekst, dane kontaktowe i metadane konwersacji.
4
Eksportuj conversations
Kliknij Eksportuj i wybierz wymagany format, jeśli jest dostępny.
Oczekiwany wynik: Eksport zawiera przefiltrowane dane konwersacji.
5
Otwórz Kontakty
Kliknij Kontakty na pasku bocznym.
Oczekiwany wynik: Pojawiają się rekordy potencjalnego klienta/kontaktu ze źródłem, botem i statusem.
6
Filtruj i eksportuj kontakty
Wyszukaj kontakty, wybierz żądane rekordy, a następnie wyeksportuj lub zsynchronizuj z SendPulse.
Oczekiwany wynik: Wybrane kontakty są dostępne poza sem.chat zgodnie z wybraną akcją.
Jak to przetestować: Wyeksportuj mały, przefiltrowany plik CSV i otwórz go lokalnie, aby potwierdzić, że kolumny i zakres dat są prawidłowe.
Problem
Napraw
Brak kontaktu w Kontaktach
Upewnij się, że przechwytywanie potencjalnych klientów jest włączone, a odwiedzający przesłał formularz.
Eksport jest za duży
Przed eksportem zawęź zakres dat lub filtr botów.
SendPulse synchronizacja niedostępna
Najpierw połącz SendPulse w Integracjach, a następnie wróć do Kontaktów.
Co dalej: Przejrzyj Analytics, aby zrozumieć trendy wydajności po uruchomieniu operacji.
08
Kanały i integracje
Połącz Slack, Facebook, Instagram, WhatsApp, Telegram poprzez BotFather, ręczne poświadczenia, alternatywne łącza chat, integracje SendPulse i CRM.
/integracjeKanały, CRM i połączenia e-mailowe
1Wybierz kanał lub kartę integracji CRM.
2Postępuj zgodnie z procedurą OAuth lub poświadczeniami dla każdego dostawcy.
3Odłącz lub przetestuj integracje ponownie na tej samej stronie.
Połącz kanały
Połącz kanał komunikacyjny lub integrację z CRM
Do czego to służy: Użyj tej opcji, gdy sem.chat powinien otrzymać conversations poza widżetem strony lub wysłać kontakty do innych narzędzi.
Zanim zaczniesz
Uzyskaj dostęp administracyjny do platformy zewnętrznej.
Dowiedz się, który bot powinien otrzymywać wiadomości dotyczące kanału.
Użyj kanałów testowych przed połączeniem kont produkcyjnych.
1
Otwarte Integracje
Kliknij Integracje na pasku bocznym.
Oczekiwany wynik: Widoczne są dostępne kanały, narzędzia CRM, SendPulse i opcje widżetów witryny.
2
Wybierz integrację
Kliknij Połącz na Slack, meta kanałach, Telegram, SendPulse, CRM lub poświadczeniach ręcznych.
Oczekiwany wynik: Zostanie otwarte okno dialogowe konfiguracji lub proces OAuth.
3
Zakończ konfigurację dostawcy
W przypadku kanałów OAuth zatwierdź żądane uprawnienia. W przypadku kanałów ręcznych wklej wymagany token, klucz tajny, identyfikator konta lub element webhook URL.
Oczekiwany wynik: sem.chat przechowuje połączenie i pokazuje integrację jako połączoną.
4
Przypisz bota
Gdy pojawi się okno dialogowe, wybierz, który bot powinien obsługiwać wiadomości z tego kanału.
Oczekiwany wynik: Przychodzące wiadomości są kierowane do odpowiedniego asystenta.
5
Przetestuj kanał
Wyślij wiadomość testową z kanału zewnętrznego.
Oczekiwany wynik: Wiadomość pojawi się w skrzynce odbiorczej lub Chat History pod właściwym kanałem.
6
W razie potrzeby rozłącz
Użyj opcji Odłącz od karty integracji, gdy kanał powinien się zatrzymać.
Oczekiwany wynik: sem.chat przestaje odbierać lub wysyłać przez tę integrację.
Jak to przetestować: Wyślij jedną wiadomość testową przez podłączony kanał i potwierdź odpowiedź bota, wiersz skrzynki odbiorczej i zapis historii.
Problem
Napraw
Token Telegram nie powiódł się
Utwórz lub zresetuj token w BotFather i wklej go ponownie.
Slack wiadomości nie docierają
Sprawdź zakresy aplikacji, subskrypcję wydarzeń URL, token bota, sekret podpisywania i członkostwo kanału.
Połączenie z metakanałem nie powiodło się
Potwierdź, że konto Facebook/Instagram/WhatsApp ma uprawnienia administratora i wymagany dostęp biznesowy.
Synchronizacja SendPulse nie powiodła się
Połącz się ponownie z SendPulse i potwierdź, że pola kontaktowe zostały zmapowane.
Co dalej: Dokumentuj własność kanału dla zespołu i monitoruj skrzynkę odbiorczą po uruchomieniu.
09
Planowanie
Twórz typy wydarzeń, konfiguruj dostępność, łącz kalendarze, zarządzaj rezerwacjami, twórz jednorazowe linki, konfiguruj e-maile z rezerwacjami, przeglądaj statystyki, ustawiaj płatne wydarzenia i testuj publiczne linki do rezerwacji.
/harmonogramPlanowanie obszaru roboczego
1Skorzystaj z zakładek Typy wydarzeń, Rezerwacje, Analityka, Linki jednorazowe, Kalendarze, E-maile i Ustawienia.
2Edytuj, kopiuj, osadzaj, aktywuj lub wstrzymuj typy zdarzeń.
3Skopiuj link publiczny i uruchom test rezerwacji prywatnej.
Redaktor wydarzeńKonfiguracja typu zdarzenia
1Wprowadź nazwę, opis, czas trwania, lokalizację i bufory.
2Ustaw dostępność, okna rezerwacji, pytania, opcje płatnych wydarzeń i zasady anulowania.
1Odwiedzający wybierają datę na publicznej stronie rezerwacji.
2Odwiedzający wybierają dostępny przedział czasowy.
3Goście potwierdzają rezerwację i otrzymują e-mail z potwierdzeniem.
Typ wydarzenia
Utwórz typ wydarzenia i opublikuj link do rezerwacji
Do czego to służy: Użyj tej opcji, gdy odwiedzający powinni zarezerwować prezentacje, konsultacje, rozmowy sprzedażowe, sesje wprowadzające lub sesje wsparcia.
Zanim zaczniesz
Wybierz nazwę wydarzenia, czas trwania, typ spotkania i właściciela.
Przed udostępnieniem linków ustaw strefę czasową i dostępność.
Połącz kalendarze, jeśli liczy się podwójna rezerwacja.
1
Otwórz harmonogram
Kliknij opcję Harmonogram na pasku bocznym.
Oczekiwany wynik: Obszar roboczy planowania zawiera zakładki dotyczące typów wydarzeń, rezerwacji, analiz, łączy jednorazowych, kalendarzy, e-maili i ustawień.
2
Utwórz typ wydarzenia
Kliknij Utwórz, a następnie dodaj nazwę, opis, czas trwania, lokalizację, bufor i reguły rezerwacji.
Oczekiwany wynik: Wydarzenie zawiera wystarczającą ilość informacji publicznych, aby odwiedzający mogli je zrozumieć.
3
Ustaw dostępność
Skonfiguruj godziny pracy w tygodniu, zmiany dat, okna powiadomień i okna rezerwacji.
Oczekiwany wynik: Odwiedzający widzą tylko te godziny, które jesteś skłonny zaoferować.
4
Dodaj pytania
Dodaj wymagane pytania, takie jak telefon, firma, strona internetowa lub cel spotkania.
Oczekiwany wynik: Rezerwacje zbierają kontekst, jakiego potrzebuje Twój zespół przed rozmową.
5
Połącz kalendarze
Otwórz Kalendarze i połącz się z Google, Outlook lub iCal, jeśli są dostępne.
Oczekiwany wynik: Zajęte czasy można blokować, a potwierdzone rezerwacje można zapisywać w kalendarzu.
6
Ustawiaj e-maile i przypomnienia
Otwórz Wiadomości e-mail i skonfiguruj wiadomości z potwierdzeniem, przypomnieniem, anulowaniem i zmianą terminu.
Skopiuj link do wydarzenia, otwórz go w prywatnym oknie, wybierz miejsce i dokończ rezerwację testową.
Oczekiwany wynik: Rezerwacja pojawia się w zakładce Rezerwacje i wysyłane są wiadomości potwierdzające.
Jak to przetestować: Dokonaj jednej rezerwacji testowej, jednej zmiany terminu i jednego anulowania. Upewnij się, że każde wydarzenie pojawia się w Planowaniu i połączonych kalendarzach.
Problem
Napraw
Na stronie publicznej nie pojawiają się żadne godziny
Sprawdź ustawienia poczty e-mail i folder spamu, a następnie wyślij kolejną rezerwację testową.
Płatność nie powiodła się w przypadku płatnego wydarzenia
Przed opublikowaniem upewnij się, że ustawienia rozliczeń/integracji płatności i waluta są prawidłowe.
Co dalej: Umieść linki do rezerwacji w bocie, na stronie internetowej lub w kolejnych wiadomościach e-mail.
Zaawansowane planowanie
Korzystaj z jednorazowych linków, analiz, osadzania i płatnych wydarzeń
Do czego to służy: Użyj tej opcji, jeśli planowanie wymaga tymczasowej dostępności, raportowania, wbudowanej rezerwacji lub płatności.
Zanim zaczniesz
Najpierw utwórz co najmniej jeden typ zdarzenia.
Połącz kalendarze, zanim zaczniesz intensywnie korzystać z jednorazowych linków.
Zdefiniuj zasady zwrotów/anulowania przed włączeniem płatnych wydarzeń.
1
Utwórz jednorazowe łącze
Otwórz Linki jednorazowe, wybierz oferowane sloty lub zasady, a następnie wygeneruj link.
Oczekiwany wynik: Odbiorca może dokonać rezerwacji wyłącznie z wybranej dostępności.
2
Osadź harmonogram
Skorzystaj z opcji osadzenia karty wydarzenia, jeśli proces rezerwacji powinien pojawić się na Twojej stronie.
Oczekiwany wynik: Interfejs rezerwacji można umieścić na stronie, na której dokonuje się konwersja odwiedzających.
3
Przejrzyj analizę harmonogramu
Otwórz Analytics w harmonogramie.
Oczekiwany wynik: Możesz zobaczyć rezerwacje, trendy realizacji i skuteczność typu wydarzenia.
4
Włącz płatne wydarzenia
Otwórz edytor wydarzeń, ustaw cenę, walutę i sposób płatności.
Oczekiwany wynik: Odwiedzający muszą ukończyć etap płatności zgodnie z konfiguracją wydarzenia.
5
Rezerwacje audytowe
Otwórz Rezerwacje i przejrzyj nadchodzące, zakończone, anulowane i przełożone wpisy.
Oczekiwany wynik: Zespół może zarządzać frekwencją i działaniami następczymi.
Jak to przetestować: Zarezerwuj za pośrednictwem strony publicznej i strony osadzonej, jeśli jest używana. Potwierdź, że oba tworzą ten sam typ rekordu rezerwacji.
Problem
Napraw
Jednorazowy link ujawnia niewłaściwe miejsca
Wygeneruj ponownie link, używając mniejszego zestawu przedziałów lub bardziej rygorystycznego zakresu dat.
Wbudowana rezerwacja jest zbyt wąska
Umieść osad w szerszym kontenerze treści i sprawdź układ mobilny.
Analityka wygląda na pustą
Twórz lub czekaj na prawdziwe rezerwacje; analityka zależy od zapisów rezerwacji.
Co dalej: Połącz wyniki planowania z raportami i analizami.
10
Analityka i raporty
Wybierz zakresy dat, używaj dat niestandardowych, czytaj podstawowe dane, eksportuj CSV, przeglądaj trendy satysfakcji i rozmów, konfiguruj raporty e-mailowe i weryfikuj dostawę.
/analitykaPanel analityczny
1Wybierz zakresy dat lub daty niestandardowe.
2Przeczytaj dane dotyczące konwersacji, satysfakcji, języka, kanału i konwersji.
Rozpocznij lub uaktualnij plany, zarządzaj portalem rozliczeniowym, zapraszaj członków zespołu, ustawiaj role, edytuj profil/język, konfiguruj powiadomienia, włączaj 2FA, korzystaj z działań w strefie zagrożenia i uruchamiaj przepływ pracy dla partnerów.
/ rozliczeniaKontrola planowania i rozliczeń
1Przejrzyj bieżący plan, stan próbny i limity usage.
2Porównaj funkcje planu przed aktualizacją.
3Otwórz portal rozliczeniowy, aby wyświetlić faktury, metody płatności, anulowanie lub ponowną aktywację.
/ustawieniaUstawienia, zespół i bezpieczeństwo
1Użyj opcji Ogólne dla profilu i języka.
2Użyj zespołu do zaproszeń i ról.
3Użyj zabezpieczeń dla kluczy 2FA, API i działań w strefie niebezpiecznej.
/partnerKontrola programu partnerskiego
1Dołącz do programu, aby utworzyć link polecający.
2Skopiuj link polecający do kampanii.
3Ustaw adres e-mail wypłaty i poproś o kwalifikujące się wypłaty.
Rozliczenia
Rozpocznij, uaktualnij, anuluj lub ponownie aktywuj plan
Do czego to służy: Użyj tej opcji, gdy obszar roboczy wymaga aktywacji próbnej, dodatkowych limitów, faktur, aktualizacji płatności lub zmian w subskrypcji.
Zanim zaczniesz
Właściciel konta lub administrator ds. rozliczeń powinien wykonać czynności rozliczeniowe.
Sprawdź, które funkcje są objęte planem: głos, sklonowane głosy, niestandardowe awatary, API, zespół, CRM i kanały.
Skorzystaj z bezpiecznego portalu rozliczeniowego, aby zmienić metodę płatności i fakturę.
1
Otwórz rozliczenia
Kliknij opcję Rozliczenia na pasku bocznym.
Oczekiwany wynik: Widoczny jest bieżący plan, stan próbny, limity usage i karty planów.
Oczekiwany wynik: Wiesz, który plan odblokowuje potrzebną funkcję.
3
Wybierz interwał rozliczeniowy
Wybierz opcję miesięczną lub roczną, jeśli przełącznik jest dostępny.
Oczekiwany wynik: Aktualizacja cen i oszczędności dla wybranego interwału.
4
Uaktualnij lub rozpocznij realizację transakcji
Wybierz żądany plan i dokończ realizację transakcji.
Oczekiwany wynik: Subskrypcja staje się aktywna po potwierdzeniu płatności.
5
Otwórz portal klienta
Skorzystaj z portalu rozliczeniowego, aby określić metodę płatności, faktury, anulowanie lub ponowną aktywację.
Oczekiwany wynik: Wrażliwe działania rozliczeniowe odbywają się w bezpiecznym portalu dostawcy.
6
Sprawdź dostęp do funkcji
Wróć do zablokowanej funkcji i załaduj ponownie aplikację.
Oczekiwany wynik: Odblokowana funkcja jest teraz dostępna, jeśli plan ją uwzględnia.
Jak to przetestować: Po aktualizacji otwórz wcześniej zablokowaną funkcję, taką jak klonowanie głosu lub klucze API i potwierdź, że blokada zniknęła.
Problem
Napraw
Funkcja pozostaje zablokowana po aktualizacji
Odśwież aplikację, poczekaj chwilę na synchronizację subskrypcji, a następnie ponownie sprawdź Płatności.
Zamówienie zostało anulowane
Wróć do Rozliczeń i rozpocznij ponownie realizację transakcji; po anulowaniu transakcji nie nastąpią żadne zmiany planu.
Potrzebujesz zmiany faktury lub karty
Otwórz portal klienta, zamiast edytować szczegóły płatności w aplikacji.
Co dalej: Zaproś członków drużyny i zabezpiecz konto właściciela.
Zespół i bezpieczeństwo
Zaproś członków drużyny, ustaw role, edytuj profil, włącz 2FA i zarządzaj ustawieniami
Do czego to służy: Użyj tej opcji, gdy obszar roboczy przechodzi z konfiguracji solo do pracy zespołowej.
Zanim zaczniesz
Przed wysłaniem zaproszeń poznaj rolę każdego członka zespołu.
Użyj dostępu z najniższymi uprawnieniami: właściciel, administrator, redaktor, przeglądający.
Przygotuj aplikację uwierzytelniającą na 2FA.
1
Otwórz Ustawienia
Kliknij Ustawienia na pasku bocznym.
Oczekiwany wynik: Widoczne są karty Ogólne, powiadomienia, zespół, raporty, programiści, bezpieczeństwo i powiązane.
2
Edytuj profil i język
Zaktualizuj nazwę wyświetlaną, informacje o profilu i ogólnie preferowany język.
Oczekiwany wynik: Aplikacja poprawnie identyfikuje użytkownika i używa wybranego języka, jeśli jest on dostępny.
3
Zaproś członków zespołu
Otwórz aplikację Team, wprowadź adres e-mail, wybierz rolę i wyślij zaproszenie.
Oczekiwany wynik: Członek drużyny otrzyma link z zaproszeniem i będzie wyświetlany jako oczekujący, dopóki nie zostanie zaakceptowany.
4
Ustaw uprawnienia roli
Użyj właściciela, aby uzyskać pełną kontrolę, administratora, aby zarządzać, edytora, aby zmienić treść i przeglądającego, aby uzyskać dostęp tylko do odczytu.
Oczekiwany wynik: Każdy użytkownik ma dostęp odpowiedni do swoich obowiązków.
5
Skonfiguruj powiadomienia
Wybierz powiadomienia e-mail, przeglądarkę, push, wsparcie na żywo, rozliczenia i raporty.
Oczekiwany wynik: Właściwi ludzie otrzymują powiadomienia bez niepotrzebnego hałasu.
6
Włącz 2FA
Otwórz zabezpieczenia, włącz uwierzytelnianie dwuskładnikowe, zeskanuj kod i zapisz szczegóły odzyskiwania.
Oczekiwany wynik: Konto wymaga drugiego czynnika po zalogowaniu się hasłem.
7
Ostrożnie korzystaj z akcji w strefie zagrożenia
Eksportuj potrzebne dane i potwierdzaj aktywne widżety/integracje przed destrukcyjnymi działaniami na koncie.
Oczekiwany wynik: Przestrzeń robocza pozwala uniknąć przypadkowej utraty danych.
Jak to przetestować: Zaproś członka zespołu testowego, zaakceptuj zaproszenie w osobnej przeglądarce i potwierdź, że rola udostępnia tylko zamierzone funkcje.
Problem
Napraw
Brak e-maila z zaproszeniem
Sprawdź spam, wyślij ponownie zaproszenie i zweryfikuj adres.
Kolega z drużyny widzi za dużo
Obniż jego rolę i przejrzyj ustawienia dostępu bota.
Konfiguracja 2FA nie powiodła się
Sprawdź czas urządzenia, zeskanuj ponownie kod QR i zapisz szczegóły odzyskiwania, zanim zaczniesz na nim polegać.
Co dalej: Skonfiguruj klucze API tylko dla użytkowników i usług, które ich potrzebują.
Współpracownik
Dołącz do partnera, skopiuj link polecający, ustaw adres e-mail wypłaty i poproś o wypłatę
Do czego to służy: Użyj tej opcji, gdy partner lub klient chce polecić nowych użytkowników sem.chat i śledzić aktywność związaną z prowizją.
Zanim zaczniesz
Użyj konta, które powinno posiadać przypisanie poleceń.
Przygotuj wiadomość e-mail dotyczącą wypłaty przed złożeniem wniosku o wypłatę.
Przed opublikowaniem kampanii poleceń sprawdź zasady programu.
1
Otwórz Partnera
Kliknij opcję Partner na pasku bocznym lub otwórz zakładkę partnera w Ustawieniach, jeśli jest tam połączona.
Oczekiwany wynik: Strona programu partnerskiego pokazuje obszary dołączenia, polecenia, wypłaty i historii.
2
Dołącz do programu
Kliknij Dołącz, jeśli konto jeszcze się nie dołączyło.
Oczekiwany wynik: Tworzony jest kod polecający i link polecający.
3
Skopiuj link polecający
Skopiuj unikalny link i użyj go w treściach, kampaniach lub wiadomościach partnerów.
Oczekiwany wynik: Rejestracje poprzez link można przypisać do konta partnerskiego.
4
Ustaw adres e-mail wypłaty
Wpisz adres e-mail wypłaty i zapisz go.
Oczekiwany wynik: Kwalifikujące się wypłaty mogą być prawidłowo kierowane.
5
Przejrzyj polecenia i prowizje
Sprawdź listę poleconych, status prowizji i historię wypłat.
Oczekiwany wynik: Wiesz, co jest oczekujące, kwalifikujące się lub już opłacone.
6
Poproś o wypłatę
Kliknij opcję Poproś o wypłatę, gdy zostaną spełnione zasady programu i minimalne kwoty.
Oczekiwany wynik: Żądanie wypłaty jest rejestrowane do przetworzenia.
Jak to przetestować: Otwórz link polecający w prywatnej przeglądarce i potwierdź, że trafi na oczekiwany proces rejestracji dzięki śledzeniu poleceń.
Problem
Napraw
Brak linku polecającego
Najpierw dołącz do programu lub odśwież stronę partnerską po dołączeniu.
Żądanie wypłaty niedostępne
Sprawdź minimalny próg wypłaty, stan kwalifikującej się prowizji i adres e-mail dotyczący wypłaty.
Nie przypisano skierowania
Upewnij się, że użytkownik użył dokładnego linku polecającego i nie usunął parametrów śledzenia.
Co dalej: Skorzystaj z analiz i raportów, aby monitorować wpływ poleconych klientów, jeśli ma to zastosowanie.
12
Powiadomienia i App Updates
Przeglądaj alerty, oznaczaj powiadomienia jako przeczytane, filtruj ważne zdarzenia i korzystaj z aktualizacji aplikacji, aby zrozumieć nowe zmiany w produktach.
/powiadomieniaCentrum powiadomień
1Użyj opcji Oznacz wszystkie jako przeczytane po przejrzeniu nieprzeczytanych alertów.
2Filtruj według nieprzeczytanych, rozliczeń, pomocy na żywo lub zdarzeń systemowych.
1Przeczytaj informacje o wersji, aby poznać nowe funkcje i poprawki.
2Wykorzystaj szczegóły, aby przeszkolić członków zespołu przed zmianami w przepływie pracy.
3Sprawdź aktualizacje po zauważeniu zmian w interfejsie użytkownika lub zachowaniu.
Powiadomienia
Przeglądaj powiadomienia i reaguj na alerty
Do czego to służy: Użyj tej opcji, gdy aplikacja zgłasza przekazania, stan rozliczeń, zdarzenia systemowe, dostarczenie raportów lub ważną aktywność w obszarze roboczym.
Zanim zaczniesz
Upewnij się, że preferencje powiadomień są ustawione w Ustawieniach.
Zapewnij wsparcie na żywo, jeśli włączone są powiadomienia o przekazaniu.
Przejrzyj nieprzeczytane alerty, zanim oznaczysz je jako przeczytane.
1
Otwórz powiadomienia
Kliknij Powiadomienia na pasku bocznym lub w pozycji powiadomienia w nagłówku aplikacji.
Oczekiwany wynik: Centrum powiadomień zawiera listę ostatnich alertów.
2
Filtruj alerty
Użyj filtrów nieprzeczytanych lub kategorii, aby skupić się na rozliczeniach, wsparciu na żywo, bocie, raportach lub zdarzeniach systemowych.
Oczekiwany wynik: Widoczne będą tylko pasujące alerty.
3
Otwórz powiązaną stronę
Kliknij alert lub użyj jego kontekstu, aby otworzyć Rozliczenia, Live Support, Raporty lub odpowiedniego bota.
Oczekiwany wynik: Działasz zgodnie z powiadomieniem, a nie tylko je czytasz.
4
Zaznacz przeczytane
Oznacz pojedynczy alert jako przeczytany lub użyj. Oznacz wszystkie jako przeczytane po przejrzeniu.
Oczekiwany wynik: Liczba nieprzeczytanych i sprawdzonych elementów nie jest już podświetlona.
5
Dostosuj preferencje
Otwórz Ustawienia, Powiadomienia, jeśli pojawi się za dużo lub za mało alertów.
Oczekiwany wynik: Strumień powiadomień odpowiada potrzebom zespołu.
Jak to przetestować: Utwórz bezpieczne zdarzenie testowe, takie jak prośba o wsparcie na żywo lub natychmiastowy raport, a następnie potwierdź, że powiadomienie się pojawiło i można je oznaczyć jako przeczytane.
Problem
Napraw
Żadne powiadomienie nie przychodzi
Sprawdź preferencje powiadomień w Ustawieniach, uprawnienia przeglądarki i czy zdarzenie faktycznie miało miejsce.
Za dużo alertów
Wyłącz hałaśliwe kategorie lub wyślij je tylko do odpowiedzialnych członków zespołu.
Licznik nieprzeczytanych danych wydaje się być zablokowany
Odśwież aplikację po zaznaczeniu wszystkich przeczytanych i potwierdź, że filtry nie ukrywają nieprzeczytanych elementów.
Co dalej: Przejrzyj App Updates, gdy zmieni się zachowanie lub pojawią się nowe elementy sterujące.
Aktualizacje aplikacji
Korzystaj z aktualizacji aplikacji, aby zrozumieć zmiany w produkcie
Do czego to służy: Użyj tej opcji, gdy członkowie zespołu muszą dowiedzieć się, co się zmieniło, zanim skorzystają z nowej funkcji.
Zanim zaczniesz
Otwórz aktualizacje po głównych wydaniach lub po zmianie interfejsu użytkownika.
Udostępnij odpowiednie notatki dotyczące aktualizacji użytkownikom wsparcia i sprzedaży.
Przetestuj ponownie krytyczne przepływy pracy po wprowadzeniu większych zmian.
1
Otwórz App Updates
Kliknij App Updates na pasku bocznym.
Oczekiwany wynik: Kanał aktualizacji zawiera nowe funkcje, poprawki i informacje o wersji.
2
Przeczytaj najnowszą aktualizację
Otwórz kartę najnowszej aktualizacji lub widok szczegółów.
Oczekiwany wynik: Widzisz, co się zmieniło i na jaki przepływ pracy wpływa.
3
Zamapuj zmianę w swoim przepływie pracy
Określ, czy aktualizacja dotyczy botów, widżetów, wsparcia, harmonogramu, rozliczeń lub programistów.
Oczekiwany wynik: Właściwi członkowie zespołu wiedzą, co sprawdzić.
4
Przetestuj ponownie ścieżki krytyczne
Jeśli aktualizacja wpływa na przepływ pracy w środowisku produkcyjnym, powtórz odpowiednie kroki ręczne z tej dokumentacji.
Oczekiwany wynik: Zespół potwierdza, że zmieniony przepływ pracy nadal działa.
5
Udostępnij wewnętrznie
Wyślij podsumowanie aktualizacji do użytkowników będących właścicielami dotkniętego obszaru.
Oczekiwany wynik: Adopcja zespołu przebiega płynniej, a pytania dotyczące wsparcia spadają.
Jak to przetestować: Po odpowiedniej aktualizacji powtórz przewodnik dotyczący danej funkcji i potwierdź, że zrzuty ekranu lub nazwy kroków nadal się zgadzają.
Problem
Napraw
Aktualizacja wspomina o zablokowanej funkcji
Otwórz opcję Rozliczenia, aby sprawdzić, czy bieżący plan ją uwzględnia.
Zespół przegapił zmianę
Dodaj recenzję App Updates do procedur wydań lub cotygodniowych operacji.
Dokumentacja wygląda na nieaktualną po aktualizacji
Skorzystaj z Przewodnika inżyniera, aby zaktualizować zrzuty ekranu i kroki.
Co dalej: Dbaj o aktualność dokumentacji publicznej w miarę rozwoju funkcji.
13
Przepisy programistyczne
Wygeneruj klucze API, użyj uwierzytelniania x-api-key, wywołaj punkty końcowe oparte na akcjach, połącz wsparcie na żywo z CRM, zarejestruj webhooki, zweryfikuj podpisy i osadź widżet w kodzie.
Ustawienia / ProgramiściKlawisze API, szybki start i karty usage
1Wygeneruj i unieważnij klucze API na karcie Klucze API.
2Użyj Quick Start dla pierwszych przykładów zwijania.
3Przejrzyj użycie przed włączeniem automatyzacji na dużą skalę.
API szybki start
Wygeneruj klucz API i wykonaj pierwsze wywołania API
Do czego to służy: Użyj tego do raportowania skryptów, aplikacji niestandardowych, mostów CRM, zewnętrznego wsparcia na żywo lub automatyzacji.
Zanim zaczniesz
Użyj środowiska po stronie serwera. Nie ujawniaj kluczy API w przeglądarce JavaScript.
Wygeneruj osobny klucz dla każdej integracji.
Skopiuj klucz natychmiast, ponieważ klucze tajne są wyświetlane raz.
1
Otwórz programistów
Otwórz Ustawienia i wybierz Deweloperów lub użyj przekierowania Deweloperów, jeśli jest dostępne.
Oczekiwany wynik: Widoczne są karty API Klucze, Quick Start, Dokumentacja i Użycie.
2
Wygeneruj klucz
Kliknij opcję Wygeneruj klucz, nadaj mu wyraźną etykietę i natychmiast skopiuj.
Oczekiwany wynik: Klucz zaczyna się od sk_live_ i jest dostępny dla żądań po stronie serwera.
3
Wyślij nagłówek x-api-key
Dołącz x-api-key do każdego publicznego żądania API.
Oczekiwany wynik: Publiczny API może uwierzytelnić żądanie i określić jego zakres dla właściciela.
4
Lista botów
Wywołaj akcję=list-bots, aby znaleźć potrzebny identyfikator bota.
Oczekiwany wynik: Odpowiedź zwraca identyfikatory botów, nazwy, stan aktywny i podsumowanie konfiguracji.
5
Wyślij wiadomość chat
POST akcja chat z botId i komunikatem.
Oczekiwany wynik: Odpowiedź zwraca odpowiedź, model i informacje usage.
6
Sprawdź usage
Wywołaj akcję=usage przed uruchomieniem zadań o dużej objętości.
Oczekiwany wynik: Znasz aktualny plan i stan usage przed uruchomieniem automatyzacji.
7
W razie potrzeby obróć klawisze
Unieważnij nieużywane klucze i wygeneruj nowe dla zmienionych dostawców lub usług.
Oczekiwany wynik: Stare usługi nie mogą w dalszym ciągu korzystać z nieaktualnych poświadczeń.
Jak to przetestować: Uruchom list-bots i chat z lokalnego terminala lub środowiska serwera, a następnie potwierdź, że konwersacja pojawia się w Chat History, jeśli wysłano chat.
Problem
Napraw
401 lub nieautoryzowana odpowiedź
Sprawdź pisownię x-api-key, skopiuj pełny klucz i potwierdź, że nie został on unieważniony.
Nie znaleziono bota
Użyj ponownie list-bots i potwierdź, że bot należy do właściciela klucza API.
Problem z CORS przeglądarki
Przenieś wywołanie API do swojego backendu; Klucze API są przeznaczone do użytku po stronie serwera.
Co dalej: Użyj /api-docs, aby uzyskać szczegółowe informacje o punkcie końcowym i zachowaj tę stronę jako wskazówki dotyczące przepływu pracy.
Lista botów
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Wyślij wiadomość 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?"
}'
Most wsparcia na żywo CRM
Odpytuj lub przesyłaj prośby o pomoc na żywo do CRM
Do czego to służy: Użyj tej opcji, gdy agenci pracują w innym systemie, ale sem.chat odbiera rozmowę z gościem.
Zanim zaczniesz
Utwórz dedykowany klucz API o nazwie dla mostu CRM.
Zdecyduj, czy odpytywanie lub webhook pasują do Twojej infrastruktury.
Upewnij się, że CRM przechowuje identyfikatory rozmów na potrzeby przyszłych odpowiedzi/rozwiązań.
1
Lista oczekujących przekazania
GET akcja=live-support-list ze statusem=żądanie lub status=wszystko.
Przechowuj najnowszy status przekazania, identyfikator wiadomości i znaczniki czasu.
Oczekiwany wynik: CRM i sem.chat podlegają kontroli.
Jak to przetestować: Utwórz bezpieczne przekazanie, odbij je na CRM, odpowiedz z mostu i potwierdź aktualizacje wątków gości.
Problem
Napraw
Zduplikuj bilety CRM
Użyj conversationId jako klucza idempotencji w moście CRM.
Odpowiedzi przychodzą nie w kolejności
Przechowuj znaczniki czasu wiadomości i unikaj równoczesnych odpowiedzi z wielu systemów.
AI odpowiada, gdy agent pracuje
Najpierw zażądaj przekazania i oddaj sprawę dopiero wtedy, gdy agent skończy pracę.
Co dalej: Zarejestruj webhooki, jeśli odpytywanie jest zbyt wolne lub zbyt drogie.
Haki internetowe
Zarejestruj webhooki i zweryfikuj X-SemChat-Signature
Do czego to służy: Użyj tej opcji, jeśli Twój system potrzebuje zdarzeń w czasie rzeczywistym w celu przekazania informacji, komunikatów i aktualizacji rozwiązań.
Zanim zaczniesz
Webhook URL musi być HTTPS i być osiągalny z publicznego Internetu.
Natychmiast przechowuj sekret webhooka; jest to pokazane raz.
Weryfikuj podpisy przed przetworzeniem zdarzeń.
1
Zarejestruj webhooka
POST akcja webhook-register z adresem URL i wydarzeniami.
Oczekiwany wynik: Odpowiedź zawiera szczegóły elementu webhook i jednorazowy klucz podpisywania.
2
Przechowuj tajemnicę
Zapisz sekret w środowisku serwera lub w menedżerze sekretów.
Oczekiwany wynik: Przyszłe dostawy można zweryfikować.
3
Zweryfikuj podpis
Przeczytaj X-SemChat-Signature i porównaj go z HMAC SHA-256 w nieprzetworzonej treści żądania.
Oczekiwany wynik: Akceptowane są wyłącznie oryginalne dostawy sem.chat.
4
Obsługuj ponowne próby idempotentnie
Użyj identyfikatora zdarzenia lub identyfikatora rozmowy/wiadomości, aby uniknąć podwójnego przetwarzania.
Oczekiwany wynik: Ponowne próby nie powodują utworzenia zduplikowanych rekordów CRM.
5
Lista webhooków
GET akcja webhook-list do audytu skonfigurowanych punktów końcowych.
Oczekiwany wynik: Możesz zobaczyć URL, zdarzenia, stan włączenia i stan ostatniej dostawy.
6
Usuń nieaktualne elementy webhook
POST akcja webhook-delete z identyfikatorem webhooka.
Oczekiwany wynik: Stare punkty końcowe przestają odbierać zdarzenia.
Jak to przetestować: Zarejestruj testowy punkt końcowy, wywołaj zdarzenie wsparcia na żywo, zweryfikuj podpis i potwierdź, że program obsługi zwraca 2xx.
Problem
Napraw
Podpis nie pasuje
Użyj nieprzetworzonej treści, nieanalizowanej JSON i potwierdź poprawny klucz tajny elementu webhook.
Webhook nie odbiera żadnych zdarzeń
Upewnij się, że lista zdarzeń zawiera testowane zdarzenie, a punkt końcowy to HTTPS.
Przekroczono limit czasu webhooka
Szybko potwierdzaj i przetwarzaj długą pracę asynchronicznie.
Co dalej: Link dla inżynierów do /api-docs, aby uzyskać szczegółowe informacje i przykłady punktów końcowych.
Używaj poprawnie publicznego API opartego na akcjach
Do czego to służy: Użyj tego, wybierając właściwą akcję dla funkcji.
Zanim zaczniesz
Każde żądanie korzysta z tej samej funkcji publicznego interfejsu API URL.
Akcje GET korzystają z parametrów zapytania. Akcje POST wykorzystują treść JSON.
Wysyłaj x-api-key na wszystkie prośby.
Jak to przetestować: Wywołaj usage i list-bots w ramach testu dymnego po dowolnej zmianie klucza API lub punktu końcowego.
Problem
Napraw
Niezgodność metody
Użyj metody pokazanej w tabeli punktów końcowych. Niektóre akcje obejmują tylko GET lub POST.
Brak wymaganej wartości
Sprawdź botId, conversationId, identyfikator webhooka i pisownię akcji.
Co dalej: Użyj Quick Start dla pierwszych żądań, a następnie /api-docs dla pełnego odniesienia.
Metoda
Akcja
Cel
GET
list-bots
Lista wszystkich botów dostępnych dla właściciela klucza API.
GET
get-bot
Pobierz konfigurację jednego bota według identyfikatora bota.
POST
chat
Wyślij wiadomość od gościa do bota i zwróć odpowiedź AI.
GET
conversations
Lista ostatnich conversations dla bota, maksymalnie 100 rekordów.
GET
usage
Plan zwrotu, środki, liczba botów, conversations i klucz API usage.
GET
live-support-list
Lista conversations czeka na agenta ludzkiego lub jest przez niego obsługiwana.
GET
live-support-messages
Pobierz wątek przekazania z wiadomościami i informacjami o gościach.
POST
live-support-reply
Wyślij odpowiedź od agenta z systemu zewnętrznego.
POST
live-support-claim
Zgłoś oczekującą rozmowę o przekazaniu.
POST
live-support-resolve
Rozstrzygnij przekazanie lub przywróć kontrolę do AI.
POST
webhook-register
Zarejestruj punkt końcowy elementu webhook HTTPS.
GET
webhook-list
Wyświetl listę rejestracji webhooków bez zwracania wpisów tajnych.
POST
webhook-delete
Usuń rejestrację webhooka według identyfikatora.
14
Przewodnik inżyniera: Dodaj funkcje
Dodaj trasy, nawigację w panelu, ustawienia narzędzia do tworzenia botów, tabele/funkcje/migracje Supabase, dokumenty API, dokumentację publiczną, kontrole SEO i weryfikację lokalną.
Przepływ pracy z funkcjami aplikacji
Dodaj trasę aplikacji, stronę, element nawigacyjny i wpis w dokumencie
Do czego to służy: Użyj tej opcji, dodając nową funkcję pulpitu nawigacyjnego skierowanego do klienta.
Zanim zaczniesz
Utwórz gałąź przed edycją.
Określ, czy funkcja należy do repozytorium aplikacji, czy do publicznego repozytorium frontonu sem.chat.
Sprawdź istniejącą trasę, pasek boczny, i18n i wzorce ustawień przed dodaniem nowej struktury.
1
Add the route
Zaktualizuj plik src/App.tsx, dodając chronioną trasę dla stron klientów lub trasę publiczną tylko wtedy, gdy strona musi być publiczna.
Oczekiwany wynik: URL jest rozpoznawany w aplikacji bez naciśnięcia przycisku NotFound.
2
Utwórz lub zaktualizuj komponent strony
Użyj istniejących wzorców stron, ładowania danych, pustych stanów, stanów ładowania i uprawnień.
Oczekiwany wynik: Funkcja zachowuje się spójnie z pulpitem nawigacyjnym.
3
Add dashboard navigation
W razie potrzeby zaktualizuj źródło paska bocznego/nawigacji za pomocą etykiety, ikony, trasy i planuj bramy.
Oczekiwany wynik: Użytkownicy mogą odkryć nową stronę z poziomu powłoki aplikacji.
4
Dodaj kartę lub ustawienie narzędzia do tworzenia botów
Jeśli funkcja należy do bota, dodaj ją na kartach Bot Builder i zachowaj ją w istniejących procesach zapisywania.
Oczekiwany wynik: Konfiguracja specyficzna dla bota jest zapisywana wraz z botem i nie jest zawieszana w stanie lokalnym.
5
Dodaj zmiany schematu/funkcji Supabase
Twórz migracje tabel/polityk i funkcji brzegowych do pracy po stronie serwera.
Oczekiwany wynik: Zachowanie bazy danych i serwera można wdrażać wielokrotnie.
6
Zaktualizuj kształt API, jeśli jest publiczny
Dodaj lub rozszerz obsługę akcji w supabase/functions/public-api/index.ts i udokumentuj zachowanie x-api-key.
Oczekiwany wynik: Integracje mogą bezpiecznie korzystać z tej funkcji.
7
Zaktualizuj dokumentację aplikacji i dokumentację publiczną
Zaktualizuj dokumentację programisty w aplikacji i tę stronę dokumentacji, dodając zrzuty ekranu i instrukcje krok po kroku.
Oczekiwany wynik: Użytkownicy i inżynierowie widzą tę funkcję w obu miejscach.
8
Run checks
Uruchom testy/kompilację aplikacji, optymalizację SEO w witrynie publicznej, sprawdzenie mapy witryny i weryfikację przeglądarki.
Oczekiwany wynik: Funkcja działa lokalnie, a witrynę publiczną można przeszukiwać.
Jak to przetestować: Otwórz nową trasę, użyj funkcji od końca do końca, sprawdź błędy konsoli/sieci i zweryfikuj wszelkie zmiany w bazie danych z poziomu interfejsu użytkownika.
Problem
Napraw
Trasa działa, ale nawigacja nie podświetla się
Sprawdź dopasowanie trasy na pasku bocznym i przekieruj ścieżki.
Dane działają lokalnie, ale nie są wdrożone
Potwierdź migrację, zasady RLS i zmienne środowiskowe funkcji brzegowej.
W mapie witryny brakuje dokumentów publicznych
Uruchom optymalizator SEO i sprawdź plik sitemap.xml pod kątem kanonicznego URL.
Co dalej: Przechwytuj lub odtwarzaj zrzuty ekranu dokumentacji przy każdej zmianie interfejsu użytkownika.
Przepływ pracy z obsługą dokumentów
Zaktualizuj tę publiczną stronę dokumentacji po wprowadzeniu zmian w produkcie
Do czego to służy: Użyj tej opcji, gdy zmienią się zrzuty ekranu, przepływy pracy, zachowanie API lub nawigacja.
Zanim zaczniesz
Używaj wyłącznie bezpiecznych danych demonstracyjnych.
Nigdy nie ujawniaj prawdziwych klientów, e-maili, szczegółów płatności, kluczy API ani prywatnych rozmów.
Najpierw zaktualizuj angielski podręcznik, a następnie odśwież każdą zlokalizowaną stronę dokumentacji przed kontrolami SEO.
1
Audit the changed route
Otwórz ścieżkę aplikacji i określ, co zmieniło się wizualnie i proceduralnie.
Oczekiwany wynik: Wiesz, które wiersze przewodnika, zrzutu ekranu i rozwiązywania problemów wymagają edycji.
2
Zrób lub wygeneruj bezpieczny zrzut ekranu
Skorzystaj z demonstracyjnego obszaru roboczego i zamaskuj sekrety przed zapisaniem zasobów WebP w obszarze zasoby/dokumentacja.
Oczekiwany wynik: Zrzut ekranu jest dokładny i można go bezpiecznie opublikować.
3
Zaktualizuj przewodnik
Edytuj odpowiednie sekcje: Do czego to służy, Przed rozpoczęciem, Kroki, Oczekiwane wyniki, Testowanie, Rozwiązywanie problemów i Dalej.
Oczekiwany wynik: Przewodnik informuje użytkowników, co kliknąć i co powinno się wydarzyć po każdym kliknięciu.
4
W razie potrzeby zaktualizuj nawigację
Dodaj sekcję do przyklejonego spisu treści, mobilnego selektora sekcji i indeksu wizualnego, jeśli jest to strona główna.
Oczekiwany wynik: Czytelnicy mogą szybko znaleźć nową treść.
5
Uruchom narzędzia SEO
Uruchom narzędzia węzła/seo-optimize-static-pages.js i narzędzia węzła/seo-optimize-static-pages.js --check.
Oczekiwany wynik: Dane wyjściowe kanoniczne, metadane, mapa witryny i dane wyjściowe robotów pozostają prawidłowe.
6
Uruchom czyszczenie i sprawdzanie różnicowe
Uruchom narzędzia węzła/static-translation-cleanup.js --audit i git diff --check.
Oczekiwany wynik: Tłumaczenia statyczne i białe znaki są czyste.
7
Zweryfikuj przeglądarkę
Obsługuj witrynę lokalnie i testuj/dokumentację na komputerach stacjonarnych i urządzeniach mobilnych.
Oczekiwany wynik: Obrazy ładują się, wyszukiwanie działa, przyciski kopiowania działają, podświetlony spis treści, a układ nie nakłada się na baner plików cookie.
Jak to przetestować: Wyszukaj zmienioną nazwę funkcji w /dokumentacji i potwierdź, że pojawia się prawidłowy blok prowadzący.
Problem
Napraw
Znaczniki zrzutów ekranu dryfują na urządzeniach mobilnych
Zachowaj znaczniki wewnątrz obrazu zrzutu ekranu lub użyj responsywnych współrzędnych znaczników.
Wyszukiwanie pomija nowy przewodnik
Dodaj przydatne słowa kluczowe do tytułu danych i uwzględnij dokładne terminy dotyczące produktów, których szukają użytkownicy.
Zlokalizowana dokumentacja staje się nieaktualna
Po edycji angielskiego podręcznika odśwież każdą zlokalizowaną stronę dokumentacji, ponownie uruchom optymalizator SEO i potwierdź, że sitemap.xml zawiera każdy URL dokumentacji.
Co dalej: Zatwierdź razem stronę dokumentu, zasoby, linki nagłówka/stopki, plik .htaccess i zmiany w mapie witryny.
Potrzebujesz skoncentrowanego odniesienia do API?
Starsza strona /api-docs pozostaje dostępna dla szczegółów API na poziomie punktu końcowego.