Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Połącz swoją witrynę

Czytaj strony, produkty i zamówienia bezpośrednio ze swojej platformy

Otwórz okno połączenia
Plany Standard, Pro i Enterprise

Przegląd

Połączenie witryny daje sztucznej inteligencji klucz do Twojej platformy tylko do odczytu. Zamiast indeksować strony z zewnątrz, prosimy o nie bezpośrednio platformę.

W ten sposób docieramy do treści, do których robot indeksujący nie sięga. Przechodzą strony za logowaniem, głębokie strony, do których nic nie prowadzi, oraz witryny za zaporą antybotową. Ceny i stany magazynowe pozostają aktualne, bo odczytujemy je ponownie, a nie polegamy na tym, co strona pokazywała w dniu indeksowania.

Tylko do odczytu. Nic w Twojej witrynie nie jest tworzone, zmieniane ani usuwane. Każde nasze wywołanie to odczyt.

Trzy rodzaje danych

To Ty wybierasz, czym się dzielisz. Każdy wybór odpowiada temu, na co asystent będzie mógł odpowiedzieć.

Wybór Co wnosi Na co asystent może odpowiedzieć
Strony Treść Twojej strony, synchronizowana automatycznie. Pytania o Twoje zasady, usługi, kursy, poradniki i każdą inną stronę tekstową.
Produkty Aktualne ceny, stany magazynowe, linki i zdjęcia. Co sprzedajesz, ile to kosztuje, czy jest dostępne, oraz link do zakupu.
Zamówienia Sprawdzanie statusu zamówienia dla Twoich klientów. Gdzie jest zamówienie klienta, kiedy zostało wysłane i co w nim było.

Które platformy działają

Wszystkie. Na czymkolwiek zbudowana jest Twoja witryna, asystent może odpowiadać na podstawie Twoich stron, produktów i zamówień.

Niektóre platformy da się czytać bezpośrednio kluczem API. W pozostałych te same dane docierają przez indeksowanie, kanał produktowy, kontekst użytkownika lub Twoje własne narzędzia. Nie musisz ustalać, co dotyczy Ciebie: otwórz okno, wybierz platformę, zaznacz, czym chcesz się podzielić, a zobaczysz kroki dla swojego przypadku.

Zobacz kroki dla swojej platformy

Zbudowałeś witrynę samodzielnie? Wybierz w oknie Własna / bez CMS. Witryna zbudowana ręcznie, rozwiązanie headless czy dowolna platforma, której nie wymieniamy, działają tak samo.
Dwa zestawy danych w sklepie WooCommerce. WooCommerce czyta produkty i zamówienia. Strony pochodzą z leżącego pod nim WordPressa, który potrzebuje własnego hasła aplikacji. Okno powie Ci, kiedy potrzebny jest drugi klucz.

Jak połączyć

  1. Otwórz panel i znajdź Połącz swoją witrynę obok Dodaj do bazy wiedzy.
  2. Wybierz platformę z listy. Zaznacz Własna / bez CMS, jeśli zbudowałeś witrynę samodzielnie.
  3. Zaznacz, czym chcesz się podzielić: stronami, produktami, zamówieniami lub dowolną kombinacją.
  4. Naciśnij Dalej. Zobaczysz teraz kroki konfiguracji napisane dla Twojej platformy i Twoich wyborów.
  5. Wykonaj kroki w panelu administracyjnym swojej platformy, aby utworzyć klucz.
  6. Wklej klucz w pola na dole tego samego okna i naciśnij Połącz.

Co się dzieje po naciśnięciu Połącz

Sprawdzamy dane logowania, zanim je zapiszemy. Błędny klucz nigdy nie zostaje zapisany.

  1. Wykonujemy jedno prawdziwe zapytanie do Twojej platformy z wklejonymi danymi.
  2. Jeśli się nie powiedzie, błąd pojawi się pod przyciskiem, a pola pozostaną edytowalne, żebyś mógł go poprawić.
  3. Jeśli się powiedzie, zapisujemy połączenie i zaczynamy czytać Twoje treści.
  4. Okno zgłasza następnie wynik: ile elementów weszło albo co dokładnie zawiodło.
Pierwszy odczyt działa w tle. Możesz zamknąć okno, zakończy się sam.

Utrzymywanie aktualności

Odczytujemy Twoje treści ponownie według harmonogramu, więc zmiana ceny albo nowa strona docierają do asystenta bez Twojego udziału.

Ponownie indeksowane jest tylko to, co się zmieniło. Porównujemy treść każdego elementu z tym, co już mamy, więc niezmieniona strona nic nie kosztuje. Możesz też w dowolnej chwili nacisnąć Synchronizuj teraz na stronie ustawień danej platformy.

Uprawnienia i dostęp

To, ile widzi klucz, zależy od platformy, a ta różnica ma znaczenie.

Magento, Shopify, WooCommerce i BigCommerce przyznają uprawnienia per zasób. Gdy zaznaczysz tylko produkty, klucz naprawdę sięga wyłącznie produktów.

WordPress i Moodle działają inaczej. Hasło aplikacji WordPressa dziedziczy uprawnienia konta, które je utworzyło, a token Moodle widzi to, co widzi jego użytkownik. Nie ma listy zakresów do zaznaczenia. Użyj konta o dostępie nie większym niż treści, na które chcesz odpowiadać, i pamiętaj, że wejdą też wpisy prywatne i chronione hasłem.

Po naszej stronie czytamy wyłącznie ścieżki z treścią, i tylko metodą GET. Nigdy nie zapisujemy.

Łączenie bez klucza API

Każdy wybór ma też drogę, która w ogóle nie wymaga klucza. Działają na dowolnej platformie, a okno pokazuje je obok kroków.

Zamiast Użyj Co robi
Strony Skanowanie Czytamy całą Twoją witrynę i przechowujemy treści w bazie wiedzy.
Produkty Kanał danych w czasie rzeczywistym Podaj nam publiczny adres kanału produktowego. Stamtąd ceny i stany magazynowe pozostają zsynchronizowane.
Zamówienia Kontekst użytkownika lub Narzędzia własne Wyślij dane zalogowanego klienta ze swojej witryny albo podłącz własny endpoint, który asystent może wywołać.

Odłączanie

Otwórz z okna stronę ustawień platformy i naciśnij Odłącz. Usuwa to zapisane dane logowania i kasuje wszystko, co ten klucz wniósł do Twojej bazy wiedzy. Treści z innych źródeł pozostają nietknięte.

Klucz możesz też unieważnić na swojej platformie. Kolejna synchronizacja zakończy się wtedy błędem uwierzytelniania i nic nowego nie zostanie odczytane.

Rozwiązywanie problemów

Co widzisz Co to zwykle oznacza
Uwierzytelnianie nie powiodło się Klucz jest błędny, wygasł lub został unieważniony. W WordPressie zdarza się to też, gdy zamiast hasła aplikacji wklejone zostanie zwykłe hasło logowania.
Gotowe, ale nie znaleźliśmy nic do odczytania Dane logowania działają, ale stojące za nimi konto nie widzi żadnych treści. Wybierz konto z dostępem do stron lub produktów, na które chcesz odpowiadać.
Połączono, ale nie udało się odczytać Twoich treści Klucz został przyjęty, a potem odczyt zawiódł. Dokładny błąd z Twojej platformy pokazujemy razem z komunikatem.
Brakuje uprawnienia Klucz utworzono bez jednego z zasobów wymienionych w krokach. Utwórz go ponownie ze wszystkimi uprawnieniami, które wskazało okno.