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
- FLOWii z płatną licencją – licencja FREE nie ma API.
- Administratora FLOWii – tylko on ustawi użytkownikowi prawa dostępu.
- W draften właściciela lub menedżera organizacji.
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
- 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ł.
- 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).
- 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
- 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ą.
- 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).
- 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ń.
- 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 komunikacie | Co to znaczy | Co zrobić |
|---|---|---|
the login, the password or the API key was refused | FLOWii nie przyjął e-maila, hasła albo klucza API | sprawdzić wszystkie trzy dane; użytkownik musi być aktywny, a licencja płatna |
the login reaches N companies - set the company's id on the connection | użytkownik widzi kilka firm | uzupełnić ID firmy według wyniku testu |
the login does not reach company … | użytkownik nie widzi firmy o podanym ID | poprawić ID albo udostępnić użytkownikowi firmę |
the login reaches no company | użytkownik nie widzi żadnej firmy | przypisać użytkownika do firmy |
the user of the login may not read this (403) | użytkownik nie może czytać modułu | ustawić Prohlížení przy potrzebnych modułach |
FLOWii rate limit reached (429) | wyczerpany dzienny limit wywołań API | spróbować później |