> ## Documentation Index
> Fetch the complete documentation index at: https://pomoc.wenetasystent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integracja z Firmao

> Jak połączyć Asystent AI z systemem Firmao CRM, aby chatbot mógł wymieniać dane z Twoją bazą klientów.

## Co daje integracja z Firmao

Po połączeniu Asystenta AI z Twoim systemem Firmao CRM **dane klientów zebrane podczas rozmowy** trafiają automatycznie jako nowe rekordy do Twojego CRM-a. Koniec z ręcznym przepisywaniem leadów.

<Note>
  Integracja zaczyna działać dopiero po pomyślnym przetestowaniu połączenia. Do tego momentu nowe leady nie są wysyłane do Firmao.
</Note>

## Czego potrzebujesz

* Aktywne konto w Firmao CRM z dostępem do sekcji **Integracje → API**
* Aktywne konto w Asystent AI z uprawnieniami administratora
* Login API i hasło API (token) wygenerowane w Firmao
* ID organizacji (fragment adresu URL po zalogowaniu do Firmao, np. `system.firmao.pl/`**`nazwa-firmy`**`/...`)

## Krok 1 — Otwórz ustawienia integracji w panelu Asystent AI

<Steps>
  <Step title="Zaloguj się do panelu">
    Wejdź na [app.wenetasystent.ai](https://app.wenetasystent.ai) i zaloguj się na konto administratora.
  </Step>

  <Step title="Przejdź do Ustawień">
    W menu po lewej stronie kliknij ikonę **koła zębatego** (Ustawienia).
  </Step>

  <Step title="Otwórz zakładkę Integracje">
    W górnym menu ustawień wybierz zakładkę **Integracje**. Znajdziesz tam kartę **Firmao CRM** — pozostaw ją otwartą, w następnym kroku wypełnisz pola **Login API**, **Hasło API** i **ID organizacji**.
  </Step>
</Steps>

## Krok 2 — Pobierz dane dostępowe z Firmao

<Steps>
  <Step title="Zaloguj się do Firmao CRM">
    Otwórz Firmao w nowej karcie przeglądarki i zaloguj się na swoje konto.
  </Step>

  <Step title="Przejdź do Integracje → API">
    W menu bocznym kliknij **Integracje**, a następnie z rozwiniętej listy wybierz **API**.
  </Step>

  <Step title="Skopiuj Login API">
    W sekcji **Klucz API użytkownika** znajdziesz pole **Login API**. To zazwyczaj Twój adres e-mail używany w Firmao. Skopiuj go.
  </Step>

  <Step title="Pokaż i skopiuj Hasło API">
    Kliknij niebieski przycisk **Pokaż hasło API**. Skopiuj wyświetlony token — to będzie Twoje hasło API w Asystent AI.
  </Step>
</Steps>

<Warning>
  Token API traktuj jak hasło — nie udostępniaj go osobom trzecim i nie wklejaj do publicznych dokumentów ani zgłoszeń. Jeśli token wycieknie, wygeneruj nowy w Firmao.
</Warning>

## Krok 3 — Dokończ konfigurację w Asystent AI

<Steps>
  <Step title="Wklej Login API">
    Wróć do karty z panelem Asystent AI. W polu **Login API** wklej login skopiowany z Firmao (zazwyczaj w formacie `nazwafirmy.api@firmao.pl`).
  </Step>

  <Step title="Wklej Hasło API">
    W polu **Hasło API** wklej skopiowany token.
  </Step>

  <Step title="Uzupełnij ID organizacji">
    W polu **ID organizacji** wpisz fragment adresu URL z Firmao — np. dla `system.firmao.pl/moja-firma/...` ID organizacji to `moja-firma`. Jeśli login był w formacie `nazwafirmy.api@firmao.pl`, pole zostanie wypełnione automatycznie.
  </Step>

  <Step title="Zapisz ustawienia">
    Kliknij **Zapisz**, aby zatwierdzić dane dostępowe.
  </Step>

  <Step title="Przetestuj połączenie">
    Kliknij **Testuj połączenie**. Jeśli dane są poprawne, zobaczysz potwierdzenie „Połączenie z Firmao działa poprawnie". Następnie włącz integrację suwakiem w prawym górnym rogu karty.
  </Step>
</Steps>

<Tip>
  Po włączeniu suwaka każda rozmowa, w której klient zostawi dane kontaktowe, automatycznie trafia jako nowy rekord do Firmao.
</Tip>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Test połączenia kończy się błędem">
    * Upewnij się, że skopiowany Login API i Hasło API nie zawierają dodatkowych spacji na początku ani na końcu.
    * Sprawdź, czy konto użytkownika w Firmao ma uprawnienia do API — w razie wątpliwości skontaktuj się z administratorem Firmao.
    * Wygeneruj ponownie token w Firmao (przycisk **Pokaż hasło API**) i wklej świeżą wartość.
  </Accordion>

  <Accordion title="Połączenie działa, ale dane z CRM się nie pojawiają">
    * Po zapisaniu integracji odśwież panel Asystent AI.
    * Sprawdź w Firmao, czy konto API ma dostęp do tych obiektów (klientów, zamówień), o które pyta chatbot.
    * Jeśli problem się utrzymuje, napisz na [pomoc@wenetasystent.ai](mailto:pomoc@wenetasystent.ai).
  </Accordion>

  <Accordion title="Chcę wyłączyć integrację">
    Wróć do **Ustawienia → Zaawansowane → Integracje CRM** i przesuń suwak przy **Firmao CRM** w pozycję wyłączoną, a następnie zapisz zmiany. Dane dostępowe zostaną usunięte z panelu.
  </Accordion>
</AccordionGroup>