---
title: "Narzędzia MCP Requiply"
description: "Wszystkie narzędzia, które może wywołać asystent połączony z Requiply: orientacja i instrukcje, rekordy, rezerwacje i sprzedaż, dostępność i ceny, rozmowy, komentarze, raporty i konfiguracja."
canonical_url: "https://requiply.com/docs/pl/ai/mcp/tools"
---
# Narzędzia MCP Requiply

> Wszystkie narzędzia, które może wywołać asystent połączony z Requiply: orientacja i instrukcje, rekordy, rezerwacje i sprzedaż, dostępność i ceny, rozmowy, komentarze, raporty i konfiguracja.

To narzędzia, które serwer MCP Requiply udostępnia [połączonemu asystentowi](https://requiply.com/docs/pl/ai/mcp/connecting). Narzędzia tylko do odczytu można wywoływać bez ograniczeń. Każde narzędzie, które coś zmienia, najpierw pokazuje podgląd i zapisuje zmiany dopiero po Twoim potwierdzeniu. Przykłady ich użycia znajdziesz w [Zastosowaniach](https://requiply.com/docs/pl/ai/mcp/use-cases).

## Jak asystent pracuje z Requiply

Requiply udostępnia niewielki, spójny zestaw narzędzi. Poniższe narzędzia pozwalają asystentowi zorientować się w sytuacji, zanim zajmie się danymi:

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Co robi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          whoami
        </code>
      </strong>
    </td>
    
    <td>
      Zwraca profil firmy (waluta, język, strefa czasowa, godziny pracy i dni wolne, oddziały, opcje płatności i dostawy), informację, w czyim imieniu działa asystent, macierz dostępu dla każdego typu obiektu oraz pracowników z ich grupami uprawnień. Asystenci wywołują je jako pierwsze w rozmowie.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          describe
        </code>
      </strong>
    </td>
    
    <td>
      Odkrywanie schematu. Wymienia typy obiektów dostępne dla połączenia, sekcje ustawień i tematy instrukcji. Dla jednego typu obiektu zwraca pola, filtry, aktualne wartości, takie jak statusy rezerwacji czy kategorie, Twoje <a href="https://requiply.com/docs/pl/guides/settings/fields/entity-fields">
        pola dodatkowe
      </a>
      
       rezerwacji, klientów i grup pozycji oraz pola, według których <code>
        objects_query
      </code>
      
       może filtrować i grupować. Dla sekcji ustawień zwraca pola tej sekcji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          get_guidance
        </code>
      </strong>
    </td>
    
    <td>
      Zwraca szczegółowe instrukcje do zadania: każde makro obsługiwane przez Twoją organizację (w tym Twoje pola dodatkowe), zasady formatu szablonów, struktury wyzwalaczy i akcji automatyzacji z gotowymi przepisami, operatory filtrów, katalog raportów, język zapytań i mapę stron aplikacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          get_profile
        </code>
      </strong>
    </td>
    
    <td>
      Zwraca konto Requiply, na które loguje się połączenie: imię i nazwisko, e-mail i organizację. Tylko w połączeniach zalogowanych jako członek zespołu.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          search_help
        </code>
      </strong>
    </td>
    
    <td>
      Przeszukuje tę bazę wiedzy pod kątem tego, jak działa Requiply i jak coś skonfigurować, oraz czyta całą stronę. Asystent podaje strony, z których skorzystał.
    </td>
  </tr>
</tbody>
</table>

Makra i struktury automatyzacji pochodzą z narzędzi, a nie z pamięci asystenta, więc szablon przygotowany przez asystenta używa dokładnie tych makr, które ma Twoja organizacja.

**get_guidance** przyjmuje jeden lub kilka z tych tematów:

<table>
<thead>
  <tr>
    <th>
      Temat
    </th>
    
    <th>
      Czego dotyczy
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        getting_started
      </code>
    </td>
    
    <td>
      Jak narzędzia ze sobą współpracują i zasada „najpierw podgląd, potem potwierdzenie” przy zapisie.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        booking_rules
      </code>
    </td>
    
    <td>
      Godziny pracy, bufory, status zapytania oraz to, co zapytanie o rezerwację robi, a czego nie robi.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        email_template_macros
      </code>
    </td>
    
    <td>
      Każde <code>
        {{macro}}
      </code>
      
       dostępne w szablonach e-maili, w tym Twoje pola dodatkowe.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        message_template_macros
      </code>
    </td>
    
    <td>
      Makra i zasady formatu szablonów wiadomości SMS, Viber i Telegram.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        export_template_macros
      </code>
    </td>
    
    <td>
      Makra i składnia kolumn tabel w szablonach dokumentów PDF.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        template_conditionals
      </code>
    </td>
    
    <td>
      Bloki <code>
        {{#if}}
      </code>
      
       i zachowanie pustych wartości.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow_recipes
      </code>
    </td>
    
    <td>
      Struktury wyzwalaczy i akcji z gotowymi przepisami automatyzacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow_filters
      </code>
    </td>
    
    <td>
      Nazwy właściwości filtrów, operatory i formaty wartości w automatyzacjach.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reports_catalog
      </code>
    </td>
    
    <td>
      Który raport odpowiada na które pytanie biznesowe i jakie ma parametry.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        query_language
      </code>
    </td>
    
    <td>
      Składnia <strong>
        <code>
          objects_query
        </code>
      </strong>
      
      : pola, operatory, daty, grupowanie i omówione przykłady.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        app_navigation
      </code>
    </td>
    
    <td>
      Każda strona aplikacji webowej Requiply ze ścieżką w menu i linkiem, do pytań typu „gdzie znajdę” i „jak to zrobić”.
    </td>
  </tr>
</tbody>
</table>

## Rekordy

Rekordy odczytuje się dwoma ogólnymi narzędziami, a zmienia narzędziem zapisu przeznaczonym dla danego typu. Argument `objectType` wybiera, z czym pracujesz. Każdy rekord, który ma stronę w Requiply, zawiera `url`, który ją otwiera, i asystenci podają linki do rekordów właśnie przez niego.

<table>
<thead>
  <tr>
    <th>
      Typ obiektu
    </th>
    
    <th>
      Odczyt
    </th>
    
    <th>
      Zapis
    </th>
    
    <th>
      Uwagi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        booking
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          bookings_manage
        </code>
      </strong>
      
      ; pola dodatkowe przez <strong>
        <code>
          objects_manage
        </code>
      </strong>
    </td>
    
    <td>
      Wyszukiwanie zwraca uproszczone wiersze, a get pełne pozycje, usługi, płatności i pola dodatkowe. Numer rezerwacji widoczny dla użytkownika to <code>
        reservationOrgId
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        client
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tworzenie, aktualizacja, pola dodatkowe
    </td>
    
    <td>
      Dokładne wyszukiwanie po e-mailu lub telefonie, wyszukiwanie przybliżone po nazwie. Tworzenie zabezpiecza przed duplikatami. Tworzenie i aktualizacja przyjmują <code>
        customFields
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        item_group
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tylko pola dodatkowe
    </td>
    
    <td>
      Pozycje do wynajęcia ze stanem, cenami, progami cenowymi, polami dodatkowymi i dostępnością w wybranym okresie. Same pozycje edytuje się w aplikacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        sale_item
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      Towary na sprzedaż (<a href="https://requiply.com/docs/pl/guides/sales">
        Sprzedaż
      </a>
      
      ): nazwa, SKU, kod kreskowy, kategoria, cena sprzedaży, stan na magazynie (może być ujemny), sprzedaż z ostatnich 30 dni. <code>
        purchaseCost
      </code>
      
       tylko dla kont z uprawnieniem <strong>
        Zezwalaj na zarządzanie stanem magazynowym
      </strong>
      
      . Wymaga włączonej sprzedaży i uprawnienia do sprzedaży.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        sale
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          sales_manage
        </code>
      </strong>
    </td>
    
    <td>
      Sprzedaż towarów, samodzielna lub w ramach rezerwacji, od najnowszej. Filtry: <code>
        kind
      </code>
      
       (samodzielna lub w rezerwacji), <code>
        status
      </code>
      
      , <code>
        unpaid
      </code>
      
      , <code>
        clientId
      </code>
      
      , <code>
        soldFrom
      </code>
      
      , <code>
        soldTo
      </code>
      
      . Get zwraca pozycje, zwroty i płatności. Numer widoczny dla użytkownika to <code>
        saleOrgId
      </code>
      
      . Przekaż <code>
        idKind="org"
      </code>
      
      , aby pobrać sprzedaż po tym numerze.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        category
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tworzenie, aktualizacja
    </td>
    
    <td>
      Kategorie pozycji, zagnieżdżane przez <code>
        parentId
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        service
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tworzenie, aktualizacja
    </td>
    
    <td>
      Usługi dodatkowe. Zamiast usuwać, archiwizuj.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        location
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Tworzenie, aktualizacja
    </td>
    
    <td>
      Oddziały wydania i zwrotu.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reservation_status
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      Statusy rezerwacji, używane do ustalania identyfikatorów w automatyzacjach i filtrach.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        email_template
      </code>
      
      , <code>
        message_template
      </code>
      
      , <code>
        export_template
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          templates_manage
        </code>
      </strong>
    </td>
    
    <td>
      Na liście bez treści, treść zwraca get. <strong>
        <code>
          templates_preview
        </code>
      </strong>
      
       wyświetla szablon na danych wybranej rezerwacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          workflows_manage
        </code>
      </strong>
    </td>
    
    <td>
      Na liście z czytelnym podsumowaniem wyzwalacza i akcji, get zwraca pełną konfigurację.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        bundle
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Nie
    </td>
    
    <td>
      <a href="https://requiply.com/docs/pl/guides/inventory/bundles">
        Zestawy
      </a>
      
      , które można zarezerwować, z ich pozycjami i rabatem. Przekaż daty do wyszukiwania, aby sprawdzić, ile kompletów jest wolnych. Zestawy tworzy się i edytuje w aplikacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        conversation
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          conversations_manage
        </code>
      </strong>
    </td>
    
    <td>
      <a href="https://requiply.com/docs/pl/guides/conversations/inbox">
        Skrzynka rozmów
      </a>
      
      , od najnowszych: kanał, kontakt, powiązany klient, kto teraz odpowiada (AI czy człowiek), właściciel, status i liczba nieprzeczytanych. Filtry: <code>
        view
      </code>
      
       (<code>
        needs_human
      </code>
      
      , <code>
        mine
      </code>
      
      , <code>
        ai
      </code>
      
      , <code>
        closed
      </code>
      
      ), <code>
        period
      </code>
      
       (<code>
        today
      </code>
      
      , <code>
        week
      </code>
      
      ), <code>
        channel
      </code>
      
      . Get zwraca najnowsze wiadomości i informację, czy na tym kanale można jeszcze wysłać odpowiedź.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        comment
      </code>
    </td>
    
    <td>
      Tak
    </td>
    
    <td>
      Przez <strong>
        <code>
          comments_manage
        </code>
      </strong>
    </td>
    
    <td>
      <a href="https://requiply.com/docs/pl/guides/conversations/comments">
        Komentarze
      </a>
      
       do rezerwacji, klienta, egzemplarza lub zadania. Wyszukiwanie wymaga <code>
        entityType
      </code>
      
       i <code>
        entityId
      </code>
      
       (wątek jednego rekordu) albo <code>
        mentionsMe=true
      </code>
      
       (komentarze, w których oznaczono Ciebie, w połączeniach członków zespołu). Wpisy systemowe są pomijane, chyba że podasz <code>
        includeSystem=true
      </code>
      
      .
    </td>
  </tr>
</tbody>
</table>

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Co potrafi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
    </td>
    
    <td>
      Wyświetla lub przeszukuje jeden typ obiektu z tekstem w <code>
        query
      </code>
      
      , typowanymi <code>
        filters
      </code>
      
       (daty, nazwy statusów, identyfikator klienta, kategoria, okres dostępności, widok skrzynki) i stronicowaniem kursorowym.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_get
        </code>
      </strong>
    </td>
    
    <td>
      Pobiera do 20 rekordów po identyfikatorze ze wszystkimi szczegółami, w tym z polami dodatkowymi rezerwacji, klientów i grup pozycji. W przypadku rezerwacji i sprzedaży <code>
        idKind="org"
      </code>
      
       przyjmuje numer widoczny w aplikacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_query
        </code>
      </strong>
    </td>
    
    <td>
      Odpowiada na pytania z filtrowaniem i grupowaniem dotyczące rezerwacji, klientów, grup pozycji i sprzedaży za pomocą RQL (Requiply Query Language), zapytania w formacie JSON: warunki łączone przez AND i OR na dowolnym polu, w tym na kliencie, statusie, pozycjach i ich kategorii, saldzie do zapłaty i polach dodatkowych. Zwraca pasujące rekordy z linkami albo po jednym wierszu na grupę z liczbą, sumami, średnimi i medianami, na przykład przychód w poszczególnych miesiącach. Tylko do odczytu. Sumy kwot wymagają <strong>
        dostępu do raportów
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_manage
        </code>
      </strong>
    </td>
    
    <td>
      Tworzy lub aktualizuje klienta, kategorię, usługę lub oddział oraz ustawia wartości pól dodatkowych w istniejącej rezerwacji, kliencie lub grupie pozycji (<code>
        set_custom_fields
      </code>
      
      ). Wymaga odpowiedniego uprawnienia: <strong>
        Zezwalaj na zarządzanie klientami
      </strong>
      
       dla klientów, <strong>
        Zezwalaj na zarządzanie sprzętem
      </strong>
      
       dla kategorii i pól dodatkowych grup pozycji, <strong>
        Zezwalaj na zarządzanie usługami
      </strong>
      
       dla usług, <strong>
        Zezwalaj na zarządzanie rezerwacjami
      </strong>
      
       dla pól dodatkowych rezerwacji i <strong>
        Zezwalaj na dostęp do ustawień
      </strong>
      
       dla oddziałów.
    </td>
  </tr>
</tbody>
</table>

<note>

**Którego narzędzia odczytu używa asystent.** `objects_search` znajduje rekordy po nazwie, numerze lub kilku stałych filtrach. `reports_run` odpowiada standardowymi raportami biznesowymi. `objects_query` obsługuje pytania pomiędzy nimi, takie jak „rezerwacje w lipcu z dronem, które nadal nie są opłacone” albo „klienci z co najmniej trzema rezerwacjami, którzy nie rezerwowali od czerwca”. Przed pierwszym zapytaniem asystenci czytają temat instrukcji `query_language`.

</note>

## Narzędzia rezerwacji, sprzedaży, dostępności i cen

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Co potrafi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          availability_check
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        mode="items"
      </code>
      
       zwraca grupy pozycji, w których co najmniej jeden egzemplarz jest wolny przez cały okres. <code>
        mode="calendar"
      </code>
      
       zwraca liczby dla każdej grupy pozycji dzień po dniu.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          pricing_quote
        </code>
      </strong>
    </td>
    
    <td>
      Oblicza dokładną wycenę na podstawie wybranych grup pozycji, zestawów, usług, dat wynajmu, progów cenowych i opcjonalnego rabatu klienta. Data bez godziny jest wyceniana od godziny otwarcia do godziny zamknięcia, a wynik podaje daty, których użyto.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          sales_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        create
      </code>
      
       rejestruje samodzielną sprzedaż towarów po cenie katalogowej, z opcjonalnym klientem (po identyfikatorze albo po nazwie z e-mailem lub telefonem) i metodą płatności. Podgląd pokazuje pozycje, sumę, ostrzeżenia o stanie magazynowym (stan może spaść poniżej zera, sprzedaż i tak jest dozwolona) oraz to, czy metoda płatności działa. Potwierdzone wywołanie rejestruje sprzedaż i zwraca link do płatności dla metod online. Wymaga uprawnienia <strong>
        Zezwalaj na sprzedaż towarów
      </strong>
      
      . Zwroty, anulowanie, edycję pozycji i oznaczanie płatności jako opłaconych wykonuje się w aplikacji.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          bookings_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        create_request
      </code>
      
       tworzy szkic rezerwacji w statusie ustawionym w <strong>
        Status zapytań o rezerwację
      </strong>
      
       Twojej organizacji (<em>
        Zapytanie
      </em>
      
      , chyba że zmieniono to w <a href="https://requiply.com/docs/pl/guides/settings/bookings/booking-creation#wyb%C3%B3r-status%C3%B3w-pocz%C4%85tkowych">
        Tworzenie rezerwacji
      </a>
      
      ). Wywołanie podglądu sprawdza dostępność, wycenia sprzęt i zwraca podsumowanie, a potwierdzone wywołanie tworzy zapytanie. Przyjmuje <code>
        customFields
      </code>
      
       rezerwacji z kluczami pól, które podaje <strong>
        <code>
          describe
        </code>
      </strong>
      
      . <code>
        add_note
      </code>
      
       dodaje do rezerwacji wewnętrzną notatkę widoczną tylko dla pracowników. Pracownicy, których grupa uprawnień ma <strong>
        Zezwalaj na rezerwacje poza godzinami pracy
      </strong>
      
      , mogą poprosić o wydanie lub zwrot poza godzinami pracy, a narzędzie przekazuje dla nich <code>
        allowOutsideWorkingHours
      </code>
      
      . Pracownicy, których grupa ma <strong>
        Zezwalaj na korekty kosztu i kaucji
      </strong>
      
      , mogą też przekazać jedną korektę <code>
        adjustment
      </code>
      
       (<code>
        units
      </code>
      
      , <code>
        percent
      </code>
      
       lub <code>
        amount
      </code>
      
      , ze znakiem), zobacz <a href="https://requiply.com/docs/pl/guides/bookings/changing/cost-adjustment#przez-api-i-asystenta-ai">
        Korekta kosztu rezerwacji
      </a>
      
      . Pracownicy z uprawnieniem <strong>
        Zezwalaj na sprzedaż towarów
      </strong>
      
       mogą przekazać <code>
        saleLines
      </code>
      
      , aby sprzedać towary razem z rezerwacją po cenie katalogowej: podgląd pokazuje je jako <code>
        saleSubtotal
      </code>
      
      , wliczone w sumę i nigdy nie objęte rabatem, a ich stan magazynowy spada po utworzeniu zapytania. Zapytanie może też zawierać <code>
        bundles
      </code>
      
      , rezerwowane jako ich pozycje z rabatem zestawu.
    </td>
  </tr>
</tbody>
</table>

Zapytanie o rezerwację nigdy nie blokuje sprzętu i nie pobiera płatności. Pracownik zatwierdza je w aplikacji, a zatwierdzenie ponownie sprawdza dostępność. Zmiany statusu, płatności i edycję pozycji w istniejącej rezerwacji wykonuje się w aplikacji.

**Daty i godziny są w Twoim czasie lokalnym.** Asystenci przekazują daty i godziny bez strefy czasowej, na przykład `2026-10-06T10:00:00`, a Requiply odczytuje je w strefie czasowej organizacji z [ustawień daty i godziny](https://requiply.com/docs/pl/guides/settings/organization/date-and-time), z uwzględnieniem czasu letniego. Data bez godziny, taka jak `2026-10-06`, oznacza godzinę otwarcia dla wydania i godzinę zamknięcia dla zwrotu. Wartości z własnym przesunięciem, takie jak `2026-10-06T10:00:00+03:00`, są używane bez zmian.

**Godziny pracy są sprawdzane w podglądzie.** Gdy żądane wydanie lub zwrot przypada na dzień zamknięcia albo poza godzinami pracy, podgląd informuje o tym w `workingHours`, podając najbliższy dzień pracy lub dozwolony przedział, a asystent nie prosi o potwierdzenie. Zamiast tego proponuje inny termin.

**Każda reguła biznesowa jest sprawdzana w podglądzie.** Gdy zapytania nie da się zarezerwować w podanej postaci, podgląd zwraca `bookable: false` i listę `problems`, każdy z kodem, przyczyną i krokiem `nextStep`, który asystent wykonuje, zanim poprosi o potwierdzenie:

<table>
<thead>
  <tr>
    <th>
      Kod
    </th>
    
    <th>
      Znaczenie
    </th>
    
    <th>
      Co asystent robi dalej
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        working_hours
      </code>
    </td>
    
    <td>
      Wydanie lub zwrot w dzień zamknięcia albo poza godzinami pracy.
    </td>
    
    <td>
      Proponuje najbliższy prawidłowy termin.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        minimum_duration
      </code>
    </td>
    
    <td>
      Krócej niż <strong>
        Minimalny czas rezerwacji
      </strong>
      
       z <a href="https://requiply.com/docs/pl/guides/settings/bookings/booking-duration">
        Czas trwania rezerwacji
      </a>
      
      .
    </td>
    
    <td>
      Proponuje najwcześniejszy zwrot, który zostanie przyjęty.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        unavailable
      </code>
    </td>
    
    <td>
      Za mało wolnego sprzętu w tych datach.
    </td>
    
    <td>
      Podaje, ile jest wolnych egzemplarzy, i proponuje inne daty, mniejszą ilość albo podobną pozycję.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        not_found
      </code>
    </td>
    
    <td>
      Nie znaleziono pozycji, usługi lub klienta.
    </td>
    
    <td>
      Wyszukuje ponownie albo prosi o dane klienta.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        not_allowed
      </code>
    </td>
    
    <td>
      Twoja grupa uprawnień lub plan nie pozwala na część zapytania.
    </td>
    
    <td>
      Proponuje kontynuowanie bez tej części, na przykład bez korekty.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_request
      </code>
    </td>
    
    <td>
      Coś w zapytaniu jest nieprawidłowe, na przykład zwrot przed wydaniem.
    </td>
    
    <td>
      Poprawia zapytanie i ponownie pokazuje podgląd.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        system_error
      </code>
    </td>
    
    <td>
      Chwilowa awaria.
    </td>
    
    <td>
      Próbuje jeszcze raz.
    </td>
  </tr>
</tbody>
</table>

Problemy są zwracane jako zwykłe odpowiedzi, a nie błędy, więc asystent zawsze mówi, co się stało i co proponuje, zamiast po cichu przerwać pracę. `pricing_quote` i `availability_check` odpowiadają w ten sam sposób: dostępność jest sprawdzana dla dokładnie podanych godzin, z uwzględnieniem buforów rezerwacji.

**Powtórzone „tak” nie tworzy podwójnej rezerwacji.** Jeśli potwierdzisz to samo zapytanie dwa razy w ciągu 30 minut (ten sam klient, daty i sprzęt), drugie wywołanie zwraca numer już utworzonego zapytania, zamiast tworzyć kolejne.

## Rozmowy i komentarze

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Co potrafi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          conversations_manage
        </code>
      </strong>
    </td>
    
    <td>
      Działania w skrzynce w imieniu zalogowanego członka zespołu. <code>
        reply
      </code>
      
       wysyła wiadomość do klienta na jego kanale (Telegram, Instagram, Viber, OLX lub czat na stronie). Członek zespołu staje się właścicielem rozmowy, a asystent AI przestaje w niej odpowiadać. <code>
        update
      </code>
      
       przekazuje rozmowę człowiekowi lub z powrotem AI (<code>
        handler
      </code>
      
      ), zamyka ją lub otwiera ponownie (<code>
        status
      </code>
      
      ) albo ustawia członka zespołu jako właściciela lub usuwa właściciela (<code>
        assign
      </code>
      
      ). Podgląd pokazuje kanał, osobę, obecnego właściciela, to, czy okno odpowiedzi kanału jest nadal otwarte, i ewentualny powód odrzucenia odpowiedzi. Na rozmowę należącą do innego członka zespołu asystent odpowiada tylko wtedy, gdy poprosisz go o jej przejęcie. Wymaga uprawnienia <strong>
        Zezwalaj na dostęp do rozmów
      </strong>
      
       i połączenia zalogowanego jako członek zespołu. Klucze API organizacji nie mogą odpowiadać.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          comments_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        add
      </code>
      
       dodaje wewnętrzny komentarz do rezerwacji, klienta, egzemplarza lub zadania w imieniu zalogowanego członka zespołu (klucz API organizacji dodaje go bez autora). <code>
        mentionUserIds
      </code>
      
       oznacza członków zespołu z <strong>
        <code>
          whoami
        </code>
      </strong>
      
      , którzy dostają powiadomienie push, a <code>
        parentCommentId
      </code>
      
       zamienia komentarz w odpowiedź na inny komentarz w tym samym rekordzie. Klienci nigdy nie widzą tych komentarzy.
    </td>
  </tr>
</tbody>
</table>

## Raporty

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Na co odpowiada
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          reports_run
        </code>
      </strong>
    </td>
    
    <td>
      Jedno narzędzie z argumentem <code>
        report
      </code>
      
      : <code>
        revenue
      </code>
      
      , <code>
        bookings_summary
      </code>
      
      , <code>
        utilization
      </code>
      
      , <code>
        top_items
      </code>
      
      , <code>
        top_clients
      </code>
      
      , <code>
        outstanding
      </code>
      
      , <code>
        overdue
      </code>
      
      , <code>
        pipeline
      </code>
      
       i <code>
        inventory_status
      </code>
      
       (egzemplarze obecnie w wynajmie). Domyślnie obejmuje ostatnie 30 dni. Wymaga <strong>
        dostępu do raportów
      </strong>
      
      .
    </td>
  </tr>
</tbody>
</table>

Na pytania, których nie obejmują standardowe raporty, na przykład przychód w poszczególnych miesiącach dla jednej wartości pola dodatkowego, asystent odpowiada za pomocą **objects_query** (zobacz [Rekordy](#rekordy)).

## Narzędzia konfiguracji

Odczyt i sprawdzanie to osobne narzędzia niż zmiany, więc asystent może przejrzeć Twoją konfigurację, nie proponując żadnych zmian. Narzędzia odczytu działają w każdym połączeniu. Narzędzia zapisu wymagają uprawnienia **Zezwalaj na dostęp do ustawień**, które grupa Administratorzy ma zawsze.

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Odczyt czy zapis
    </th>
    
    <th>
      Co potrafi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          settings_get
        </code>
      </strong>
    </td>
    
    <td>
      Odczyt
    </td>
    
    <td>
      Zwraca bieżące ustawienia jednej sekcji: <code>
        organization
      </code>
      
       (nazwa, opis, dane kontaktowe, język oraz pola dodatkowe na poziomie organizacji), <code>
        working_hours
      </code>
      
       (strefa czasowa i tygodniowy harmonogram), <code>
        booking_rules
      </code>
      
       (wybór dat, minimalny czas, bufory), <code>
        deposits
      </code>
      
       i <code>
        features
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          settings_manage
        </code>
      </strong>
    </td>
    
    <td>
      Zapis
    </td>
    
    <td>
      Aktualizuje jedną sekcję tylko w zmienianych polach i najpierw pokazuje różnicę przed zmianą i po niej. Sekcja <code>
        organization
      </code>
      
       przyjmuje też <code>
        customFields
      </code>
      
      . Funkcje wymagające wyższego planu są zgłaszane jako zablokowane i nie da się ich tu włączyć.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          templates_preview
        </code>
      </strong>
    </td>
    
    <td>
      Odczyt
    </td>
    
    <td>
      Wyświetla szablon e-maila, wiadomości (SMS, Viber, Telegram) lub dokumentu (PDF) na danych prawdziwej rezerwacji bez zapisywania czegokolwiek: zapisany szablon po identyfikatorze albo niezapisany szkic. Zwraca temat, HTML i zwykły tekst oraz wymienia każde makro, którego organizacja nie ma.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          templates_manage
        </code>
      </strong>
    </td>
    
    <td>
      Zapis
    </td>
    
    <td>
      Tworzy, aktualizuje i usuwa szablony e-maili, wiadomości i dokumentów. Podgląd sprawdza poprawność szablonu i wymienia nieznane makra. Usunięcie jest odrzucane, jeśli szablonu nadal używa automatyzacja lub inny szablon.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          workflows_validate
        </code>
      </strong>
    </td>
    
    <td>
      Odczyt
    </td>
    
    <td>
      Sprawdza pełną lub częściową automatyzację bez zapisywania: zamienia identyfikatory statusów i szablonów na nazwy, sprawdza, czy identyfikatory pracowników należą do członków zespołu, czy format szablonu wiadomości pasuje do kanału, i ostrzega, gdy operator wiadomości nie jest połączony.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          workflows_manage
        </code>
      </strong>
    </td>
    
    <td>
      Zapis
    </td>
    
    <td>
      Tworzy, aktualizuje, włącza lub wyłącza (<code>
        set_enabled
      </code>
      
      ) i usuwa automatyzacje. Oprócz akcji e-mail, push i wiadomości do klienta może ustawić <code>
        change_booking_status
      </code>
      
       i <code>
        send_group_push_notification
      </code>
      
      , które wysyła powiadomienia push do <a href="https://requiply.com/docs/pl/guides/settings/organization/accounts/permission-groups">
        grup uprawnień
      </a>
      
       według <code>
        groupIds
      </code>
      
      . <strong>
        <code>
          whoami
        </code>
      </strong>
      
       podaje grupę każdego członka zespołu.
    </td>
  </tr>
</tbody>
</table>

Szablony i automatyzacje wyświetla się i odczytuje za pomocą **objects_search** i **objects_get**, tak jak każdy inny rekord.

## Opinie

<table>
<thead>
  <tr>
    <th>
      Narzędzie
    </th>
    
    <th>
      Co robi
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          send_feedback
        </code>
      </strong>
    </td>
    
    <td>
      Wysyła Twoją opinię o tych narzędziach do zespołu Requiply: narzędzie, które nie zadziałało lub zwróciło błędne dane, coś, czego potrzebujesz, a czego nie potrafi żadne narzędzie, albo pochwałę. Zawiera Twoje własne słowa bez nazw klientów, adresów e-mail i numerów telefonów i niczego nie zmienia w Twojej organizacji.
    </td>
  </tr>
</tbody>
</table>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.