Requiply MCP

Сценарії використання MCP Requiply

Запитання до асистента, підключеного до Requiply, інструменти MCP для відповіді на них і скорочені приклади того, що повертає кожен інструмент.

Запитання, які можна поставити асистенту, підключеному до Requiply, з інструментами, якими він на них відповідає.

Приклади питань

Що можна запитати в асистента	Ймовірні MCP-інструменти Requiply
«Як ми попрацювали минулого місяця?»	`whoami`, `reports_run` (`bookings_summary`, `revenue`)
«Яке обладнання вільне на ці вихідні?»	`availability_check`
«Скільки коштуватимуть дві камери з пʼятниці до понеділка?»	`objects_search` (`item_group`), `pricing_quote`
«Які товари використовуються замало?»	`reports_run` (`utilization`, `top_items`)
«Хто нам винен?»	`reports_run` (`outstanding`)
«Які липневі весілля з дроном досі не оплачені?»	`describe` (`booking`), `get_guidance` (`query_language`), `objects_query`
«Дохід за кожен місяць цього року з медіанним бронюванням»	`objects_query` (`groupBy` за місяцем, `sum`, `median`)
«Які постійні клієнти не бронювали з червня?»	`objects_query` (`client`)
«Покажи бронювання #24»	`objects_get` (`booking`, `idKind="org"`)
«Встанови тип події в бронюванні #24 на Весілля»	`describe` (`booking`), `objects_manage` (`set_custom_fields`, попередній перегляд, потім підтвердження)
«Створи запит на бронювання двох камер на наступну пʼятницю»	`availability_check`, `bookings_manage` (попередній перегляд, потім підтвердження)
«Які розмови чекають на нас?»	`objects_search` (`conversation`, `view="needs_human"`)
«Відповідай Олені, що намет вільний у суботу»	`objects_get` (`conversation`), `conversations_manage` (`reply`, попередній перегляд, потім підтвердження)
«Поверни цей чат AI»	`conversations_manage` (`update`, `handler="ai"`)
«Де команда мене згадала?»	`objects_search` (`comment`, `mentionsMe=true`)
«Залиш нотатку до бронювання #24 для Андрія, щоб перевірив кабелі»	`whoami` (учасники), `comments_manage` (`add` зі згадкою, попередній перегляд, потім підтвердження)
«Скільки SD-карт у нас залишилося?»	`objects_search` (`sale_item`)
«Запиши продаж двох акумуляторів Олені, оплата на місці»	`objects_search` (`sale_item`, `client`), `sales_manage` (попередній перегляд, потім підтвердження)
«Які продажі досі не оплачені?»	`objects_search` (`sale`, `unpaid=true`)
«Напиши лист-підтвердження, який показує заставу лише тоді, коли вона є»	`get_guidance` (`email_template_macros`), `templates_preview`, `templates_manage` (створення)
«Надсилай нагадування за 24 години до видачі»	`get_guidance` (`workflow_recipes`), `objects_search` (`message_template`), `workflows_validate`, `workflows_manage` (створення)
«Які в нас робочі години?»	`settings_get` (`working_hours`)
«Відтепер ми не працюємо в неділю»	`settings_manage` (`working_hours`, попередній перегляд, потім підтвердження)
«Як налаштувати онлайн-оплату?»	`search_help`, `get_guidance` (`app_navigation`)

Сценарії з прикладами відповідей

Кожен сценарій нижче показує, що можна запитати в асистента та який інструмент на це відповідає. Також наведено скорочений приклад структурованого JSON, який повертає інструмент. Асистент перетворює цей JSON на відповідь звичайною мовою.

Приклади наведено для ілюстрації. Довгі поля (URL зображень, id) скорочено, дані клієнтів анонімізовано, а списки обрізано. Назви полів і структура збігаються з тим, що насправді повертають інструменти.

Огляд бізнесу

Запит: «Дай мені огляд бізнесу». → whoami

Приклад відповіді

{
  "organization": {
    "name": "Acme Rentals",
    "currency": "UAH",
    "language": "uk",
    "timezone": "Europe/Kyiv",
    "tier": "advanced",
    "workingHours": [
      { "day": "monday", "startTime": "09:00", "endTime": "18:00", "isWorkingDay": true },
      { "day": "sunday", "startTime": "00:00", "endTime": "23:59", "isWorkingDay": false }
    ]
  },
  "locations": [
    { "name": "Main Studio", "city": "Lviv", "country": "Ukraine", "isDefault": true }
  ],
  "supportedPaymentMethods": ["payOnPickup", "monobank"],
  "stats": { "totalClients": 30, "totalItemGroups": 9, "bookingsActiveNow": 0, "bookingsUpcoming": 1 },
  "caller": { "kind": "user", "name": "Olena K.", "isAdmin": true },
  "access": {
    "objects": { "booking": "write", "client": "write", "item_group": "read", "workflow": "write" },
    "reports": true,
    "settings": "write"
  },
  "members": [{ "userId": "8c1d…", "name": "Olena K.", "isAdmin": true }]
}

Перевірка вільного на період дат

Запит: «Що ми можемо запропонувати з 19 по 21 червня?» → availability_check з mode="items"

Повертає лише групи товарів, у яких хоча б одна одиниця вільна в кожен день періоду.

Приклад відповіді

