Podłącz Base.com

E-commerce

Śledzenie zamówień i odpowiedzi o produktach z Twojego sklepu Base.com

Gdy Base.com jest podłączony, czat na stronie znajduje zamówienie klienta i odpowiada o jego statusie, paczkach, płatnościach, fakturach i zwrotach. Twój katalog produktów może trafić do Bazy wiedzy. Wtedy każdy agent odpowiada o produktach, cenach i dostępności. Konrado korzysta z API Base.com za pomocą jednego tokenu. W Twoim sklepie nic się nie instaluje.

Co Konrado robi z Base.com

Odpowiedzi na zgłoszenia nigdy nie korzystają z Base.com, ale używają katalogu produktów, bo jest on częścią Bazy wiedzy. Twoja organizacja ma jedno połączenie z Base.com.

Wyszukiwanie zamówienia

Narzędzie czatu nazywa się base_find_orders. Klient podaje numer zamówienia oraz adres e-mail lub numer telefonu użyty przy zamówieniu. Konrado pokazuje zamówienie tylko wtedy, gdy obie dane pasują do tego samego zamówienia.

Numer zamówienia może być identyfikatorem zamówienia w Base.com, własnym numerem Twojego sklepu albo numerem z marketplace'u, na przykład Allegro lub Amazon. Liczą się też zamówienia jeszcze niepotwierdzone. Dzięki temu klient może sprawdzić płatność zaraz po złożeniu zamówienia.

Każda informacja wczytuje się osobno. Jeśli Base.com nie zwróci faktur, Konrado i tak odpowie o paczce i powie, że nie udało mu się sprawdzić faktury.

Notatki do zamówień

Gdy klient chce zmienić coś, co wybrał przy zamówieniu, na przykład rozmiar albo tekst nadruku, Konrado może dodać do zamówienia notatkę dla Twojego zespołu. Narzędzie nazywa się base_add_to_order_konrado_note. Ma status Wyłączone, dopóki nie wybierzesz agentów, którzy mogą go używać. Robisz to w zakładce Narzędzia połączenia z Base.com.

Notatka trafia do pola dodatkowego zamówienia o nazwie Konrado. To pole tworzysz raz w Base.com. Bez niego Konrado nie dodaje notatek. Przejdź do Orders › Settings › Extra fields (Zamówienia › Ustawienia › Pola dodatkowe) i kliknij Add extra field (Dodaj pole dodatkowe). Nazwij je Konrado, wybierz Text field (Pole tekstowe) i zakres Orders (Zamówienia). Nie używaj tego pola do niczego innego.

1. Konrado znajduje zamówienie przez wyszukiwanie: po numerze zamówienia oraz e-mailu lub telefonie z zamówienia.
2. Pisze jedno zdanie o prośbie, w języku czatu, i pokazuje je klientowi na karcie z przyciskami Zatwierdź i Odrzuć.
3. Po kliknięciu Zatwierdź Konrado dodaje notatkę. Po kliknięciu Odrzuć nic nie zostaje zapisane.

Każda notatka trafia na początek pola Konrado, najnowsza na górze, oddzielona znakami |. Data po notatce jest podana według ustawienia Strefa czasowa Twojej organizacji, które znajdziesz w Ustawienia obszaru roboczegoUstawienia. Gdy strefa nie jest ustawiona, data jest w UTC, z oznaczeniem UTC:

The customer asked to change the size from L to M. - 2026-10-02 11:12 | The customer asked for a gift box. - 2026-10-01 19:40

Pole przechowuje najnowsze notatki, które mieszczą się w 200 znakach. Konrado nigdy nie pisze w komentarzu sprzedawcy (Uwagi) ani w żadnym innym miejscu zamówienia.

Konrado sprawdza zamówienie przed pokazaniem karty i jeszcze raz tuż przed zapisaniem:

Zmianę wprowadza Twój zespół. Konrado nigdy nie zmienia produktów, cen, adresu ani statusu zamówienia. W zakładce Narzędzia możesz też wyłączyć kartę zatwierdzenia dla wybranego agenta. Wtedy notatka zapisuje się od razu, a wszystkie powyższe sprawdzenia nadal działają.

