---
title: "Інструменти MCP Requiply"
description: "Усі інструменти, які може викликати асистент, підключений до Requiply: орієнтація та підказки, записи, бронювання й продажі, доступність і ціни, розмови, коментарі, звіти та налаштування."
canonical_url: "https://requiply.com/docs/uk/ai/mcp/tools"
---
# Інструменти MCP Requiply

> Усі інструменти, які може викликати асистент, підключений до Requiply: орієнтація та підказки, записи, бронювання й продажі, доступність і ціни, розмови, коментарі, звіти та налаштування.

Це інструменти, які MCP-сервер Requiply пропонує [підключеному асистенту](https://requiply.com/docs/uk/ai/mcp/connecting). Інструменти лише для читання можна викликати вільно. Кожен інструмент, що щось змінює, спершу показує попередній перегляд і зберігає зміни лише після вашого підтвердження. Як вони працюють на практиці, дивіться в розділі [Сценарії використання](https://requiply.com/docs/uk/ai/mcp/use-cases).

## Як асистент працює з Requiply

Requiply надає невеликий узгоджений набір інструментів. Ці інструменти потрібні, щоб асистент зорієнтувався, перш ніж працювати з даними:

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Що він робить
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          whoami
        </code>
      </strong>
    </td>
    
    <td>
      Повертає профіль бізнесу (валюта, мова, часовий пояс, робочі години й вихідні дні, локації, способи оплати й доставки), відомості про те, від чийого імені діє асистент, матрицю доступу для кожного типу обʼєктів і список співробітників з їхніми групами дозволів. Асистенти викликають його першим у розмові.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          describe
        </code>
      </strong>
    </td>
    
    <td>
      Виявлення схеми. Показує типи обʼєктів, доступні підключенню, розділи налаштувань і теми інструкцій. Для одного типу обʼєктів повертає поля, фільтри, актуальні значення, як-от статуси бронювань чи категорії, ваші <a href="https://requiply.com/docs/uk/guides/settings/fields/entity-fields">
        власні поля
      </a>
      
       бронювань, клієнтів і груп товарів, а також поля, за якими <code>
        objects_query
      </code>
      
       може фільтрувати й групувати. Для розділу налаштувань повертає поля цього розділу.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          get_guidance
        </code>
      </strong>
    </td>
    
    <td>
      Повертає докладні інструкції для завдання: усі макроси, які підтримує ваша організація (зокрема ваші власні поля), правила формату шаблонів, структуру тригерів і дій автоматизацій із готовими рецептами, оператори фільтрів, каталог звітів, мову запитів і карту сторінок застосунку.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          get_profile
        </code>
      </strong>
    </td>
    
    <td>
      Повертає обліковий запис Requiply, від імені якого входить підключення: імʼя, email і організацію. Лише для підключень, у які виконано вхід як учасник.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          search_help
        </code>
      </strong>
    </td>
    
    <td>
      Шукає в цій базі знань, як працює Requiply і як щось налаштувати, а також читає сторінку повністю. Асистент посилається на сторінки, які використав.
    </td>
  </tr>
</tbody>
</table>

Макроси та структура автоматизацій надходять з інструментів, а не з памʼяті асистента. Тому шаблон, складений асистентом, використовує саме ті макроси, які є у вашій організації.

**get_guidance** приймає одну чи кілька з цих тем:

<table>
<thead>
  <tr>
    <th>
      Тема
    </th>
    
    <th>
      Що вона охоплює
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        getting_started
      </code>
    </td>
    
    <td>
      Як інструменти поєднуються між собою та правило «попередній перегляд, потім підтвердження» для записів.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        booking_rules
      </code>
    </td>
    
    <td>
      Робочі години, буфери, статус запиту, а також що запит на бронювання робить і чого не робить.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        email_template_macros
      </code>
    </td>
    
    <td>
      Усі <code>
        {{macro}}
      </code>
      
      , доступні в шаблонах листів, зокрема ваші власні поля.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        message_template_macros
      </code>
    </td>
    
    <td>
      Макроси та правила формату для шаблонів повідомлень SMS, Viber і Telegram.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        export_template_macros
      </code>
    </td>
    
    <td>
      Макроси та синтаксис колонок таблиць для шаблонів PDF-документів.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        template_conditionals
      </code>
    </td>
    
    <td>
      Блоки <code>
        {{#if}}
      </code>
      
       і поведінка порожніх значень.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow_recipes
      </code>
    </td>
    
    <td>
      Структура тригерів і дій із готовими рецептами автоматизацій.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow_filters
      </code>
    </td>
    
    <td>
      Назви властивостей фільтрів, оператори та формати значень для автоматизацій.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reports_catalog
      </code>
    </td>
    
    <td>
      Який звіт відповідає на яке бізнес-питання та його параметри.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        query_language
      </code>
    </td>
    
    <td>
      Синтаксис <strong>
        <code>
          objects_query
        </code>
      </strong>
      
      : поля, оператори, дати, групування та розібрані приклади.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        app_navigation
      </code>
    </td>
    
    <td>
      Усі сторінки вебзастосунку Requiply зі шляхом у меню та посиланням, для питань «де знайти» і «як зробити».
    </td>
  </tr>
</tbody>
</table>

## Записи

Записи читають двома загальними інструментами, а змінюють інструментом запису, названим для кожного типу. Аргумент `objectType` визначає, з чим працювати. Кожен запис, що має сторінку в Requiply, містить `url`, який її відкриває. Саме через нього асистенти дають посилання на записи.

<table>
<thead>
  <tr>
    <th>
      Тип обʼєкта
    </th>
    
    <th>
      Читання
    </th>
    
    <th>
      Запис
    </th>
    
    <th>
      Примітки
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        booking
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          bookings_manage
        </code>
      </strong>
      
      , власні поля через <strong>
        <code>
          objects_manage
        </code>
      </strong>
    </td>
    
    <td>
      Пошук повертає скорочені рядки, а get повертає повний перелік товарів, послуг, оплат і власних полів. Номер бронювання, який бачить користувач, міститься в <code>
        reservationOrgId
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        client
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Створення, оновлення, власні поля
    </td>
    
    <td>
      Точний пошук за email чи телефоном, нечіткий пошук за імʼям. Створення захищене від дублікатів. Створення й оновлення приймають <code>
        customFields
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        item_group
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Лише власні поля
    </td>
    
    <td>
      Товари для оренди з залишками, цінами, кількісним ціноутворенням, власними полями й доступністю на період дат. Самі товари редагують у застосунку.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        sale_item
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Ні
    </td>
    
    <td>
      Товари на продаж (<a href="https://requiply.com/docs/uk/guides/sales">
        Продажі
      </a>
      
      ): назва, артикул, штрихкод, категорія, ціна продажу, залишок на складі (може бути відʼємним), продано за останні 30 днів. <code>
        purchaseCost
      </code>
      
       лише для облікових записів із <strong>
        Дозволити керування залишками
      </strong>
      
      . Потрібні увімкнені продажі та дозвіл на продажі.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        sale
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          sales_manage
        </code>
      </strong>
    </td>
    
    <td>
      Продажі товарів, окремі чи в бронюванні, від найновіших. Фільтри: <code>
        kind
      </code>
      
       (окремий продаж чи в бронюванні), <code>
        status
      </code>
      
      , <code>
        unpaid
      </code>
      
      , <code>
        clientId
      </code>
      
      , <code>
        soldFrom
      </code>
      
      , <code>
        soldTo
      </code>
      
      . Get повертає рядки, повернення та оплати. Номер, який бачить користувач, міститься в <code>
        saleOrgId
      </code>
      
      . Щоб отримати продаж за ним, передайте <code>
        idKind="org"
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        category
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Створення, оновлення
    </td>
    
    <td>
      Категорії товарів, вкладені через <code>
        parentId
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        service
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Створення, оновлення
    </td>
    
    <td>
      Додаткові послуги. Їх архівують замість видалення.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        location
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Створення, оновлення
    </td>
    
    <td>
      Локації видачі та повернення.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reservation_status
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Ні
    </td>
    
    <td>
      Статуси бронювань, за якими визначають id для автоматизацій і фільтрів.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        email_template
      </code>
      
      , <code>
        message_template
      </code>
      
      , <code>
        export_template
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          templates_manage
        </code>
      </strong>
    </td>
    
    <td>
      У списку без вмісту. Вміст повертає get. <strong>
        <code>
          templates_preview
        </code>
      </strong>
      
       відображає шаблон на бронюванні.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        workflow
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          workflows_manage
        </code>
      </strong>
    </td>
    
    <td>
      У списку з читабельним описом тригера та дії. Get повертає повну конфігурацію.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        bundle
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Ні
    </td>
    
    <td>
      <a href="https://requiply.com/docs/uk/guides/inventory/bundles">
        Комплекти
      </a>
      
      , які можна забронювати, з їхніми товарами та знижкою. Передайте дати в пошук, щоб дізнатися, скільки наборів вільно. Комплекти створюють і редагують у застосунку.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        conversation
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          conversations_manage
        </code>
      </strong>
    </td>
    
    <td>
      <a href="https://requiply.com/docs/uk/guides/conversations/inbox">
        Скринька розмов
      </a>
      
      , від найновіших: канал, контакт, привʼязаний клієнт, хто зараз відповідає (AI чи людина), власник, статус і кількість непрочитаних. Фільтри: <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 повертає останні повідомлення і те, чи можна ще надіслати відповідь у цьому каналі.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        comment
      </code>
    </td>
    
    <td>
      Так
    </td>
    
    <td>
      Через <strong>
        <code>
          comments_manage
        </code>
      </strong>
    </td>
    
    <td>
      <a href="https://requiply.com/docs/uk/guides/conversations/comments">
        Коментарі
      </a>
      
       до бронювання, клієнта, одиниці чи завдання. Для пошуку потрібні <code>
        entityType
      </code>
      
       і <code>
        entityId
      </code>
      
       (стрічка одного запису) або <code>
        mentionsMe=true
      </code>
      
       (коментарі, у яких згадано вас, для підключень учасників). Системні записи не включаються, якщо не передати <code>
        includeSystem=true
      </code>
      
      .
    </td>
  </tr>
</tbody>
</table>

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Що він може
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
    </td>
    
    <td>
      Показати список або шукати обʼєкти одного типу з довільним текстом у <code>
        query
      </code>
      
      , типізованими <code>
        filters
      </code>
      
       (дати, назви статусів, id клієнта, категорія, період доступності, вид скриньки) і пагінацією за курсором.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_get
        </code>
      </strong>
    </td>
    
    <td>
      Отримати до 20 записів за id з повними деталями, зокрема з власними полями для бронювань, клієнтів і груп товарів. Для бронювань і продажів <code>
        idKind="org"
      </code>
      
       приймає номер, показаний у застосунку.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_query
        </code>
      </strong>
    </td>
    
    <td>
      Відповідати на питання з фільтрами й групуванням щодо бронювань, клієнтів, груп товарів і продажів мовою RQL (Requiply Query Language), тобто JSON-запитом: умови, поєднані через AND і OR, за будь-яким полем, зокрема клієнтом, статусом, товарами та їхньою категорією, залишком до сплати й власними полями. Повертає відповідні записи з посиланнями або по одному рядку на групу з кількістю, сумами, середніми й медіанами, наприклад дохід за кожен місяць. Лише читання. Для грошових підсумків потрібен <strong>
        Доступ до звітності
      </strong>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          objects_manage
        </code>
      </strong>
    </td>
    
    <td>
      Створити чи оновити клієнта, категорію, послугу або локацію, а також задати значення власних полів наявного бронювання, клієнта чи групи товарів (<code>
        set_custom_fields
      </code>
      
      ). Потрібен відповідний дозвіл: <strong>
        Доступ до клієнтів
      </strong>
      
       для клієнтів, <strong>
        Доступ до інвентарю
      </strong>
      
       для категорій і власних полів груп товарів, <strong>
        Доступ до послуг
      </strong>
      
       для послуг, <strong>
        Доступ до бронювань
      </strong>
      
       для власних полів бронювань і <strong>
        Доступ до налаштувань
      </strong>
      
       для локацій.
    </td>
  </tr>
</tbody>
</table>

<note>

**Коли асистент використовує який інструмент читання.** `objects_search` знаходить записи за назвою, номером або кількома фіксованими фільтрами. `reports_run` відповідає стандартними бізнес-звітами. `objects_query` охоплює питання між ними, як-от «бронювання в липні з дроном, які досі не оплачені» чи «клієнти з трьома й більше бронюваннями, які не бронювали з червня». Перед першим запитом асистенти читають тему інструкцій `query_language`.

</note>

## Інструменти для бронювань, продажів, доступності та цін

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Що він може
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          availability_check
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        mode="items"
      </code>
      
       повертає групи товарів, у яких хоча б одна одиниця вільна протягом усього періоду дат. <code>
        mode="calendar"
      </code>
      
       повертає кількість за днями для кожної групи товарів.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          pricing_quote
        </code>
      </strong>
    </td>
    
    <td>
      Розрахувати точну вартість за вибраними групами товарів, комплектами, послугами, датами оренди, кількісним ціноутворенням і, за потреби, знижкою клієнта. Дату без часу рахують від часу відкриття до часу закриття, а результат повторює використані дати.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          sales_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        create
      </code>
      
       записує окремий продаж товарів за ціною з каталогу, з клієнтом за бажанням (за id або за імʼям з email чи телефоном) і способом оплати. Попередній перегляд показує рядки, суму, попередження щодо залишків (залишок може стати відʼємним, продаж однаково дозволено) і чи працює спосіб оплати. Підтверджений виклик записує продаж і повертає посилання на оплату для онлайн-способів. Потрібен дозвіл <strong>
        Дозволити продаж товарів
      </strong>
      
      . Повернення, скасування, редагування рядків і позначення оплат як сплачених виконують у застосунку.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          bookings_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        create_request
      </code>
      
       створює бронювання в статусі, вибраному у вашій організації як <strong>
        Статус запитів на бронювання
      </strong>
      
       (<em>
        Запит
      </em>
      
      , якщо ви не змінили його в розділі <a href="https://requiply.com/docs/uk/guides/settings/bookings/booking-creation#%D0%B2%D0%B8%D0%B1%D1%96%D1%80-%D0%BF%D0%BE%D1%87%D0%B0%D1%82%D0%BA%D0%BE%D0%B2%D0%B8%D1%85-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%D1%96%D0%B2">
        Створення бронювання
      </a>
      
      ). Виклик попереднього перегляду перевіряє доступність, розраховує вартість набору й повертає підсумок. Підтверджений виклик створює запит. Інструмент приймає <code>
        customFields
      </code>
      
       бронювання з ключами полів, які показує <strong>
        <code>
          describe
        </code>
      </strong>
      
      . <code>
        add_note
      </code>
      
       додає до бронювання внутрішню нотатку, яку бачить лише персонал. Співробітники, чия група дозволів має <strong>
        Бронювання поза робочим часом
      </strong>
      
      , можуть попросити видачу чи повернення поза розкладом: для них інструмент передає <code>
        allowOutsideWorkingHours
      </code>
      
      . Співробітники, чия група має <strong>
        Коригування вартості та застави
      </strong>
      
      , також можуть передати одне <code>
        adjustment
      </code>
      
       (<code>
        units
      </code>
      
      , <code>
        percent
      </code>
      
       або <code>
        amount
      </code>
      
      , зі знаком), див. <a href="https://requiply.com/docs/uk/guides/bookings/changing/cost-adjustment#%D1%87%D0%B5%D1%80%D0%B5%D0%B7-api-%D1%82%D0%B0-ai-%D0%B0%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BD%D1%82%D0%B0">
        Коригування вартості бронювання
      </a>
      
      . Співробітники з <strong>
        Дозволити продаж товарів
      </strong>
      
       можуть передати <code>
        saleLines
      </code>
      
      , щоб продати товари разом із бронюванням за ціною з каталогу. Попередній перегляд показує їх як <code>
        saleSubtotal
      </code>
      
      , вони входять у суму без жодних знижок, а їхній залишок зменшується після створення запиту. Запит також може містити <code>
        bundles
      </code>
      
      , які бронюються як їхні товари зі знижкою комплекту.
    </td>
  </tr>
</tbody>
</table>

Запит на бронювання ніколи не утримує інвентар і не приймає оплату. Співробітник схвалює його в застосунку. Під час схвалення доступність перевіряється знову. Зміни статусу, оплати й редагування товарів у наявному бронюванні виконують у застосунку.

**Дати й час задаються за вашим місцевим часом.** Асистенти передають дати й час без часового поясу, наприклад `2026-10-06T10:00:00`, а Requiply читає їх у часовому поясі організації з [Налаштувань дати та часу](https://requiply.com/docs/uk/guides/settings/organization/date-and-time) з урахуванням переходу на літній час. Дата без часу, як-от `2026-10-06`, означає час відкриття для видачі та час закриття для повернення. Значення з власним зміщенням, як-от `2026-10-06T10:00:00+03:00`, використовуються як є.

**Робочі години перевіряються в попередньому перегляді.** Коли видача чи повернення припадає на вихідний день або поза робочі години, попередній перегляд повідомляє про це в `workingHours` і вказує найближчий робочий день або дозволений проміжок. Асистент тоді не просить вас підтвердити, а пропонує інший час.

**Кожне бізнес-правило перевіряється в попередньому перегляді.** Коли запит неможливо забронювати так, як його сформульовано, попередній перегляд повертає `bookable: false` і список `problems`. Кожна проблема містить код, причину та `nextStep`, який асистент виконує, перш ніж просити вас підтвердити:

<table>
<thead>
  <tr>
    <th>
      Код
    </th>
    
    <th>
      Значення
    </th>
    
    <th>
      Що робить асистент далі
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        working_hours
      </code>
    </td>
    
    <td>
      Видача чи повернення припадає на вихідний день або поза робочі години.
    </td>
    
    <td>
      Пропонує найближчий допустимий час.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        minimum_duration
      </code>
    </td>
    
    <td>
      Коротше за <strong>
        Мінімальна тривалість бронювання
      </strong>
      
       з розділу <a href="https://requiply.com/docs/uk/guides/settings/bookings/booking-duration">
        Тривалість бронювання
      </a>
      
      .
    </td>
    
    <td>
      Пропонує найраніше повернення, яке буде прийнято.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        unavailable
      </code>
    </td>
    
    <td>
      Недостатньо вільного залишку на ці дати.
    </td>
    
    <td>
      Повідомляє кількість вільних одиниць і пропонує інші дати, меншу кількість або схожий товар.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        not_found
      </code>
    </td>
    
    <td>
      Товар, послугу чи клієнта не знайдено.
    </td>
    
    <td>
      Шукає ще раз або просить у вас дані клієнта.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        not_allowed
      </code>
    </td>
    
    <td>
      Ваша група дозволів або тариф не дозволяє частину запиту.
    </td>
    
    <td>
      Пропонує продовжити без неї, наприклад без коригування.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        invalid_request
      </code>
    </td>
    
    <td>
      Щось у запиті сформовано неправильно, наприклад повернення раніше за видачу.
    </td>
    
    <td>
      Виправляє запит і знову показує попередній перегляд.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        system_error
      </code>
    </td>
    
    <td>
      Тимчасовий збій.
    </td>
    
    <td>
      Повторює спробу один раз.
    </td>
  </tr>
</tbody>
</table>

Проблеми повертаються як звичайні відповіді, а не як помилки. Тому асистент завжди розповідає, що сталося і що він пропонує натомість, а не зупиняється мовчки. `pricing_quote` і `availability_check` відповідають так само: доступність перевіряється саме на запитаний час з урахуванням ваших буферів бронювань.

**Повторне «так» не створює подвійних бронювань.** Якщо ви підтвердите той самий запит двічі протягом 30 хвилин (той самий клієнт, дати та набір), другий виклик поверне номер уже створеного запиту замість створення ще одного.

## Розмови та коментарі

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Що він може
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          conversations_manage
        </code>
      </strong>
    </td>
    
    <td>
      Дії зі скринькою від імені учасника, який увійшов. <code>
        reply
      </code>
      
       надсилає повідомлення клієнту в його каналі (Telegram, Instagram, Viber, OLX або вебчат). Учасник стає власником розмови, а AI-асистент перестає в ній відповідати. <code>
        update
      </code>
      
       передає розмову людині або назад AI (<code>
        handler
      </code>
      
      ), закриває чи знову відкриває її (<code>
        status
      </code>
      
      ), а також робить учасника власником або прибирає власника (<code>
        assign
      </code>
      
      ). Попередній перегляд показує канал, співрозмовника, поточного власника, чи ще відкрите вікно відповіді каналу, а також причину, з якої відповідь може бути відхилено. На розмову, якою володіє інший учасник, асистент відповідає лише тоді, коли ви просите його перебрати її. Потрібні <strong>
        Доступ до розмов
      </strong>
      
       і підключення, у яке виконано вхід як учасник. API-ключі організації відповідати не можуть.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          comments_manage
        </code>
      </strong>
    </td>
    
    <td>
      <code>
        add
      </code>
      
       записує внутрішній коментар до бронювання, клієнта, одиниці чи завдання від імені учасника, який увійшов (API-ключ організації записує його без автора). <code>
        mentionUserIds
      </code>
      
       згадує учасників команди з <strong>
        <code>
          whoami
        </code>
      </strong>
      
      , які отримують push-сповіщення, а <code>
        parentCommentId
      </code>
      
       робить коментар відповіддю на інший коментар до того самого запису. Клієнти ніколи не бачать цих коментарів.
    </td>
  </tr>
</tbody>
</table>

## Звітність

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      На що він може відповісти
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          reports_run
        </code>
      </strong>
    </td>
    
    <td>
      Один інструмент з аргументом <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>
      
       та <code>
        inventory_status
      </code>
      
       (одиниці, що зараз в оренді). За замовчуванням береться період за останні 30 днів. Потрібен дозвіл <strong>
        Доступ до звітності
      </strong>
      
      .
    </td>
  </tr>
</tbody>
</table>

Для питань, яких стандартні звіти не охоплюють, як-от дохід за кожен місяць для одного значення власного поля, асистент використовує **objects_query** (див. [Записи](#%D0%B7%D0%B0%D0%BF%D0%B8%D1%81%D0%B8)).

## Інструменти конфігурації

Читання й перевірка є окремими інструментами від змін, тому асистент може переглянути ваші налаштування, жодного разу не пропонуючи зміну. Інструменти читання працюють у кожному підключенні. Для інструментів запису потрібен **Доступ до налаштувань**, який група «Адміністратори» має завжди.

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Читає чи записує
    </th>
    
    <th>
      Що він може
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          settings_get
        </code>
      </strong>
    </td>
    
    <td>
      Читає
    </td>
    
    <td>
      Повертає поточні налаштування одного розділу: <code>
        organization
      </code>
      
       (назва, опис, контактні дані, мова, а також ваші власні поля рівня організації), <code>
        working_hours
      </code>
      
       (часовий пояс і тижневий розклад), <code>
        booking_rules
      </code>
      
       (вибір дат, мінімальна тривалість, буфери), <code>
        deposits
      </code>
      
       і <code>
        features
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          settings_manage
        </code>
      </strong>
    </td>
    
    <td>
      Записує
    </td>
    
    <td>
      Оновлює один розділ лише тими полями, які треба змінити. Спершу показує різницю «до/після». Розділ <code>
        organization
      </code>
      
       також приймає <code>
        customFields
      </code>
      
      . Функції, яким потрібен вищий тариф, позначено як заблоковані: тут їх увімкнути не можна.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          templates_preview
        </code>
      </strong>
    </td>
    
    <td>
      Читає
    </td>
    
    <td>
      Відображає шаблон листа, повідомлення (SMS, Viber, Telegram) чи експорту (PDF-документ) на реальному бронюванні без жодного збереження: збережений шаблон за id або незбережену чернетку. Повертає тему, HTML і звичайний текст, а також показує макроси, яких немає в організації.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          templates_manage
        </code>
      </strong>
    </td>
    
    <td>
      Записує
    </td>
    
    <td>
      Створює, оновлює й видаляє шаблони листів, повідомлень і експорту. Попередній перегляд перевіряє шаблон і показує невідомі макроси. Видалити шаблон, який досі використовує автоматизація чи інший шаблон, неможливо.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          workflows_validate
        </code>
      </strong>
    </td>
    
    <td>
      Читає
    </td>
    
    <td>
      Перевіряє повну чи часткову автоматизацію без збереження: перетворює id статусів і шаблонів на назви, перевіряє, що id співробітників належать учасникам, а формат шаблону повідомлення підходить каналу. Також попереджає, коли провайдера повідомлень не підключено.
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        <code>
          workflows_manage
        </code>
      </strong>
    </td>
    
    <td>
      Записує
    </td>
    
    <td>
      Створює, оновлює, вмикає чи вимикає (<code>
        set_enabled
      </code>
      
      ) і видаляє автоматизації. Окрім дій з email, push і повідомленнями клієнту, інструмент може налаштувати <code>
        change_booking_status
      </code>
      
       та <code>
        send_group_push_notification
      </code>
      
      , яка надсилає push-сповіщення <a href="https://requiply.com/docs/uk/guides/settings/organization/accounts/permission-groups">
        групам дозволів
      </a>
      
       за <code>
        groupIds
      </code>
      
      . <strong>
        <code>
          whoami
        </code>
      </strong>
      
       показує групу кожного учасника.
    </td>
  </tr>
</tbody>
</table>

Шаблони й автоматизації отримують у списку й читають через **objects_search** і **objects_get**, як і будь-які інші записи.

## Зворотний звʼязок

<table>
<thead>
  <tr>
    <th>
      Інструмент
    </th>
    
    <th>
      Що він робить
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        <code>
          send_feedback
        </code>
      </strong>
    </td>
    
    <td>
      Надсилає команді Requiply ваш відгук про ці інструменти: інструмент, що дав збій або повернув хибні дані, щось потрібне вам, чого не вміє жоден інструмент, або похвалу. Відгук містить лише ваші власні слова без імен, email і телефонів клієнтів і нічого не змінює у вашій організації.
    </td>
  </tr>
</tbody>
</table>


## Sitemap

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