{
  "items": [
    {
      "id": "80e9332d-…",
      "name": "ATEM Mini Pro",
      "sku": "ATEM-MIPR",
      "priceType": "day",
      "basePrice": 400,
      "currency": "UAH",
      "totalQuantity": 1,
      "availableQuantity": 1,
      "pricingTiers": []
    }
  ],
  "nextCursor": null
}

Пошук бронювання за номером

Запит: «Що входить у бронювання #9?» → objects_get з objectType="booking", ids=[9], idKind="org"

Приклад відповіді

{
  "objectType": "booking",
  "results": [
    {
      "id": 9,
      "record": {
        "id": 253,
        "reservationOrgId": 9,
        "startDate": "2026-07-01T10:00:00+00:00",
        "endDate": "2026-07-03T10:00:00+00:00",
        "totalCost": 700,
        "currency": "UAH",
        "items": [{ "groupId": "d73e…", "name": "Rode Procaster", "quantity": 1 }],
        "services": [],
        "payments": []
      }
    }
  ]
}

Огляд результатів за період

Запит: «Як ми попрацювали цього року?» → reports_run з report="bookings_summary"

Приклад відповіді

{
  "report": "bookings_summary",
  "currency": "UAH",
  "dateFrom": "2026-01-01",
  "dateTo": "2026-09-08",
  "totals": { "totalBookings": 12, "totalRevenue": 41000, "avgOrderValue": 3416.67, "medianOrderValue": 2800 },
  "rates": { "cancellationRate": 0.08, "completionRate": 0.75 },
  "timing": { "avgLeadTimeDays": 6.4, "avgDurationDays": 2.1 },
  "byStatus": [{ "statusName": "Completed", "count": 9, "percentage": 75 }]
}

Створення запиту на бронювання (запис)

Запит: «Забронюй ATEM Mini Pro з 6 по 8 жовтня для jordan.lee@example.com».

Асистент викликає bookings_manage з operation="create_request" без прапорця confirmed. Попередній перегляд перевіряє доступність, розраховує вартість набору й повертає підсумок, який асистент показує вам.

Приклад відповіді (попередній перегляд)

{
  "applied": false,
  "operation": "create_request",
  "preview": {
    "startDate": "2026-10-06T10:00:00",
    "endDate": "2026-10-08T18:00:00",
    "deliveryType": "pickup",
    "client": { "name": "Jordan", "email": "jordan.lee@example.com" },
    "lineItems": [{ "name": "ATEM Mini Pro", "quantity": 1, "unitPrice": 400, "unitCount": 3, "subtotal": 1200 }],
    "total": 1200,
    "currency": "UAH",
    "status": "Request (pending staff approval; inventory is not held)"
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Після вашого схвалення той самий виклик із confirmed=true створює запит і повертає номер бронювання.

Приклад відповіді (підтверджено)

{
  "applied": true,
  "operation": "create_request",
  "preview": { "reservationId": 318, "reservationOrgId": 24, "totalCost": 1200, "currency": "UAH" },
  "message": "Booking request #24 created as a request; staff will review it."
}

Створення шаблону листа з макросами

Запит: «Створи лист-підтвердження, який показує заставу лише тоді, коли ми її беремо».

get_guidance з topics=["email_template_macros"] повертає всі макроси, зокрема ваші власні поля.
templates_preview з чернеткою відображає її на недавньому бронюванні без жодного збереження. Невідомі макроси потрапляють у список, щоб асистент виправив їх до збереження.
templates_manage з operation="create" показує перевірений шаблон, а підтверджений виклик зберігає його.

Приклад відповіді (попередній перегляд)

{
  "bookingId": 253,
  "bookingNumber": 9,
  "subject": "Booking #9 confirmed",
  "html": "<p>Hi Alex, your total is 700,00 ₴.</p><table>…</table>",
  "text": "Hi Alex, your total is 700,00 ₴. …",
  "unknownMacros": ["{{totalPrice}}"]
}

Налаштування автоматизації

Запит: «Надсилай шаблон підтвердження email-листом, коли бронювання переходить у статус Підтверджено».

Асистент визначає id статусу через objects_search (reservation_status) та id шаблону через objects_search (email_template), потім перевіряє чернетку через workflows_validate і викликає workflows_manage з operation="create". Попередній перегляд показує визначені назви, щоб ви перевірили їх перед підтвердженням.

Приклад відповіді (попередній перегляд)

{
  "applied": false,
  "operation": "create",
  "preview": {
    "name": "Confirmation email",
    "isEnabled": true,
    "triggerType": "status_reached",
    "triggerConfig": { "statusId": "5b1d0c3e-…" },
    "actionType": "send_email",
    "actionConfig": { "templateId": "2a967b5e-…" },
    "filtersConfig": null,
    "resolved": { "triggerConfig.statusId": "Confirmed", "actionConfig.templateId": "Booking confirmation" }
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Зміна налаштування

Запит: «Бери заставу 20% з кожного бронювання». → settings_manage з section="deposits" і patch з полями, які треба змінити

Приклад відповіді (попередній перегляд)

{
  "applied": false,
  "operation": "update",
  "objectType": "settings.deposits",
  "preview": { "depositMethod": "percentage", "depositValue": 20 },
  "changes": [
    { "field": "depositMethod", "before": "none", "after": "percentage" },
    { "field": "depositValue", "before": 0, "after": 20 }
  ],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Інструменти

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

Усунення проблем

Що робити, коли конектор не підключається, вхід зупиняється на «Admin role required», асистент відмовляється щось змінити, запит на бронювання виходить за робочі години або інструменти не зʼявляються.