Katalog produktów

Gdy Base.com jest podłączony, możesz dodać jego katalog do Bazy wiedzy. Konrado czyta Twoje katalogi Base.com (magazyny) i przechowuje jeden dokument na każdy produkt:

Importowane są wszystkie katalogi, chyba że wybierzesz niektóre w ustawieniach źródła, na przykład żeby pominąć katalog testowy albo hurtowy. Dla sklepu WooCommerce możesz podać adres sklepu. Wtedy każdy produkt prowadzi do swojej strony w Twoim sklepie.

Katalog synchronizuje się co noc. Ceny i dostępność to stan z ostatniej synchronizacji i Konrado tak je przedstawia. Produkty z zerowym stanem też są importowane i oznaczone jako niedostępne. Dzięki temu Konrado może powiedzieć "tak, ale nie w tej chwili" zamiast "tego nie sprzedajemy".

Czego Konrado nie potrafi

Wyszukiwanie zamówień obsługuje anonimowych odwiedzających, więc chroni każde zamówienie tak:

• Zamówienie pojawia się tylko wtedy, gdy ma podany numer oraz jego własny adres e-mail lub numer telefonu zgadza się z tym, co wpisał odwiedzający. Numer telefonu musi mieć co najmniej 9 cyfr. Prefiks kraju jest w porządku.
• Nieudane wyszukiwanie daje tę samą odpowiedź dla "nie ma takiego zamówienia" i "to nie Twoje zamówienie", więc czat nigdy nie potwierdza, że dany numer zamówienia istnieje.
• Po 3 nieudanych wyszukiwaniach w jednej rozmowie wyszukiwanie się zatrzymuje, a Konrado kieruje odwiedzającego do Twojego zespołu.
• Wynik dotyczący zamówienia nie przechodzi do dalszych wiadomości w rozmowie.
• Konrado czyta tylko stałą listę pól zamówienia i produktu, a resztę pomija.

Konrado korzysta z tych metod API Base.com. Tylko setOrderFields zapisuje dane i tylko po to, żeby dodać notatkę zatwierdzoną przez klienta:

Daj dostęp tylko do tych metod

Bez notatek do zamówień najprostszym bezpiecznym wyborem jest Read (Odczyt). To uprawnienie obejmuje wszystkie metody odczytu na Twoim koncie. Full (Pełny) też działa, ale pozwala tokenowi zmienić wszystko na Twoim koncie. Jeśli używasz notatek do zamówień albo chcesz dać mniej niż pełny odczyt, przy tworzeniu tokenu wybierz Selected methods (Wybrane metody) i zaznacz dokładnie te 16 metod:

getOrders
getOrdersByPhone
getOrderPackages
getOrderPaymentsHistory
getInvoices
getOrderReturns
getOrderStatusList
getInventories
getInventoryProductsList
getInventoryProductsData
getInventoryCategories
getInventoryManufacturers
getInventoryPriceGroups
getExternalStoragesList
getOrderExtraFields
setOrderFields

Pomiń metody katalogu, jeśli chcesz tylko wyszukiwać zamówienia. Pomiń getOrderExtraFields i setOrderFields, jeśli nie używasz notatek do zamówień. Zaznaczaj tylko metody Base.com: base_find_orders i base_add_to_order_konrado_note to nazwy narzędzi czatu Konrado, a Base.com odrzuca je z komunikatem Invalid API method (Nieprawidłowa metoda API).

Zanim zaczniesz

• Konto właściciela lub administratora w Konrado.
• Konto Base.com z dostępem do My account › API.
• Do wyszukiwania zamówień: czat na stronie zainstalowany na Twojej stronie. Zobacz, jak zainstalować czat.

Utwórz token API w Base.com

Dodaj token

W panelu Base.com otwórz menu konta w prawym górnym rogu i wybierz My account (Moje konto). Otwórz zakładkę API i kliknij Add API token (Dodaj Token API). Wpisz Name (Nazwa), na przykład Konrado.

