Dla administratorów
← Wszystkie tematy

FLOWii: podłączenie

Użytkownik z możliwie najwęższymi uprawnieniami i klucz API we FLOWii oraz połączenie w draften, krok po kroku.

Asystent czyta z FLOWii, kto do niego pisze: kontakt i partnera, sprawy handlowe, zamówienia oraz zdarzenia i zadania. Do FLOWii nigdy nic nie zapisuje. Co dokładnie może czytać, ustalasz osobno dla każdej skrzynki. Jak połączenia działają w draften ogólnie, opisuje strona Integracje.

Czego potrzebujesz

W FLOWii

FLOWii loguje się przez API e-mailem i hasłem użytkownika, a do tego kluczem API. draften potrzebuje więc hasła użytkownika – dlatego utwórz dla asystenta osobnego użytkownika z możliwie najwęższymi uprawnieniami, a nie konto człowieka.

Użytkownik z możliwie najwęższymi uprawnieniami

  1. Otwórz Firma → Uživatelé (Użytkownicy) → Nový uživatel (Nowy użytkownik). Wypełnij imię, nazwisko i e-mail logowania – zapamiętaj go, draften będzie go potrzebował.
  2. Otwórz nowego użytkownika → zakładka Přístupová práva (Prawa dostępu). Przy modułach, które asystent ma czytać, wybierz Prohlížení (Przeglądanie), przy wszystkich pozostałych Zakázaný (Zabroniony):
    • Partneři (Partnerzy) – kontakt i partner,
    • Obchodní případy (Sprawy handlowe),
    • Zakázky (Zamówienia),
    • Události (Zdarzenia) i Úlohy (Zadania).
  3. Użytkownik musi być aktywny i mieć ustawione hasło. Aktywuje go administrator; hasło użytkownik ustawi przy pierwszym logowaniu. Każdy użytkownik to w FLOWii płatna licencja.

Te same prawa możesz zapisać jako profil i używać go ponownie: koło zębate w górnym menu → Nastavení (Ustawienia) → Přístupová práva → Profily (Profile) → Nový profil (Nowy profil); przy użytkowniku wybierzesz go potem w polu Profil.

Klucz API

Koło zębate w górnym menu → Nastavení → Rozšíření (Rozszerzenia) → API → FLOWii REST API. Wyświetli się API klíč (Klucz API) – skopiuj go.

ID firmy

Tylko gdy logowanie użytkownika obejmuje kilka firm. ID nie musisz szukać: test połączenia w draften wypisze firmy razem z ich ID.

W draften

  1. Otwórz Organizacja → Integracje i na karcie Integracje wypełnij:
    • System – FLOWii,
    • Nazwa – np. FLOWii – sprzedaż,
    • E-mail logowania użytkownika – e-mail użytkownika z poprzedniego kroku,
    • ID firmy (opcjonalnie) – puste, jeśli użytkownik widzi tylko jedną firmę,
    • Hasło użytkownika i Klucz API.

    Kliknij Dodaj połączenie. Hasło i klucz zostaną zapisane w postaci zaszyfrowanej i nigdy więcej się nie wyświetlą.

  2. W wierszu połączenia otwórz menu ⋯ → Przetestuj połączenie. Po chwili pojawi się „Połączenie działa (…), konto …” z nazwą firmy. Gdy użytkownik widzi kilka firm, test napisze „Logowanie obejmuje te firmy – wpisz ID właściwej w pole „ID firmy””; uzupełnij ID i powtórz test. Moduły, których użytkownik czytać nie może, test wypisze pod „Niedostępne z tym tokenem:” (nazwy modułów są po słowacku, tak jak zwraca je FLOWii).
  3. W sekcji Które skrzynki mogą używać połączenia kliknij przy skrzynce Nadaj, zaznacz, co asystent może czytać, i kliknij Zapisz uprawnienie:
    • Kontakt i partner,
    • Sprawy handlowe, a pod nimi Oczekiwane przychody,
    • Zamówienia,
    • Zdarzenia i zadania, a pod nimi Notatki do zdarzeń.
  4. Edytor asystenta dodaje potem w Ustawieniach asystenta → Wiedza źródło rodzaju system zewnętrzny i wybiera, co asystent faktycznie czyta – zobacz Podłączenie CRM i innych systemów.

Gdy użytkownikowi zmieni się hasło, połączenie przestanie działać. Nowe hasło wpisz przy połączeniu w pola pod Nowy sekret dostępowy (hasło i klucz API) i kliknij Wymień; potem znowu Przetestuj połączenie.

Błędy testu połączenia

Komunikat testu jest po angielsku, bezpośrednio od FLOWii albo od draften:

W komunikacieCo to znaczyCo zrobić
the login, the password or the API key was refusedFLOWii nie przyjął e-maila, hasła albo klucza APIsprawdzić wszystkie trzy dane; użytkownik musi być aktywny, a licencja płatna
the login reaches N companies - set the company's id on the connectionużytkownik widzi kilka firmuzupełnić ID firmy według wyniku testu
the login does not reach company …użytkownik nie widzi firmy o podanym IDpoprawić ID albo udostępnić użytkownikowi firmę
the login reaches no companyużytkownik nie widzi żadnej firmyprzypisać użytkownika do firmy
the user of the login may not read this (403)użytkownik nie może czytać modułuustawić Prohlížení przy potrzebnych modułach
FLOWii rate limit reached (429)wyczerpany dzienny limit wywołań APIspróbować później

Wersja tekstowa