W sekcji API permissions (Uprawnienia API) wybierz Read (Odczyt) do wyszukiwania zamówień i katalogu. Jeśli chcesz też używać notatek do zamówień, wybierz Selected methods (Wybrane metody) i zaznacz 16 metod. Kliknij Save (Zapisz).

Skopiuj token

Base.com potwierdza, że token został utworzony. Kliknij ikonę kopiowania obok ukrytego tokenu i zapisz wartość w menedżerze haseł.

Base.com pokazuje token tylko raz. Jeśli go zgubisz, usuń go w Base.com i utwórz nowy. Nigdy nie wklejaj tokenu do zgłoszenia, na zrzut ekranu ani do dokumentu.

Sprawdź listę tokenów

Token pojawia się w tabeli API tokens (Tokeny API) razem z uprawnieniami. W sekcji API call logs (Logi wywołań API) pod tabelą widać każdą metodę, z której korzysta Konrado.

Podłącz Base.com

Wypełnij formularz

Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację, wybierz E-commerce, a potem Base.com. Wpisz nazwę w polu Nazwa integracji, na przykład Main store, i wklej token w pole Token API.

Przetestuj i podłącz

Kliknij Testuj połączenie. Udany test pokazuje komunikat Połączono pomyślnie!. Kliknij Podłącz.

Wybierz, kto może dodawać notatki

Zakładka Narzędzia pokazuje dwa narzędzia. Gdy Base.com jest podłączony, narzędzie Wyszukiwanie zamówień (base_find_orders) jest dostępne dla każdego agenta. Narzędzie Dodanie notatki do zamówienia (base_add_to_order_konrado_note) ma status Wyłączone, dopóki go nie klikniesz i nie wybierzesz agentów. Jego przełącznik Poproś klienta o zatwierdzenie jest na początku włączony. Gdy go wyłączasz, musisz to potwierdzić przyciskiem Wyłącz zatwierdzanie.

Sprawdź, czy działa

W tabeli Base.com ma status Połączono. Na czacie na stronie zapytaj o prawdziwe zamówienie, podając jego numer i e-mail z zamówienia. Konrado odpowie, podając status zamówienia.

Aby później przetestować połączenie, otwórz menu wiersza (...), kliknij Zarządzaj, a potem Testuj połączenie. Pole tokenu pokazuje tylko końcówkę tokenu. Kliknij Zmień tylko wtedy, gdy chcesz zmienić token.

Dodaj katalog produktów

1. Otwórz Ustawienia obszaru roboczegoBaza wiedzy, kliknij Dodaj źródło i wybierz Produkty.
2. W sekcji Twoje platformy kliknij Base.com, a potem Dodaj katalog.

Jeśli Base.com jest w sekcji Podłącz platformę z przyciskiem Podłącz, nie jest jeszcze podłączony. Po pierwszej synchronizacji źródło pojawia się na liście jako Katalog produktów, z liczbą produktów. Otwórz je, aby przeglądać produkty w zakładce Zawartość. Zakładka Ustawienia zawiera:

Reaguj na notatki w Base.com

Konrado nie prowadzi Twojej obsługi zamówień. Aby od razu zareagować na notatkę, na przykład dodać pozycję za 0 PLN, wysłać e-mail do klienta albo zmienić status, utwórz automatyczną akcję we własnym panelu Base.com. W Konrado niczego nie ustawiasz.

Base.com uruchamia automatyczne akcje, gdy pole dodatkowe zamówienia zmienia się przez API. Dzięki temu każda notatka w polu Konrado może w kilka sekund uruchomić akcję. Przejdź do Orders › Automatic actions (Zamówienia › Automatyczne akcje) i dodaj akcję:

Pole Konrado zapisuje tylko Konrado, więc samo zdarzenie oznacza nową notatkę.

Jeśli coś nie działa

Usuń integrację

1. Usuń z Bazy wiedzy źródło Katalog produktów, jeśli było dodane.
2. Otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza Base.com (...) i kliknij Usuń.
3. W Base.com usuń token w My account › API.