[
  {
    "key": "adesk",
    "name": "Adesk",
    "name_en": "Adesk",
    "description": "Управленческий учёт: операции, ДДС, ОПиУ, проекты, обязательства, бюджеты",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "adesk",
    "description_en": "Management accounting: transactions, cash flow, P&L, projects, liabilities and budgets",
    "search_terms": [
      "адеск",
      "управленческий учёт",
      "ддс",
      "опиу"
    ],
    "guide": {
      "url": "https://app.adesk.ru",
      "steps": [
        {
          "title": "Войдите в Adesk под владельцем аккаунта",
          "desc": "Ключ API принадлежит аккаунту целиком и видит все юрлица, счета и проекты, к которым у профиля есть доступ.",
          "title_en": "Sign in to Adesk as the account owner",
          "desc_en": "The API key belongs to the whole account and sees every legal entity, bank account and project the profile can reach."
        },
        {
          "title": "Откройте «Настройки» → «Профиль»",
          "desc": "В профиле есть отдельный блок с ключом доступа к API. Скопируйте его целиком, без пробелов по краям.",
          "title_en": "Open «Настройки» → «Профиль»",
          "desc_en": "The profile has a separate block with the API access key (Настройки → Профиль, Settings → Profile). Copy it whole, without spaces at the ends."
        },
        {
          "title": "Проверьте, что подписка активна",
          "desc": "Без пробного периода или оплаченной подписки Adesk блокирует все методы API и отвечает «Payment required».",
          "title_en": "Make sure the subscription is active",
          "desc_en": "Without a trial or a paid subscription Adesk blocks every API method and answers «Payment required»."
        },
        {
          "title": "Не вставляйте ключ наугад несколько раз",
          "desc": "После нескольких неверных ключей подряд Adesk временно блокирует вход по API. Если ключ не принят, скопируйте его заново из профиля.",
          "title_en": "Do not retry with guessed keys",
          "desc_en": "After several wrong keys in a row Adesk temporarily locks API sign-in. If the key is rejected, copy it again from the profile."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Adesk с ИИ-агентом: проекты в минусе и ДДС",
      "description": "Проекты, ушедшие в минус за месяц, и ответ, хватит ли денег на плановые платежи недели: агент сведёт их из Adesk. Подключение ключом API из профиля.",
      "headline": "Управленческий учёт Adesk в чате: ДДС, прибыль по проектам и долги",
      "scenarios": [
        {
          "title": "ДДС за месяц по статьям",
          "desc": "Агент соберёт поступления и списания за период по статьям и счетам и покажет, куда ушли деньги и откуда пришли."
        },
        {
          "title": "Прибыль по проектам и сделкам",
          "desc": "Агент прочитает показатели проектов и сравнит выручку, расходы и маржу, чтобы было видно, какие сделки работают в минус."
        },
        {
          "title": "Дебиторка и кредиторка",
          "desc": "Агент сведёт обязательства по контрагентам: кто должен вам, кому должны вы и что просрочено."
        },
        {
          "title": "Плановые платежи на неделю",
          "desc": "Агент покажет плановые операции из платёжного календаря на ближайшие дни и остатки на счетах, чтобы не уйти в кассовый разрыв."
        },
        {
          "title": "Разнести операции по статьям",
          "desc": "Агент найдёт операции без статьи и предложит статью и проект для каждой, а записывает только после вашего подтверждения."
        },
        {
          "title": "Бюджет против факта",
          "desc": "Агент сравнит бюджет с фактическими операциями за месяц и назовёт статьи, где расход вышел за план."
        }
      ],
      "how_it_works": [
        "Работа начинается со справочников аккаунта: юрлица, счета, статьи операций, проекты и контрагенты. По ним агент понимает, как устроен учёт именно у вас, и дальше читает операции за нужный период с фильтрами по счёту, статье, проекту или контрагенту, а не выгружает всё подряд.",
        "Списки Adesk отдаёт частями, поэтому длинный период агент читает страницами до конца и говорит, если остановился раньше. Фактические и плановые операции он считает раздельно, а дату платежа отличает от даты начисления: отчёт о движении денег и отчёт о прибыли строятся по разным датам.",
        "Записывать агент умеет всё, что открывает API: операции, переводы, обязательства, проекты, контрагентов, бюджеты и собственные строки отчёта о прибылях и убытках. Любая запись и любое удаление идут только после вашего подтверждения, а удаление в Adesk не отменяется.",
        "Если ключ не принят или подписка закончилась, агент так и скажет, а не покажет пустую таблицу. Повторять неверный ключ он не будет: после нескольких попыток подряд Adesk временно блокирует вход по API, поэтому ключ лучше заново скопировать из профиля."
      ],
      "requirements": [
        "Активный пробный период или подписка Adesk",
        "Ключ доступа к API из «Настройки → Профиль»",
        "Запись и удаление только после вашего подтверждения"
      ],
      "faq": [
        {
          "q": "Как подключить Adesk?",
          "a": "Ключом доступа к API из раздела «Настройки → Профиль» в Adesk. Ключ вводится один раз и хранится в зашифрованном виде."
        },
        {
          "q": "Что агент может делать в Adesk?",
          "a": "Читать операции, счета, проекты, обязательства, бюджеты и отчётные строки, а также создавать и менять их после вашего подтверждения."
        },
        {
          "q": "Подходит ли для нескольких юрлиц?",
          "a": "Да, агент видит все юрлица и счета аккаунта и умеет сводить их в один отчёт или считать раздельно."
        }
      ]
    },
    "seo_en": {
      "title": "Adesk AI agent: loss-making projects and cash flow",
      "description": "Ask which projects went into the red this month and whether cash covers the week's planned payments. Adesk connects with one API key from your profile.",
      "headline": "Adesk accounting in chat: cash flow, profit by project and debts",
      "scenarios": [
        {
          "title": "Monthly cash flow by category",
          "desc": "The agent collects money in and out for a period by category and account and shows where the money went and where it came from."
        },
        {
          "title": "Profit by project and deal",
          "desc": "The agent reads project figures and compares revenue, costs and margin, so you can see which deals lose money."
        },
        {
          "title": "Receivables and payables",
          "desc": "The agent rolls up commitments by counterparty: who owes you, whom you owe and what is overdue."
        },
        {
          "title": "Planned payments for the week",
          "desc": "The agent shows planned operations from the payment calendar for the coming days next to account balances, so you do not run short of cash."
        },
        {
          "title": "Assign operations to categories",
          "desc": "The agent finds operations without a category and suggests a category and a project for each, writing them only after you confirm."
        },
        {
          "title": "Budget against actuals",
          "desc": "The agent compares a budget with the month's actual operations and names the categories where spending went over plan."
        }
      ],
      "how_it_works": [
        "The work starts from the account's reference data: legal entities, bank accounts, operation categories, projects and counterparties. From them the agent learns how your accounting is set up, then reads operations for the period you need, filtered by account, category, project or counterparty, rather than pulling everything.",
        "Adesk returns lists in parts, so a long period is read page by page to the end, and the agent says so if it stopped early. Actual and planned operations are counted apart, and the payment date is kept apart from the accrual date: the cash flow report and the profit report are built on different dates.",
        "The agent can write everything the API opens: operations, transfers, commitments, projects, counterparties, budgets and custom lines of the profit and loss report. Every write and every deletion happens only after you confirm, and a deletion in Adesk cannot be undone.",
        "If the key is rejected or the subscription has ended, the agent says so instead of showing an empty table. It does not retry a wrong key: after several attempts in a row Adesk temporarily locks API sign-in, so the key is best copied again from the profile."
      ],
      "requirements": [
        "An active Adesk trial or subscription",
        "The API access key from «Настройки → Профиль» (Settings → Profile)",
        "Writes and deletions only after your confirmation"
      ],
      "faq": [
        {
          "q": "How do I connect Adesk?",
          "a": "With the API access key from «Настройки → Профиль» (Settings → Profile) in Adesk. The key is entered once and stored encrypted."
        },
        {
          "q": "What can the agent do in Adesk?",
          "a": "Read operations, accounts, projects, commitments, budgets and report lines, and create or change them after your confirmation."
        },
        {
          "q": "Does it work with several legal entities?",
          "a": "Yes, the agent sees every legal entity and bank account of the account and can roll them into one report or count them apart."
        }
      ]
    }
  },
  {
    "key": "alfabank",
    "name": "Альфа-Банк Бизнес",
    "name_en": "Alfa-Bank Business",
    "description": "Счета, выписки, операции, платежи",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "alfabank",
    "short_name": "Альфа-Банк",
    "short_name_en": "Alfa-Bank",
    "description_en": "Accounts, statements, transactions and payments",
    "guide": {
      "url": "https://developers.alfabank.ru/products/alfa-api",
      "steps": [
        {
          "title": "Проверьте счёт и Альфа-Бизнес Онлайн",
          "desc": "Alfa API выдают компаниям с расчётным счётом, оформленным РКО и подключённым Альфа-Бизнес Онлайн. Комиссий за подключение и использование API банк не берёт.",
          "title_en": "Check your account and Alfa-Business Online",
          "desc_en": "Alfa API is granted to companies with a settlement account, cash management and Alfa-Business Online (Альфа-Бизнес Онлайн) enabled. There is no connection fee."
        },
        {
          "title": "Напишите на alfa_api@alfabank.ru за доступом",
          "desc": "Отправьте заявку на alfa_api@alfabank.ru с реквизитами компании. Договор ИТВ придёт на подпись в Альфа-Бизнес Онлайн; после подписи банк выдаёт Client ID.",
          "title_en": "Email alfa_api@alfabank.ru to request access",
          "desc_en": "Email alfa_api@alfabank.ru with your company details. Sign the ITV agreement in Alfa-Business Online; the bank then issues your Client ID."
        },
        {
          "title": "Сформируйте CSR командой openssl req",
          "desc": "Выполните openssl req -new -key name.key -out name.csr и заполните поля с данными компании и ИНН. Банк вернёт сертификат в PEM; name.key остаётся только у вас.",
          "title_en": "Generate the CSR with openssl req",
          "desc_en": "Run openssl req -new -key name.key -out name.csr with your company details. The bank returns a PEM certificate; name.key never leaves you."
        },
        {
          "title": "Пройдите «Песочницу» и откройте доступ",
          "desc": "Проверьте методы в «Песочнице» и напишите на alfa_api@alfabank.ru письмо с темой «Завершено тестирование»: банк откроет baas.alfabank.ru.",
          "title_en": "Pass the Sandbox and open production",
          "desc_en": "Call the methods in the Sandbox, then email alfa_api@alfabank.ru with the subject “Завершено тестирование”. The bank opens baas.alfabank.ru."
        }
      ]
    },
    "seo": {
      "title": "Альфа-Банк API и ИИ: нетипичные списания и обороты",
      "description": "Интеграция Альфа-Бизнеса по API: агент найдёт нетипичные списания недели и сверит выписку с проводками 1С. Нужен API-ключ, для части методов сертификат.",
      "headline": "Смотрите обороты и операции по счетам Альфа-Банка в чате",
      "scenarios": [
        {
          "title": "Операции и остатки за период",
          "desc": "Агент выгрузит выписку по счетам Альфа-Бизнеса, посчитает обороты и покажет крупные и нетипичные операции."
        },
        {
          "title": "Сверка с бухгалтерией",
          "desc": "Агент сверит банковские операции с проводками 1С и покажет, какие платежи не отражены в учёте."
        },
        {
          "title": "Еженедельный финансовый дайджест",
          "desc": "Агент по расписанию соберёт динамику остатков, топ-платежи и поступления недели в один отчёт."
        },
        {
          "title": "Расклад по контрагентам",
          "desc": "Агент разложит поступления и платежи по контрагентам и назначениям и покажет, кто принёс больше всего денег, а на что они утекли."
        },
        {
          "title": "Платёжка перед отправкой",
          "desc": "Агент соберёт реквизиты и сумму распоряжения, покажет их одним списком и остановится, а подпись остаётся за вами в Альфа-Бизнес Онлайн."
        },
        {
          "title": "Куда ушли деньги за квартал",
          "desc": "Агент заберёт выписку за длинный период частями, склеит её сам и покажет структуру расходов и как менялись обороты от месяца к месяцу."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Альфа-Бизнеса на baas.alfabank.ru и начинает со списка счетов компании, тем же запросом, которым проверяется подключение. Дальше он забирает выписку по выбранным счетам за период, считает обороты по приходу и расходу, поднимает крупные и нетипичные операции и раскладывает поступления и платежи по контрагентам и назначениям, чтобы недельная сводка собиралась без ручной выгрузки из интернет-банка.",
        "Банковская выписка показывает не то же самое, что происходит на счёте прямо сейчас: в неё попадают операции, которые банк уже провёл, поэтому свежий платёж или зачисление появляются в ней позже, чем о них узнали в компании. Агент опирается на дату проводки, а не на момент, когда о платеже стало известно, и при сверке с проводками 1С сопоставляет операции по сумме, дате и реквизитам контрагента, а не по одному лишь назначению.",
        "По умолчанию агент читает: счета, выписки, историю операций, сверку с учётом и регулярные сводки. Платёжная часть API доступна, но подпись распоряжения остаётся на стороне банка и проходит через подтверждение в Альфа-Бизнес Онлайн, так что молча отправить деньги агент не может. Перед любым действием на запись он показывает собранные реквизиты и сумму и останавливается, пока вы их не подтвердите.",
        "Доступ устроен в два слоя: API-ключ передаётся как токен, а часть методов дополнительно требует клиентского сертификата, поэтому набор доступных операций зависит от того, какой слой открыт. Выписку API отдаёт страницами и с ограничением на длину периода, поэтому длинные интервалы агент собирает частями и склеивает сам, выдерживая частоту запросов. Если данных за период нет или ключу не хватает прав, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Расчётный счёт и оформленное РКО в Альфа-Банке",
        "Руководитель или сотрудник с правом подписи",
        "OpenSSL на компьютере для генерации приватного ключа"
      ],
      "faq": [
        {
          "q": "Что нужно для подключения Альфа-Банка?",
          "a": "API-ключ из Альфа-Бизнес Онлайн и, для части методов, клиентский сертификат. Всё хранится в зашифрованном виде."
        },
        {
          "q": "Какие данные читает агент?",
          "a": "Счета, выписки, операции и платежи компании в рамках прав ключа. Данные запрашиваются в момент задачи, без постоянной выгрузки."
        },
        {
          "q": "Можно ли отозвать доступ?",
          "a": "Да, в один клик: удалите подключение у нас или отзовите ключ в Альфа-Бизнес Онлайн, и доступ прекращается сразу."
        }
      ]
    },
    "seo_en": {
      "title": "Alfa-Bank API and AI agent: unusual debits and turnover",
      "description": "The agent reads Alfa-Business statements and flags unusual weekly debits or breaks down quarterly spending. Needs an API key, plus a certificate for some methods.",
      "headline": "See turnover and account transactions from Alfa-Bank in chat",
      "scenarios": [
        {
          "title": "Transactions and balances for any period",
          "desc": "The agent pulls the statement across your Alfa-Business accounts, totals turnover and flags large or unusual transactions."
        },
        {
          "title": "Reconciliation with accounting",
          "desc": "The agent matches bank transactions against 1C entries and shows which payments never made it into the books."
        },
        {
          "title": "Weekly financial digest",
          "desc": "On a schedule, the agent assembles balance dynamics, top payments and the week's incoming funds into a single report."
        },
        {
          "title": "Breakdown by counterparty",
          "desc": "The agent splits receipts and payments by counterparty and purpose and shows who brought in the most money and where it drained away."
        },
        {
          "title": "A payment before it leaves",
          "desc": "The agent assembles the order's details and amount, lays them out in one list and stops, while the signature stays with you in Alfa-Business Online."
        },
        {
          "title": "Where the quarter's money went",
          "desc": "The agent pulls a long statement period in chunks, stitches it together itself and shows the spending structure and how turnover moved month to month."
        }
      ],
      "how_it_works": [
        "The agent calls the Alfa-Business API at baas.alfabank.ru and starts from the list of company accounts, the same request that verifies the connection. From there it pulls the statement for the selected accounts over a period, totals incoming and outgoing turnover, surfaces large and unusual transactions and breaks payments and receipts down by counterparty and purpose, so the weekly summary comes together without a manual export from the internet bank.",
        "A bank statement is not the same thing as what is happening on the account right now: it carries the transactions the bank has already posted, so a fresh payment or credit appears in it later than the company learns about it. The agent works from the posting date rather than the moment the payment became known, and when reconciling against 1C entries it matches transactions by amount, date and counterparty details rather than by the payment purpose alone.",
        "By default the agent reads: accounts, statements, transaction history, reconciliation with the books and recurring summaries. The payment part of the API is available, but signing an order stays on the bank's side and goes through confirmation in Alfa-Business Online, so the agent cannot send money silently. Before any write action it shows the details and the amount it has assembled and stops until you confirm them.",
        "Access has two layers: the API key travels as a token, while some methods additionally require a client certificate, so the set of available operations depends on which layer is open. The statement comes back in pages and with a cap on the length of the period, so the agent collects long intervals in chunks and stitches them together itself, holding the request rate. If there is no data for the period or the key lacks permissions, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A settlement account and cash management at Alfa-Bank",
        "A director or an employee with signing authority",
        "OpenSSL installed to generate the private key"
      ],
      "faq": [
        {
          "q": "What do I need to connect Alfa-Bank?",
          "a": "An API key from Alfa-Business Online and, for some methods, a client certificate. Everything is stored encrypted."
        },
        {
          "q": "What data does the agent read?",
          "a": "Company accounts, statements, transactions and payments, within the permissions of the key. Data is requested at the moment of the task, with no permanent export."
        },
        {
          "q": "Can access be revoked?",
          "a": "Yes, in one click: delete the connection on our side or revoke the key in Alfa-Business Online, and access stops immediately."
        }
      ]
    }
  },
  {
    "key": "amocrm",
    "name": "AmoCRM (Kommo)",
    "name_en": "AmoCRM (Kommo)",
    "description": "Сделки, контакты и воронки продаж",
    "category": "crm",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "amocrm",
    "short_name": "amoCRM",
    "short_name_en": "amoCRM",
    "description_en": "Deals, contacts and sales pipelines",
    "search_terms": [
      "амо",
      "амоцрм",
      "коммо"
    ],
    "signup_url": "https://www.amocrm.ru/account/",
    "guide": {
      "url": "https://www.amocrm.ru",
      "steps": [
        {
          "title": "Под администратором скопируйте адрес аккаунта",
          "desc": "Скопируйте адрес аккаунта, например https://your-company.amocrm.ru. Укажите его целиком в поле «Адрес аккаунта». Для выпуска токена нужны права администратора.",
          "title_en": "As administrator, copy the account URL",
          "desc_en": "Copy your account URL, for example https://your-company.amocrm.ru, and paste it into Account URL. Administrator rights are required to generate a token."
        },
        {
          "title": "В амоМаркете создайте внешнюю интеграцию",
          "desc": "амоМаркет → Создать интеграцию → Внешняя интеграция. Заполните название и обязательные настройки amoCRM, затем сохраните интеграцию.",
          "title_en": "In amoMarket create an external integration",
          "desc_en": "amoMarket → Create integration → External integration. Enter a name and complete the required amoCRM settings, then save the integration."
        },
        {
          "title": "В блоке «Разрешить доступ» отметьте права",
          "desc": "В блоке «Разрешить доступ» отмечены все права. Оставьте сделки, контакты, компании и задачи: без них агент не увидит воронки и не сможет ставить задачи.",
          "title_en": "In the Allow access block select the scopes",
          "desc_en": "In the Allow access block every scope is checked. Keep leads, contacts, companies and tasks; the rest you can clear."
        },
        {
          "title": "В «Ключах и доступах» выпустите токен",
          "desc": "В «Ключах и доступах» сгенерируйте долгосрочный токен. Выберите срок и сразу скопируйте токен: его показывают один раз. Введите в форме адрес аккаунта и токен.",
          "title_en": "In Keys and access issue a long-lived token",
          "desc_en": "In Keys and access, generate a long-lived token. Choose an expiry and copy it immediately: it is shown once. Enter your account URL and token in our form."
        }
      ]
    },
    "seo": {
      "title": "amoCRM и ИИ-агент: где теряются сделки в воронке",
      "description": "Из 312 сделок квартала до оплаты дошли 47. Агент находит этап, где воронка amoCRM теряет больше всего, и карточки, в которых не хватает полей для работы.",
      "headline": "Находите дыры в воронке продаж, не открывая amoCRM",
      "scenarios": [
        {
          "title": "Найти дыры в воронке продаж",
          "desc": "Агент разберёт сделки по этапам, посчитает конверсию между шагами и покажет, где лиды застревают или теряются без задач."
        },
        {
          "title": "Сводка по менеджерам за неделю",
          "desc": "Агент соберёт по каждому менеджеру новые сделки, закрытия, суммы и просроченные задачи, и отчёт готов к планёрке."
        },
        {
          "title": "Реанимация зависших сделок",
          "desc": "Агент найдёт сделки без движения дольше N дней, сгруппирует по этапам и подготовит список для прозвона с контекстом по каждой."
        },
        {
          "title": "Контроль качества заполнения CRM",
          "desc": "Агент проверит сделки без бюджета, контакты без телефона и лиды без ответственного, а затем пришлёт список на исправление."
        },
        {
          "title": "Дежурство по новым лидам",
          "desc": "Агент ловит подписанный вебхук о новой сделке, поднимает карточку с бюджетом, контактом и ответственным и пишет в чат, не опрашивая CRM по расписанию."
        },
        {
          "title": "Задачи по итогам разбора",
          "desc": "Агент соберёт сделки без единой задачи, покажет списком (кому и что поставить) и после вашего подтверждения проставит задачи, перечитав каждую сделку."
        }
      ],
      "how_it_works": [
        "Агент ходит в API вашего аккаунта по адресу поддомена (amocrm.ru у amoCRM или kommo.com у Kommo) и читает сделки, контакты, компании, воронки, задачи и примечания. Первым делом он забирает список воронок вместе с их этапами: без этой карты конверсию не с чем сопоставить. Дальше считаются переходы между шагами, суммы и сроки по каждому менеджеру, сделки без движения и поля, которые остались пустыми: бюджет, телефон, ответственный.",
        "Этап сделки в amoCRM двигают руками, поэтому сам по себе он не говорит, работают с клиентом или нет. Агент смотрит на дату последнего изменения, на открытые и просроченные задачи и на переписку в примечаниях: сделка, третью неделю стоящая на переговорах без единой задачи, попадает в зависшие, а не в активные. Одинаковые названия этапов в разных воронках это разные сущности, и в одну конверсию агент их не сводит.",
        "На запись агент делает то, что разрешено интеграции: ставит задачи, переводит сделки между этапами, дописывает примечания. Перед правкой он перечитывает сделку, чтобы не затереть свежее изменение менеджера, а массовое действие (перевод десятка сделок или раздачу задач) показывает списком и ждёт подтверждения. О создании, обновлении и удалении сделок, контактов, компаний и задач amoCRM сообщает подписанными вебхуками, так что о смене агент узнаёт без постоянного опроса.",
        "Долгосрочный токен действует до выбранной при выпуске даты и не продлевается автоматически. По истечении срока создайте новый токен в amoCRM и замените его в подключении. Сделки, контакты и задачи amoCRM отдаёт страницами по 250 записей, и агент дочитывает выборку до конца, а не обрывается на первой странице. Если интеграцию отозвали в кабинете, доступ обрывается сразу, и агент говорит, что подключение нужно восстановить, вместо того чтобы молча вернуть ноль. Частоту запросов он держит в рамках допустимого, а если раздел закрыт правами или сделок за период не было, скажет это прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права администратора аккаунта amoCRM или Kommo.",
        "Полный адрес кабинета, например https://your-company.amocrm.ru.",
        "Долгосрочный токен внешней интеграции с правами на нужные данные."
      ],
      "faq": [
        {
          "q": "Как подключается amoCRM?",
          "a": "По долгосрочному токену: в «амоМаркет» откройте внешнюю интеграцию, затем «Ключи и доступы» → «Долгосрочный токен» → «Сгенерировать токен». Выберите срок действия и скопируйте токен в нашу форму вместе с полным адресом аккаунта. Доступ работает от имени интеграции и отзывается там же."
        },
        {
          "q": "Что агент видит в amoCRM?",
          "a": "Сделки, контакты, компании, воронки, задачи и примечания в рамках прав, выданных интеграции. Агент читает данные по запросу и не копирует базу целиком."
        },
        {
          "q": "Может ли агент создавать и менять сделки?",
          "a": "Да, при выданных правах на запись: создавать задачи, двигать сделки по этапам, дописывать примечания. Любое действие с записью агент подтверждает у вас, если не настроено иначе."
        },
        {
          "q": "Работает ли с Kommo?",
          "a": "Да, Kommo это международная версия amoCRM с тем же API, коннектор совместим с обеими."
        }
      ]
    },
    "seo_en": {
      "title": "amoCRM and AI agent: where deals drop out of the funnel",
      "description": "Of 312 deals this quarter, 47 reached payment. The agent finds the stage where the amoCRM funnel loses the most and the cards missing the fields reps need.",
      "headline": "Find the leaks in your sales funnel without opening amoCRM",
      "scenarios": [
        {
          "title": "Find the leaks in your sales funnel",
          "desc": "The agent breaks deals down by stage, computes step-to-step conversion and shows where leads stall or slip away with no task attached."
        },
        {
          "title": "Weekly rep performance summary",
          "desc": "The agent gathers new deals, closures, amounts and overdue tasks for every rep, so the report is ready for the stand-up."
        },
        {
          "title": "Revive stalled deals",
          "desc": "The agent finds deals with no movement for N days, groups them by stage and prepares a call list with context on each one."
        },
        {
          "title": "Keep CRM data clean",
          "desc": "The agent checks for deals without a budget, contacts without a phone and leads with no owner, then sends a list to fix."
        },
        {
          "title": "Keep watch on new leads",
          "desc": "The agent catches a signed webhook about a new deal, pulls up the card with budget, contact and owner and posts it to chat, with no scheduled polling."
        },
        {
          "title": "Hand out tasks after a review",
          "desc": "The agent collects deals with not a single task, lists who should get what, and once you confirm it creates the tasks, re-reading every deal first."
        }
      ],
      "how_it_works": [
        "The agent calls your account API at the address of your subdomain (amocrm.ru for amoCRM or kommo.com for Kommo) and reads deals, contacts, companies, pipelines, tasks and notes. The first thing it fetches is the list of pipelines together with their stages: without that map there is nothing to measure conversion against. Then it counts the step-to-step transitions, amounts and timings per rep, deals with no movement and the fields left empty: budget, phone, owner.",
        "A deal stage in amoCRM is moved by hand, so on its own it does not tell you whether anyone is working the client. The agent looks at the date of the last change, at open and overdue tasks and at the correspondence in the notes: a deal sitting in negotiations for a third week with not a single task lands in the stalled pile, not the active one. Identically named stages in different pipelines are different entities, and the agent does not merge them into one conversion.",
        "For writes the agent does what the integration is allowed to do: create tasks, move deals between stages, append notes. Before an edit it re-reads the deal so as not to overwrite a rep's fresh change, and a bulk action (moving a dozen deals or handing out tasks) is shown as a list and waits for confirmation. Creations, updates and deletions of deals, contacts, companies and tasks arrive from amoCRM as signed webhooks, so the agent learns about a change without constant polling.",
        "The long-lived token works until the expiry date chosen at issuance and does not renew automatically. When it expires, generate a new token in amoCRM and replace it in the connection. Deals, contacts and tasks come back from amoCRM in pages of 250 records, and the agent reads a selection to the end instead of stopping at the first page. Revoke the integration in the account and access stops immediately, and the agent says the connection has to be restored rather than quietly returning zero. It keeps the request rate within what is allowed, and if a section is closed by permissions or there simply were no deals in the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Account administrator rights in amoCRM or Kommo.",
        "Your full account URL, for example https://your-company.amocrm.ru.",
        "A long-lived external integration token with access to the required data."
      ],
      "faq": [
        {
          "q": "How does amoCRM connect?",
          "a": "Using a long-lived token: open your external integration in amoMarket, then Keys and access → Long-lived token → Generate token. Choose an expiry date and paste the token into our form along with your full account URL. Access runs on behalf of the integration and is revoked in the same place."
        },
        {
          "q": "What does the agent see in amoCRM?",
          "a": "Deals, contacts, companies, pipelines, tasks and notes, within the permissions granted to the integration. The agent reads data on demand and never copies the whole database."
        },
        {
          "q": "Can the agent create and change deals?",
          "a": "Yes, when write permissions are granted: create tasks, move deals between stages, append notes. The agent confirms every write with you unless you configure it otherwise."
        },
        {
          "q": "Does it work with Kommo?",
          "a": "Yes. Kommo is the international version of amoCRM with the same API, and the connector supports both."
        }
      ]
    }
  },
  {
    "key": "appmetrica",
    "name": "AppMetrica",
    "name_en": "AppMetrica",
    "description": "Мобильная аналитика Яндекса: установки, сессии, события, краши, выручка, push-кампании",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "appmetrica",
    "description_en": "Yandex mobile analytics: installs, sessions, events, crashes, revenue and push campaigns",
    "search_terms": [
      "аппметрика"
    ],
    "guide": {
      "url": "https://appmetrica.yandex.ru",
      "steps": [
        {
          "title": "На appmetrica.yandex.ru войдите Яндекс ID",
          "desc": "Откройте appmetrica.yandex.ru и войдите тем Яндекс ID, в чьём списке видно приложение. Код подтверждения нужно будет вводить под этим же логином.",
          "title_en": "Sign in to appmetrica.yandex.ru by Yandex ID",
          "desc_en": "Open appmetrica.yandex.ru and sign in with the Yandex ID that sees the app in its list. The confirmation code must be entered under that same login."
        },
        {
          "title": "Проверьте, что приложение есть в кабинете",
          "desc": "Приложение должно быть в списке кабинета. Если его нет, заведите новое и отдайте разработчику API key из «Настройки» → «Основное».",
          "title_en": "Check the app is listed in the account",
          "desc_en": "The app must be in the account's list. If it is missing, create it and give your developer the API key from “Settings” → “General”."
        },
        {
          "title": "В «Управлении доступом» добавьте Яндекс ID",
          "desc": "Настройки приложения → «Управление доступом» → добавьте почту Яндекс ID. Отчётам хватит «Только чтение», push-кампаниям нужно «Чтение/редактирование».",
          "title_en": "In Access management add the Yandex ID",
          "desc_en": "App settings → “Access management” → add the Yandex ID email. Reports need only “Read only”; push campaigns need “Read/edit”."
        },
        {
          "title": "Не выдавайте уровень «Агентство: чтение»",
          "desc": "«Агентство: чтение» показывает только выбранные источники трафика и целевые события, поэтому сводка по установкам, выручке и крашам придёт неполной.",
          "title_en": "Do not grant the Agency: read level",
          "desc_en": "“Agency: read” exposes only the selected traffic sources and target events, so the installs, revenue and crash summary arrives incomplete."
        },
        {
          "title": "В «Экспорте данных» допустите неточности",
          "desc": "«Настройки» → «Основное» → «Экспорт данных». Включённая опция отдаёт выгрузку при сбое части серверов, теряя менее 1% строк; выключенная ждёт всех.",
          "title_en": "In Data export allow inaccurate results",
          "desc_en": "“Settings” → “General” → “Data export”. Enabled, exports run even when some servers are down, losing under 1% of rows; disabled, they wait."
        }
      ]
    },
    "seo": {
      "title": "AppMetrica и ИИ-агент: какой релиз роняет приложение",
      "description": "Найдёт релиз, из-за которого приложение стало падать, и посчитает задетые устройства; разложит установки и ARPU по каналам. Вход через аккаунт Яндекса.",
      "headline": "Разбирайте источники установок и качество трафика в чате",
      "scenarios": [
        {
          "title": "Источники установок и качество трафика",
          "desc": "Агент разложит установки и сессии по партнёрам и источникам, посчитает выручку и ARPU и покажет, какие каналы приводят платящих пользователей."
        },
        {
          "title": "Краши по версиям приложения",
          "desc": "Агент соберёт краши и ошибки в разрезе версий, ОС и моделей устройств, посчитает задетые устройства и покажет, какой релиз ломает приложение."
        },
        {
          "title": "Ежедневная сводка по продукту",
          "desc": "Агент подтянет активные устройства, сессии, retention и выручку за сутки и пришлёт короткую сводку в разрезе стран и версий приложения."
        },
        {
          "title": "Выгрузка сырых событий",
          "desc": "Агент выгрузит через Logs API установки, кастомные события и краши построчно за период и сведёт их в разрез, которого нет в отчётах кабинета."
        },
        {
          "title": "Push-рассылка по группе",
          "desc": "Агент заведёт группу push-кампании, покажет параметры и текст до отправки, отправит после подтверждения и перечитает статус: дошла рассылка или отвалилась."
        },
        {
          "title": "Все приложения кабинета разом",
          "desc": "Агент пройдёт по списку приложений кабинета и сведёт установки, сессии и выручку каждого в одну таблицу: видно, какой проект растёт, а какой просел."
        }
      ],
      "how_it_works": [
        "Агент ходит в API AppMetrica под OAuth-токеном Яндекса: сначала забирает список приложений кабинета через management/v1/applications, затем снимает отчёты Reporting API (установки, сессии, активные устройства, кастомные события, краши и выручку) в разрезах по партнёрам и источникам трафика, версиям приложения, ОС, моделям устройств и странам. Поверх этого считаются ARPU и retention, а каналы сравниваются по платящим пользователям, а не по объёму установок.",
        "Сырые данные AppMetrica отдаёт иначе, чем отчёты: Logs API готовит выгрузку асинхронно: первый запрос ставит задачу, а файл приезжает только после подготовки, поэтому агент повторяет обращение до готовности. Пагинации там нет, так что длинный период он режет на куски по датам и склеивает построчные установки, кастомные события и краши сам. Так собирается разрез, которого в отчётах кабинета нет.",
        "На запись агент выходит только там, где это разрешает уровень доступа: заводит группы push-кампаний, отправляет рассылки и правит настройки приложения. Перед отправкой он показывает, какая группа и с какими параметрами уходит, и ждёт явного подтверждения. Рассылка уходит группой, а не по одному устройству, и после отправки агент перечитывает статус кампании, чтобы сказать, дошла она или отвалилась.",
        "Подключение идёт входом в аккаунт Яндекса по коду: токен агент получает и продлевает сам, копировать ключи вручную не нужно. Отчёты AppMetrica досчитывает не мгновенно: последние часы ещё догружаются, поэтому агент называет дату среза рядом с цифрами и не выдаёт неполные сутки за итог. Частоту запросов он выдерживает сам, а если данных за период нет, так и говорит, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Аккаунт Яндекса с доступом к приложению в AppMetrica",
        "Уровень доступа «Только чтение» или выше, не агентский",
        "SDK в приложении инициализирован, иначе отчёты пустые"
      ],
      "faq": [
        {
          "q": "Как подключить AppMetrica?",
          "a": "Входом в аккаунт Яндекса по коду: вы подтверждаете доступ, токен агент получает сам. Заранее проверьте, что этому логину в «Управление доступом» приложения выдан уровень «Только чтение» или выше: агентский уровень отдаёт данные не полностью."
        },
        {
          "q": "Какие данные видит агент?",
          "a": "Список приложений кабинета, отчёты Reporting API (установки, сессии, активные устройства, кастомные события, краши и выручку) и построчные выгрузки Logs API по тем приложениям, к которым у вашего логина есть доступ."
        },
        {
          "q": "Может ли агент что-то менять в AppMetrica?",
          "a": "Да, если уровень доступа «Чтение/редактирование»: агент умеет заводить группы push-кампаний, отправлять рассылки и править настройки приложения. С уровнем «Только чтение» остаются отчёты и выгрузки."
        },
        {
          "q": "Почему выгрузка Logs API приходит не сразу?",
          "a": "Logs API готовит файл асинхронно: первый запрос ставит задачу, данные приезжают после подготовки, поэтому агент повторяет запрос до готовности. Пагинации там нет, большой период он режет на куски по датам."
        }
      ]
    },
    "seo_en": {
      "title": "AppMetrica AI agent: find the release causing crashes",
      "description": "Pinpoints the release behind a crash spike and counts affected devices, then splits installs and ARPU by channel. Connects through your Yandex account.",
      "headline": "Break down install sources and traffic quality in chat",
      "scenarios": [
        {
          "title": "Install sources and traffic quality",
          "desc": "The agent splits installs and sessions by partner and source, computes revenue and ARPU and shows which channels bring paying users."
        },
        {
          "title": "Crashes by app version",
          "desc": "The agent collects crashes and errors by version, OS and device model, counts affected devices and shows which release is breaking the app."
        },
        {
          "title": "Daily product summary",
          "desc": "The agent pulls active devices, sessions, retention and revenue for the day and sends a short summary split by country and app version."
        },
        {
          "title": "Raw event export",
          "desc": "Through the Logs API the agent exports installs, custom events and crashes row by row for a period and builds a breakdown the dashboard does not offer."
        },
        {
          "title": "Push campaign to a group",
          "desc": "The agent creates a push campaign group, shows the parameters and text before sending, sends it once you confirm and re-reads the status to say whether it landed."
        },
        {
          "title": "Every app in the account at once",
          "desc": "The agent walks the list of apps in the account and pulls installs, sessions and revenue for each into one table, showing which project grew and which slipped."
        }
      ],
      "how_it_works": [
        "The agent calls the AppMetrica API with a Yandex OAuth token: first it fetches the list of apps in the account through management/v1/applications, then it pulls Reporting API reports (installs, sessions, active devices, custom events, crashes and revenue) broken down by partner and traffic source, app version, OS, device model and country. On top of that it computes ARPU and retention, and compares channels by paying users rather than by install volume.",
        "AppMetrica hands out raw data differently from reports: the Logs API prepares an export asynchronously: the first request queues the job and the file only arrives once it is ready, so the agent retries until it is. There is no pagination there, so a long period is split into date chunks and the row-level installs, custom events and crashes are stitched together by the agent. That is how a breakdown the dashboard does not offer gets built.",
        "The agent writes only where the access level permits it: it creates push campaign groups, sends campaigns and edits app settings. Before sending it shows which group goes out and with which parameters, and waits for an explicit confirmation. A campaign goes out as a group rather than device by device, and after sending the agent re-reads the campaign status to say whether it landed or fell over.",
        "The connection runs as a sign-in to a Yandex account with a code: the agent obtains and renews the token itself, with no keys to copy by hand. AppMetrica does not finish counting reports instantly: the last hours are still loading, so the agent names the cut-off date next to the figures and never passes an incomplete day off as a total. It holds the request rate itself, and if there is no data for the period it says so instead of showing an empty table."
      ],
      "requirements": [
        "A Yandex account with access to the app in AppMetrica",
        "Access level Read only or higher, not an agency level",
        "The SDK initialised in the app, otherwise reports stay empty"
      ],
      "faq": [
        {
          "q": "How do I connect AppMetrica?",
          "a": "By signing in to your Yandex account with a code: you confirm access and the agent obtains the token itself. Check in advance that this login has the Read-only level or higher in Access management for the app, because the agency level returns incomplete data."
        },
        {
          "q": "What data does the agent see?",
          "a": "The list of apps in the account, Reporting API reports such as installs, sessions, active devices, custom events, crashes and revenue, and row-level Logs API exports for the apps your login can access."
        },
        {
          "q": "Can the agent change anything in AppMetrica?",
          "a": "Yes, with the Read and edit access level the agent can create push campaign groups, send campaigns and edit app settings. With Read-only it is limited to reports and exports."
        },
        {
          "q": "Why does a Logs API export not arrive right away?",
          "a": "The Logs API prepares the file asynchronously: the first request queues the job and the data arrives once it is ready, so the agent retries until it is. There is no pagination there, so a long period is split into date chunks."
        }
      ]
    }
  },
  {
    "key": "ati_su",
    "name": "ATI.SU",
    "name_en": "ATI.SU",
    "description": "Биржа грузоперевозок: грузы, торги, машины, фирмы, АТИ-Доки, тайм-слоты, индекс ставок",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ati-su",
    "description_en": "Freight exchange: loads, bids, trucks, companies, ATI-Docs, time slots and rate index",
    "search_terms": [
      "ати"
    ],
    "signup_url": "https://id.ati.su/register/",
    "guide": {
      "url": "https://ati.su/developers/tokens/",
      "steps": [
        {
          "title": "Войдите на ATI.SU под контактом фирмы",
          "desc": "Токен привязан к контакту и фирме: он перестаёт работать при смене пароля, удалении контакта или фирмы. Аккаунт на ATI.SU должен быть подтверждён заранее.",
          "title_en": "Sign in to ATI.SU as the firm's contact",
          "desc_en": "The token is bound to a contact and a firm: it stops working if the password changes or the contact or firm is deleted. Verify the ATI.SU account beforehand."
        },
        {
          "title": "Откройте ati.su/developers/tokens/",
          "desc": "Портал ati.su/developers/tokens/ → «Мои токены». Таблица показывает столбцы «Приложение», «Client_id», «Токен» и дату окончания срока.",
          "title_en": "Open ati.su/developers/tokens/",
          "desc_en": "Portal ati.su/developers/tokens/ → “Мои токены” (My tokens). The table lists the application, the client_id, the token itself and the expiry date."
        },
        {
          "title": "Нажмите «Создать временный токен»",
          "desc": "Кнопка выдаёт токен приложения api-panda-portal без полей ввода. Живёт 7 дней: хватит на проверку, но не на постоянную работу.",
          "title_en": "Press “Создать временный токен”",
          "desc_en": "The button issues an api-panda-portal token with no fields to fill. It lives 7 days: enough for a trial, not for permanent work."
        },
        {
          "title": "Запросите client_id на api@ati.su",
          "desc": "Постоянный токен создаётся только по client_id. Напишите на api@ati.su имя и почту сотрудника, название продукта и цель использования API.",
          "title_en": "Request a client_id at api@ati.su",
          "desc_en": "A permanent token is issued only against a client_id. Write to api@ati.su with the employee name and email, product name and purpose."
        },
        {
          "title": "Впишите client_id и нажмите «Создать токен»",
          "desc": "Новый токен появится строкой в списке. Скопируйте значение из столбца «Токен».",
          "title_en": "Enter the client_id and press “Создать токен”",
          "desc_en": "The new token appears as a row in the list. Copy the value from the Token column."
        }
      ]
    },
    "seo": {
      "title": "ATI.SU API и ИИ-агент: ставки рейсов против индекса",
      "description": "Подключить ИИ к АТИ (ATI.SU) можно токеном API. Агент покажет, где ставки выше индекса ATI.SU, например 214 тыс ₽ переплаты за месяц, и найдёт рейсы без перевозчика.",
      "headline": "Находите рейсы без перевозчика на ATI.SU прямо в чате",
      "scenarios": [
        {
          "title": "Рейсы без перевозчика",
          "desc": "Агент пройдёт по вашим грузам и заказам на бирже и покажет, какие рейсы до сих пор висят без перевозчика и сколько времени."
        },
        {
          "title": "Ставки против индекса",
          "desc": "Агент сверит ставки в ваших заказах с индексом ATI.SU по направлению и назовёт маршруты, где вы платите заметно выше рынка."
        },
        {
          "title": "Сводка по торгам и откликам",
          "desc": "Агент соберёт утреннюю сводку по торгам и новым откликам перевозчиков, чтобы биржу не приходилось обновлять вручную."
        },
        {
          "title": "Проверка фирмы перед рейсом",
          "desc": "Агент поднимет карточку фирмы в справочнике ATI.SU, покажет её машины и площадки, по которым вы решаете, отдавать ли рейс."
        },
        {
          "title": "Документы по рейсу",
          "desc": "Агент поднимет АТИ-Доки по нужному заказу и назовёт, каких документов до сих пор нет, раньше, чем их хватится бухгалтерия."
        },
        {
          "title": "Тайм-слоты на ближайшие дни",
          "desc": "Агент соберёт тайм-слоты на площадках и покажет, где погрузка встала впритык к разгрузке, а где окно так и осталось пустым."
        }
      ],
      "how_it_works": [
        "Агент ходит в API биржи на api.ati.su и читает те же разделы, что вы видите в кабинете: грузы и заказы, торги и отклики перевозчиков, справочник фирм с их машинами и площадками, переписку в мессенджере биржи, документы АТИ-Доки, тайм-слоты и индекс ставок. Разделы он запрашивает по одному под конкретный вопрос, а не выкачивает биржу целиком: на вопрос про рейс поднимаются заявка, отклики по ней и карточка перевозчика, остальное не трогается.",
        "Устроена биржа так, что статус заявки сам по себе говорит мало: груз неделю числится размещённым и при этом не собирает ни одного отклика. Поэтому агент считает не статус, а время рейса без перевозчика и число откликов по каждой заявке. Ставку из вашего заказа он сверяет с индексом ATI.SU по направлению, помня, что индекс это рыночный ориентир по маршруту, а не цена конкретной сделки.",
        "По умолчанию агент работает на чтение: собирает утреннюю сводку по торгам и новым откликам, поднимает карточку фирмы вместе с её машинами и площадками перед тем, как отдать рейс, и складывает найденное в ответ в чате. Всё, что меняет состояние на бирже (сообщение перевозчику в мессенджере, движение по заказу), он сначала показывает целиком и отправляет только после вашего подтверждения.",
        "Частота ограничена десятью запросами в секунду, поэтому большие выгрузки агент собирает частями и растягивает по времени, а не бьёт биржу параллельными вызовами. Списки он забирает страницами и останавливается, когда набрал нужный период, а не когда кончились данные. Про раздел, который не ответил, агент говорит прямо, вместо пустой таблицы."
      ],
      "requirements": [
        "Зарегистрированная и подтверждённая фирма на ATI.SU",
        "Права на нужные разделы биржи у вашего аккаунта"
      ],
      "faq": [
        {
          "q": "Как подключить ATI.SU?",
          "a": "API-токеном: на портале ati.su/developers/tokens/ в разделе «Мои токены» кнопка «Создать временный токен» даёт ключ на 7 дней для проверки, а для постоянной работы client_id запрашивается на api@ati.su. Значение из столбца «Токен» вставляется в поле токена."
        },
        {
          "q": "Что агент видит в ATI.SU?",
          "a": "Грузы, заказы, торги, машины, фирмы и площадки, переписку в мессенджере биржи, документы АТИ-Доки и индекс ставок в пределах прав аккаунта, чей токен подключён."
        },
        {
          "q": "Пишет ли агент в ATI.SU?",
          "a": "По умолчанию агент читает биржу и отвечает в чате. Права токена наследуются от аккаунта: если доступа к разделу нет, агент прямо скажет, чего не хватает, вместо непонятной ошибки."
        },
        {
          "q": "Есть ли ограничения по запросам?",
          "a": "Обращения идут не чаще 10 запросов в секунду, поэтому большие выгрузки агент собирает частями. Временный токен живёт 7 дней, после этого подключение нужно обновить постоянным."
        }
      ]
    },
    "seo_en": {
      "title": "ATI.SU API for an AI agent: rates against the ATI index",
      "description": "Checks your ATI.SU order rates against the index and names the lanes where you overpay, then finds loads with no carrier. Connects with an ATI.SU API token.",
      "headline": "Spot ATI.SU loads still without a carrier right in chat",
      "scenarios": [
        {
          "title": "Loads with no carrier",
          "desc": "The agent walks through your cargo and orders on the exchange and shows which trips are still sitting without a carrier, and for how long."
        },
        {
          "title": "Rates against the index",
          "desc": "The agent compares the rates in your orders with the ATI.SU index for the lane and names the routes where you pay noticeably above market."
        },
        {
          "title": "Auctions and responses at a glance",
          "desc": "The agent builds a morning summary of auctions and new carrier responses, so nobody has to refresh the exchange by hand."
        },
        {
          "title": "Vet a firm before the trip",
          "desc": "The agent pulls up the firm card in the ATI.SU directory and shows its trucks and sites, which is enough to decide whether to hand over the trip."
        },
        {
          "title": "Paperwork on a trip",
          "desc": "The agent pulls the ATI-Doki documents for a given order and names the ones still missing, well before accounting comes looking for them."
        },
        {
          "title": "Time slots for the days ahead",
          "desc": "The agent collects the time slots across sites and shows where loading ended up back to back with unloading and where a window stayed empty."
        }
      ],
      "how_it_works": [
        "The agent calls the exchange API at api.ati.su and reads the same sections you see in the account: cargo and orders, auctions and carrier responses, the firm directory with their trucks and sites, conversations in the exchange messenger, ATI-Doki documents, time slots and the rate index. It requests the sections one at a time, under the specific question, rather than pulling the whole exchange: a question about a trip raises the listing, its responses and the carrier card and leaves the rest alone.",
        "The exchange is built so that the status of a listing on its own says little: a load sits marked as posted for a week and collects not a single response. So the agent counts not the status but the time a trip spends without a carrier and the number of responses on each listing. The rate in your order is compared against the ATI.SU index for the lane, keeping in mind that the index is a market reference for the route, not the price of a particular deal.",
        "By default the agent works read-only: it builds a morning summary of auctions and new responses, pulls up a firm card together with its trucks and sites before a trip is handed over, and puts what it found into a reply in chat. Anything that changes state on the exchange (a message to a carrier in the messenger, a move on an order) it first shows in full and sends only after your confirmation.",
        "The rate is capped at ten requests per second, so large exports are collected in parts and spread over time rather than fired at the exchange in parallel. Lists are taken page by page and the agent stops once it has the period it was asked for, not once the data runs out. About a section that did not answer it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A registered and verified company on ATI.SU",
        "Account rights to the exchange sections you need"
      ],
      "faq": [
        {
          "q": "How do I connect ATI.SU?",
          "a": "With an API token: on ati.su/developers/tokens/ the My tokens section has a Create temporary token button that issues a key for 7 days of testing, and for permanent work a client_id is requested at api@ati.su. Paste the value from the Token column into the token field."
        },
        {
          "q": "What does the agent see in ATI.SU?",
          "a": "Cargo, orders, auctions, trucks, firms and sites, conversations in the exchange messenger, ATI-Doki documents and the rate index, within the permissions of the account whose token is connected."
        },
        {
          "q": "Does the agent write to ATI.SU?",
          "a": "By default the agent reads the exchange and replies in chat. Token rights are inherited from the account: if a section is closed, the agent says plainly what is missing instead of throwing a cryptic error."
        },
        {
          "q": "Are there request limits?",
          "a": "Requests go out at no more than 10 per second, so the agent collects large exports in parts. A temporary token lives 7 days, after which the connection has to be renewed with a permanent one."
        }
      ]
    }
  },
  {
    "key": "avito",
    "name": "Avito",
    "name_en": "Avito",
    "description": "Объявления, статистика, мессенджер, отзывы и автозагрузка",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "avito",
    "short_name": "Авито",
    "short_name_en": "Avito",
    "description_en": "Listings, statistics, messenger, reviews and autoload",
    "guide": {
      "url": "https://www.avito.ru/professionals/api",
      "steps": [
        {
          "title": "Подключите платный тариф на аккаунте Авито",
          "desc": "Персональные ключи Авито выдаёт только аккаунтам с платным тарифом. Тариф нужен на том аккаунте, где лежат нужные объявления.",
          "title_en": "Activate a paid plan on the Avito account",
          "desc_en": "Avito issues personal API keys only to accounts on a paid plan. The plan must be on the account that holds the listings you care about."
        },
        {
          "title": "Откройте avito.ru/professionals/api",
          "desc": "Путь в меню: «Управление профилем» → «Настройки» → «Интеграции»; тот же раздел открывается по адресу avito.ru/professionals/api.",
          "title_en": "Open avito.ru/professionals/api",
          "desc_en": "Menu path: «Управление профилем» → «Настройки» → «Интеграции»; the same section opens directly at avito.ru/professionals/api."
        },
        {
          "title": "Нажмите «Получить ключи»",
          "desc": "Появятся Client ID и Client secret (в форме подключения это «ID клиента» и «Секрет клиента»). Если пусто, обновите страницу через минуту: ключи создаются не сразу.",
          "title_en": "Press «Получить ключи» (Get keys)",
          "desc_en": "A pair of values appears: Client ID and Client secret. If nothing shows up right away, reload the page after a minute, as keys are not issued instantly."
        },
        {
          "title": "Скопируйте ID клиента и секрет клиента",
          "desc": "Нужны обе строки. Пара остаётся в разделе, скопировать её можно повторно; ключи действуют только для того аккаунта, где выданы.",
          "title_en": "Copy the Client ID and the Client secret",
          "desc_en": "Both strings are needed. The pair stays in the section and can be copied again; the keys work only for the account that issued them."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для Авито: отзывы, чаты и отдача продвижения",
      "description": "Покажет, какие объявления на Авито тратят бюджет продвижения без единого контакта, и подготовит ответы на отзывы на две звезды. Вход парой Client ID и Client Secret.",
      "headline": "ИИ для Авито: считайте отдачу объявлений и отвечайте в чате",
      "scenarios": [
        {
          "title": "Сводка по объявлениям и звонкам",
          "desc": "Агент соберёт статистику просмотров, контактов и звонков по объявлениям и покажет, какие позиции дают лиды, а какие висят мёртвым грузом."
        },
        {
          "title": "Разбор входящих сообщений",
          "desc": "Агент пройдёт по диалогам мессенджера Avito, выделит горячие запросы без ответа и подготовит черновики ответов."
        },
        {
          "title": "Контроль отзывов профиля",
          "desc": "Агент отследит новые отзывы, подготовит ответы и предупредит о негативе, который снижает рейтинг профиля."
        },
        {
          "title": "Куда ушёл бюджет продвижения",
          "desc": "Агент сведёт расходы на продвижение с контактами и избранным по каждому объявлению и покажет, какие позиции окупают платный показ, а какие просто тратят."
        },
        {
          "title": "Что не встало из автозагрузки",
          "desc": "Агент разберёт последние выгрузки автозагрузки, назовёт объявления, которые не появились в профиле, и покажет причину отказа по каждому."
        },
        {
          "title": "Новые чаты за ночь",
          "desc": "Агент к утру покажет чаты, открытые за ночь: уведомление о каждом приходит сразу, поэтому в сводке видно и первый вопрос покупателя, и время ожидания."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Авито напрямую: читает объявления профиля и их статистику (просмотры, контакты, избранное и расходы на продвижение), разбирает диалоги мессенджера, отзывы профиля и выгрузки автозагрузки. Подключение он проверяет запросом к собственному аккаунту, поэтому сразу знает, чей профиль обслуживает, и сводит цифры по объявлениям с ценами, показывая отдачу от размещения, а не голый счётчик просмотров.",
        "Мессенджер и отзывы агент не опрашивает по кругу: новое сообщение, открытый чат, добавленный и обновлённый отзыв приходят уведомлениями на личный адрес этого подключения, и чужой адрес их не примет. Отдельное событие «отзыв обновлён» здесь важно: оценка и текст на Авито правятся задним числом, поэтому агент перечитывает отзыв, а не полагается на первую версию, попавшую в сводку.",
        "На запись агент работает в мессенджере и в отзывах: отвечает в диалогах и готовит ответы на отзывы. Режим выбираете вы: агент отправляет сам или оставляет черновик, который отправляете вы. Горячие запросы без ответа он поднимает наверх и отделяет от переписки, которая уже закрыта, а негатив, бьющий по рейтингу профиля, называет отдельно, а не растворяет в общей статистике.",
        "По паре Client ID и Client Secret сервис сам получает токен и обновляет его по истечении суток, копировать вручную нечего. Что агенту доступно, решает набор прав токена: без права messenger диалоги и ответы закрыты, и агент назовёт это причиной, а не промолчит. Частоту запросов он держит сам, а к Автотеке обращается заметно реже, чем к остальным разделам: там лимит жёстче. Когда за период данных нет, он говорит об этом прямо, а не показывает пустую сводку."
      ],
      "requirements": [
        "Доступ к сообщениям профиля: агент читает диалоги и отвечает",
        "Доступ к статистике объявлений: просмотры, контакты, расходы"
      ],
      "faq": [
        {
          "q": "Что нужно для подключения Avito?",
          "a": "Client ID и Client Secret из кабинета Avito: «Управление профилем → Интеграции». Ключи хранятся в зашифрованном виде, доступ отзывается удалением ключа в кабинете."
        },
        {
          "q": "Агент может отвечать покупателям в мессенджере?",
          "a": "Да, при наличии прав messenger в ключе агент читает диалоги и отправляет ответы. Можно настроить так, что агент готовит черновики, а отправляете вы."
        },
        {
          "q": "Какая аналитика доступна по объявлениям?",
          "a": "Просмотры, контакты, избранное и расходы на продвижение по каждому объявлению. Агент сводит их с ценами и остатками, чтобы показать реальную отдачу от размещения."
        },
        {
          "q": "Пишет ли ИИ текст для объявлений на Авито?",
          "a": "Текст объявления агент готовит и правит по вашим замечаниям, но публикует его не он: на запись коннектор работает в мессенджере и в отзывах, а само объявление вы обновляете через кабинет или автозагрузку."
        },
        {
          "q": "Может ли нейросеть собрать карточки для Авито?",
          "a": "Нейросеть соберёт карточку (заголовок, описание, характеристики) и сверит её со статистикой похожих позиций профиля. На площадку карточки уходят файлом автозагрузки, а агент потом назовёт объявления, которые из выгрузки не встали, и причину отказа по каждому."
        }
      ]
    },
    "seo_en": {
      "title": "Avito AI agent: promotion spend and review replies",
      "description": "Shows which Avito listings burn promotion budget with zero contacts and drafts replies to two-star reviews. Connects with a Client ID and Client Secret pair.",
      "headline": "Track how your Avito listings pay off and reply in the messenger",
      "scenarios": [
        {
          "title": "Listings and calls at a glance",
          "desc": "The agent gathers views, contacts and call stats per listing and shows which positions bring leads and which sit there as dead weight."
        },
        {
          "title": "Triage of incoming messages",
          "desc": "The agent goes through Avito messenger conversations, picks out hot unanswered requests and drafts replies."
        },
        {
          "title": "Keep an eye on profile reviews",
          "desc": "The agent tracks new reviews, prepares responses and warns about negatives that drag your profile rating down."
        },
        {
          "title": "Where the promotion budget went",
          "desc": "The agent lines up promotion spend against contacts and favourites for every listing and shows which positions pay the paid views back and which merely burn money."
        },
        {
          "title": "What the autoload feed dropped",
          "desc": "The agent goes through the latest autoload feeds, names the listings that never made it into the profile and shows the reason each one was rejected."
        },
        {
          "title": "Overnight chats by morning",
          "desc": "The agent shows the chats opened overnight: every one of them arrives as a notification straight away, so the summary holds both the buyer's first question and the waiting time."
        }
      ],
      "how_it_works": [
        "The agent calls the Avito API directly: it reads the profile's listings and their statistics (views, contacts, favourites and promotion spend) and works through messenger conversations, profile reviews and autoload feeds. It verifies the connection with a request for the account itself, so it knows from the start whose profile it serves, and it combines listing figures with prices to show the return on a placement rather than a bare view counter.",
        "The agent does not poll the messenger and the reviews in circles: a new message, an opened chat, an added and an updated review arrive as notifications at this connection's own address, and no other address accepts them. The separate review updated event matters here: on Avito a rating and its text get edited after the fact, so the agent re-reads the review instead of trusting the first version that made it into a summary.",
        "The agent writes in the messenger and in reviews: it replies in conversations and drafts responses to reviews. The mode is yours to choose: the agent either sends on its own or leaves a draft for you to send. Hot unanswered requests are surfaced and kept apart from conversations that are already closed, and negatives that hit the profile rating are named separately rather than dissolved into the overall statistics.",
        "From a Client ID and Client Secret pair the service obtains the token itself and renews it once the day is up, so there is nothing to copy by hand. What the agent can reach is decided by the token scopes: without the messenger permission conversations and replies stay closed, and the agent names that as the reason instead of going quiet. It holds the request rate itself and turns to Autoteka far less often than to the other sections, where the limit is tighter; when a period has no data, it says so directly rather than showing an empty summary."
      ],
      "requirements": [
        "Access to profile messages: the agent reads chats and replies",
        "Access to listing statistics: views, contacts, promotion spend"
      ],
      "faq": [
        {
          "q": "What do I need to connect Avito?",
          "a": "A Client ID and Client Secret from the Avito account, under Profile management and Integrations. Keys are stored encrypted, and access is revoked by deleting the key in the account."
        },
        {
          "q": "Can the agent reply to buyers in the messenger?",
          "a": "Yes. With messenger permissions on the key the agent reads conversations and sends replies. You can also set it up so the agent prepares drafts and you send them."
        },
        {
          "q": "What listing analytics are available?",
          "a": "Views, contacts, favourites and promotion spend for every listing. The agent combines them with prices and stock to show the real return on each placement."
        },
        {
          "q": "Does the AI write listing copy for Avito?",
          "a": "The agent drafts the listing text and reworks it on your notes, but it is not the one that publishes: the connector writes in the messenger and in reviews, while the listing itself you update through the account or an autoload feed."
        },
        {
          "q": "Can the AI assemble listing cards for Avito?",
          "a": "It will assemble a card (title, description, attributes) and check it against the stats of similar positions in your profile. Cards reach the marketplace through an autoload file, and afterwards the agent names the listings that did not come up from the feed and the rejection reason for each."
        }
      ]
    }
  },
  {
    "key": "avito_ads",
    "name": "Авито Реклама (рекламный кабинет)",
    "name_en": "Avito Ads (advertising account)",
    "description": "Кампании, группы, креативы, статистика и балансы",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": false,
    "integration_slug": "avito",
    "short_name": "Авито Реклама",
    "short_name_en": "Avito Ads",
    "description_en": "Campaigns, groups, creatives, statistics and balances",
    "variant_of": "avito",
    "guide": {
      "url": "https://ads.avito.ru",
      "steps": [
        {
          "title": "Войдите на ads.avito.ru",
          "desc": "Войдите на ads.avito.ru под пользователем, который управляет нужным рекламным кабинетом.",
          "title_en": "Sign in at ads.avito.ru",
          "desc_en": "Sign in at ads.avito.ru as a user who can manage the advertising account."
        },
        {
          "title": "В настройках кабинета откройте доступ к API",
          "desc": "В настройках рекламного кабинета откройте раздел доступа к API и создайте ключи.",
          "title_en": "In the account settings open API access",
          "desc_en": "In the advertising account settings, open the API access section and create credentials."
        },
        {
          "title": "Скопируйте ID кабинета",
          "desc": "Скопируйте числовой ID рекламного кабинета: по нему API адресует кампании и статистику.",
          "title_en": "Copy the account ID",
          "desc_en": "Copy the numeric advertising account ID; requests use it to address campaigns and statistics."
        },
        {
          "title": "Скопируйте ID клиента и секрет клиента",
          "desc": "Вставьте значения в поля «ID клиента рекламного кабинета», «Секрет клиента» и «ID рекламного аккаунта» формы подключения.",
          "title_en": "Copy the Client ID and secret",
          "desc_en": "Paste the values into the “Advertising account Client ID”, “Client Secret” and “Advertising account ID” fields in the connection form."
        }
      ]
    }
  },
  {
    "key": "bacnet_ip",
    "name": "BACnet/IP",
    "name_en": "BACnet/IP",
    "description": "Объекты контроллера здания или котельной по BACnet/IP через сервер сбора на объекте, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "bacnet-ip",
    "description_en": "Read-only BACnet/IP objects of building and boiler room controllers via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Узнайте IP-адрес контроллера",
          "desc": "Нужен адрес контроллера BACnet/IP или маршрутизатора BACnet перед ним. Программа сбора данных шлёт запросы прямо на этот адрес, по умолчанию на UDP-порт 47808.",
          "title_en": "Find the controller's IP address",
          "desc_en": "You need the address of the BACnet/IP controller or the BACnet router in front of it. The collection program sends requests straight there, to UDP port 47808 by default."
        },
        {
          "title": "Откройте UDP 47808 до контроллера",
          "desc": "Сервер сбора должен достучаться до контроллера по UDP и получить ответ обратно. Межсетевой экран между ними пропускает этот обмен в обе стороны.",
          "title_en": "Open UDP 47808 to the controller",
          "desc_en": "The collection server has to reach the controller over UDP and get its answer back. A firewall between them lets this exchange through both ways."
        },
        {
          "title": "Для MS/TP узнайте сеть и MAC",
          "desc": "Если устройство стоит на линии MS/TP за маршрутизатором BACnet, укажите адрес маршрутизатора, номер сети за ним и MAC устройства в этой сети, только вместе.",
          "title_en": "For MS/TP, note the network and MAC",
          "desc_en": "If the device sits on an MS/TP line behind a BACnet router, enter the router's address, the network number behind it and the device's MAC there, always together."
        },
        {
          "title": "Не занимайте порт системы здания",
          "desc": "Если на сервере сбора уже работает система диспетчеризации на 47808, оставьте UDP-порт программы сбора 0. Ставьте 47808, только если устройство отвечает на этот порт.",
          "title_en": "Leave the building system's port free",
          "desc_en": "If a building management system already uses 47808 on the collection server, keep the program's UDP port at 0. Set 47808 only if the device answers to that port."
        }
      ]
    },
    "seo": {
      "title": "Подключение BACnet/IP к ИИ-агенту: котельная и уставки",
      "description": "Подача 68 °C при уставке 70: агент сверит котельную с уставками контроллера BACnet/IP и отбросит точки, помеченные неисправными. Сбор на объекте, только чтение.",
      "headline": "Котельная и инженерия здания по BACnet/IP прямо в чате",
      "scenarios": [
        {
          "title": "Температуры котельной",
          "desc": "Агент прочитает подачу, обратку и температуры в помещениях с единицами измерения, которые называет сам контроллер, и сравнит их с уставками."
        },
        {
          "title": "Насосы, вентиляторы и клапаны",
          "desc": "Агент покажет, какие насосы и вентиляторы сейчас работают, в каком режиме многопозиционные объекты и что изменилось с утра."
        },
        {
          "title": "Неисправные точки",
          "desc": "Агент найдёт точки, которые контроллер помечает неисправными, недостоверными или выведенными из обслуживания, и назовёт их по именам объектов."
        },
        {
          "title": "Как прошла ночь",
          "desc": "Агент поднимет историю значений за ночь или неделю и покажет, когда температура уходила от нормы и сколько это длилось."
        },
        {
          "title": "Опись контроллера",
          "desc": "Без списка тегов агент увидит все объекты контроллера со значением: аналоговые, двоичные, многопозиционные, счётчики, с их именами и единицами."
        },
        {
          "title": "Задача по порогу",
          "desc": "Агент заведёт задачу по событию: например, температура подачи ниже порога дольше десяти минут. Задача сработает, когда условие наступит, и когда снимется."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и отправляет данные наружу только исходящим соединением. В подключении указывается адрес контроллера вида udp://10.0.5.20:47808. Номер устройства BACnet можно не указывать: контроллер назовёт его сам.",
        "Если список тегов пуст, программа сбора читает Object_List контроллера и заводит тегом каждый объект со значением, с именем из Object_Name и единицами из Units. Вместе со значением каждый тег читает Status_Flags и Reliability: неисправность или ненулевая Reliability делают значение недостоверным, выведенный из обслуживания объект помечается сомнительным. Запросы идут пачками ReadPropertyMultiple, а устройство, которое их не поддерживает, программа опрашивает по одному свойству.",
        "Подключение только читает. Программа сбора не отправляет WriteProperty и команд с приоритетом: ни уставку, ни режим насоса агент через него не изменит. Массив приоритетов и значение по умолчанию двоичного объекта можно прочитать тегом, если нужно понять, кто сейчас командует точкой.",
        "Программа сбора опрашивает контроллер с заданным интервалом, по умолчанию раз в секунду, и отправляет значение при изменении (с мёртвой зоной, если она задана), а молчащий тег повторяет раз в 30 минут. История копится в хранилище и читается за любой период; если связь с облаком пропала, данные ждут на диске сервера сбора и приходят после её восстановления."
      ],
      "requirements": [
        "Контроллер или маршрутизатор с BACnet/IP",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к контроллеру по UDP, по умолчанию порт 47808",
        "Для устройств MS/TP: номер сети за маршрутизатором и MAC устройства"
      ],
      "faq": [
        {
          "q": "Как подключить BACnet/IP?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите BACnet/IP и укажите адрес контроллера, например udp://10.0.5.20:47808; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Список тегов можно оставить пустым: программа сама прочитает объекты контроллера."
        },
        {
          "q": "Что агент видит в BACnet/IP?",
          "a": "Аналоговые, двоичные и многопозиционные входы, выходы и значения, счётчики, целочисленные и текстовые значения контроллера, их имена и единицы, качество значения по Status_Flags и Reliability и историю значений."
        },
        {
          "q": "Может ли агент изменить уставку или включить насос?",
          "a": "Нет. Подключение только читает: программа сбора не отправляет записи свойств и команд с приоритетом, поэтому значения и режимы в контроллере остаются такими, какими их выставили вы или система диспетчеризации."
        },
        {
          "q": "Устройство стоит на линии MS/TP. Как до него достучаться?",
          "a": "Через маршрутизатор BACnet: в подключении укажите адрес маршрутизатора, а в дополнительных полях номер сети за ним и MAC устройства в этой сети (у станции MS/TP это один байт, например 05). Оба поля заполняются только вместе."
        }
      ]
    },
    "seo_en": {
      "title": "BACnet/IP AI agent: boiler room against its setpoints",
      "description": "Supply at 68 °C against a setpoint of 70: the agent checks a boiler room against its BACnet/IP controller and skips faulty points. On-site collection, read-only.",
      "headline": "Boiler room and building systems over BACnet/IP right in the chat",
      "scenarios": [
        {
          "title": "Boiler room temperatures",
          "desc": "The agent reads supply, return and room temperatures with the units the controller itself names, and compares them with the setpoints."
        },
        {
          "title": "Pumps, fans and valves",
          "desc": "The agent shows which pumps and fans are running now, what state the multi-state objects are in and what has changed since the morning."
        },
        {
          "title": "Faulty points",
          "desc": "The agent finds the points the controller marks as faulty, unreliable or out of service, and names them by their object names."
        },
        {
          "title": "How the night went",
          "desc": "The agent pulls the value history for the night or the week and shows when a temperature left its range and for how long."
        },
        {
          "title": "Controller inventory",
          "desc": "Without a tag list the agent sees every value object of the controller: analog, binary, multi-state and counters, with their names and units."
        },
        {
          "title": "Threshold task",
          "desc": "The agent sets up an event task: for example, the supply temperature below a threshold for more than ten minutes. The task fires when the condition starts and when it clears."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server in the site network and sends data out over an outgoing connection only. The connection takes the controller address, such as udp://10.0.5.20:47808. The BACnet device instance can be left empty: the controller names it itself.",
        "With an empty tag list the program reads the controller's Object_List and makes a tag of every value object, named by its Object_Name with units from Units. Each tag reads Status_Flags and Reliability beside its value: a fault or a nonzero Reliability makes the value bad, and an object out of service is marked uncertain. Requests go in ReadPropertyMultiple batches, and a device that does not support them is read one property at a time.",
        "The connection only reads. The program sends no WriteProperty and no prioritized commands: the agent cannot change a setpoint or a pump's mode through it. The priority array and a binary object's relinquish default can be read as tags when you need to see what is commanding a point.",
        "The program polls the controller at the set interval, once a second by default, sends a value when it changes (beyond the deadband, if one is set) and repeats a silent tag every 30 minutes. History is kept in the store and read for any period; when the link to the cloud drops, data waits on the collection server's disk and arrives once the link is back."
      ],
      "requirements": [
        "A controller or router with BACnet/IP",
        "A collection server in the site network: Windows or Linux with Docker",
        "UDP access from the collection server to the controller, port 47808 by default",
        "For MS/TP devices: the network number behind the router and the device's MAC"
      ],
      "faq": [
        {
          "q": "How do I connect BACnet/IP?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick BACnet/IP and enter the controller address, for example udp://10.0.5.20:47808; the collection server is assigned automatically, and if there are several, pick one in the form. The tag list can stay empty: the program reads the controller's objects itself."
        },
        {
          "q": "What does the agent see in BACnet/IP?",
          "a": "The controller's analog, binary and multi-state inputs, outputs and values, counters, integer and text values, their names and units, value quality from Status_Flags and Reliability, and the value history."
        },
        {
          "q": "Can the agent change a setpoint or start a pump?",
          "a": "No. The connection only reads: the program sends no property writes and no prioritized commands, so values and modes in the controller stay as you or the building management system set them."
        },
        {
          "q": "The device is on an MS/TP line. How is it reached?",
          "a": "Through a BACnet router: enter the router's address in the connection, and in the advanced fields the network number behind it and the device's MAC on that network (one byte for an MS/TP station, for example 05). Both fields are filled only together."
        }
      ]
    }
  },
  {
    "key": "beeline_cloudpbx",
    "name": "Билайн Облачная АТС",
    "name_en": "Beeline Cloud PBX",
    "description": "Облачная АТС: звонки, переадресация, запись разговоров, чёрные списки, детализация",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "beeline-cloudpbx",
    "description_en": "Cloud PBX: calls, forwarding rules, call recordings, blacklists and call details",
    "guide": {
      "url": "https://cloudpbx.beeline.ru",
      "steps": [
        {
          "title": "Войдите на cloudpbx.beeline.ru",
          "desc": "Кабинет: cloudpbx.beeline.ru, вход по учётным данным из договора на Облачную АТС. Дальше всё делается в разделе «Настройки».",
          "title_en": "Sign in at cloudpbx.beeline.ru",
          "desc_en": "The account is at cloudpbx.beeline.ru; sign in with the credentials from the Cloud PBX contract. Everything else happens under «Настройки» (Settings)."
        },
        {
          "title": "Во вкладке «API» включите «Интеграция по API»",
          "desc": "«Настройки» → вкладка «API» → переключатель «Интеграция по API». Услуга платная: 500 ₽ в месяц с НДС. Пока она выключена, запросы к АТС не проходят.",
          "title_en": "On the API tab turn on Интеграция по API",
          "desc_en": "«Настройки» → the “API” tab → the «Интеграция по API» switch. The add-on is paid, 500 ₽ a month incl. VAT; while it is off, nothing reaches the PBX."
        },
        {
          "title": "Заберите реквизиты с вкладки «API»",
          "desc": "На табе «Version 2.0» нажмите «Создать новый токен»: это «Токен Portal API». На «Version 1.0» вместо него выдаётся пара «логин» + «пароль»: без токена подойдёт и она.",
          "title_en": "Collect the credentials on “API”",
          "desc_en": "On “Version 2.0” press «Создать новый токен»: that is the Portal API token. “Version 1.0” hands out a «логин» + «пароль» pair instead; without a token, it works too."
        }
      ]
    },
    "seo": {
      "title": "Билайн Облачная АТС с ИИ: поиск записи разговора",
      "description": "Записи разговоров Билайн Облачной АТС: агент найдёт вчерашний звонок клиента и перескажет договорённости, утром пришлёт пропущенные. Токен из cloudpbx.beeline.ru.",
      "headline": "Разбирайте статистику звонков Билайн АТС прямо в чате",
      "scenarios": [
        {
          "title": "Статистика звонков за период",
          "desc": "Агент соберёт журнал звонков АТС за нужный период и покажет, сколько вызовов приняли, сколько потеряли и по каким абонентам."
        },
        {
          "title": "Записи разговоров",
          "desc": "Агент найдёт запись нужного разговора по номеру и дате, скачает файл из АТС и перескажет, о чём договорились с клиентом."
        },
        {
          "title": "Переадресация и чёрные списки",
          "desc": "Агент настроит переадресацию по занятости или на мобильный и добавит навязчивый номер в чёрный список, не открывая кабинет АТС."
        },
        {
          "title": "Исходящий вызов от абонента",
          "desc": "Агент инициирует двухсторонний вызов от нужного внутреннего номера и при необходимости включит абоненту постоянную запись разговоров."
        },
        {
          "title": "Карта внутренних номеров",
          "desc": "Агент возьмёт список абонентов АТС, сверит внутренние номера с именами и покажет, у кого включена запись и куда уходит переадресация."
        },
        {
          "title": "Утренняя сводка пропущенных",
          "desc": "Агент по утрам берёт журнал звонков за прошедшие сутки, отбирает потерянные вызовы и присылает список номеров с разбивкой по абонентам."
        }
      ],
      "how_it_works": [
        "Агент ходит в облачную АТС Билайн через её API на cloudpbx.beeline.ru: первым делом читает список абонентов АТС, затем журнал звонков, записи разговоров, правила переадресации и списки номеров абонентов. Из этого он считает, сколько вызовов приняли и сколько потеряли, и раскладывает результат по внутренним номерам, то есть по тем абонентам, которых открывает подключённая учётная запись API.",
        "Журнал звонков агент листает по всей АТС за нужный период, поэтому отчёт строится по завершённым вызовам, а не по счётчику в реальном времени, и звонки с конкретного номера находятся в том же журнале. Записи разговоров лежат отдельными файлами: агент находит нужную по номеру и дате, скачивает её из АТС и пересказывает, о чём договорились с клиентом.",
        "На запись агент умеет ровно то, что позволяет АТС: инициировать двухсторонний вызов от указанного внутреннего номера, включить абоненту постоянную запись разговоров, поменять переадресацию по занятости или на мобильный, добавить навязчивый номер в чёрный список. По умолчанию он работает на чтение и отчёты, а перед изменением настроек называет абонента и правило и ждёт подтверждения.",
        "Границы доступа задаёт учётная запись API: агент видит абонентов и звонки той АТС, к которой она привязана, и в чужие номера не заглядывает. Длинные периоды он листает постранично и частоту запросов выдерживает, чтобы не упереться в ограничения АТС. Записи разговоров он скачивает по одной и только под конкретный вопрос, а при отсутствии данных за период говорит это словами, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Договор на Облачную АТС Билайн с доступом в кабинет",
        "Бюджет 500 ₽ в месяц с НДС на услугу «Интеграция по API»"
      ],
      "faq": [
        {
          "q": "Как подключить Билайн Облачную АТС?",
          "a": "Токеном API. В кабинете cloudpbx.beeline.ru откройте «Настройки» → вкладку «API», включите услугу «Интеграция по API» и на табе «Version 2.0» нажмите «Создать новый токен»: он и вставляется в поле «Токен Portal API». Пара логин-пароль для внешних систем выдаётся только на табе «Version 1.0»: если токена нет, подойдёт и она. Логин и пароль от самого кабинета не подойдут."
        },
        {
          "q": "Что агент видит в Облачной АТС?",
          "a": "Абонентов АТС, журнал звонков, записи разговоров, правила переадресации и списки номеров абонентов в объёме, который открывает подключённая учётная запись API."
        },
        {
          "q": "Пишет ли агент в АТС?",
          "a": "Может: инициировать вызов от абонента, включать запись разговора, менять переадресацию и пополнять чёрный список. По умолчанию работает на чтение и отчёты."
        },
        {
          "q": "Нужна ли отдельная услуга у оператора?",
          "a": "Да. «Интеграция по API» подключается на вкладке «API» отдельно и тарифицируется как платная услуга: пока переключатель выключен, запросы к АТС не проходят."
        }
      ]
    },
    "seo_en": {
      "title": "Beeline Cloud PBX AI agent: find a call recording",
      "description": "Finds yesterday's call with a client in Beeline Cloud PBX recordings and sums up what was agreed; each morning lists missed calls by extension. Uses an API token.",
      "headline": "Break down Beeline Cloud PBX call stats right in chat",
      "scenarios": [
        {
          "title": "Call stats for any period",
          "desc": "The agent pulls the PBX call log for the period you need and shows how many calls were answered, how many were missed and by which extensions."
        },
        {
          "title": "Call recordings",
          "desc": "The agent finds the recording of the call you need by number and date, downloads the file from the PBX and retells what was agreed with the client."
        },
        {
          "title": "Forwarding and blacklists",
          "desc": "The agent sets up forwarding on busy or to a mobile and adds a nuisance number to the blacklist without opening the PBX console."
        },
        {
          "title": "Outgoing call from an extension",
          "desc": "The agent starts a two-way call from the extension you name and, if needed, turns on permanent call recording for that user."
        },
        {
          "title": "Map of your extensions",
          "desc": "The agent pulls the list of PBX extensions, matches internal numbers with names and shows who has recording switched on and where forwarding sends calls."
        },
        {
          "title": "Morning missed-call digest",
          "desc": "Every morning the agent takes the call log for the past day, picks out the missed calls and sends over the list of numbers broken down by extension."
        }
      ],
      "how_it_works": [
        "The agent calls the Beeline Cloud PBX through its API at cloudpbx.beeline.ru: first it reads the list of PBX extensions, then the call log, call recordings, forwarding rules and the extensions' number lists. From that it counts how many calls were answered and how many were missed, and breaks the result down by extension, across the users the connected API account opens up.",
        "The agent pages through the call log of the whole PBX for the period you need, so the report is built from completed calls rather than from a live counter, and calls from a particular number are found in the same log. Call recordings are separate files: the agent finds the one you need by number and date, downloads it from the PBX and retells what was agreed with the client.",
        "On the write side the agent does exactly what the PBX allows: start a two-way call from a named extension, turn on permanent call recording for a user, change forwarding on busy or to a mobile, add a nuisance number to the blacklist. By default it works read-only and builds reports, and before changing a setting it names the extension and the rule and waits for confirmation.",
        "Access boundaries are set by the API account: the agent sees the extensions and the calls of the PBX it belongs to and never looks into other numbers. Long periods are paged through, and it holds the request rate so the PBX limits are not hit. Recordings are downloaded one at a time and only for a specific question, and when there is no data for the period it says so in words instead of showing an empty table."
      ],
      "requirements": [
        "A Beeline Cloud PBX contract with console access",
        "Budget of 500 RUB a month incl. VAT for the API add-on"
      ],
      "faq": [
        {
          "q": "How do I connect Beeline Cloud PBX?",
          "a": "With an API token. In the cloudpbx.beeline.ru console open Settings and the API tab, enable the API integration service and press “Create new token” on the Version 2.0 tab; that token goes into the Portal API token field. The login and password pair for external systems is only issued on the Version 1.0 tab: without a token, it works too. The console's own login and password will not work."
        },
        {
          "q": "What does the agent see in the Cloud PBX?",
          "a": "PBX extensions, the call log, call recordings, forwarding rules and the extensions' number lists, as far as the connected API account allows."
        },
        {
          "q": "Does the agent write to the PBX?",
          "a": "It can: start a call from an extension, turn on call recording, change forwarding and extend the blacklist. By default it works read-only and builds reports."
        },
        {
          "q": "Do I need a separate service from the operator?",
          "a": "Yes. API integration is enabled separately on the API tab and is billed as a paid service: while the toggle is off, requests to the PBX will not go through."
        }
      ]
    }
  },
  {
    "key": "bitrix24",
    "name": "Bitrix24 CRM",
    "name_en": "Bitrix24 CRM",
    "description": "Сделки, лиды и контакты",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "bitrix24",
    "short_name": "Битрикс24",
    "short_name_en": "Bitrix24",
    "description_en": "Deals, leads and contacts",
    "signup_url": "https://www.bitrix24.ru/create.php",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://www.bitrix24.ru",
      "steps": [
        {
          "title": "Войдите под сотрудником, видящим всю CRM",
          "desc": "Откройте свой портал <ваш-домен>.bitrix24.ru. Вебхук работает с правами создателя: если он видит только свои сделки, столько же увидит и агент.",
          "title_en": "Sign in as a user who sees the whole CRM",
          "desc_en": "Open your portal at <your-domain>.bitrix24.com. A webhook runs with its creator's permissions: it sees the deals that employee sees."
        },
        {
          "title": "В «Разработчикам» создайте «Входящий вебхук»",
          "desc": "«Приложения → Разработчикам», вкладка «Готовые сценарии» → блок «Другое» → «Входящий вебхук».",
          "title_en": "In Developer resources add an inbound webhook",
          "desc_en": "\"Applications → Developer resources\", the \"Ready-made scenarios\" tab → \"Other\" → \"Incoming webhook\"."
        },
        {
          "title": "Отметьте права CRM и «Задачи» у вебхука",
          "desc": "Для чтения воронки хватит галочки CRM. Чтобы агент создавал задачи и двигал сделки, добавьте «Задачи»; права меняются и позже.",
          "title_en": "Tick CRM and Tasks in the webhook permissions",
          "desc_en": "CRM alone is enough to read the funnel. Add \"Tasks\" to create tasks and move deals; scopes can be changed later too."
        },
        {
          "title": "Скопируйте URL вебхука",
          "desc": "Нужна ссылка вида https://<ваш-домен>.bitrix24.ru/rest/1/<секретный код>/ со слешем на конце и без имени метода. Код виден только создателю вебхука.",
          "title_en": "Copy the webhook URL",
          "desc_en": "You need a link shaped like https://<your-domain>.bitrix24.com/rest/1/<secret code>/, with a trailing slash and no method name."
        }
      ]
    },
    "seo": {
      "title": "Битрикс24 с ИИ: потерянные лиды и дубли контактов",
      "description": "540 лидов за месяц и 58 оплат: на какой стадии Битрикс24 теряет лиды, агент показывает по входящему вебхуку, а заодно находит пары дублей среди контактов.",
      "headline": "Разбирайте воронку Битрикс24 и находите потерянные лиды",
      "scenarios": [
        {
          "title": "Разбор воронки и потерянных лидов",
          "desc": "Агент посчитает конверсию по стадиям, найдёт лиды без ответственного и сделки, брошенные после первого касания."
        },
        {
          "title": "Еженедельный отчёт по продажам",
          "desc": "Агент соберёт закрытые сделки, суммы и активность менеджеров за неделю и пришлёт сводку в Telegram к планёрке."
        },
        {
          "title": "Синхронизация CRM с учёткой",
          "desc": "Агент сверит сделки Битрикс24 с оплатами в банке или 1С и покажет, какие выигранные сделки так и не оплачены."
        },
        {
          "title": "Задачи по зависшим сделкам",
          "desc": "Агент найдёт сделки без задач и без движения, создаст менеджерам задачи с дедлайном и контекстом."
        },
        {
          "title": "Дубли в базе клиентов",
          "desc": "Агент пройдёт по контактам и компаниям, найдёт дубли по телефону и почте и покажет, где один клиент завёлся дважды под разными менеджерами."
        },
        {
          "title": "Ответы клиентам открытой линии",
          "desc": "Агент ответит клиенту, который написал в открытую линию Битрикс24 из мессенджера или с сайта: заглянет в его контакт и сделки, а сложный вопрос передаст живому оператору."
        }
      ],
      "how_it_works": [
        "Агент обращается к порталу через входящий вебхук: его URL уже содержит и адрес, и ключ, поэтому запросы идут REST-методами вроде crm.deal.list прямо в ваш Битрикс24, облачный или коробочный. Он читает сделки, лиды, контакты, компании и счета, считает конверсию по стадиям, активность менеджеров за период и суммы закрытий. Длинные списки забираются страницами. При подключении в портале появляется чат-бот «Сам Решу»: выберите его в настройках открытой линии, и агент будет отвечать её клиентам, а данные CRM возьмёт запросами к API.",
        "Воронка в Битрикс24 разорвана надвое: лид и сделка являются разными сущностями, и при конвертации из лида рождаются сразу сделка, контакт и компания. Считать конверсию по одним сделкам значит потерять верх воронки, поэтому агент связывает лид с тем, во что он превратился. Стадии тоже не универсальны: у каждого направления сделок свой набор, а часть смысла лежит в пользовательских полях, и их агент читает вместе со стандартными.",
        "На запись агент ставит задачи с дедлайном и контекстом и двигает сделки по стадиям, а карточку перед правкой перечитывает: портал не запирает запись от параллельных изменений. Перед созданием контакта или компании он ищет дубли по телефону и почте: повторный лид в Битрикс24 ничего не блокирует и спокойно ложится поверх существующей базы. Массовый импорт и поиск дублей идут заметно медленнее обычных запросов: портал на такие методы отвечает неохотно, и лучше подождать, чем упереться в отказ.",
        "Ссылка вебхука хранится зашифрованной и отзывается в том же разделе «Разработчикам → Другое»; отдельной авторизации портал не требует: ключ едет внутри URL каждого запроса. Частоту запросов агент держит невысокой: лимит портала делится со всеми интеграциями сразу, поэтому длинные выборки он проходит страницами, а не одним махом. Если метод закрыт правами или сделок за период не было, он скажет это прямо, а не отдаст пустую таблицу."
      ],
      "requirements": [
        "Платный тариф Битрикс24: на бесплатном REST API закрыт.",
        "Портал Битрикс24: облачный на *.bitrix24.ru или коробка на своём домене."
      ],
      "faq": [
        {
          "q": "Как подключить Битрикс24?",
          "a": "Входящим вебхуком: в Битрикс24 откройте «Разработчикам → Другое → Входящий вебхук», выберите права и вставьте полученный URL при подключении. Ссылка хранится в зашифрованном виде."
        },
        {
          "q": "Какие права нужны вебхуку?",
          "a": "Для аналитики достаточно CRM (чтение). Если хотите, чтобы агент создавал задачи и двигал сделки, добавьте права на запись CRM и «Задачи». Чтобы он отвечал клиентам открытой линии, добавьте «Чат-боты» и «Открытые линии». Права всегда можно сузить: агент попросит недостающее, когда упрётся."
        },
        {
          "q": "Облачный и коробочный Битрикс24 оба работают?",
          "a": "Да, вебхук-механика одинакова: подключается и облачный портал *.bitrix24.ru, и коробка на вашем домене."
        },
        {
          "q": "Агент увидит изменения в сделках сразу?",
          "a": "Да, агент читает REST API в момент задачи и видит сделки такими, какие они сейчас. События о сделках и лидах входящий вебхук не присылает: сам по сообщению агент отвечает только клиентам открытой линии через чат-бота «Сам Решу»."
        }
      ]
    },
    "seo_en": {
      "title": "Bitrix24 and AI agent: lost leads and duplicate contacts",
      "description": "540 leads a month, 58 paid: the agent shows the Bitrix24 stage where leads are lost and finds duplicate contacts, connected through an inbound webhook.",
      "headline": "Break down the Bitrix24 funnel and find the leads you lost",
      "scenarios": [
        {
          "title": "Funnel and lost lead breakdown",
          "desc": "The agent computes stage-by-stage conversion, finds leads with no owner and deals abandoned after the first touch."
        },
        {
          "title": "Weekly sales report",
          "desc": "The agent gathers closed deals, amounts and rep activity for the week and sends the summary to Telegram in time for the stand-up."
        },
        {
          "title": "Sync the CRM with the books",
          "desc": "The agent reconciles Bitrix24 deals with payments in the bank or 1C and shows which won deals were never paid."
        },
        {
          "title": "Tasks for stalled deals",
          "desc": "The agent finds deals with no tasks and no movement and creates tasks for the reps with a deadline and context."
        },
        {
          "title": "Duplicates in the client base",
          "desc": "The agent walks the contacts and companies, finds duplicates by phone and email and shows where one client was entered twice under different reps."
        },
        {
          "title": "Replies to open channel clients",
          "desc": "The agent answers a client who wrote to a Bitrix24 open channel from a messenger or the website: it checks the client's contact and deals and hands a hard question to a live operator."
        }
      ],
      "how_it_works": [
        "The agent reaches the portal through an inbound webhook: its URL already carries both the address and the key, so requests go as REST methods like crm.deal.list straight into your Bitrix24, cloud or self-hosted. It reads deals, leads, contacts, companies and invoices, computes stage-by-stage conversion, rep activity for the period and closed amounts. Long lists are fetched page by page. On connect, a chatbot named Сам Решу appears in the portal: pick it in the open channel settings, and the agent answers that channel's clients and reads CRM data through API calls.",
        "The funnel in Bitrix24 is torn in two: a lead and a deal are different entities, and converting a lead gives birth to a deal, a contact and a company at once. Counting conversion on deals alone means losing the top of the funnel, so the agent ties a lead to whatever it turned into. Stages are not universal either: every deal direction has its own set, and part of the meaning sits in custom fields, and the agent reads those alongside the standard ones.",
        "For writes the agent creates tasks with a deadline and context and moves deals between stages, re-reading the card first: the portal does not lock a record against parallel edits. Before creating a contact or a company it looks for duplicates by phone and email: a repeat lead in Bitrix24 blocks nothing and happily lands on top of the existing base. Bulk import and duplicate search run noticeably slower than ordinary requests: the portal answers such methods reluctantly, and waiting beats running into a refusal.",
        "The webhook link is stored encrypted and is revoked in the same Developer resources, Other section; the portal asks for no separate authorization, as the key rides inside the URL of every request. The request rate is kept low: the portal quota is shared with every other integration at once, so long selections are walked page by page rather than pulled in one go. If a method is closed by permissions or there were no deals in the period, it says so directly instead of handing over an empty table."
      ],
      "requirements": [
        "A paid Bitrix24 plan: the REST API is closed on the free tier.",
        "A Bitrix24 portal: cloud on *.bitrix24.ru or self-hosted on your domain."
      ],
      "faq": [
        {
          "q": "How do I connect Bitrix24?",
          "a": "With an inbound webhook: in Bitrix24 open Developer resources, then Other and Inbound webhook, pick the permissions and paste the resulting URL when connecting. The link is stored encrypted."
        },
        {
          "q": "What permissions does the webhook need?",
          "a": "CRM read access is enough for analytics. If you want the agent to create tasks and move deals, add CRM write and Tasks. For it to answer open channel clients, add Chatbots and Open Channels. The scope can always be narrowed, and the agent will ask for what is missing when it hits a wall."
        },
        {
          "q": "Do cloud and on-premise Bitrix24 both work?",
          "a": "Yes, the webhook mechanics are identical: a cloud portal on *.bitrix24.ru and a self-hosted box on your own domain both connect."
        },
        {
          "q": "Will the agent see deal changes right away?",
          "a": "Yes, the agent reads the REST API at the moment of the task and sees deals as they are now. The inbound webhook does not deliver deal and lead events: on its own the agent replies only to open channel clients, through the Сам Решу chatbot."
        }
      ]
    }
  },
  {
    "key": "bitrix24_app",
    "name": "Bitrix24 CRM",
    "name_en": "Bitrix24 CRM",
    "description": "Вход через портал Битрикс24: сделки, задачи, чаты, диск и календарь без копирования вебхука",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "never",
    "has_own_page": false,
    "integration_slug": "bitrix24",
    "short_name": "Битрикс24",
    "short_name_en": "Bitrix24",
    "description_en": "Sign in through your Bitrix24 portal for deals, tasks, chats, drive and calendar, no webhook",
    "variant_of": "bitrix24",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://www.bitrix24.ru",
      "steps": [
        {
          "title": "Выберите портал Битрикс24",
          "desc": "Откройте портал, где лежат CRM, задачи и чаты, с которыми будет работать агент.",
          "title_en": "Choose your Bitrix24 portal",
          "desc_en": "Open the portal that holds the CRM, tasks and chats you want the agent to use."
        },
        {
          "title": "Войдите в Битрикс24",
          "desc": "Используйте учётную запись сотрудника с доступом к нужным сущностям CRM и рабочим группам.",
          "title_en": "Sign in to Bitrix24",
          "desc_en": "Use an employee account with access to the needed CRM entities and workgroups."
        },
        {
          "title": "Разрешите запрошенный доступ",
          "desc": "Проверьте права в окне Битрикс24 и подтвердите их. Подключение вернётся сюда автоматически.",
          "title_en": "Allow the requested access",
          "desc_en": "Review the permissions in the Bitrix24 window and confirm; the connection returns here automatically."
        }
      ]
    }
  },
  {
    "key": "bolid_orion",
    "name": "Болид Орион Про",
    "name_en": "Bolid Orion Pro",
    "description": "Проходы, пропуска и события охраны",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "bolid-orion",
    "short_name": "Орион Про",
    "short_name_en": "Bolid Orion Pro",
    "description_en": "Entries, passes and security events",
    "search_terms": [
      "болид",
      "bolid",
      "орион",
      "orion pro",
      "скуд",
      "арм орион"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://bolid.ru/production/orion/po-orion/po-integration/mod_integr_orion_pro.html",
      "steps": [
        {
          "title": "Поставьте модуль интеграции Орион Про",
          "desc": "Модуль покупается у Болида отдельно и ставится рядом с АРМ «Орион Про»: распакуйте IntegrServ.zip и запустите integrServ.exe, лучше службой.",
          "title_en": "Install the Orion Pro integration module",
          "desc_en": "The module is bought from Bolid separately and installed next to АРМ Orion Pro: unpack IntegrServ.zip and run integrServ.exe, preferably as a service."
        },
        {
          "title": "Проверьте settings.ini модуля",
          "desc": "В settings.ini укажите базу Ориона в [DBMS] и порт в [Sockets] (ListenPort=8090). Логин и пароль из [HttpAuth] нужны, только если IsNeedAuth=1.",
          "title_en": "Check the module's settings.ini",
          "desc_en": "In settings.ini set the Orion database in [DBMS] and the port in [Sockets] (ListenPort=8090). The [HttpAuth] login and password matter only if IsNeedAuth=1."
        },
        {
          "title": "Заведите пароль удалённого управления",
          "desc": "Для дверей, охраны и вторичной авторизации добавьте в АБД на вкладке «Пароли» пароль с типом «Удалённое управление». Нужен АРМ 1.20.3 и выше.",
          "title_en": "Create a remote control password",
          "desc_en": "For doors, alarms and secondary authorization add a password of the Remote control type on the Passwords tab of the access database. АРМ 1.20.3+ is required."
        },
        {
          "title": "Откройте порт модуля в сети объекта",
          "desc": "Компьютер, с которого вы подключаетесь, должен видеть сервер модуля: разрешите порт 8090 (8091 для HTTPS) в брандмауэре Windows на сервере.",
          "title_en": "Open the module port on the site network",
          "desc_en": "The computer you connect from must see the module server: allow port 8090 (8091 for HTTPS) in Windows Firewall on the server."
        }
      ]
    },
    "seo": {
      "title": "Орион Про и ИИ-агент: опоздания по журналу проходов",
      "description": "За неделю 7 опозданий у 4 сотрудников: такой итог агент собирает из журнала проходов Орион Про, а выдачу карты новичку готовит с нужным уровнем доступа.",
      "headline": "Сотрудники, пропуска и журнал проходов Орион Про прямо в чате",
      "scenarios": [
        {
          "title": "Табель по проходам",
          "desc": "Агент соберёт из журнала первый вход и последний выход каждого сотрудника по дням и покажет опоздания и ранние уходы против графика, который вы назовёте."
        },
        {
          "title": "Пропуск новому сотруднику",
          "desc": "Агент заведёт карточку сотрудника, привяжет карту и уровень доступа одним вызовом и покажет, что именно запишет, до вашего подтверждения."
        },
        {
          "title": "Утерянная карта",
          "desc": "Агент найдёт сотрудника по фамилии или табельному номеру, покажет его ключи и заблокирует нужную карту, не трогая остальные."
        },
        {
          "title": "Кто где был",
          "desc": "Агент выгрузит проходы через выбранные двери за период и назовёт, кто входил в помещение и когда."
        },
        {
          "title": "Отказы в доступе",
          "desc": "Агент разберёт события с отказом и назовёт причину каждого: нет прав, истёк срок карты, нарушение antipassback или окна времени."
        },
        {
          "title": "Сверка с кадровым учётом",
          "desc": "Агент сравнит список сотрудников Ориона с выгрузкой из кадровой системы и покажет уволенных с действующими картами."
        }
      ],
      "how_it_works": [
        "Агент работает с модулем интеграции Орион Про, отдельной платной программой Болида, которая ставится рядом с АРМ «Орион Про» и читает его базу напрямую. Обмен идёт по JSON-RPC: сотрудники и посетители, ключи всех видов (карты, PIN-коды, отпечатки, лица, QR), уровни доступа с окнами времени, справочники организаций и подразделений, приборы и зоны, журнал событий.",
        "Сервер СКУД стоит в вашей локальной сети, поэтому агент обращается к нему через приложение на вашем компьютере, тем же путём, что и к локальной 1С. Пока компьютер включён и видит сервер, агент работает с ним напрямую; отказ соединения он называет отказом сети, а не отсутствием данных.",
        "Журнал агент читает страницами за период или с последнего прочитанного события, поэтому длинные выгрузки не обрываются молча. Табель он строит по направлению прохода, а не по любому событию, и праздники, отпуска и больничные сверяет с уважительными причинами отсутствия из Ориона.",
        "На запись агент заводит и правит сотрудников, выдаёт и блокирует ключи, правит уровни доступа, каждый раз показывая, что запишет, и ждёт вашего подтверждения. Удаление из базы необратимо, поэтому уволенного он по умолчанию архивирует или блокирует. Управление дверями и охраной агент выполняет только по прямой просьбе, назвав дверь или зону и последствие."
      ],
      "requirements": [
        "Модуль интеграции Орион Про (покупается у Болида отдельно)",
        "АРМ «Орион Про» 1.12 и выше, для управления дверями 1.20.3 и выше",
        "Компьютер с приложением в той же сети, что и сервер модуля",
        "Пароль «Удалённое управление» в АБД для управления дверями"
      ],
      "faq": [
        {
          "q": "Как подключить Орион Про?",
          "a": "Адресом модуля интеграции с портом (по умолчанию http://адрес-сервера:8090). Если в settings.ini модуля включена первичная авторизация, добавьте её логин и пароль; для управления дверями и при включённой вторичной авторизации укажите логин и пароль удалённого управления из АБД."
        },
        {
          "q": "Что агент видит в Орион Про?",
          "a": "Сотрудников и посетителей, их ключи и уровни доступа, двери, зоны и приборы, журнал событий с проходами и тревогами, причины отсутствия. Отчётов учёта рабочего времени модуль не отдаёт: табель агент считает сам по журналу проходов."
        },
        {
          "q": "Может ли агент открыть дверь?",
          "a": "Может, если в подключении есть пароль удалённого управления и АРМ не ниже 1.20.3, но только по вашей прямой просьбе и после подтверждения: это физическое действие на объекте."
        },
        {
          "q": "Почему нет событий в реальном времени?",
          "a": "Модуль отправляет события только на адрес в вашей сети, до облака он не достаёт. Поэтому агент забирает новые события опросом журнала с последнего прочитанного."
        }
      ]
    },
    "seo_en": {
      "title": "Bolid Orion Pro and AI agent: lateness from the pass log",
      "description": "Seven late arrivals by four people this week: the agent totals them from the Orion Pro pass log and prepares a new hire's card with the right access level.",
      "headline": "Employees, passes and the access log of Orion Pro right in the chat",
      "scenarios": [
        {
          "title": "A timesheet from door events",
          "desc": "The agent collects each employee's first entry and last exit per day from the log and shows late arrivals and early leaves against the schedule you name."
        },
        {
          "title": "A pass for a new hire",
          "desc": "The agent creates the employee card, binds the card and access level in one call and shows exactly what it will write before you confirm."
        },
        {
          "title": "A lost card",
          "desc": "The agent finds the employee by surname or personnel number, shows their keys and blocks the right card, leaving the others alone."
        },
        {
          "title": "Who was where",
          "desc": "The agent pulls the passes through the doors you choose for a period and names who entered the room and when."
        },
        {
          "title": "Denied access",
          "desc": "The agent goes through denied events and names the reason for each: no rights, an expired card, an antipassback or time window violation."
        },
        {
          "title": "Reconciling with HR records",
          "desc": "The agent compares the Orion employee list with an export from your HR system and shows dismissed people who still hold active cards."
        }
      ],
      "how_it_works": [
        "The agent works with the Orion Pro integration module, a separate paid Bolid program installed next to АРМ Orion Pro that reads its database directly. The exchange runs over JSON-RPC: employees and visitors, keys of every kind (cards, PINs, fingerprints, faces, QR), access levels with time windows, company and department directories, devices and zones, the event log.",
        "The access control server sits in your local network, so the agent reaches it through the app on your computer, the same way it reaches an on-premise 1C. While the computer is on and can see the server, the agent works with it directly; a refused connection is reported as a network failure, not as missing data.",
        "The agent reads the log in pages for a period or from the last event it read, so long exports never stop silently. It builds a timesheet from the pass direction rather than from any event, and checks holidays, vacations and sick leave against the absence reasons stored in Orion.",
        "For writes the agent creates and edits employees, issues and blocks keys and edits access levels, each time showing what it will write and waiting for your confirmation. Deleting from the database cannot be undone, so by default a dismissed employee is archived or blocked. Door and alarm control happens only on your direct request, naming the door or zone and the consequence."
      ],
      "requirements": [
        "The Orion Pro integration module (bought from Bolid separately)",
        "АРМ Orion Pro 1.12 or later, 1.20.3 or later for door control",
        "A computer with the app in the same network as the module server",
        "A Remote control password in the access database for door control"
      ],
      "faq": [
        {
          "q": "How do I connect Orion Pro?",
          "a": "With the integration module address and port (http://server-address:8090 by default). If primary authorization is on in the module's settings.ini, add its login and password; for door control and when secondary authorization is on, add the remote control login and password from the access database."
        },
        {
          "q": "What does the agent see in Orion Pro?",
          "a": "Employees and visitors, their keys and access levels, doors, zones and devices, the event log with passes and alarms, and absence reasons. The module serves no time tracking reports: the agent computes the timesheet itself from the pass log."
        },
        {
          "q": "Can the agent open a door?",
          "a": "It can when the connection carries a remote control password and АРМ is 1.20.3 or later, but only on your direct request and after confirmation: it is a physical action on site."
        },
        {
          "q": "Why are there no real-time events?",
          "a": "The module pushes events only to an address inside your network and cannot reach the cloud. So the agent picks up new events by polling the log from the last one it read."
        }
      ]
    }
  },
  {
    "key": "bpmsoft",
    "name": "BPMSoft CRM",
    "name_en": "BPMSoft CRM",
    "description": "Контакты, контрагенты, лиды, продажи, бизнес-процессы",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "bpmsoft",
    "short_name": "BPMSoft",
    "short_name_en": "BPMSoft",
    "description_en": "Contacts, accounts, leads, sales and business processes",
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://edu.bpmsoft.ru/baza-znaniy/",
      "steps": [
        {
          "title": "Скопируйте адрес BPMSoft из адресной строки",
          "desc": "Откройте кабинет BPMSoft и скопируйте адрес из адресной строки до первого слэша, вида https://crm.company.ru.",
          "title_en": "Copy the BPMSoft address from the address bar",
          "desc_en": "Open your BPMSoft workspace and copy the address bar value up to the first slash, like https://crm.company.ru."
        },
        {
          "title": "В «Пользователях системы» заведите сотрудника",
          "desc": "Дизайнер системы → «Пользователи и администрирование» → «Пользователи системы» → «Добавить пользователя», тип «Сотрудник компании».",
          "title_en": "In System Designer create a system user",
          "desc_en": "System Designer → «Пользователи и администрирование» → «Пользователи системы» → «Добавить пользователя», type «Сотрудник компании»."
        },
        {
          "title": "На вкладке «Лицензии» отметьте лицензию",
          "desc": "В карточке пользователя откройте вкладку «Лицензии» и отметьте лицензию. Без неё вход по логину и паролю отклоняется.",
          "title_en": "On the user's Лицензии tab tick a license",
          "desc_en": "On the user's page open the «Лицензии» tab and tick a license. Without one the login and password are rejected at sign-in."
        },
        {
          "title": "В «Правах доступа на операции» выдайте OData",
          "desc": "Дизайнер системы → «Права доступа на операции» → операция «Доступ к OData»: добавьте пользователя или его роль. Адрес, логин и пароль готовы.",
          "title_en": "In operation permissions add Доступ к OData",
          "desc_en": "System Designer → «Права доступа на операции» → the «Доступ к OData» operation: add the user or their role. The address, login and password are ready."
        }
      ]
    },
    "seo": {
      "title": "BPMSoft и ИИ-агент: просроченная дебиторка по счетам",
      "description": "Просроченная дебиторка 4,3 млн ₽ по 38 счетам и 47 пар дублей по телефону и почте. Всё это агент собирает из BPMSoft по OData с адреса вашего сервера.",
      "headline": "Разбирайте этапы продаж BPMSoft прямо по данным OData",
      "scenarios": [
        {
          "title": "Разбор этапов продаж",
          "desc": "Агент пройдёт по объектам Opportunity, посчитает суммы и вероятности по этапам и покажет, где сделки стоят дольше обычного."
        },
        {
          "title": "Чистка справочников",
          "desc": "Агент найдёт дубли контактов и контрагентов по телефону и почте и соберёт карточки, в которых не заполнены поля для связи."
        },
        {
          "title": "Счета и просроченная оплата",
          "desc": "Агент сверит суммы счетов с проведёнными оплатами по статусу платежа и покажет просроченную дебиторку в разрезе контрагентов."
        },
        {
          "title": "Дискавери схемы OData",
          "desc": "Агент прочитает $metadata и покажет, какие поля и связи есть у ваших сущностей, включая добавленные при внедрении."
        },
        {
          "title": "Откуда приходят лиды",
          "desc": "Агент сгруппирует лиды по источнику и стадии квалификации и покажет, какие каналы доводят до продажи, а какие оседают в необработанных."
        },
        {
          "title": "Хвосты в обращениях",
          "desc": "Агент соберёт открытые обращения вместе с активностями по ним и покажет, где ответственный не отмечался дольше недели, а срок ответа уже вышел."
        }
      ],
      "how_it_works": [
        "Агент работает с BPMSoft по OData 4: запросы уходят на адрес вашего сервера в раздел /0/odata, откуда читаются контакты, контрагенты, лиды, продажи, активности, счета, заказы, обращения, продукты и документы. На этих данных считаются суммы и вероятности по этапам продаж, сделки, стоящие дольше обычного, дубли в справочниках по телефону и почте и просроченная дебиторка в разрезе контрагентов.",
        "Первым делом агент читает $metadata и разбирается в схеме именно вашего внедрения: набор сущностей и полей в BPMSoft дописывается под заказчика, и колонки, появившиеся при внедрении, для отчёта нередко важнее типовых. Оттуда же берутся связи: ссылочные поля приходят идентификаторами, и без разворачивания связи вместо названия контрагента в таблице останется GUID. Ответ сервера ограничен 20 000 строк, поэтому большие выборки агент забирает постранично.",
        "По умолчанию агент работает на чтение: считает, сверяет, показывает. Запись он умеет (создать и обновить запись, запустить бизнес-процесс по имени схемы), но делает это по вашему запросу и проговаривая, что именно изменится. Запуск процесса опаснее обычной правки: за ним тянутся уведомления, задачи и переходы по этапам, поэтому схему и объект, к которому она применяется, агент называет до старта, а не после.",
        "Границы агента задают права пользователя интеграции: сущность, закрытая ролью, не появится ни в одном отчёте, и агент назовёт причину, а не покажет пустую таблицу. Отбор и сортировку он отдаёт серверу параметрами $filter, $orderby и $select, чтобы не тянуть лишние колонки, а даты приводит к формату OData, иначе отфильтруется не тот период. Частоту обращений держит умеренной: постраничная выборка идёт с паузами, а не занимает сервер целиком."
      ],
      "requirements": [
        "Права администратора в кабинете BPMSoft",
        "Свободная лицензия для нового пользователя",
        "Сервер доступен извне, а не только из внутренней сети"
      ],
      "faq": [
        {
          "q": "Как подключить BPMSoft CRM?",
          "a": "Тремя полями: адрес сервера из адресной строки кабинета до первого слэша, логин и пароль отдельного пользователя. Пользователю нужна лицензия на вкладке «Лицензии» и операция «Доступ к OData» в разделе «Права доступа на операции»."
        },
        {
          "q": "Что агент видит в BPMSoft CRM?",
          "a": "Сущности OData 4: контакты, контрагентов, лиды, продажи, активности, счета, заказы, обращения, продукты и документы в объёме прав пользователя интеграции."
        },
        {
          "q": "Пишет ли агент в BPMSoft CRM?",
          "a": "Может: создавать и обновлять записи и запускать бизнес-процесс по имени схемы. По умолчанию работает на чтение и аналитику, а запись ведёт по вашему запросу."
        },
        {
          "q": "Что с коробочным сервером?",
          "a": "Адрес должен быть доступен извне: сервер во внутренней сети без внешнего доступа коннектор не увидит. Ответ ограничен 20 000 строк, дальше идёт постраничная выборка."
        }
      ]
    },
    "seo_en": {
      "title": "BPMSoft and AI agent: overdue receivables by invoice",
      "description": "4.3 million rubles overdue across 38 invoices and 47 duplicate pairs by phone and email, pulled by the agent from BPMSoft over OData on your own server.",
      "headline": "Break down BPMSoft sales stages straight from OData",
      "scenarios": [
        {
          "title": "Sales stage breakdown",
          "desc": "The agent walks the Opportunity objects, totals amounts and probabilities by stage and shows where deals sit longer than usual."
        },
        {
          "title": "Clean up the directories",
          "desc": "The agent finds duplicate contacts and accounts by phone and email and collects the cards where contact fields are left empty."
        },
        {
          "title": "Invoices and overdue payments",
          "desc": "The agent matches invoice amounts with recorded payments by payment status and shows overdue receivables per account."
        },
        {
          "title": "OData schema discovery",
          "desc": "The agent reads $metadata and shows which fields and relations your entities have, including the ones added during implementation."
        },
        {
          "title": "Where the leads come from",
          "desc": "The agent groups leads by source and qualification stage and shows which channels reach a sale and which ones pile up unprocessed."
        },
        {
          "title": "Loose ends in cases",
          "desc": "The agent pulls open cases together with their activities and shows where the owner logged nothing for over a week and the response window has passed."
        }
      ],
      "how_it_works": [
        "The agent works with BPMSoft over OData 4: requests go to your server address into the /0/odata section, which is where contacts, accounts, leads, opportunities, activities, invoices, orders, cases, products and documents are read from. On that data it totals amounts and probabilities by sales stage, deals sitting longer than usual, duplicates in the directories by phone and email and overdue receivables per account.",
        "The first thing the agent reads is $metadata, which spells out the schema of your particular implementation: the set of entities and fields in BPMSoft is extended per customer, and the columns added during implementation often matter more for a report than the standard ones. Relations come from there too: reference fields arrive as identifiers, and without expanding the relation a table shows a GUID where the account name should be. A server response is capped at 20 000 rows, so large selections are fetched page by page.",
        "By default the agent works read-only: it counts, reconciles and reports. It can write (create and update a record, run a business process by schema name), but it does that on your request and while spelling out exactly what will change. Running a process is riskier than an ordinary edit: notifications, tasks and stage transitions follow it, so the agent names the schema and the object it applies to before the start, not after.",
        "The agent's boundaries are the permissions of the integration user: an entity closed by a role shows up in no report at all, and the agent names that cause instead of putting an empty table on screen. Filtering and sorting are handed to the server through $filter, $orderby and $select so that spare columns are never pulled, and dates are cast into the OData format, otherwise the period filters to the wrong range. The request rate stays moderate: paged selections run with pauses instead of taking the server over."
      ],
      "requirements": [
        "Administrator rights in the BPMSoft workspace",
        "A spare licence for the new user",
        "A server reachable from outside, not only inside your network"
      ],
      "faq": [
        {
          "q": "How do I connect BPMSoft CRM?",
          "a": "With three fields: the server address from the account URL up to the first slash, plus the login and password of a dedicated user. That user needs a licence on the Licences tab and the Access to OData operation under operation permissions."
        },
        {
          "q": "What does the agent see in BPMSoft CRM?",
          "a": "OData 4 entities: contacts, accounts, leads, opportunities, activities, invoices, orders, cases, products and documents, within the permissions of the integration user."
        },
        {
          "q": "Does the agent write to BPMSoft CRM?",
          "a": "It can: create and update records and run a business process by schema name. By default it works read-only for analytics, and writes happen on your request."
        },
        {
          "q": "What about an on-premise server?",
          "a": "The address has to be reachable from outside: a server on an internal network with no external access is invisible to the connector. A response is capped at 20 000 rows, beyond which it pages through."
        }
      ]
    }
  },
  {
    "key": "brand_analytics",
    "name": "Brand Analytics",
    "name_en": "Brand Analytics",
    "description": "Мониторинг упоминаний в соцсетях и СМИ, анализ тональности, топики, авторы",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "brand-analytics",
    "description_en": "Mentions in social media and the press, sentiment, topics and authors",
    "search_terms": [
      "бренд аналитикс"
    ],
    "guide": {
      "url": "https://brandanalytics.ru",
      "steps": [
        {
          "title": "Войдите под администратором кабинета",
          "desc": "Подключить API может «Администратор» или «Супер Администратор» на тарифе «Расширенный» и выше; у остальных пункта в настройках нет.",
          "title_en": "Sign in as an account administrator",
          "desc_en": "Only an «Администратор» or «Супер Администратор» can enable the API, and only on the «Расширенный» plan or higher. Other users will not see the item at all."
        },
        {
          "title": "Заведите хотя бы одну тему мониторинга",
          "desc": "Тема это объект мониторинга с поисковыми запросами и фильтрами. Данные идут в разрезе тем: пока темы нет, ответ приходит пустым.",
          "title_en": "Create at least one monitoring topic",
          "desc_en": "A topic is a monitored object plus its search queries and filters. Data is served per topic: until a topic exists the reply comes back empty."
        },
        {
          "title": "В «Интеграциях» выберите «Статистический API»",
          "desc": "В списке интеграций выберите «Статистический API» и нажмите «Подключить». Рядом появятся ссылка на документацию, API-ключ и переключатель «Интеграция активна».",
          "title_en": "In Интеграции choose Статистический API",
          "desc_en": "In the integrations list pick «Статистический API» and click «Подключить». The API key and the «Интеграция активна» switch appear next to it."
        },
        {
          "title": "Включите «Интеграция активна», заберите ключ",
          "desc": "Отметьте «Интеграция активна», сохраните и скопируйте API-ключ. Без галочки ключ выдан, но запросы не проходят.",
          "title_en": "Tick Интеграция активна and copy the API key",
          "desc_en": "Tick «Интеграция активна» and save, otherwise the key exists but requests are rejected. Copy the API key: only a «Супер Администратор» may reissue it."
        }
      ]
    },
    "seo": {
      "title": "Brand Analytics и ИИ-агент: откуда пошла волна негатива",
      "description": "Покажет, какой пост дал всплеск негатива и сколько охвата он собрал, сведёт упоминания темы мониторинга по дням. Только чтение по токену Статистического API.",
      "headline": "Собирайте упоминания бренда за любой период прямо в чате",
      "scenarios": [
        {
          "title": "Упоминания бренда за период",
          "desc": "Агент соберёт упоминания по теме мониторинга за выбранные даты, отфильтрует их по площадкам и покажет сообщения с наибольшим охватом."
        },
        {
          "title": "Тональность и всплески негатива",
          "desc": "Агент разложит сообщения по тональности, построит динамику по дням и покажет, в какой день и на какой площадке негатив пошёл вверх."
        },
        {
          "title": "Топ авторов и площадок",
          "desc": "Агент соберёт авторов с наибольшим охватом, разложит упоминания по типам источников и регионам и покажет, где о вас говорят чаще всего."
        },
        {
          "title": "Аудит тем мониторинга",
          "desc": "Агент сверит темы кабинета между собой, найдёт дубли по объекту и поисковым запросам и покажет, какие темы простаивают и тратят лимит."
        },
        {
          "title": "Мы и соседи по рынку",
          "desc": "Агент возьмёт две темы мониторинга сразу, сравнит объём упоминаний, тональность и площадки и покажет, где о вас говорят иначе, чем о конкуренте."
        },
        {
          "title": "Утренняя сводка упоминаний",
          "desc": "Агент по расписанию соберёт вчерашние упоминания, сравнит объём и тональность с предыдущими днями и пришлёт короткую сводку с самыми заметными сообщениями."
        }
      ],
      "how_it_works": [
        "Агент работает со «Статистическим API» Brand Analytics по токену из кабинета: сначала читает список тем мониторинга, затем по выбранной теме собирает сами упоминания с текстами, статистику по дням, распределение тональности, разрез по типам источников, географию и топ авторов по охвату. Из этого складываются динамика негатива по дням и площадкам и картина того, где о бренде говорят чаще всего.",
        "Ключевая особенность сервиса: всё привязано к темам. Упоминания не существуют сами по себе: их границы задаёт поисковый запрос темы, заведённый в кабинете, и агент видит ровно то, что в этот запрос попало. Поэтому он отдельно сверяет темы между собой: находит дубли по объекту и формулировке запроса и показывает темы, которые простаивают, но продолжают тратить лимит тарифа.",
        "На запись агент здесь не ходит вовсе: «Статистический API» используется только на чтение. Он не создаёт и не правит темы, поисковые запросы и фильтры: если выборка собирает лишнее или упускает нужное, агент называет конкретную тему и то, что в её запросе стоит поменять, а правку вы делаете в кабинете сами. Всё остальное (сбор, разбор и сведение упоминаний) остаётся на нём.",
        "Доступ даёт один API-токен из кабинета: он подставляется в каждый запрос, а объём выдачи упирается в лимит тарифа: счётчик упоминаний общий на все темы. Агент экономит его: забирает период порциями, не перезапрашивает уже разобранное и сам выдерживает частоту обращений. Если по теме за период упоминаний нет, он скажет об этом прямо, а не выдаст пустую таблицу за отсутствие негатива."
      ],
      "requirements": [
        "Тариф «Расширенный» или выше в кабинете Brand Analytics.",
        "Роль «Администратор» или «Супер Администратор» в кабинете."
      ],
      "faq": [
        {
          "q": "Как подключить Brand Analytics?",
          "a": "API-токеном: откройте кабинет Brand Analytics → «Настройки» → «Интеграции», подключите «Статистический API», отметьте «Интеграция активна» и скопируйте ключ в поле подключения. Пункт доступен роли «Администратор» на тарифе «Расширенный» и выше."
        },
        {
          "q": "Что агент видит в Brand Analytics?",
          "a": "Темы мониторинга и их настройки, отдельные упоминания с текстами, статистику по дням, распределение тональности, разрез по источникам, географию и топ авторов по темам, заведённым в кабинете."
        },
        {
          "q": "Пишет ли агент в Brand Analytics?",
          "a": "Нет. Статистический API используется на чтение: агент собирает и разбирает упоминания, но не создаёт и не меняет темы мониторинга, запросы и фильтры."
        },
        {
          "q": "Почему список тем приходит пустым?",
          "a": "Либо в кабинете ещё нет ни одной темы, либо ключ выдан, но переключатель «Интеграция активна» выключен. Данные отдаются только в разрезе тем, поэтому без них подключение выглядит нерабочим."
        }
      ]
    },
    "seo_en": {
      "title": "Brand Analytics AI agent: trace a spike in negativity",
      "description": "Traces which post sparked a wave of negative mentions and how far it reached, and charts a monitoring topic by day. Uses a Statistical API token, read-only.",
      "headline": "Collect brand mentions for any period right in the chat",
      "scenarios": [
        {
          "title": "Brand mentions for any period",
          "desc": "The agent pulls mentions for a monitoring topic across the dates you pick, filters them by platform and surfaces the posts with the widest reach."
        },
        {
          "title": "Sentiment and negativity spikes",
          "desc": "The agent breaks messages down by sentiment, charts the daily dynamics and shows exactly which day and which platform the negativity climbed on."
        },
        {
          "title": "Top authors and platforms",
          "desc": "The agent collects the authors with the widest reach, splits mentions by source type and region and shows where people talk about you most."
        },
        {
          "title": "Monitoring topic audit",
          "desc": "The agent compares the topics in your account, finds duplicates by object and search query and shows which topics sit idle while burning your quota."
        },
        {
          "title": "You against a competitor",
          "desc": "The agent takes two monitoring topics at once, compares mention volume, sentiment and platforms and shows where people talk about you differently than about your rival."
        },
        {
          "title": "Morning mentions summary",
          "desc": "On a schedule, the agent gathers yesterday's mentions, compares volume and sentiment against the previous days and sends a short digest with the loudest posts."
        }
      ],
      "how_it_works": [
        "The agent works with the Brand Analytics Statistical API using the token from your account: first it reads the list of monitoring topics, then for the chosen topic it collects the mentions themselves with full text, daily statistics, sentiment distribution, a breakdown by source type, geography and the top authors by reach. Out of that come the daily negativity dynamics by platform and the picture of where the brand is talked about most.",
        "The key trait of the service is that everything is tied to topics. Mentions do not exist on their own: their boundaries are set by the topic search query configured in the account, and the agent sees exactly what that query captured. So it separately compares topics against each other: it finds duplicates by object and by query wording and shows the topics that sit idle while still burning the plan quota.",
        "The agent never writes here: the Statistical API is used read-only. It neither creates nor edits topics, search queries or filters: if a selection picks up noise or misses what you need, the agent names the specific topic and what should change in its query, and you make the edit in the account yourself. Everything else (collecting, analysing and consolidating mentions) stays on the agent.",
        "Access comes from a single API token issued in the account: it is attached to every request, while the volume you can pull is capped by the plan quota, which is shared across all topics. The agent spends it carefully: it fetches the period in portions, does not re-request what it has already parsed and holds the request rate itself. If a topic has no mentions for the period, it says so directly instead of passing an empty table off as an absence of negativity."
      ],
      "requirements": [
        "The Expanded plan or higher in the Brand Analytics account.",
        "The Administrator or Super Administrator role in the account."
      ],
      "faq": [
        {
          "q": "How do I connect Brand Analytics?",
          "a": "With an API token: in your account open Settings, then Integrations, enable the Statistical API, tick Integration active and copy the key into the connection field. The menu item is available to the Administrator role on the Extended plan and above."
        },
        {
          "q": "What can the agent see in Brand Analytics?",
          "a": "Monitoring topics and their settings, individual mentions with full text, daily statistics, sentiment distribution, a breakdown by source, geography and top authors, for the topics set up in your account."
        },
        {
          "q": "Does the agent write to Brand Analytics?",
          "a": "No. The Statistical API is used read-only: the agent collects and analyses mentions, but never creates or changes monitoring topics, queries or filters."
        },
        {
          "q": "Why does the topic list come back empty?",
          "a": "Either there are no topics in the account yet, or the key was issued while the Integration active toggle stayed off. Data is only served per topic, so without topics the connection looks broken."
        }
      ]
    }
  },
  {
    "key": "bybit",
    "name": "ByBit",
    "name_en": "ByBit",
    "description": "Криптобиржа: тикеры, баланс, ордера, позиции, свечи",
    "category": "banks",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "never",
    "has_own_page": false,
    "integration_slug": null,
    "description_en": "Crypto exchange: tickers, balance, orders, positions and candles",
    "search_terms": [
      "байбит"
    ],
    "guide": {
      "url": "https://www.bybit.com/app/user/api-management",
      "steps": [
        {
          "title": "Откройте «API Management» в кабинете Bybit",
          "desc": "Войдите под аккаунтом, на котором лежат средства, и откройте www.bybit.com/app/user/api-management. Ключ суб-аккаунта видит только его баланс и сделки.",
          "title_en": "Open “API Management” in your Bybit account",
          "desc_en": "Sign in with the account that holds the funds and open www.bybit.com/app/user/api-management. A sub-account key sees only that sub-account's balance."
        },
        {
          "title": "Создайте ключ «System-generated»",
          "desc": "Нажмите «Create New Key» и выберите «System-generated API Keys». Самостоятельный RSA-ключ не подойдёт: запросы подписываются HMAC-SHA256.",
          "title_en": "Create a “System-generated” key",
          "desc_en": "Click “Create New Key” and pick “System-generated API Keys”. A self-generated RSA key will not work: requests are signed with HMAC-SHA256."
        },
        {
          "title": "В правах ключа выберите «Read-Only»",
          "desc": "В правах ключа выберите «Read-Only»: этого хватает на баланс, позиции, ордера, свечи и историю сделок. Права группы Wallet на вывод выдавать не нужно.",
          "title_en": "Set the key permissions to Read-Only",
          "desc_en": "Set the key permissions to “Read-Only”, enough for balances, positions, orders, candles and trade history. The Wallet withdrawal group is not needed."
        },
        {
          "title": "Без своего IP оставьте «No IP restriction»",
          "desc": "Без белого списка IP ключ истекает через 90 дней, а с привязанными адресами не истекает. Если постоянного IP нет, оставьте «No IP restriction».",
          "title_en": "Without a static IP keep No IP restriction",
          "desc_en": "A key with no IP whitelist expires in 90 days; one bound to addresses does not. Without a static IP leave “No IP restriction” and set a reminder."
        },
        {
          "title": "Скопируйте API Key и Secret",
          "desc": "Сразу после создания скопируйте оба значения. Secret показывается один раз: если он потерян, ключ придётся удалить и создать заново.",
          "title_en": "Copy the API Key and Secret",
          "desc_en": "Copy both values right after creation. The Secret is shown once: if it is lost, you have to delete the key and create a new one."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для ByBit: открытые позиции и закрытый PnL",
      "description": "Агент покажет открытые позиции с нереализованным PnL и закрытый результат месяца по каждой паре. Хватает ключа Read-Only, права на вывод средств не нужны.",
      "headline": "Следите за балансом и позициями Bybit прямо в чате",
      "scenarios": [
        {
          "title": "Баланс и открытые позиции",
          "desc": "Агент покажет баланс кошелька и все открытые позиции с текущим PnL одним ответом, без переключения вкладок биржи."
        },
        {
          "title": "Сделки и закрытый PnL",
          "desc": "Агент соберёт исполненные сделки за период и разложит закрытый результат по каждому символу и стороне сделки."
        },
        {
          "title": "Котировки и свечи",
          "desc": "Агент снимет тикеры и свечи по нужным парам и посчитает, как двигалась цена за выбранный вами период."
        },
        {
          "title": "Сводка по расписанию",
          "desc": "Агент пришлёт сводку по расписанию: цены нужных пар, изменение баланса и заявки, которые так и висят неисполненными."
        },
        {
          "title": "Спот и фьючерсы порознь",
          "desc": "Агент запросит спот, бессрочные контракты и опционы отдельными категориями и покажет баланс и позиции по каждой, не сваливая разные контуры в одну сумму."
        },
        {
          "title": "Проверка ключа перед отчётом",
          "desc": "Агент сделает подписанный запрос сведений о ключе и скажет, жив ли он: истёк по 90-дневному сроку, отозван или подпись отвергнута. Вместо пустой таблицы будет причина."
        }
      ],
      "how_it_works": [
        "Агент работает с единым API Bybit пятой версии: рыночные тикеры и свечи по нужным парам, баланс кошелька, открытые позиции с текущим PnL, активные ордера и история исполненных сделок. Из этого он считает закрытый результат за период с разбивкой по символу и стороне сделки, изменение баланса между датами и список заявок, которые так и висят неисполненными, и всё по аккаунту, чей ключ подключён.",
        "У Bybit почти каждый запрос требует указать категорию рынка: спот, бессрочные контракты и опционы образуют разные учётные контуры, и позиция в одном не видна в другом. Агент запрашивает категории отдельно и не смешивает их в одной сумме. Ещё одна тонкость: PnL по открытой позиции означает переоценку по текущей цене, она меняется каждую секунду, поэтому в отчётах агент отделяет её от закрытого результата по фактическим сделкам.",
        "Читать здесь важнее, чем писать. Баланс, позиции, ордера, история и сводки по расписанию собираются одним только чтением: коннектор не переводит средства и не запрашивает прав на вывод. Торговые права появляются, только если вы сами выдали их ключу на стороне биржи; без них агент считает и показывает, но ни одной заявки не выставит и не отменит, а на попытку ответит отказом биржи, а не молчанием.",
        "Подключение идёт парой API Key и Secret: каждый запрос подписывается HMAC-SHA256 вместе с меткой времени, поэтому часы на стороне агента синхронизированы с биржей, иначе подпись отвергается как просроченная. Историю сделок Bybit отдаёт окнами по датам и страницами по курсору, так что длинный период агент обходит частями и складывает результат сам. Частоту обращений он выдерживает сам, а об истёкшем или отозванном ключе говорит прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Аккаунт Bybit, на котором лежат средства",
        "Постоянный IP-адрес, если ключ не должен истекать через 90 дней"
      ],
      "faq": [
        {
          "q": "Как подключить ByBit?",
          "a": "Ключом API: в кабинете Bybit откройте «API Management» → «Create New Key» и выберите тип «System-generated API Keys»: RSA-ключ не подойдёт. Вставьте API Key и Secret, адрес API можно оставить по умолчанию. Уровня «Read-Only» хватает для баланса, позиций и истории."
        },
        {
          "q": "Что агент видит на бирже?",
          "a": "Тикеры и свечи рынка, баланс кошелька, открытые позиции, ордера и историю исполненных сделок того аккаунта, чей ключ подключён."
        },
        {
          "q": "Может ли агент торговать?",
          "a": "По умолчанию нет: для всей аналитики достаточно ключа уровня «Read-Only», а права на вывод средств коннектору не нужны вовсе. Торговые права выдаются только вашим решением на стороне биржи."
        },
        {
          "q": "Почему ключ перестал работать?",
          "a": "Без белого списка IP ключ Bybit истекает через 90 дней: после этого API отвечает отказом, и ключ нужно перевыпустить в разделе «API Management»."
        }
      ]
    },
    "seo_en": {
      "title": "ByBit AI agent: open positions and closed PnL",
      "description": "See open positions with unrealized PnL and the month's closed result per symbol in one answer. A Read-Only API key is enough; no withdrawal rights needed.",
      "headline": "Track your Bybit balance and open positions right in chat",
      "scenarios": [
        {
          "title": "Balance and open positions",
          "desc": "The agent shows your wallet balance and every open position with its current PnL in a single answer, without you flipping between exchange tabs."
        },
        {
          "title": "Trades and realised PnL",
          "desc": "The agent collects executed trades for a period and breaks the realised result down by symbol and by trade side."
        },
        {
          "title": "Tickers and candles",
          "desc": "The agent pulls tickers and candles for the pairs you care about and works out how the price moved over the period you choose."
        },
        {
          "title": "Scheduled summary",
          "desc": "The agent sends a summary on schedule: prices for your pairs, the change in balance and the orders still sitting unfilled."
        },
        {
          "title": "Spot and futures kept apart",
          "desc": "The agent queries spot, perpetuals and options as separate categories and shows balance and positions for each, never rolling different ledgers into one total."
        },
        {
          "title": "Check the key before a report",
          "desc": "The agent makes a signed request for the key's own details and tells you whether the key is alive: expired after 90 days, revoked or a rejected signature. A reason, not an empty table."
        }
      ],
      "how_it_works": [
        "The agent works with the unified v5 Bybit API: market tickers and candles for the pairs you care about, wallet balance, open positions with their current PnL, active orders and the executed trade history. From that it calculates the realised result for a period broken down by symbol and trade side, the change in balance between dates and the list of orders still sitting unfilled, all for the account the connected key belongs to.",
        "In Bybit almost every request has to name a market category: spot, perpetual contracts and options are separate ledgers, and a position in one is invisible in another. The agent queries the categories separately and never merges them into a single total. One more subtlety: the PnL on an open position is a mark-to-market figure that moves every second, so in reports the agent keeps it apart from the realised result of actual trades.",
        "Reading matters more here than writing. Balances, positions, orders, history and scheduled summaries are assembled by reading alone: the connector moves no funds and asks for no withdrawal rights. Trading rights appear only if you granted them to the key on the exchange side; without them the agent counts and shows, but places and cancels nothing, and an attempt comes back as a refusal from the exchange rather than silence.",
        "The connection runs on an API Key and Secret pair: every request is signed with HMAC-SHA256 together with a timestamp, so the agent keeps its clock in step with the exchange, otherwise the signature is rejected as stale. Bybit hands over trade history in date windows and cursor pages, so a long period is walked in parts and added up by the agent itself. It holds the request rate on its own, and an expired or revoked key is reported directly instead of an empty table."
      ],
      "requirements": [
        "A Bybit account that actually holds the funds",
        "A static IP address if the key must not expire after 90 days"
      ],
      "faq": [
        {
          "q": "How do I connect ByBit?",
          "a": "With an API key: in your Bybit account open API Management, then Create New Key, and pick the System-generated API Keys type, since an RSA key will not work. Paste the API Key and Secret; the API address can stay at its default. Read-Only level is enough for balance, positions and history."
        },
        {
          "q": "What can the agent see on the exchange?",
          "a": "Market tickers and candles, wallet balance, open positions, orders and the executed trade history of whichever account the key belongs to."
        },
        {
          "q": "Can the agent trade?",
          "a": "Not by default: a Read-Only key covers all the analytics, and the connector never needs withdrawal rights at all. Trading permissions are granted only by your own decision on the exchange side."
        },
        {
          "q": "Why did my key stop working?",
          "a": "Without an IP allowlist a Bybit key expires after 90 days: the API starts refusing requests and the key has to be reissued under API Management."
        }
      ]
    }
  },
  {
    "key": "cdek",
    "name": "СДЭК",
    "name_en": "CDEK",
    "description": "Доставка: заказы, расчёт тарифов, отслеживание, ПВЗ, вызов курьера",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "cdek",
    "description_en": "Delivery: orders, rate quotes, tracking, pickup points and courier calls",
    "search_terms": [
      "сдек"
    ],
    "guide": {
      "url": "https://lk.cdek.ru/integration",
      "steps": [
        {
          "title": "Заключите договор со СДЭК",
          "desc": "Доступ к API открывается только по договору на юрлицо или ИП. Без договора кабинет работает как розничный: раздела с ключами в нём нет.",
          "title_en": "Sign a contract with CDEK",
          "desc_en": "API access requires an active contract with a company or sole proprietor. Without one the account stays retail-only and shows no key section."
        },
        {
          "title": "Войдите в кабинет на lk.cdek.ru",
          "desc": "Входите под учётной записью, к которой привязан договор: ключи выпускаются в контуре этого договора. Розничный кабинет отправителя их не выдаёт.",
          "title_en": "Log in to the account at lk.cdek.ru",
          "desc_en": "Log in with the account the contract is attached to: keys are issued within that contract. A retail sender account cannot issue them."
        },
        {
          "title": "Откройте lk.cdek.ru/integration",
          "desc": "В меню кабинета выберите «Интеграция» (страница lk.cdek.ru/integration). Здесь же настраиваются вебхуки, поэтому статусы посылок придут в тот же контур.",
          "title_en": "Open lk.cdek.ru/integration",
          "desc_en": "Pick «Интеграция» in the account menu; the page is lk.cdek.ru/integration. Webhooks live there too, so parcel statuses arrive in the same scope."
        },
        {
          "title": "Нажмите «Создать новый ключ»",
          "desc": "Кабинет выдаст пару Account и Secure password. Secure password показывается один раз при создании: если не сохранить, ключ придётся выпускать заново.",
          "title_en": "Click «Создать новый ключ»",
          "desc_en": "You get an Account and a Secure password. The Secure password is shown only once at creation: lose it and you must issue a new key."
        }
      ]
    },
    "seo": {
      "title": "Интеграция СДЭК с ИИ: тариф и срок посылки в чате",
      "description": "Назовёт цену и срок до отправки: посылка 3,2 кг в Казань от 480 ₽ и 2 дня. Оформит заказ и вызовет курьера только после вашего подтверждения.",
      "headline": "ИИ для логистики: тарифы и сроки доставки СДЭК в чате",
      "scenarios": [
        {
          "title": "Расчёт тарифа и срока",
          "desc": "Агент рассчитает стоимость и срок доставки по нужному направлению, весу и габаритам и подберёт ближайший к клиенту пункт выдачи."
        },
        {
          "title": "Оформление отправки",
          "desc": "Агент оформит заказ на доставку, вызовет курьера и вернёт трек-номер, не открывая личный кабинет lk.cdek.ru вручную."
        },
        {
          "title": "Контроль посылок в пути",
          "desc": "Агент поймает смену статуса каждой посылки по вебхуку и пришлёт сводку о тех, что застряли в пути дольше обычного."
        },
        {
          "title": "Подбор пункта выдачи",
          "desc": "Агент подберёт ПВЗ по городу и адресу клиента с учётом габаритов посылки и режима работы пункта."
        },
        {
          "title": "Накладные по готовности",
          "desc": "Агент дождётся события о готовности печатной формы и фото по заказу, заберёт их и покажет вместе с посылкой, так что искать в личном кабинете вручную не придётся."
        },
        {
          "title": "Города по справочнику",
          "desc": "Агент сверит города и адреса из заявок со справочником регионов и городов СДЭК и покажет те, на которых оформление заказа не сойдётся."
        }
      ],
      "how_it_works": [
        "Агент ходит в API СДЭК на api.cdek.ru: считает стоимость и срок доставки по направлению, весу и габаритам, поднимает справочники регионов, городов и пунктов выдачи, читает заказы вместе с историей их статусов и забирает печатные формы и фото по готовности. Подбор ПВЗ он делает не по одному городу, а с оглядкой на габариты посылки и режим работы пункта, иначе клиент приедет к закрытой двери.",
        "Статусы в доставке приходят не по расписанию, и опрашивать заказ по кругу бессмысленно, поэтому СДЭК шлёт события сам: смену статуса заказа, готовность печатной формы и готовность фото. Агент ловит их вебхуком, привязывает к номеру заказа СДЭК и по накопленной истории видит, какая посылка стоит на одном статусе дольше обычного, то есть застряла, а не просто едет.",
        "На запись агент умеет ровно две вещи: оформить заказ на доставку и вызвать курьера. Обе он показывает вам до отправки (направление, габариты, получателя, дату вызова) и делает шаг только после подтверждения, потому что ошибка здесь стоит реального рейса и денег. После создания заказа агент возвращает трек-номер и дальше ведёт посылку уже на чтение.",
        "Токен коннектор получает и обновляет сам, поэтому ключи вводятся один раз и дальше о них можно забыть. Частота запросов держится в пределах пяти в секунду: массовый расчёт тарифов агент разбивает на пачки, а города берёт из справочника СДЭК, а не из текста заявки, иначе адрес не сойдётся. Про данные, которых в ответе нет, он говорит прямо, вместо пустой таблицы."
      ],
      "requirements": [
        "Подтверждение с вашей стороны на создание заказа и вызов курьера",
        "Тестовый контур api.edu.cdek.ru, если нужно проверить без реальной отправки"
      ],
      "faq": [
        {
          "q": "Как подключить СДЭК?",
          "a": "Парой ключей из личного кабинета lk.cdek.ru: раздел «Интеграция» → «Создать новый ключ». Account это client_id, Secure password это client_secret, и он показывается один раз при создании. Доступ к API открывается только по договору на юрлицо или ИП."
        },
        {
          "q": "Что агент видит в СДЭК?",
          "a": "Заказы и историю их статусов, расчёт тарифов, справочники регионов, городов и пунктов выдачи, а также печатные формы и фото, приходящие по вебхуку."
        },
        {
          "q": "Пишет ли агент в СДЭК?",
          "a": "Да: агент может создать заказ на доставку и вызвать курьера, и такие действия он подтверждает с вами перед отправкой. Остальная работа сводится к чтению статусов и расчётам."
        },
        {
          "q": "Есть ли тестовый контур?",
          "a": "Да, кроме боевого api.cdek.ru коннектор знает тестовый адрес api.edu.cdek.ru, и заказы, созданные там, в реальную доставку не уходят."
        }
      ]
    },
    "seo_en": {
      "title": "CDEK integration with AI: parcel price and transit time",
      "description": "Quotes a parcel before you ship: 3.2 kg to Kazan from 480 RUB in 2 days. The agent creates the CDEK order and books a courier only after you confirm.",
      "headline": "Calculate CDEK delivery prices and transit times in chat",
      "scenarios": [
        {
          "title": "Delivery quote and transit time",
          "desc": "The agent calculates the cost and delivery time for a given route, weight and dimensions, and picks the pickup point closest to your customer."
        },
        {
          "title": "Creating a shipment",
          "desc": "The agent creates the delivery order, books a courier and returns the tracking number, with no manual trips to the lk.cdek.ru account."
        },
        {
          "title": "Parcels in transit under control",
          "desc": "The agent catches every parcel status change over a webhook and sends a summary of the ones stuck in transit longer than usual."
        },
        {
          "title": "Picking a pickup point",
          "desc": "The agent finds a pickup point by the customer city and address, taking parcel dimensions and the point opening hours into account."
        },
        {
          "title": "Waybills once they are ready",
          "desc": "The agent waits for the print form and photo ready events on an order, collects both and shows them next to the parcel, with no manual hunting in the account."
        },
        {
          "title": "Cities from the reference list",
          "desc": "The agent checks the cities and addresses from your requests against the CDEK region and city lists and flags the ones order creation will not match."
        }
      ],
      "how_it_works": [
        "The agent calls the CDEK API at api.cdek.ru: it calculates the cost and transit time for a route, weight and dimensions, pulls up the reference lists of regions, cities and pickup points, reads orders along with their status history and collects print forms and photos once they are ready. A pickup point is chosen not by city alone but with an eye on parcel dimensions and the opening hours of the point, otherwise the customer arrives at a closed door.",
        "Delivery statuses do not arrive on a schedule and polling an order in circles is pointless, so CDEK sends the events itself: an order status change, a print form ready and a photo ready. The agent catches them over a webhook, ties them to the CDEK order number and, from the accumulated history, sees which parcel has been sitting on one status longer than usual, that is, stuck rather than simply in transit.",
        "On the write side the agent does exactly two things: create a delivery order and book a courier. It shows both to you before sending (route, dimensions, recipient, pickup date) and takes the step only after confirmation, because a mistake here costs a real trip and real money. Once the order is created the agent returns the tracking number and follows the parcel read-only from there.",
        "The connector obtains and refreshes the token on its own, so the keys are entered once and can be forgotten afterwards. The request rate is held within five per second: a bulk tariff calculation is split into batches, and cities are taken from the CDEK reference list rather than from the text of a request, or the address will not match. About data missing from a response the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Your confirmation before an order is created or a courier is booked",
        "The api.edu.cdek.ru sandbox if you want to test without real shipments"
      ],
      "faq": [
        {
          "q": "How do I connect CDEK?",
          "a": "With a key pair from the lk.cdek.ru account: go to the Integration section and choose Create new key. Account is your client_id, Secure password is your client_secret, and it is shown only once at creation. API access is granted only under a contract with a company or sole trader."
        },
        {
          "q": "What can the agent see in CDEK?",
          "a": "Orders and their status history, tariff calculations, reference lists of regions, cities and pickup points, plus the print forms and photos delivered by webhook."
        },
        {
          "q": "Does the agent write to CDEK?",
          "a": "Yes: the agent can create a delivery order and book a courier, and it confirms such actions with you before sending them. Everything else is reading statuses and running calculations."
        },
        {
          "q": "Is there a sandbox environment?",
          "a": "Yes, alongside the production api.cdek.ru the connector knows the test address api.edu.cdek.ru, and orders created there never enter real delivery."
        }
      ]
    }
  },
  {
    "key": "chat2desk",
    "name": "Chat2Desk",
    "name_en": "Chat2Desk",
    "description": "Омниканальная платформа: сообщения, диалоги, каналы (WhatsApp, Telegram и др.)",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "chat2desk",
    "description_en": "Omnichannel platform: messages, dialogs and channels such as WhatsApp and Telegram",
    "signup_url": "https://chat2desk.com/registr",
    "guide": {
      "url": "https://chat2desk.com",
      "steps": [
        {
          "title": "Войдите в Chat2Desk под администратором",
          "desc": "Токен доступен только администратору аккаунта: у оператора и супервайзера нужного раздела в меню нет. Вход на chat2desk.com логином и паролем аккаунта.",
          "title_en": "Sign in to Chat2Desk as an administrator",
          "desc_en": "Only the account administrator sees the token: operators and supervisors have no such section. Sign in at chat2desk.com with your account login and password."
        },
        {
          "title": "В «API и скрипты» откройте «API»",
          "desc": "В меню «Настройки» → «API и скрипты» → «API» живёт единственный токен для внешних систем. Токен Telegram или другого канала из настроек канала не подойдёт.",
          "title_en": "In Settings open API and scripts, then API",
          "desc_en": "This is the only place the token for external systems lives. A Telegram or other channel token will not work: you need the account one."
        },
        {
          "title": "Нажмите «Показать» и скопируйте токен",
          "desc": "Значение скрыто по умолчанию; кнопка «Показать» раскрывает его целиком. Копируйте строку без пробелов по краям: она передаётся как есть, без префикса Bearer.",
          "title_en": "Click Show and copy the token",
          "desc_en": "The value is hidden by default; the Show button reveals it in full. Copy the string without surrounding spaces: it is sent as is, with no Bearer prefix."
        },
        {
          "title": "Рядом с токеном проверьте остаток запросов",
          "desc": "Рядом с токеном видно, сколько вызовов доступно и потрачено в этом месяце: во все тарифы входит 100 000 запросов. Новый токен мгновенно гасит прежний.",
          "title_en": "Next to the token check the remaining calls",
          "desc_en": "Next to the token you see the calls available and used this month: every plan includes 100,000 requests. A new token instantly invalidates the previous one."
        }
      ]
    },
    "seo": {
      "title": "Chat2Desk и ИИ-агент: у кого из операторов завал",
      "description": "Посчитает обращения за сутки и покажет, у каких операторов копятся открытые диалоги; ответит клиенту и переведёт диалог на другого. Нужен API-токен аккаунта.",
      "headline": "Находите диалоги без ответа во всех каналах Chat2Desk",
      "scenarios": [
        {
          "title": "Диалоги без ответа",
          "desc": "Агент пройдёт по открытым диалогам всех подключённых каналов и покажет, какие обращения висят без ответа дольше остальных."
        },
        {
          "title": "История переписки с клиентом",
          "desc": "Агент найдёт клиента по номеру телефона, поднимет историю диалога и перескажет, о чём договорились, не открывая чат вручную."
        },
        {
          "title": "Ответ и маршрутизация диалога",
          "desc": "Агент отправит клиенту сообщение в его канал, переведёт диалог на нужного оператора или закроет его, когда вопрос решён."
        },
        {
          "title": "Сводка обращений за сутки",
          "desc": "Агент посчитает, сколько обращений пришло за сутки и по каким каналам (WhatsApp, Telegram и остальным) и сколько диалогов осталось открытыми."
        },
        {
          "title": "Кто из операторов перегружен",
          "desc": "Агент разложит открытые и закрытые диалоги по операторам и покажет, у кого очередь длиннее и чьих ответов клиенты ждут дольше всего."
        },
        {
          "title": "О чём пишут чаще всего",
          "desc": "Агент соберёт теги диалогов за период и покажет, какие темы обращений выросли, а какие сошли на нет, отдельно по каждому подключённому каналу."
        }
      ],
      "how_it_works": [
        "Агент работает с API Chat2Desk по адресу api.chat2desk.com/v1: читает карточки клиентов, открытые диалоги и историю переписки, список подключённых каналов, операторов и теги. На этих данных он считает, сколько обращений пришло за сутки и по каким каналам (WhatsApp, Telegram и остальным), сколько диалогов осталось открытыми и какие из них ждут ответа дольше всех.",
        "Платформа омниканальная, и это меняет разбор: клиент здесь один, а переписка с ним может тянуться сразу в нескольких каналах. Агент находит клиента по номеру телефона и собирает историю целиком, а не по одному чату. «Без ответа» он определяет не по пометке, а по последнему сообщению в диалоге и времени его отправки: диалог остаётся открытым, пока его не закрыли, поэтому одного статуса для отчёта недостаточно.",
        "На запись агент отправляет клиенту сообщение, заводит карточку нового клиента, переводит диалог на другого оператора и закрывает его, когда вопрос решён. Канал он не выбирает произвольно: ответ уходит туда, откуда клиент написал. По умолчанию агент работает на чтение и разбор, а перед отправкой показывает получателя и текст, чтобы сообщение клиенту не ушло без вашего согласия.",
        "Токен аккаунта открывает агенту все подключённые каналы сразу, а не один мессенджер, поэтому границу выборки задаёт не ключ, а фильтр по каналу и периоду. Клиентов и сообщения API отдаёт страницами, и разбор недели на большой базе требует десятков запросов, а лимит здесь один на весь аккаунт: 100 000 вызовов в месяц на всех тарифах. Поэтому агент выдерживает частоту и читает выборкой под задачу, а если данных за период нет, говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Права администратора аккаунта Chat2Desk",
        "Общий API-токен аккаунта, а не токен отдельного канала",
        "Запас в лимите 100 000 запросов к API в месяц"
      ],
      "faq": [
        {
          "q": "Как подключить Chat2Desk?",
          "a": "API-токеном аккаунта: войдите администратором, откройте «Настройки» → «API и скрипты» → «API», нажмите «Показать» и скопируйте строку. Токен отдельного канала не подойдёт, нужен общий токен аккаунта."
        },
        {
          "q": "Что агент видит в Chat2Desk?",
          "a": "Подключённые каналы, карточки клиентов, открытые диалоги и историю переписки, операторов и теги в объёме, который открывает API-токен аккаунта."
        },
        {
          "q": "Пишет ли агент в Chat2Desk?",
          "a": "Может: отправить сообщение клиенту, завести карточку клиента, перевести диалог на другого оператора и закрыть диалог. По умолчанию работает на чтение и разбор."
        },
        {
          "q": "Есть ли лимит на запросы к API?",
          "a": "Во все тарифы входит 100 000 вызовов в месяц, остаток показан на той же странице, где лежит токен. Генерация нового токена мгновенно гасит прежний."
        }
      ]
    },
    "seo_en": {
      "title": "Chat2Desk AI agent: see which operators are swamped",
      "description": "Counts the day's requests and shows which operators are piling up open dialogs; replies to a client and hands the dialog over. Needs the account API token.",
      "headline": "Find dialogs left without a reply across all Chat2Desk channels",
      "scenarios": [
        {
          "title": "Dialogs left without a reply",
          "desc": "The agent walks through the open dialogs of every connected channel and shows which requests have been waiting for an answer the longest."
        },
        {
          "title": "Chat history with a customer",
          "desc": "The agent finds the customer by phone number, pulls up the dialog history and retells what was agreed, without you opening the chat by hand."
        },
        {
          "title": "Replying and routing a dialog",
          "desc": "The agent sends the customer a message in their own channel, hands the dialog over to the right operator or closes it once the question is settled."
        },
        {
          "title": "Daily request summary",
          "desc": "The agent counts how many requests arrived in the last 24 hours and through which channels (WhatsApp, Telegram and the rest) and how many dialogs are still open."
        },
        {
          "title": "Which operators are swamped",
          "desc": "The agent splits open and closed dialogs by operator and shows whose queue runs longer and whose replies customers have been waiting for the longest."
        },
        {
          "title": "What customers write about most",
          "desc": "The agent gathers dialog tags for the period and shows which request topics grew and which faded away, separately for every connected channel."
        }
      ],
      "how_it_works": [
        "The agent works with the Chat2Desk API at api.chat2desk.com/v1: it reads customer cards, open dialogs and chat history, the list of connected channels, operators and tags. On that data it counts how many requests arrived in the last 24 hours and through which channels (WhatsApp, Telegram and the rest), how many dialogs are still open and which of them have been waiting for an answer the longest.",
        "The platform is omnichannel, and that changes the analysis: the customer here is a single person, while the correspondence with them may run through several channels at once. The agent finds the customer by phone number and assembles the whole history rather than one chat at a time. «Left without a reply» is decided not by a label but by the last message in the dialog and the time it was sent: a dialog stays open until someone closes it, so a status alone is not enough for a report.",
        "On the write side the agent sends the customer a message, creates a card for a new customer, hands the dialog over to another operator and closes it once the question is settled. It does not pick the channel freely: the reply goes back to wherever the customer wrote from. By default the agent works read-only and just analyses, and before sending it shows the recipient and the text, so no message reaches a customer without your consent.",
        "The account token opens every connected channel to the agent at once rather than a single messenger, so the boundary of a sample is set by the channel and period filter, not by the key. Customers and messages come back in pages, and a week of analysis on a large base is dozens of calls, while the limit is a single one for the whole account: 100,000 calls a month on every plan. So the agent holds the rate and reads a sample sized to the task, and when there is no data for the period it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Chat2Desk account administrator rights",
        "The account-wide API token, not a single channel token",
        "Room in the limit of 100,000 API requests a month"
      ],
      "faq": [
        {
          "q": "How do I connect Chat2Desk?",
          "a": "With the account API token: sign in as an administrator, open Settings, then API and scripts, then API, click Show and copy the string. A token for a single channel will not do; you need the shared account token."
        },
        {
          "q": "What can the agent see in Chat2Desk?",
          "a": "Connected channels, customer cards, open dialogs and chat history, operators and tags, as far as the account API token allows."
        },
        {
          "q": "Does the agent write to Chat2Desk?",
          "a": "It can: send a message to a customer, create a customer card, hand a dialog to another operator and close a dialog. By default it works read-only and just analyses."
        },
        {
          "q": "Is there a limit on API requests?",
          "a": "Every plan includes 100,000 calls a month, and the remaining balance is shown on the same page as the token. Generating a new token instantly kills the previous one."
        }
      ]
    }
  },
  {
    "key": "chestnyznak",
    "name": "Честный ЗНАК",
    "name_en": "Chestny ZNAK",
    "description": "Маркировка товаров: коды маркировки, документы, карточки товаров, остатки",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "chestnyznak",
    "description_en": "Product labeling: marking codes, documents, product cards and stock",
    "search_terms": [
      "чз"
    ],
    "guide": {
      "url": "https://markirovka.crpt.ru",
      "steps": [
        {
          "title": "Проверьте участие в ГИС МТ",
          "desc": "Вход по сертификату на markirovka.crpt.ru/login-kep. «Профиль» → «Данные участника» → «Редактировать»: ваша товарная группа должна быть в списке. Один ИНН, один кабинет.",
          "title_en": "Check your GIS MT participation",
          "desc_en": "Sign in at markirovka.crpt.ru/login-kep by certificate. «Профиль» → «Данные участника» → «Редактировать»: your product group must be listed. One tax ID, one account."
        },
        {
          "title": "Кнопка «Сгенерировать токен» не подходит",
          "desc": "В блоке «Участие в системе» она выдаёт ключ для проверок на кассе (ККТ). True API такой ключ не принимает.",
          "title_en": "The «Сгенерировать токен» button won't work",
          "desc_en": "In «Участие в системе» (Participation in the system) it issues a key for checks at the cash register (KKT). True API does not accept that key."
        },
        {
          "title": "Получите токен True API подписью УКЭП",
          "desc": "Его выдаёт не кабинет, а True API: программа с КриптоПро подписывает вашей УКЭП запрос /auth/key и получает токен в /auth/simpleSignIn. Так делают 1С и учётные системы.",
          "title_en": "Get a True API token via qualified signature",
          "desc_en": "True API issues it, not the account: a CryptoPro program signs the /auth/key challenge with your qualified e-signature and gets it from /auth/simpleSignIn, as 1C does."
        },
        {
          "title": "Вставьте токен и обновляйте его",
          "desc": "Токен True API: длинная строка из трёх частей через точку. Он живёт до 10 часов, потом его нужно выпустить заново и обновить в подключении.",
          "title_en": "Paste the token and keep it fresh",
          "desc_en": "A True API token is a long string of three dot-separated parts. It lives up to 10 hours, after which you issue a new one and update it in the connection."
        }
      ]
    },
    "seo": {
      "title": "Честный ЗНАК и ИИ-агент: проверка кодов маркировки пачкой",
      "description": "ИИ-агент для Честного знака проверит коды поставки через True API ГИС МТ: из 480 кодов 14 не в обороте, приёмку по ним не закрыть. Подпись УКЭП ставите вы.",
      "headline": "Проверяйте коды маркировки пачками, не открывая ГИС МТ",
      "scenarios": [
        {
          "title": "Проверка кодов маркировки пачкой",
          "desc": "Агент прогонит список кодов через True API и скажет, какие в обороте, какие выбыли, а какие ещё не введены в оборот."
        },
        {
          "title": "Зависшие документы оборота",
          "desc": "Агент соберёт документы отгрузки и приёмки за период и покажет, какие не обработаны системой маркировки или отклонены с ошибкой."
        },
        {
          "title": "Остатки маркированного товара",
          "desc": "Агент сверит балансы и складские остатки кодов по товарным группам и покажет, где данные разошлись с вашим учётом."
        },
        {
          "title": "Карточки товаров в национальном каталоге",
          "desc": "Агент проверит карточки по GTIN, найдёт неопубликованные и те, где не хватает обязательных атрибутов товарной группы."
        },
        {
          "title": "Выбытие через кассу",
          "desc": "Агент сверит коды с чеками ККТ и покажет, что уже выбыло через кассу, а что ещё числится в обороте, с поправкой на задержку передачи данных."
        },
        {
          "title": "Список под подписание УКЭП",
          "desc": "Агент соберёт зависшие и отклонённые документы в один список под подпись: останется подписать носителем, а не искать их по кабинету поштучно."
        }
      ],
      "how_it_works": [
        "Агент ходит в True API ГИС МТ на markirovka.crpt.ru: прогоняет коды маркировки пачками и снимает их статусы, читает список документов оборота, поднимает карточки товаров по GTIN из национального каталога и сверяет балансы со складскими остатками по товарным группам. Из этого он считает, какие коды в обороте, какие выбыли, а какие ещё не введены, и где ваш складской учёт разошёлся с данными системы маркировки.",
        "Приём документа и его обработка в ГИС МТ это разные события: система принимает отгрузку или приёмку сразу, а результат появляется позже, и часть документов оседает необработанной или отклонённой с ошибкой. Агент разделяет эти состояния и показывает не факт подачи, а фактическую судьбу документа. Со статусами кодов он осторожен по той же причине: выбытие фиксируется чеками ККТ и доходит до системы не мгновенно.",
        "На запись агент здесь почти не работает, и это свойство самой системы: подача документов в оборот подтверждается усиленной квалифицированной подписью, которую формирует ваш носитель, а не агент. Поэтому он собирает данные, находит расхождения и готовит списки под подписание (проверенные коды, зависшие и отклонённые документы, карточки без обязательных атрибутов товарной группы), а подписать и отправить решаете вы.",
        "Коды агент проверяет пачками по несколько сотен в запросе: поштучный опрос упёрся бы в ограничение по частоте, а так ответ собирается в один список, где сразу видно, каких кодов система не знает вовсе. Когда срок действия токена выходит, запросы возвращают ошибку авторизации, и агент прямо скажет об этом вместо молчаливых повторов. Видит он ровно те товарные группы, что открыты вашей организации, а при отсутствии данных говорит об этом, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Организация, зарегистрированная в системе маркировки ГИС МТ.",
        "УКЭП руководителя или сотрудника с доверенностью.",
        "Готовность обновлять токен: он живёт до 10 часов."
      ],
      "faq": [
        {
          "q": "Как подключить Честный ЗНАК?",
          "a": "Токеном True API. Кнопка «Сгенерировать токен» в профиле ГИС МТ для этого не подходит: она выдаёт ключ для проверок на кассе (ККТ). Токен True API выпускает сам True API по подписи УКЭП: так его получают 1С и учётные системы с поддержкой маркировки через КриптоПро. Вставьте полученную строку в форму подключения."
        },
        {
          "q": "Как часто нужно обновлять токен?",
          "a": "Токен живёт до 10 часов, после чего запросы возвращают ошибку авторизации. Выпустите новый токен подписью УКЭП и обновите его в подключении. Агент прямо скажет, что срок истёк, а не будет молча повторять запросы."
        },
        {
          "q": "Что агент видит в Честном ЗНАКе?",
          "a": "Коды маркировки и их статусы, документы оборота, карточки товаров и национальный каталог, балансы и складские остатки, чеки ККТ по тем товарным группам, которые добавлены в профиле участника."
        },
        {
          "q": "Может ли агент подавать документы в оборот?",
          "a": "Подача документов требует усиленной квалифицированной подписи, которую формирует ваш носитель, а не агент. Агент работает на чтение и проверку: собирает данные, находит ошибки и готовит списки под подписание."
        }
      ]
    },
    "seo_en": {
      "title": "Chestny ZNAK and an AI agent: batch marking code checks",
      "description": "Runs a delivery's codes through the GIS MT True API: 14 of 480 are not in circulation, so the receipt can't close. You sign with your qualified e-signature.",
      "headline": "Check marking codes in batches without opening GIS MT",
      "scenarios": [
        {
          "title": "Batch check of marking codes",
          "desc": "The agent runs a list of codes through True API and tells you which are in circulation, which have been retired and which have not entered circulation yet."
        },
        {
          "title": "Stalled turnover documents",
          "desc": "The agent collects shipment and acceptance documents for a period and shows which ones the marking system has not processed or has rejected with an error."
        },
        {
          "title": "Stock of marked goods",
          "desc": "The agent reconciles code balances and warehouse stock by product group and shows where the numbers diverge from your own records."
        },
        {
          "title": "Product cards in the national catalogue",
          "desc": "The agent checks cards by GTIN and finds the unpublished ones and those missing mandatory attributes for their product group."
        },
        {
          "title": "Retired at the till",
          "desc": "The agent matches codes against cash register receipts and shows what has already been retired at the till and what is still in circulation, allowing for the reporting lag."
        },
        {
          "title": "A list ready for signing",
          "desc": "The agent gathers stalled and rejected documents into a single list ready for signing, so all that is left is to sign it with your token instead of hunting through the account."
        }
      ],
      "how_it_works": [
        "The agent calls the GIS MT True API at markirovka.crpt.ru: it runs marking codes through in batches and reads their statuses, pulls the list of turnover documents, looks up product cards by GTIN in the national catalogue and reconciles balances against warehouse stock by product group. From that it works out which codes are in circulation, which have been retired and which have not entered circulation yet, and where your own stock records diverge from the marking system.",
        "Accepting a document and processing it are two different events in GIS MT: the system takes a shipment or an acceptance immediately, the outcome shows up later, and some documents settle as unprocessed or rejected with an error. The agent keeps those states apart and reports not the fact of submission but the actual fate of the document. It treats code statuses with the same caution: retirement is recorded through cash register receipts and does not reach the system instantly.",
        "The agent barely writes anything here, and that is a property of the system itself: submitting documents into circulation is confirmed with a qualified electronic signature created by your own token, not by the agent. So it gathers data, finds discrepancies and prepares lists ready for signing (checked codes, stalled and rejected documents, cards missing mandatory attributes for their product group), and signing and sending stays your decision.",
        "Codes are checked in batches of several hundred per request: asking one by one would run straight into the rate limit, while a batch comes back as a single list that shows at once which codes the system does not know at all. Once the token's lifetime runs out, requests return an authorisation error and the agent says so outright instead of retrying in silence. It sees exactly the product groups open to your organisation, and when data is missing it says so rather than showing an empty table."
      ],
      "requirements": [
        "An organisation registered in the GIS MT marking system.",
        "A qualified e-signature of the CEO or an authorised employee.",
        "Readiness to refresh the token: it lives up to 10 hours."
      ],
      "faq": [
        {
          "q": "How do I connect Chestny ZNAK?",
          "a": "With a True API token. The Generate token button in your GIS MT profile will not do: it issues a key for checks at the cash register (KKT). A True API token is issued by True API itself against your qualified electronic signature, which is how 1C and other accounting systems with marking support get it through CryptoPro. Paste the resulting string into the connection form."
        },
        {
          "q": "How often does the token need refreshing?",
          "a": "A token lives up to 10 hours, after which requests come back with an authorisation error. Issue a new one with your qualified electronic signature and update it in the connection. The agent will tell you outright that it expired instead of silently retrying."
        },
        {
          "q": "What can the agent see in Chestny ZNAK?",
          "a": "Marking codes and their statuses, turnover documents, product cards and the national catalogue, balances and warehouse stock, and cash register receipts, for the product groups added in your participant profile."
        },
        {
          "q": "Can the agent submit documents into circulation?",
          "a": "Submitting documents requires a qualified electronic signature, which your own token creates, not the agent. The agent reads and verifies: it gathers data, finds errors and prepares lists ready for signing."
        }
      ]
    }
  },
  {
    "key": "dadata",
    "name": "DaData",
    "name_en": "DaData",
    "description": "Поиск компаний по ИНН/ОГРН, стандартизация адресов, банковские реквизиты, аффилированные компании",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "dadata",
    "description_en": "Company lookup by INN/OGRN, address cleansing, bank details and affiliated companies",
    "search_terms": [
      "дадата"
    ],
    "guide": {
      "url": "https://dadata.ru/profile/#info",
      "steps": [
        {
          "title": "Зарегистрируйтесь на dadata.ru",
          "desc": "Ключи выдаются только после перехода по ссылке из письма: до подтверждения почты профиль пуст. Регистрация бесплатная, подсказки работают сразу после неё.",
          "title_en": "Register at dadata.ru",
          "desc_en": "The keys appear only after you follow the link from the confirmation email. Registration is free and suggestions work right away."
        },
        {
          "title": "Откройте профиль dadata.ru/profile/#info",
          "desc": "API-ключ генерируется автоматически и лежит на этой странице. Скопируйте его целиком: он открывает поиск по ИНН и ОГРН.",
          "title_en": "Open your profile at dadata.ru/profile/#info",
          "desc_en": "The API key is generated automatically and sits on that page. Copy it in full: it unlocks lookups by tax ID and company registration number."
        },
        {
          "title": "Скопируйте секретный ключ рядом",
          "desc": "Секретный ключ генерируется вместе с API-ключом и лежит рядом, заберите оба. Он нужен «Стандартизации» адресов и реквизитов, она стоит 20 коп. за адрес.",
          "title_en": "Copy the secret key next to it",
          "desc_en": "The secret key sits next to the API key, so take both. It is required by «Стандартизация» of addresses and bank details, 20 kopecks each."
        }
      ]
    },
    "seo": {
      "title": "Интеграция DaData с ИИ-агентом: проверка ИНН перед оплатой",
      "description": "Пробьёт ИНН перед оплатой счёта: статус в реестре, директор, адрес и компании с тем же учредителем. По списку ИНН покажет, кто ликвидирован или сменил адрес.",
      "headline": "Проверяйте контрагентов по ИНН не выходя из чата",
      "scenarios": [
        {
          "title": "Проверка контрагента по ИНН",
          "desc": "Агент найдёт компанию по ИНН или ОГРН и покажет адрес, руководителя, коды ОКВЭД, статус в реестре и дату регистрации."
        },
        {
          "title": "Чистка базы адресов и реквизитов",
          "desc": "Агент разберёт адреса по частям вплоть до квартиры, подтянет банк по БИК и приведёт телефоны и ФИО к единому формату."
        },
        {
          "title": "Поиск аффилированных компаний",
          "desc": "Агент соберёт компании, связанные с контрагентом через учредителей и руководителей, и покажет, кто ещё стоит за той же группой лиц."
        },
        {
          "title": "Регулярная проверка портфеля",
          "desc": "Агент по расписанию пройдёт по списку ИНН и сообщит, кто ликвидирован, сменил адрес или руководителя с прошлой проверки."
        },
        {
          "title": "Кто стоит за почтой",
          "desc": "Агент найдёт компанию по корпоративной почте или домену из письма и покажет, с кем вы на самом деле переписываетесь, с ИНН и адресом."
        },
        {
          "title": "Расшифровка ОКВЭД и ОКТМО",
          "desc": "Агент поднимет справочники ОКВЭД и ОКТМО и объяснит словами, чем по документам занимается контрагент и к какому муниципалитету он приписан."
        }
      ],
      "how_it_works": [
        "Агент обращается к двум сервисам DaData сразу. Через подсказки он ищет компании по ИНН, ОГРН, БИК и корпоративной почте, собирает аффилированные компании по учредителям и руководителям, поднимает справочники ОКВЭД и ОКТМО, определяет адрес по координатам и город по IP. Через стандартизацию он разбирает адреса по частям вплоть до квартиры и приводит телефоны и ФИО к единому формату.",
        "Устроены эти два сервиса по-разному, и агент это учитывает. Подсказки отвечают списком кандидатов по неточной строке: на «ООО Ромашка» их придёт несколько, и брать первый попавшийся нельзя. Поэтому на проверке контрагента агент опирается на точный ИНН или ОГРН, а совпадение по названию помечает как гипотезу. Стандартизация же живёт на отдельном хосте и отвечает не списком кандидатов, а одним разобранным объектом: строка либо разложена по полям, либо помечена как неразобранная.",
        "Менять в DaData нечего: сервис справочный, агент отправляет строку и получает разобранный ответ, ничего не создавая и не редактируя. Записывать он может только в вашу сторону: вести список проверенных ИНН и при регулярном прогоне сообщать, кто ликвидирован, сменил адрес или руководителя с прошлой проверки. Статус в реестре агент подаёт как запись реестра, а не как доказательство, что компания реально работает.",
        "Расход считается по лимитам плана: бесплатных подсказок 10 000 запросов в сутки, стандартизация оплачивается отдельно, около 20 копеек за адрес, поэтому массовую чистку агент оценивает по объёму заранее и гонит её партиями, а не одним списком целиком. Когда лимит исчерпан или компания в реестре не найдена, он говорит об этом прямо, а не отдаёт пустую строку."
      ],
      "requirements": [
        "Бесплатный лимит подсказок: 10 000 запросов в сутки",
        "Оплаченная «Стандартизация», если нужны чистые адреса и реквизиты"
      ],
      "faq": [
        {
          "q": "Как подключить DaData?",
          "a": "Двумя ключами из профиля: зарегистрируйтесь на dadata.ru, подтвердите почту и на странице dadata.ru/profile/#info скопируйте API-ключ и секретный ключ. Оба поля обязательны: секретный нужен стандартизации адресов и реквизитов."
        },
        {
          "q": "Что агент умеет запрашивать?",
          "a": "Поиск и подсказки по ИНН, ОГРН, БИК и корпоративной почте, аффилированные компании, стандартизацию адресов, телефонов и ФИО, справочники ОКВЭД и ОКТМО, адрес по координатам и город по IP."
        },
        {
          "q": "Меняет ли агент что-то в DaData?",
          "a": "Нет. Сервис отвечает справочными данными: агент отправляет строку на поиск или стандартизацию и получает разобранный ответ, ничего в DaData не создавая и не редактируя."
        },
        {
          "q": "Какие есть лимиты?",
          "a": "Бесплатный доступ к подсказкам ограничен 10 000 запросов в сутки, а стандартизация оплачивается отдельно, около 20 копеек за адрес. Когда лимит исчерпан, агент скажет об этом прямо в чате."
        }
      ]
    },
    "seo_en": {
      "title": "DaData AI agent: check an INN before you pay an invoice",
      "description": "Checks an INN before you pay: registry status, director, address and companies sharing a founder. Run a list of INNs to see who was liquidated or moved.",
      "headline": "Vet counterparties by INN without leaving the chat",
      "scenarios": [
        {
          "title": "Vetting a counterparty by INN",
          "desc": "The agent finds the company by INN or OGRN and shows its address, director, OKVED codes, registry status and registration date."
        },
        {
          "title": "Cleaning up addresses and bank details",
          "desc": "The agent parses addresses down to the apartment, pulls the bank by BIC and brings phone numbers and personal names to a single format."
        },
        {
          "title": "Finding affiliated companies",
          "desc": "The agent collects the companies tied to a counterparty through founders and directors and shows who else stands behind the same group of people."
        },
        {
          "title": "Regular portfolio screening",
          "desc": "The agent runs through your list of INNs on a schedule and reports who has been liquidated, changed address or changed director since the last check."
        },
        {
          "title": "Who is behind an email",
          "desc": "The agent looks a company up by its corporate email or the domain from a letter and shows who you are really writing to, INN and address included."
        },
        {
          "title": "OKVED and OKTMO decoded",
          "desc": "The agent pulls the OKVED and OKTMO reference books and explains in plain words what the counterparty does on paper and which municipality it belongs to."
        }
      ],
      "how_it_works": [
        "The agent calls two DaData services at once. Through suggestions it looks companies up by INN, OGRN, BIC and corporate email, collects affiliated companies through founders and directors, pulls the OKVED and OKTMO reference books, resolves an address by coordinates and a city by IP. Through standardisation it parses addresses down to the apartment and brings phone numbers and personal names to a single format.",
        "These two services are built differently, and the agent accounts for that. Suggestions answer a fuzzy string with a list of candidates: a query like OOO Romashka returns several, and taking the first one is not an option. So when vetting a counterparty the agent relies on an exact INN or OGRN, and flags a name match as a hypothesis. Standardisation, meanwhile, lives on a separate host and answers not with a list of candidates but with one parsed object: a string is either split into fields or marked as unparsed.",
        "There is nothing to change in DaData: the service is a reference source, the agent sends a string and gets a parsed response back, creating and editing nothing. It writes only on your side: keeping the list of screened INNs and, on a regular run, reporting who has been liquidated, changed address or changed director since the last check. A registry status is presented as a registry record, not as proof that the company actually operates.",
        "Usage is counted against the plan limits: 10,000 suggestion requests a day for free, while standardisation is billed separately at roughly 20 kopecks per address, so the agent sizes a bulk clean-up by volume up front and runs it in batches rather than firing the whole list at once. When the limit runs out or a company is not found in the registry, it says so directly instead of returning an empty line."
      ],
      "requirements": [
        "The free suggestions limit is 10,000 requests a day",
        "Paid Standardisation if you need clean addresses and bank details"
      ],
      "faq": [
        {
          "q": "How do I connect DaData?",
          "a": "With two keys from your profile: sign up at dadata.ru, confirm your email and copy the API key and the secret key from dadata.ru/profile/#info. Both fields are required: the secret one is what address and bank detail standardisation needs."
        },
        {
          "q": "What can the agent look up?",
          "a": "Search and suggestions by INN, OGRN, BIC and corporate email, affiliated companies, standardisation of addresses, phone numbers and personal names, OKVED and OKTMO reference books, an address by coordinates and a city by IP."
        },
        {
          "q": "Does the agent change anything in DaData?",
          "a": "No. The service answers with reference data: the agent sends a string for lookup or standardisation and gets a parsed response back, creating and editing nothing in DaData."
        },
        {
          "q": "What are the limits?",
          "a": "Free access to suggestions is capped at 10,000 requests a day, and standardisation is billed separately at roughly 20 kopecks per address. Once the limit runs out, the agent says so right in the chat."
        }
      ]
    }
  },
  {
    "key": "diadoc",
    "name": "Контур.Диадок",
    "name_en": "Kontur.Diadoc",
    "description": "ЭДО: отправка, получение и подписание документов",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "diadoc",
    "short_name": "Диадок",
    "short_name_en": "Diadoc",
    "description_en": "Send, receive and sign electronic documents",
    "guide": {
      "url": "https://diadoc.kontur.ru",
      "steps": [
        {
          "title": "Оставьте заявку на diadoc.ru/integrations/api",
          "desc": "По заявке менеджер Контура откроет вам Кабинет интегратора на integrations.kontur.ru: ключи API не самообслуживаемые.",
          "title_en": "Submit the form at diadoc.ru/integrations/api",
          "desc_en": "On request a Kontur manager opens the Integrator Portal at integrations.kontur.ru for you; API keys are not self-service."
        },
        {
          "title": "Возьмите client_id и client_secret",
          "desc": "Оба значения лежат в Кабинете интегратора, client_secret это ключ API вашего приложения. Сам API Диадока пару не принимает: она нужна для выпуска токенов.",
          "title_en": "Take the client_id and client_secret",
          "desc_en": "Both are in the Integrator Portal; the client_secret is your app's API key. The Diadoc API itself does not accept the pair: it is used to issue tokens."
        },
        {
          "title": "Выпустите refresh_token в Кабинете",
          "desc": "Выберите clientMode «AuthorizationCode», отметьте scope openid, offline_access и Diadoc.PublicAPI и нажмите «Получить refresh-токен». Без offline_access его не выдадут.",
          "title_en": "Issue a refresh_token in the portal",
          "desc_en": "Choose the AuthorizationCode clientMode, tick the openid, offline_access and Diadoc.PublicAPI scopes and press “Get refresh token”. Without offline_access none is issued."
        },
        {
          "title": "Используйте этот refresh_token только здесь",
          "desc": "Подключение само меняет токен примерно раз в сутки, и прежний сразу перестаёт работать. Не вставляйте этот же токен в другую программу: там он умрёт после обмена.",
          "title_en": "Use this refresh_token here only",
          "desc_en": "The connection renews the token about once a day and the previous one stops working at once. Do not paste the same token into another program: it dies there."
        },
        {
          "title": "Скопируйте ID ящика из адресной строки",
          "desc": "Откройте «Входящие документы» и скопируйте из адресной строки 32 символа между https://diadoc.kontur.ru/ и /Folder/Inbox.",
          "title_en": "Copy the box ID from the address bar",
          "desc_en": "Open the Incoming documents section and copy the 32 characters between https://diadoc.kontur.ru/ and /Folder/Inbox in the address bar."
        }
      ]
    },
    "seo": {
      "title": "Диадок и ИИ: входящие, которые ждут ответа дольше суток",
      "description": "Агент соберёт входящие Диадока через API Контура: 23 за ночь, 6 ждут ответа дольше суток. Подписывает человек: КЭП на носителе, в облаке Диадока или в Госключе.",
      "headline": "ИИ для документооборота: документы Диадока, ждущие подписи",
      "scenarios": [
        {
          "title": "Документы, которые ждут подписи",
          "desc": "Агент покажет входящие документы без ответа и выделит те, что лежат дольше суток, с контрагентом, типом и датой поступления."
        },
        {
          "title": "Что зависло у контрагента",
          "desc": "Агент соберёт по контрагенту документы за период и назовёт те, где вторая сторона не подписала и не отклонила отправленное."
        },
        {
          "title": "Реестр ЭДО для сверки",
          "desc": "Агент сведёт входящие и исходящие документы по типам, датам и контрагентам и подготовит реестр под сверку с учётной системой."
        },
        {
          "title": "Утренняя сводка по документообороту",
          "desc": "Агент по расписанию пришлёт, сколько документов пришло за ночь и что требует подписи сегодня, чтобы ничего не повисло."
        },
        {
          "title": "Пакет к отправке",
          "desc": "Агент подготовит черновик и соберёт пакет к отправке: проверит комплектность, вложения и реквизиты контрагента, а затем остановится там, где нужна ваша подпись."
        },
        {
          "title": "Отказы и аннулирования",
          "desc": "Агент дочитает ленту событий ящика и соберёт документы, которые контрагент отклонил или просит аннулировать, с причиной и датой; по вашему решению он сформирует предложение об аннулировании или отказ в подписи и отправит их после подписания."
        }
      ],
      "how_it_works": [
        "Агент работает с публичным API Диадока по адресу diadoc-api.kontur.ru в границах одного ящика организации. Он читает входящие, исходящие и внутренние документы вместе с вложениями и статусами документооборота, контрагентов и ленту событий ящика. Из этого собираются реестры под сверку с учётной системой, списки документов без ответа и сводка по тому, что пришло за ночь и требует подписи сегодня.",
        "В ЭДО статус документа отражает состояние встречного движения, а не факт закрытой сделки. Отправленное может лежать неподписанным и неотклонённым неделями, а входящее ждать вашего ответа, ничем не напоминая о себе в интерфейсе. Поэтому агент смотрит не на сам факт отправки, а на возраст ожидания: выделяет документы, лежащие дольше суток, и называет контрагента, тип и дату поступления рядом с каждым.",
        "Подпись требует отдельного решения, и агент его не принимает за вас. Метод отправки подпись не создаёт: она приходит извне. Если КЭП лежит на носителе, её ставит человек, и агент доводит документ ровно до этой точки: готовит черновик, собирает пакет, проверяет комплектность и вложения. Если организация подключила облачную подпись Диадока или Госключ, агент может отправить документ на подписание и дождаться результата, но запускает это по вашей команде, а не сам. Принять двусторонний документ значит отправить свой титул получателя, и его агент тоже готовит целиком. Отклонение и аннулирование он выносит на ваше решение со всей фактурой и отправляет уже подписанное.",
        "Видит агент ровно то, что разрешает выданный Контуром доступ, и границу эту обойти не пытается. Ящик не переключается на лету, поэтому на одну организацию нужно одно подключение, а список своих юрлиц и их ящиков агент показывает из ответа GetMyOrganizations. Новое он забирает по ленте событий ящика, а не перебором дней, и помнит, до какого события дочитал, так что вторая сводка за утро не пересчитывает всё заново. Если документов за период нет, он скажет об этом прямо, а не покажет пустой реестр."
      ],
      "requirements": [
        "Организация уже работает в Диадоке, и у неё есть ящик",
        "Одно подключение на организацию: ящик задаётся при подключении",
        "Сертификат КЭП у того, кто подписывает: носитель, облако Диадока или Госключ"
      ],
      "faq": [
        {
          "q": "Как подключить Контур.Диадок?",
          "a": "Четырьмя значениями из Кабинета интегратора и Диадока: client_id, client_secret, refresh-токеном со scope offline_access и Diadoc.PublicAPI и идентификатором ящика, это 32 символа из адресной строки раздела «Входящие документы». Кабинет интегратора открывает менеджер Контура по заявке. Токен доступа живёт около суток, и подключение само обменивает refresh-токен на новый, так что вводить его заново не нужно."
        },
        {
          "q": "Что агент видит в Диадоке?",
          "a": "Входящие, исходящие и внутренние документы подключённого ящика, их вложения и статусы документооборота, контрагентов и ленту событий в пределах прав, выданных приложению в Кабинете интегратора."
        },
        {
          "q": "Может ли агент подписать документ за меня?",
          "a": "Сам по себе метод отправки подпись не создаёт: она приходит готовой. Если КЭП на носителе, подписывает человек, а агент готовит черновик и пакет к отправке. Если у организации подключена облачная подпись Диадока или Госключ, агент может отправить файлы на подписание и дождаться результата, но делает это по вашей команде."
        },
        {
          "q": "Что делать, если организаций несколько?",
          "a": "Ящик задаётся при подключении, поэтому на одну организацию нужно одно подключение. Список своих юридических лиц и идентификаторов их ящиков агент покажет из ответа метода GetMyOrganizations."
        }
      ]
    },
    "seo_en": {
      "title": "Diadoc API and an AI agent: inbound awaiting a reply",
      "description": "Collects the night's Diadoc inbound: 23 documents, 6 of them waiting over a day. The agent prepares the draft and stops at the signature a person applies.",
      "headline": "Catch the Diadoc documents that are waiting for your signature",
      "scenarios": [
        {
          "title": "Documents awaiting a signature",
          "desc": "The agent shows inbound documents with no response yet and singles out the ones sitting for more than a day, with counterparty, type and arrival date."
        },
        {
          "title": "What has stalled on the other side",
          "desc": "The agent gathers the documents for a counterparty over a period and names the ones the other party has neither signed nor rejected."
        },
        {
          "title": "An EDI register for reconciliation",
          "desc": "The agent consolidates inbound and outbound documents by type, date and counterparty and prepares a register ready to reconcile against your accounting system."
        },
        {
          "title": "Morning document flow digest",
          "desc": "The agent sends you on schedule how many documents arrived overnight and what needs signing today, so nothing is left hanging."
        },
        {
          "title": "A package ready to send",
          "desc": "The agent prepares the draft and assembles the package for sending (checking completeness, attachments and counterparty details) and stops where your signature is needed."
        },
        {
          "title": "Rejections and annulments",
          "desc": "The agent reads the box event feed and collects the documents a counterparty has rejected or asked to annul, with the reason and the date; on your decision it drafts the annulment proposal or the signature refusal and sends it once signed."
        }
      ],
      "how_it_works": [
        "The agent works with the Diadoc public API at diadoc-api.kontur.ru within the boundaries of a single organisation box. It reads inbound, outbound and internal documents together with their attachments and document flow statuses, the counterparties and the event feed of the box. Out of that come registers for reconciliation against your accounting system, lists of documents with no response and a digest of what arrived overnight and needs signing today.",
        "In EDI a document status is the state of a two-sided movement, not the fact of a closed deal. Something you sent can sit unsigned and unrejected for weeks, and an inbound document can wait for your answer without reminding you of itself anywhere in the interface. So the agent looks not at the fact of sending but at the age of the wait: it singles out documents sitting for more than a day and names the counterparty, type and arrival date beside each one.",
        "Signing is a decision of its own, and the agent does not make it for you. The sending method never creates a signature: it arrives from outside. When the qualified certificate sits on a token, a person signs, and the agent takes the document exactly up to that point: drafting it, assembling the package, checking completeness and attachments. When the organisation has Diadoc's cloud signature or Gosklyuch enabled, the agent can send files off to be signed and wait for the result, but it starts that on your command, not on its own. Accepting a two-sided document means sending your recipient title, and the agent prepares that in full too. Rejection and annulment are put to you with the whole picture and sent once signed.",
        "The agent sees exactly what the access Kontur issued permits and does not try to reach past that boundary. The box cannot be switched on the fly, so one organisation means one connection, and the agent lists your legal entities and their boxes from the GetMyOrganizations response. New material it takes from the event feed of the box rather than by walking day after day, and it remembers the last event it read, so a second digest in one morning does not recount everything. If there are no documents for the period, it says so directly instead of showing an empty register."
      ],
      "requirements": [
        "The organisation already works in Diadoc and has a box",
        "One connection per organisation: the box is fixed when you connect",
        "A qualified certificate for the signer: a token, Diadoc's cloud or Gosklyuch"
      ],
      "faq": [
        {
          "q": "How do I connect Kontur.Diadoc?",
          "a": "With four values from the Integrator Portal and Diadoc: the client_id, the client_secret, a refresh token with the offline_access and Diadoc.PublicAPI scopes, and the box identifier, which is the 32 characters from the address bar of the Inbound documents section. A Kontur manager opens the Integrator Portal on request. The access token lives about a day, and the connection exchanges the refresh token for a new one by itself, so you never re-enter it."
        },
        {
          "q": "What can the agent see in Diadoc?",
          "a": "Inbound, outbound and internal documents of the connected box, their attachments and document flow statuses, counterparties and the event feed, within the rights granted to the application in the Integrator Portal."
        },
        {
          "q": "Can the agent sign a document for me?",
          "a": "The sending method itself never creates a signature: it arrives ready-made. With a certificate on a token, a person signs and the agent prepares the draft and the package. With Diadoc's cloud signature or Gosklyuch enabled, the agent can send the files off to be signed and wait for the result, but only on your command."
        },
        {
          "q": "What if there are several organisations?",
          "a": "The box is fixed at connection time, so one organisation means one connection. The agent will list your legal entities and their box identifiers from the GetMyOrganizations response."
        }
      ]
    }
  },
  {
    "key": "ethernet_ip",
    "name": "EtherNet/IP",
    "name_en": "EtherNet/IP",
    "description": "Теги ПЛК Rockwell Logix, Micro800, Omron NJ/NX, PLC-5/SLC через сервер сбора, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ethernet-ip",
    "description_en": "Read-only Rockwell Logix, Micro800, Omron NJ/NX and PLC-5/SLC tags via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Узнайте тип контроллера",
          "desc": "controllogix подходит и для CompactLogix; ещё micro800, omron-njnx, plc5, slc500, micrologix. Программа сбора сверяет тип с ответом устройства и называет, кто ответил.",
          "title_en": "Find out the controller kind",
          "desc_en": "controllogix also covers CompactLogix; the others are micro800, omron-njnx, plc5, slc500 and micrologix. The program checks the kind against the device's answer."
        },
        {
          "title": "Запишите маршрут к ЦП",
          "desc": "Порт и слот ЦП через запятую: 1,0 это объединительная плата, слот 0. ControlLogix обычно доступен через Ethernet-модуль в шасси. У Micro800 маршрута нет.",
          "title_en": "Write down the route to the CPU",
          "desc_en": "CPU port and slot, comma separated: 1,0 is the backplane, slot 0. A ControlLogix is usually reached through an Ethernet module in its chassis. Micro800 has no route."
        },
        {
          "title": "Пропустите порт 44818 до сервера сбора",
          "desc": "EtherNet/IP работает по TCP на порту 44818. Сеть между сервером сбора и контроллером или его Ethernet-модулем должна пропускать это соединение.",
          "title_en": "Open port 44818 to the collection server",
          "desc_en": "EtherNet/IP runs over TCP port 44818. The network between the collection server and the controller or its Ethernet module has to let this connection through."
        },
        {
          "title": "Для Omron и PCCC выпишите теги",
          "desc": "Omron NJ/NX, PLC-5, SLC 500 и MicroLogix список тегов не отдают. По строке на тег: путь, имя или адрес таблицы данных (N7:0) и тип.",
          "title_en": "List the tags for Omron and PCCC",
          "desc_en": "Omron NJ/NX, PLC-5, SLC 500 and MicroLogix do not list their tags. One line per tag: a path, the name or data table address (N7:0) and a type."
        }
      ]
    },
    "seo": {
      "title": "Интеграция EtherNet/IP с ИИ: простои линии Logix",
      "description": "Остановки линии за неделю и их длительность по тегу статуса Rockwell Logix, Micro800 или Omron NJ/NX. Теги читает программа сбора на объекте, без записи в ПЛК.",
      "headline": "Теги контроллеров Logix и Omron по EtherNet/IP прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас в контроллере",
          "desc": "Агент найдёт теги контроллера и его программ по имени, например Tank или Program:Main, и покажет текущие значения со временем отсчёта."
        },
        {
          "title": "Сводка по массиву",
          "desc": "Агент возьмёт историю элементов массива, например счётчиков Counts[0]…Counts[9], и покажет по часам минимум, максимум, среднее и последнее значение."
        },
        {
          "title": "Простои за неделю",
          "desc": "Агент заберёт сырые отсчёты статуса работы за неделю и посчитает число остановок, их длительность и общее время простоя."
        },
        {
          "title": "Задача на выход за порог",
          "desc": "Агент заведёт задачу, которая запустится, когда значение тега выйдет за порог и продержится заданное время, а не на каждый отсчёт за порогом."
        },
        {
          "title": "Теги, которые не читаются",
          "desc": "Агент назовёт теги с отказом контроллера и причиной: тега нет, тип в карте не совпал, индекс за концом массива, чтение запрещено."
        },
        {
          "title": "Пропуски в данных",
          "desc": "Агент покажет промежутки истории без отсчётов и скажет, на связи ли сейчас сервер сбора объекта."
        }
      ],
      "how_it_works": [
        "Данные читает программа сбора данных: она работает службой на сервере в сети объекта и ходит к контроллеру по EtherNet/IP, TCP порт 44818. В подключении указываются адрес контроллера или его Ethernet-модуля, тип контроллера и маршрут к ЦП, например 1,0. Наружу программа отправляет данные только исходящим соединением.",
        "ControlLogix, CompactLogix и Micro800 отдают список своих символов, поэтому карту тегов можно не писать: программа сбора читает теги контроллера и его программ, разбирает шаблоны структур и читает каждое значение до элементарных типов, по умолчанию не больше 10 000 тегов. Соседние элементы одного массива читаются одним запросом, до 120 элементов по умолчанию. Перед опросом программа спрашивает у устройства, кто оно, и при несовпадении типа называет, кто ответил.",
        "Протокол ведёт встроенная в программу сбора библиотека libplctag, и из неё объявлены только функции чтения: записи в контроллер у драйвера нет. Тег, который контроллер не знает или читать не даёт, помечается плохим со своим кодом и запрашивается заново на следующем опросе, остальные читаются дальше. Обрыв сессии завершает круг опроса, и следующий подключается заново.",
        "Omron NJ/NX, PLC-5, SLC 500 и MicroLogix список тегов не отдают, поэтому для них карта тегов обязательна: имя переменной или адрес таблицы данных, например N7:0, и тип. Программа сбора отправляет изменения значений и раз в 1800 секунд повторяет тег, который не менялся. Если связь с облаком рвётся, данные копятся на диске сервера сбора и приходят после восстановления."
      ],
      "requirements": [
        "Контроллер ControlLogix, CompactLogix, Micro800, Omron NJ/NX или PLC-5/SLC",
        "Порт 44818 открыт между контроллером и сервером сбора",
        "Маршрут к ЦП (порт и слот) за Ethernet-модулем",
        "Для Omron NJ/NX, PLC-5, SLC 500 и MicroLogix: список тегов с типами",
        "Сервер сбора в сети объекта: Windows или Linux с Docker"
      ],
      "faq": [
        {
          "q": "Как подключить EtherNet/IP?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите EtherNet/IP и укажите адрес, например tcp://10.0.12.5:44818, тип контроллера и маршрут к ЦП; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Для Logix и Micro800 карту тегов можно оставить пустой, для остальных перечислите теги."
        },
        {
          "q": "Что агент видит в EtherNet/IP?",
          "a": "У Logix и Micro800 все пользовательские теги контроллера и программ, включая члены структур и элементы массивов; служебные теги модулей ввода-вывода не входят. У Omron NJ/NX и PCCC теги из карты. Для каждого тега агент читает текущее значение, историю интервалами и сырые отсчёты."
        },
        {
          "q": "Меняет ли агент значения в ПЛК?",
          "a": "Нет. Из библиотеки протокола в программу сбора подключены только функции чтения, функции записи в нём не объявлены. Агент ничего не пишет в контроллер."
        },
        {
          "q": "Теги не читаются, а контроллер на связи. Что проверить?",
          "a": "Сначала тип контроллера: Micro800, выбранный как controllogix, отвечает отказами и таймаутами, и программа сбора называет, кто ответил на самом деле. Затем маршрут к ЦП: у ControlLogix это порт и слот за Ethernet-модулем, у Micro800 поле пустое. Отказ отдельного тега с кодом значит, что имя или тип в карте не совпали с контроллером."
        }
      ]
    },
    "seo_en": {
      "title": "EtherNet/IP integration: Logix line downtime by week",
      "description": "A week of line stops and how long each lasted, from the run status tag of Rockwell Logix, Micro800 or Omron NJ/NX. An on-site program reads the tags, read-only.",
      "headline": "Logix and Omron controller tags over EtherNet/IP right in the chat",
      "scenarios": [
        {
          "title": "What is in the controller now",
          "desc": "The agent finds controller and program tags by name, such as Tank or Program:Main, and shows current values with their timestamp."
        },
        {
          "title": "Array summary",
          "desc": "The agent takes the history of array elements, such as counters Counts[0]…Counts[9], and shows the minimum, maximum, average and last value per hour."
        },
        {
          "title": "Downtime for the week",
          "desc": "The agent takes a week of raw samples of a running status and counts the stops, their length and the total downtime."
        },
        {
          "title": "A task on a threshold",
          "desc": "The agent sets up a task that fires when a tag goes past a threshold and stays there for a set time, not on every sample past it."
        },
        {
          "title": "Tags that do not read",
          "desc": "The agent names tags the controller refused and why: no such tag, the type in the map does not match, an index past the end of an array, reading not allowed."
        },
        {
          "title": "Gaps in the data",
          "desc": "The agent shows history intervals without samples and says whether the site's collection server is online right now."
        }
      ],
      "how_it_works": [
        "Data is read by the data collection program: it runs as a service on a server on the site network and reaches the controller over EtherNet/IP, TCP port 44818. The connection takes the address of the controller or its Ethernet module, the controller kind and the route to the CPU, such as 1,0. The program sends data out over outbound connections only.",
        "ControlLogix, CompactLogix and Micro800 list their symbols, so a tag map is optional: the program reads the controller and program tags, parses structure templates and reads every value down to elementary types, at most 10,000 tags by default. Neighbouring elements of one array are read in one request, up to 120 elements by default. Before polling the program asks the device who it is and names it if the kind does not match.",
        "The protocol is handled by the libplctag library built into the collection program, and only its read functions are declared: the driver has no write to the controller. A tag the controller does not know or will not let the program read is marked bad with its code and asked again on the next scan while the others keep reading. A dropped session ends the polling round, and the next one connects anew.",
        "Omron NJ/NX, PLC-5, SLC 500 and MicroLogix do not list their tags, so a tag map is required for them: a variable name or a data table address, such as N7:0, and a type. The program sends value changes and repeats a tag that has not changed every 1800 seconds. If the link to the cloud drops, data piles up on the collection server's disk and arrives once it is back."
      ],
      "requirements": [
        "A ControlLogix, CompactLogix, Micro800, Omron NJ/NX or PLC-5/SLC controller",
        "Port 44818 open between the controller and the collection server",
        "A route to the CPU (port and slot) behind an Ethernet module",
        "For Omron NJ/NX, PLC-5, SLC 500 and MicroLogix: a tag list with types",
        "A collection server on the site network: Windows or Linux with Docker"
      ],
      "faq": [
        {
          "q": "How do I connect EtherNet/IP?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick EtherNet/IP and enter the address, such as tcp://10.0.12.5:44818, the controller kind and the route to the CPU; the collection server is assigned automatically, and if there are several, pick one in the form. For Logix and Micro800 the tag map can stay empty; for the others list the tags."
        },
        {
          "q": "What does the agent see in EtherNet/IP?",
          "a": "On Logix and Micro800, every user tag of the controller and its programs, including structure members and array elements; system tags of I/O modules are left out. On Omron NJ/NX and PCCC, the tags of the map. For each tag the agent reads the current value, the history in intervals and raw samples."
        },
        {
          "q": "Does the agent change values in the PLC?",
          "a": "No. Only the read functions of the protocol library are linked into the collection program; its write functions are not declared there. The agent writes nothing to the controller."
        },
        {
          "q": "Tags do not read while the controller is online. What should I check?",
          "a": "First the controller kind: a Micro800 set as controllogix answers with refusals and timeouts, and the program names who actually answered. Then the route to the CPU: port and slot behind the Ethernet module on a ControlLogix, empty on a Micro800. A single tag refused with a code means its name or type in the map does not match the controller."
        }
      ]
    }
  },
  {
    "key": "ezsocket",
    "name": "Mitsubishi CNC",
    "name_en": "Mitsubishi CNC",
    "description": "Стойки ЧПУ Mitsubishi M700 и M800 через EZSocket и сервер сбора на Windows, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ezsocket",
    "description_en": "Read-only Mitsubishi M700 and M800 CNC data through EZSocket and a Windows collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Установите EZSocket на сервер сбора",
          "desc": "Поставьте с дистрибутива Mitsubishi среду FCSB1224W100 на сервер сбора с Windows. Программа сбора эту 32-битную библиотеку не содержит.",
          "title_en": "Install EZSocket on the collection server",
          "desc_en": "Install the FCSB1224W100 runtime from Mitsubishi's media on the Windows collection server. The data collection program does not contain this 32-bit library."
        },
        {
          "title": "Программа сама вызовет 32-битного помощника",
          "desc": "64-битная программа не грузит 32-битную библиотеку, поэтому с программой сбора идёт её 32-битный помощник. Без него подключение назовёт путь, где его ждали.",
          "title_en": "The program calls its own 32-bit helper",
          "desc_en": "A 64-bit program cannot load a 32-bit library, so the collection program ships a 32-bit helper. If it is missing, the connection names the path it expected."
        },
        {
          "title": "Откройте стойке порт 683",
          "desc": "Библиотека EZSocket говорит со стойкой по TCP 683. Сервер сбора должен достучаться до стойки по этому адресу и порту.",
          "title_en": "Open port 683 to the control",
          "desc_en": "The EZSocket library talks to the control on TCP 683. The collection server must reach the control at that address and port."
        },
        {
          "title": "Обновите прошивку стойки",
          "desc": "Обновите прошивку по бюллетеням Mitsubishi 2024-007 и 2025-022 (CVE-2024-7316, CVE-2025-2399) и пустите к порту 683 только сервер сбора.",
          "title_en": "Update the control firmware",
          "desc_en": "Update the firmware per Mitsubishi advisories 2024-007 and 2025-022 (CVE-2024-7316, CVE-2025-2399) and let only the collection server reach port 683."
        },
        {
          "title": "Задайте свои теги, если нужно",
          "desc": "Без списка программа сбора читает состояние, программу, шпиндель, подачу, модель и оси. Параметр, переменную #100 или устройство ПЛК добавьте строкой путь, адрес, тип.",
          "title_en": "Add your own tags if needed",
          "desc_en": "With no list the program reads status, program, spindle, feed, model and axes. Add a parameter, variable (#100) or PLC device as a line: path, address, type."
        }
      ]
    },
    "seo": {
      "title": "Mitsubishi CNC и ИИ: стойки M700 и M800 через EZSocket",
      "description": "Сколько каждая стойка Mitsubishi работала за смену и стояла в стопе подачи, с авариями ЧПУ и ПЛК. Программа сбора читает её через библиотеку EZSocket.",
      "headline": "Состояние и аварии стоек Mitsubishi M700 и M800 прямо в чате",
      "scenarios": [
        {
          "title": "Что с машинами сейчас",
          "desc": "Агент покажет, исполняет ли стойка программу, стоит в стопе подачи или в сбросе, и признак аварийного останова. Для активных аварий он назовёт текст со стойки."
        },
        {
          "title": "Работа и простои за смену",
          "desc": "Агент возьмёт отсчёты состояния за период и посчитает, сколько времени стойка исполняла программу, стояла в стопе подачи или ждала."
        },
        {
          "title": "Программа и кадр",
          "desc": "Агент прочитает номер главной программы и подпрограммы, номер последовательности и кадра на каждой системе стойки."
        },
        {
          "title": "Шпиндель и подача",
          "desc": "Агент соберёт историю оборотов и нагрузки шпинделя и фактической подачи интервалами: минимум, максимум и среднее."
        },
        {
          "title": "Положения осей",
          "desc": "Агент покажет машинные и рабочие координаты каждой оси каждой системы, которую называет стойка."
        },
        {
          "title": "Параметры, переменные и ПЛК",
          "desc": "Агент прочитает заданные вами параметры, общие переменные и устройства ПЛК, например счётчик деталей или бит закрытой двери."
        }
      ],
      "how_it_works": [
        "Стойка Mitsubishi стоит в сети объекта, поэтому к ней ходит программа сбора данных: она работает службой на сервере сбора с Windows в той же сети и отправляет данные наружу только исходящим соединением. В подключении указывается адрес стойки, например tcp://10.0.12.5:683, серия M700 или M800 и вид машины. Пока связи наружу нет, программа копит данные на диске сервера сбора.",
        "Программа сбора не разговаривает с портом 683 сама: искажённый кадр по этому порту может остановить стойку (CVE-2024-7316). Он вызывает библиотеку EZSocket, которую вы ставите с дистрибутива Mitsubishi. Библиотека 32-битная, поэтому её загружает 32-битный помощник программы в отдельном процессе на каждый раунд, и её сбой или зависание обрывает только этот раунд.",
        "Из библиотеки объявлены только вызовы чтения: записи параметров, переменных и ПЛК, загрузки программ и команд управления в программе сбора нет. Режима работы, коррекций, времени цикла и счётчика деталей у библиотеки нет. Если наладчик подтвердил, где они на вашей машине, их читают тегом параметра, переменной или устройства ПЛК.",
        "Каждый опрос программа сбора читает список аварий стойки: аварии ЧПУ и ПЛК, коды останова и сообщения оператора. Аварии ЧПУ и ПЛК идут авариями, коды останова и сообщения оператора идут предупреждениями. В историю попадают переходы, замеченные при опросе."
      ],
      "requirements": [
        "Стойка Mitsubishi M700, M70, E70, M800, M80 или E80 с Ethernet, порт TCP 683",
        "Библиотека EZSocket (FCSB1224W100) с дистрибутива Mitsubishi",
        "Сервер сбора на Windows в сети объекта",
        "Прошивка стойки, обновлённая по бюллетеням Mitsubishi"
      ],
      "faq": [
        {
          "q": "Как подключить стойку Mitsubishi?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных для Windows одной командой из окна. Поставьте на тот же сервер среду EZSocket FCSB1224W100. Затем выберите Mitsubishi CNC и укажите адрес стойки, например tcp://10.0.12.5:683, серию и вид машины; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в стойке Mitsubishi?",
          "a": "Аварии со стойки идут с исходным текстом при любом списке тегов. Стандартный каталог содержит состояние, программу, шпиндель, подачу, модель и оси каждой системы. В свой список можно добавить параметры, общие переменные и устройства ПЛК."
        },
        {
          "q": "Отправляет ли агент команды машине?",
          "a": "Нет. Программа сбора объявляет из библиотеки EZSocket только вызовы чтения: записи параметров, переменных и ПЛК, загрузки программ и команд управления в нём нет."
        },
        {
          "q": "Подойдёт ли стойка C70 или C80?",
          "a": "Нет. У C70 и C80 нет интерфейса автоматизации EZSocket, поэтому в подключении есть только серии M700 и M800."
        }
      ]
    },
    "seo_en": {
      "title": "Mitsubishi CNC and AI: M700 and M800 controls over EZSocket",
      "description": "How long each Mitsubishi control ran a program or sat in feed hold over a shift, with NC and PLC alarms. The collection program reads it via the EZSocket library.",
      "headline": "Mitsubishi M700 and M800 control state and alarms right in the chat",
      "scenarios": [
        {
          "title": "How the machines are now",
          "desc": "The agent shows whether the control is running a program, sitting in feed hold or reset, and the emergency stop flag. It gives the controller text of active alarms."
        },
        {
          "title": "Running and downtime per shift",
          "desc": "The agent takes state observations for a period and works out how long the control ran a program, sat in feed hold or waited."
        },
        {
          "title": "Program and block",
          "desc": "The agent reads the main program and subprogram numbers and the sequence and block numbers on each part system of the control."
        },
        {
          "title": "Spindle and feed",
          "desc": "The agent collects the history of spindle speed and load and actual feed in intervals: minimum, maximum and average."
        },
        {
          "title": "Axis positions",
          "desc": "The agent shows the machine and work coordinates of every axis of every part system the control names."
        },
        {
          "title": "Parameters, variables and PLC",
          "desc": "The agent reads the parameters, common variables and PLC devices you list, such as a part counter or a door closed bit."
        }
      ],
      "how_it_works": [
        "A Mitsubishi control sits on the site's network, so the data collection program reaches it: it runs as a service on a Windows collection server on the same network and sends data out over an outgoing connection only. The connection takes the control address, for example tcp://10.0.12.5:683, the M700 or M800 series and the machine kind. While there is no link outside, the program keeps the data on the collection server's disk.",
        "The collection program does not talk to port 683 itself: a malformed frame on that port can stop the control (CVE-2024-7316). It calls the EZSocket library you install from Mitsubishi's media. The library is 32-bit, so the program's 32-bit helper loads it in a separate process for each round, and a crash or hang inside it ends only that round.",
        "Only read calls of the library are declared: the program has no parameter, variable or PLC writes, no program download and no control commands. The library has no reading for operation mode, overrides, cycle time or part count. Where the integrator has confirmed them on your machine, they are read as a parameter, variable or PLC device tag.",
        "On every scan the program reads the control's alarm list: NC and PLC alarms, stop codes and operator messages. NC and PLC alarms arrive as alarms, stop codes and operator messages as warnings. History records transitions observed during polling."
      ],
      "requirements": [
        "A Mitsubishi M700, M70, E70, M800, M80 or E80 control with Ethernet, TCP 683",
        "The EZSocket library (FCSB1224W100) from Mitsubishi's media",
        "A Windows collection server on the site's network",
        "Control firmware updated per Mitsubishi's security advisories"
      ],
      "faq": [
        {
          "q": "How do I connect a Mitsubishi control?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program for Windows with the one command from the window. Install the EZSocket FCSB1224W100 runtime on the same server. Then pick Mitsubishi CNC and enter the control address, for example tcp://10.0.12.5:683, the series and the machine kind; the collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in a Mitsubishi control?",
          "a": "The agent gets the control's own alarm text regardless of the tag list. The standard catalog includes status, program, spindle, feed, model and axes of every part system. A custom list can include parameters, common variables and PLC devices."
        },
        {
          "q": "Does the agent send commands to the machine?",
          "a": "No. The collection program declares only read calls of the EZSocket library: it has no parameter, variable or PLC writes, no program download and no control commands."
        },
        {
          "q": "Does a C70 or C80 control work?",
          "a": "No. C70 and C80 have no EZSocket automation interface, so the connection offers only the M700 and M800 series."
        }
      ]
    }
  },
  {
    "key": "fins",
    "name": "Omron FINS",
    "name_en": "Omron FINS",
    "description": "ПЛК Omron CS/CJ/CP и NJ/NX по адресам памяти через сервер сбора на объекте, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "fins",
    "description_en": "Read-only memory areas of Omron CS/CJ/CP and NJ/NX PLCs through an on-site collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "На NJ/NX задайте переменным AT",
          "desc": "Переменные NJ/NX по FINS недоступны. В Sysmac Studio разместите каждую в памяти CJ AT-спецификацией, например %W0.00, и читайте по этому адресу.",
          "title_en": "Give NJ/NX variables an AT address",
          "desc_en": "NJ/NX variables are not reachable over FINS. In Sysmac Studio place each one in CJ memory with an AT specification, such as %W0.00, and read that address."
        },
        {
          "title": "На NX включите FINS в Sysmac Studio",
          "desc": "Если FINS отмечен как не используемый или включён Packet Filter, ПЛК не отвечает вовсе, и программа сбора видит только таймаут. NX1P2 отвечает только по UDP.",
          "title_en": "Turn FINS on for NX in Sysmac Studio",
          "desc_en": "If FINS is set to do not use or a Packet Filter is on, the PLC does not answer at all and the collection program sees only a timeout. NX1P2 answers over UDP only."
        },
        {
          "title": "Для UDP запишите узлы FINS",
          "desc": "Узел ПЛК обязателен, узел сервера сбора обычно последний октет его адреса. Если ПЛК отвечает только на порт FINS (статическая таблица узлов), задайте локальный порт 9600.",
          "title_en": "For UDP write down the FINS nodes",
          "desc_en": "The PLC node is required; the collection server node is usually its address's last octet. If the PLC answers only its FINS port, set local port 9600."
        },
        {
          "title": "Разрешите адрес сервера сбора в защите IP",
          "desc": "Если в Ethernet-модуле включена защита по IP-адресу, добавьте адрес сервера сбора. Без этого рукопожатие FINS/TCP отклоняется с ошибкой 0x22.",
          "title_en": "Allow the collection server in IP protection",
          "desc_en": "If IP address protection is on in the Ethernet unit, add the collection server's address. Otherwise the FINS/TCP handshake is refused with error 0x22."
        },
        {
          "title": "Пропустите порт 9600 до сервера сбора",
          "desc": "FINS работает по TCP или UDP на порту 9600. Сеть между сервером сбора и ПЛК должна пропускать выбранный транспорт.",
          "title_en": "Open port 9600 to the collection server",
          "desc_en": "FINS runs over TCP or UDP on port 9600. The network between the collection server and the PLC has to let the chosen transport through."
        }
      ]
    },
    "seo": {
      "title": "Omron FINS и ИИ-агент: циклы и простои печи",
      "description": "Циклы печи за неделю, часы работы и простоя по биту CIO в ПЛК Omron CS/CJ/CP или NJ/NX. Области DM и CIO по FINS опрашивает программа сбора на объекте, без записи.",
      "headline": "Память ПЛК Omron по FINS прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по пути, например line1/oven, и покажет текущие значения из DM, CIO и рабочих областей со временем отсчёта и пометкой, свежие ли они."
        },
        {
          "title": "Сводка за смену",
          "desc": "Агент возьмёт историю температуры или давления за смену и по часам покажет минимум, максимум, среднее и последнее значение."
        },
        {
          "title": "Циклы и простои",
          "desc": "Агент заберёт сырые отсчёты бита работы, например CIO10.03, за неделю и посчитает число циклов, время работы и простоя."
        },
        {
          "title": "Задача на выход за порог",
          "desc": "Агент заведёт задачу, которая запустится, когда значение тега выйдет за порог и продержится заданное время, а не на каждый отсчёт за порогом."
        },
        {
          "title": "Теги, которые ПЛК не читает",
          "desc": "Агент назовёт теги с отказом ПЛК и кодом завершения FINS, например 1103 (адрес за концом области) или 1101 (нет такой области)."
        },
        {
          "title": "Пропуски в данных",
          "desc": "Агент покажет промежутки истории без отсчётов и скажет, на связи ли сейчас сервер сбора объекта."
        }
      ],
      "how_it_works": [
        "Данные читает программа сбора данных: она работает службой на сервере в сети объекта и ходит к ПЛК по FINS/TCP или FINS/UDP, порт 9600. В подключении указываются адрес ПЛК со схемой tcp:// или udp:// и карта тегов: по строке на тег путь, адрес CX-Programmer и тип, например D100 real или CIO10.03 bool. Наружу программа отправляет данные только исходящим соединением.",
        "По TCP узлы FINS программа сбора и ПЛК согласуют рукопожатием, по UDP их задают поля подключения. Теги одной области, стоящие не дальше 8 слов друг от друга, читаются одним запросом, до 253 слов: это ниже предела любого найденного ПЛК и ниже порога, после которого CP1L делит ответ на два кадра и ждёт 200 мс. Широкие значения Omron хранит младшим словом вперёд, а первый символ строки в старшем байте слова; для одной строки карты порядок можно переопределить.",
        "Драйвер только читает: из команд FINS он посылает одно чтение области памяти. Сам протокол режима только для чтения не имеет: порт FINS принимает запись в память и остановку ЦП от любого, кто до него достаёт, поэтому чтение через программу сбора не закрывает порт. Тег, чей диапазон ПЛК отказался читать, помечается плохим с кодом завершения, остальные читаются дальше.",
        "Текущий банк EM не читается: его смысл меняется вместе с программой, поэтому банк называется явно, например E0_100. Таймер и счётчик читаются двумя способами: флаг завершения как bool и текущее значение в кодировке, которую задаёт ПЛК. Если связь с облаком рвётся, данные копятся на диске сервера сбора и приходят после восстановления."
      ],
      "requirements": [
        "ПЛК Omron CS, CJ, CP, NJ или NX с Ethernet и включённым FINS",
        "Порт 9600 по TCP или UDP открыт между ПЛК и сервером сбора",
        "Для UDP: номера узлов FINS сервера сбора и ПЛК",
        "Для NJ/NX: переменные размещены в памяти CJ AT-спецификацией",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Адреса тегов из CX-Programmer или Sysmac Studio"
      ],
      "faq": [
        {
          "q": "Как подключить Omron FINS?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Omron FINS и укажите адрес ПЛК, например tcp://10.0.12.5:9600, и карту тегов: по строке путь, адрес CX-Programmer и тип. Для udp:// задайте ещё узлы FINS сервера сбора и ПЛК. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Omron FINS?",
          "a": "Теги из карты: области CIO, рабочая, удерживаемая, вспомогательная, DM, банки EM, таймеры и счётчики. Для каждого тега агент читает текущее значение со временем отсчёта, историю интервалами и сырые отсчёты."
        },
        {
          "q": "Меняет ли агент значения в ПЛК?",
          "a": "Нет. Из команд FINS драйвер посылает только чтение области памяти, записи и управления режимом ЦП в нём нет. Учтите, что сам порт FINS запись не запрещает: её не посылает только программа сбора."
        },
        {
          "q": "Выбрать TCP или UDP?",
          "a": "По TCP узлы назначаются рукопожатием, и узел сервера сбора можно не задавать. UDP нужен, когда ПЛК TCP не принимает, например NX1P2: тогда узел ПЛК и узел сервера сбора обязательны, а при статической таблице узлов ещё и локальный порт 9600. Если рукопожатие TCP отклонено, программа сбора называет код и что проверить: занятые соединения, повтор узла или защиту по IP."
        }
      ]
    },
    "seo_en": {
      "title": "Omron FINS and an AI agent: oven cycles and downtime",
      "description": "Oven cycles this week with run and idle hours from a CIO bit in an Omron CS/CJ/CP or NJ/NX PLC. An on-site collection program polls DM and CIO over FINS, read-only.",
      "headline": "Omron PLC memory over FINS right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by path, such as line1/oven, and shows current values from DM, CIO and work areas with their timestamp and whether they are fresh."
        },
        {
          "title": "Shift summary",
          "desc": "The agent takes the temperature or pressure history for a shift and shows the minimum, maximum, average and last value per hour."
        },
        {
          "title": "Cycles and downtime",
          "desc": "The agent takes a week of raw samples of a run bit, such as CIO10.03, and counts the cycles, running time and downtime."
        },
        {
          "title": "A task on a threshold",
          "desc": "The agent sets up a task that fires when a tag goes past a threshold and stays there for a set time, not on every sample past it."
        },
        {
          "title": "Tags the PLC refuses",
          "desc": "The agent names tags the PLC refused with the FINS end code, such as 1103 (address past the end of the area) or 1101 (no such area)."
        },
        {
          "title": "Gaps in the data",
          "desc": "The agent shows history intervals without samples and says whether the site's collection server is online right now."
        }
      ],
      "how_it_works": [
        "Data is read by the data collection program: it runs as a service on a server on the site network and reaches the PLC over FINS/TCP or FINS/UDP, port 9600. The connection takes the PLC address with a tcp:// or udp:// scheme and a tag map: one line per tag with a path, a CX-Programmer address and a type, such as D100 real or CIO10.03 bool. The program sends data out over outbound connections only.",
        "Over TCP the program and the PLC agree on FINS nodes with a handshake; over UDP the connection fields name them. Tags of one area standing at most 8 words apart are read in one request, up to 253 words: below the limit of every PLC found and below the point where a CP1L splits its answer into two frames and waits 200 ms. Omron keeps wide values low word first and a string's first character in a word's high byte; one line of the map can override the order.",
        "The driver only reads: of the FINS commands it sends one, the memory area read. The protocol itself has no read-only mode: the FINS port accepts memory writes and CPU stop from anyone who reaches it, so reading through the collection program does not close the port. A tag whose range the PLC refused is marked bad with the end code while the others keep reading.",
        "The current EM bank is not read: its meaning moves with the program, so the bank is named explicitly, such as E0_100. A timer or counter is read two ways: its completion flag as bool and its present value in the coding the PLC sets. If the link to the cloud drops, data piles up on the collection server's disk and arrives once it is back."
      ],
      "requirements": [
        "An Omron CS, CJ, CP, NJ or NX PLC with Ethernet and FINS on",
        "Port 9600 over TCP or UDP open between the PLC and the collection server",
        "For UDP: the FINS node numbers of the collection server and the PLC",
        "For NJ/NX: variables placed in CJ memory with an AT specification",
        "A collection server on the site network: Windows or Linux with Docker",
        "Tag addresses from CX-Programmer or Sysmac Studio"
      ],
      "faq": [
        {
          "q": "How do I connect Omron FINS?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick Omron FINS and enter the PLC address, such as tcp://10.0.12.5:9600, and a tag map: one line per tag with a path, a CX-Programmer address and a type. For udp:// also set the collection server and PLC FINS nodes. The collection server is assigned automatically; if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in Omron FINS?",
          "a": "The tags of the map: CIO, work, holding, auxiliary and DM areas, EM banks, timers and counters. For each tag the agent reads the current value with its timestamp, the history in intervals and raw samples."
        },
        {
          "q": "Does the agent change values in the PLC?",
          "a": "No. Of the FINS commands the driver sends only the memory area read; it has no write and no CPU mode control. Keep in mind that the FINS port itself does not forbid writes: only the collection program does not send them."
        },
        {
          "q": "Should I choose TCP or UDP?",
          "a": "Over TCP the nodes are assigned by a handshake and the collection server node can be left empty. UDP is needed when the PLC does not take TCP, such as an NX1P2: then the PLC and collection server nodes are required, and with a static node table also local port 9600. If the TCP handshake is refused, the program names the code and what to check: connections in use, a repeated node or IP protection."
        }
      ]
    }
  },
  {
    "key": "focas",
    "name": "FANUC FOCAS",
    "name_en": "FANUC FOCAS",
    "description": "Стойки ЧПУ FANUC по FOCAS2 через сервер сбора на объекте и вашу библиотеку FANUC, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "focas",
    "description_en": "Read-only FANUC CNC data over FOCAS2 via a collection server with your FOCAS library",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Положите библиотеку FANUC на сервер сбора",
          "desc": "Скопируйте из своего пакета FOCAS2 Fwlib64.dll с файлами fwlib*.dll (Windows) или libfwlib32.so (Linux) в папку focas в папке данных программы сбора.",
          "title_en": "Put the FANUC library on the server",
          "desc_en": "Copy Fwlib64.dll with its fwlib*.dll files (Windows) or libfwlib32.so (Linux) from your FOCAS2 package into the focas folder in the collection program's data folder."
        },
        {
          "title": "Проверьте разрядность библиотеки",
          "desc": "Библиотека должна быть той же разрядности, что программа сбора данных. Файл другой разрядности программа отклонит до запуска и назовёт путь к нему.",
          "title_en": "Check the library's bitness",
          "desc_en": "The library must match the data collection program's bitness. A file of another bitness is refused before anything starts, with its path named."
        },
        {
          "title": "Откройте стойке порт 8193",
          "desc": "Библиотека FOCAS2 говорит со встроенным Ethernet стойки по TCP 8193. Сервер сбора должен достучаться до стойки по этому адресу и порту.",
          "title_en": "Open port 8193 to the control",
          "desc_en": "The FOCAS2 library talks to the control's embedded Ethernet on TCP 8193. The collection server must reach the control at that address and port."
        },
        {
          "title": "Задайте свои теги, если нужно",
          "desc": "Без списка программа сбора читает состояние, программу, шпиндель, подачу, детали и оси. Параметр, макропеременную #500 или адрес PMC добавьте строкой путь, адрес, тип.",
          "title_en": "Add your own tags if needed",
          "desc_en": "With no list the program reads status, program, spindle, feed, parts and axes. Add a parameter, macro variable (#500) or PMC address as a line: path, address, type."
        }
      ]
    },
    "seo": {
      "title": "FANUC FOCAS и ИИ: стойки ЧПУ по FOCAS2 за смену",
      "description": "Сколько каждая стойка FANUC работала за смену, стояла в HOLD или ждала, плюс аварии и счётчик деталей. FOCAS2 читает программа сбора с вашей библиотекой FANUC.",
      "headline": "Состояние и аварии стоек FANUC по FOCAS2 прямо в чате",
      "scenarios": [
        {
          "title": "Что с машинами сейчас",
          "desc": "Агент покажет состояние, режим и признак аварийного останова. Для активных аварий, полученных по FOCAS2, он назовёт номер и текст со стойки."
        },
        {
          "title": "Работа и простои за смену",
          "desc": "Агент возьмёт отсчёты состояния за период и посчитает, сколько времени стойка исполняла программу, стояла в HOLD или ждала."
        },
        {
          "title": "Программа и детали",
          "desc": "Агент прочитает имя и номер текущей и главной программы и счётчик деталей и покажет, сколько деталей прибавилось за период."
        },
        {
          "title": "Шпиндель и подача",
          "desc": "Агент соберёт историю оборотов и нагрузки шпинделя и фактической подачи интервалами: минимум, максимум и среднее."
        },
        {
          "title": "Положения осей",
          "desc": "Агент покажет абсолютные и машинные координаты каждой оси, которую называет стойка, с её знаками после запятой."
        },
        {
          "title": "Макропеременные и PMC",
          "desc": "Агент прочитает заданные вами макропеременные, параметры и адреса PMC, например бит закрытой двери или счётчик цикла."
        }
      ],
      "how_it_works": [
        "Стойка FANUC стоит в сети объекта, поэтому к ней ходит программа сбора данных: она работает службой на сервере в той же сети и отправляет данные наружу только исходящим соединением. В подключении указывается адрес стойки, например tcp://10.0.12.5:8193, и при необходимости файл библиотеки и список тегов. Пока связи наружу нет, программа копит данные на диске сервера сбора.",
        "FOCAS это библиотека FANUC, а не открытый сетевой протокол, поэтому программа сбора не разговаривает с портом 8193 сама, а вызывает библиотеку из вашего пакета FOCAS2: FANUC разрешает распространять её только покупателям пакета. Библиотека загружается в отдельном вспомогательном процессе на каждый раунд, и её сбой или зависание обрывает только этот раунд, а остальные подключения сервера сбора читают дальше.",
        "Из библиотеки объявлены только вызовы чтения: записи параметров и PMC, загрузки программ и команд управления в программе сбора нет. Агент читает состояние, программу, шпиндель, подачу, оси, параметры, макропеременные и PMC, но ничего не меняет в стойке. Слово состояния выводится из run и motion по тем же правилам, что у адаптера MTConnect для FANUC, так что одна стойка читается одинаково обоими путями.",
        "Программа сбора опрашивает активные аварии текущего пути CNC отдельно от списка тегов. При неполном или отказанном чтении он сохраняет ранее полученные аварии. В историю попадают переходы, замеченные при опросе. Для русской панели выберите Windows-1251 в настройке кодировки аварий."
      ],
      "requirements": [
        "Стойка FANUC с FOCAS2 по встроенному Ethernet, порт TCP 8193",
        "Библиотека FANUC из вашего пакета FOCAS2 (A02B-0207-K737)",
        "Сервер сбора на объекте: Windows или Linux с Docker, разрядность библиотеки",
        "Сетевой доступ к стойке с сервера сбора"
      ],
      "faq": [
        {
          "q": "Как подключить FANUC FOCAS?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Скопируйте библиотеку из своего пакета FOCAS2 в папку focas в папке данных программы. Затем выберите FANUC FOCAS и укажите адрес стойки, например tcp://10.0.12.5:8193; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в стойке FANUC?",
          "a": "Аварии, полученные со стойки, идут с номером и исходным текстом при любом списке тегов. Стандартный каталог содержит состояние, режим, программу, шпиндель, подачу, детали, модель и оси. В свой список можно добавить параметры, макропеременные и адреса PMC."
        },
        {
          "q": "Отправляет ли агент команды машине?",
          "a": "Нет. Программа сбора объявляет из библиотеки FANUC только вызовы чтения: записи параметров и PMC, загрузки программ и команд управления в нём нет."
        },
        {
          "q": "Почему подключение не работает без файла FANUC?",
          "a": "FANUC разрешает поставлять библиотеку FOCAS только покупателям пакета FOCAS2, поэтому программа сбора её не содержит. Положите файл из своего пакета в папку focas в данных программы; при ошибке подключение назовёт путь, который не загрузился."
        }
      ]
    },
    "seo_en": {
      "title": "FANUC FOCAS and AI: CNC run and idle time per shift",
      "description": "How long each FANUC control ran a program, sat in HOLD or waited over a shift, with alarms and part count. A collection program reads FOCAS2 via your FANUC library.",
      "headline": "FANUC control state and alarms over FOCAS2 right in the chat",
      "scenarios": [
        {
          "title": "How the machines are now",
          "desc": "The agent shows the control state, mode and emergency stop flag. It gives the number and controller text of active alarms received over FOCAS2."
        },
        {
          "title": "Running and downtime per shift",
          "desc": "The agent takes state observations for a period and works out how long the control ran a program, sat in HOLD or waited."
        },
        {
          "title": "Program and parts",
          "desc": "The agent reads the name and number of the running and main program and the part count and shows how many parts were added over a period."
        },
        {
          "title": "Spindle and feed",
          "desc": "The agent collects the history of spindle speed and load and actual feed in intervals: minimum, maximum and average."
        },
        {
          "title": "Axis positions",
          "desc": "The agent shows the absolute and machine coordinates of every axis the control names, with its decimal places."
        },
        {
          "title": "Macro variables and PMC",
          "desc": "The agent reads the macro variables, parameters and PMC addresses you list, such as a door closed bit or a cycle counter."
        }
      ],
      "how_it_works": [
        "A FANUC control sits on the site's network, so the data collection program reaches it: it runs as a service on a server on the same network and sends data out over an outgoing connection only. The connection takes the control address, for example tcp://10.0.12.5:8193, and if needed the library file and a tag list. While there is no link outside, the program keeps the data on the collection server's disk.",
        "FOCAS is FANUC's library, not an open network protocol, so the collection program does not talk to port 8193 itself but calls the library from your FOCAS2 package: FANUC lets only buyers of the package ship it. The library is loaded in a separate helper process for each round, and a crash or hang inside it ends only that round while the collection server's other connections keep reading.",
        "Only read calls of the library are declared: the program has no parameter or PMC writes, no program download and no control commands. The agent reads status, program, spindle, feed, axes, parameters, macro variables and PMC, but changes nothing in the control. The state word comes from run and motion by the same rules as FANUC's MTConnect adapter, so one control reads the same by either path.",
        "The collection program polls active alarms on the current CNC path independently of the tag list. A partial or refused read keeps previously received alarms. History records transitions observed during polling. Select Windows-1251 as the alarm text encoding for a Russian CNC display."
      ],
      "requirements": [
        "A FANUC control with FOCAS2 over embedded Ethernet, TCP port 8193",
        "The FANUC library from your FOCAS2 package (A02B-0207-K737)",
        "A site collection server: Windows or Linux with Docker, the library's bitness",
        "Network access to the control from the collection server"
      ],
      "faq": [
        {
          "q": "How do I connect FANUC FOCAS?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Copy the library from your FOCAS2 package into the focas folder in the program's data folder. Then pick FANUC FOCAS and enter the control address, for example tcp://10.0.12.5:8193; the collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in a FANUC control?",
          "a": "The agent gets the native alarm number and text regardless of the tag list. The standard catalog includes status, mode, program, spindle, feed, parts, model and axes. A custom list can include parameters, macros and PMC addresses."
        },
        {
          "q": "Does the agent send commands to the machine?",
          "a": "No. The collection program declares only read calls of the FANUC library: it has no parameter or PMC writes, no program download and no control commands."
        },
        {
          "q": "Why does the connection not work without the FANUC file?",
          "a": "FANUC lets only buyers of the FOCAS2 package ship the FOCAS library, so the collection program does not contain it. Put the file from your package into the focas folder in the program's data; on an error the connection names the path that did not load."
        }
      ]
    }
  },
  {
    "key": "github",
    "name": "GitHub",
    "name_en": "GitHub",
    "description": "Репозитории, issues, pull requests, коммиты и GitHub Actions",
    "category": "dev",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "github",
    "description_en": "Repositories, issues, pull requests, commits and GitHub Actions",
    "search_terms": [
      "гитхаб"
    ],
    "guide": {
      "url": "https://github.com",
      "steps": [
        {
          "title": "Войдите под рабочим аккаунтом GitHub",
          "desc": "Откройте github.com под аккаунтом, у которого уже есть доступ к нужным репозиториям. Права агента не шире прав этого аккаунта.",
          "title_en": "Sign in with the right GitHub account",
          "desc_en": "Open github.com under the account that already has access to the repositories you need. The agent never sees more than this account does."
        },
        {
          "title": "Найдите владельца организации",
          "desc": "Если репозитории принадлежат организации, приложение ставит её владелец: участник видит только «Install and request», и установка повисает заявкой.",
          "title_en": "Find an organization owner",
          "desc_en": "If the repositories belong to an organization, only an owner installs the app: a member just gets \"Install and request\", and the install waits as a request."
        },
        {
          "title": "Откройте SAML-сессию организации",
          "desc": "При включённом SAML SSO зайдите на github.com/orgs/ORG/sso до установки. Без активной сессии организации просто не будет в списке аккаунтов.",
          "title_en": "Start a SAML session for the organization",
          "desc_en": "With SAML SSO enforced, visit github.com/orgs/ORG/sso before installing. Without an active session the organization is not even listed as a target."
        },
        {
          "title": "На экране установки отметьте репозитории",
          "desc": "На экране установки укажите «All repositories» или «Only select repositories» и отметьте нужные. Репозиторий вне списка для агента не существует.",
          "title_en": "On the install screen pick the repositories",
          "desc_en": "On the install screen pick \"All repositories\" or \"Only select repositories\" and tick the ones you need. Anything else stays invisible."
        },
        {
          "title": "Меняйте доступ потом в Settings аккаунта",
          "desc": "Личный аккаунт: Settings → Integrations → Applications. Организация: Settings → Third-party Access → «GitHub Apps». Дальше «Configure» у установки.",
          "title_en": "Change access later in the account Settings",
          "desc_en": "Personal: Settings → Integrations → Applications. Organization: Settings → Third-party Access → \"GitHub Apps\". Then \"Configure\" on the installation."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для GitHub: почему упала сборка на main",
      "description": "Найдёт шаг и коммит, на которых упал workflow, и PR, после которого пошли красные прогоны; соберёт, что вошло в релиз между тегами. Ставится приложением GitHub.",
      "headline": "Разбирайте pull request и упавшие сборки GitHub из чата",
      "scenarios": [
        {
          "title": "Что висит без ревью",
          "desc": "Агент соберёт открытые pull request по вашим репозиториям и покажет, что дольше всех ждёт ревью и кого стоит подтолкнуть."
        },
        {
          "title": "Разбор упавших сборок",
          "desc": "Агент найдёт упавшие прогоны GitHub Actions и покажет, в каком коммите и на каком шаге сломалась сборка."
        },
        {
          "title": "Сводка по репозиторию",
          "desc": "Агент пришлёт ежедневную сводку: новые PR, закрытые issues и статус сборок по согласованному с вами расписанию."
        },
        {
          "title": "События в рабочий чат",
          "desc": "Агент поймает push, новый issue или запрос ревью по вебхуку и напишет об этом в чат команды сразу, а не утром."
        },
        {
          "title": "Что вошло в релиз",
          "desc": "Агент соберёт коммиты и слитые pull request между двумя тегами и покажет, что именно вошло в релиз и кто автор каждого изменения."
        },
        {
          "title": "Задачи, о которых забыли",
          "desc": "Агент пройдёт по issues репозитория и покажет те, что висят без ответственного и без комментариев дольше месяца, с автором и последней активностью."
        }
      ],
      "how_it_works": [
        "Агент работает с GitHub через его API: репозитории, issues, pull request с комментариями и ревью, коммиты и прогоны GitHub Actions. Поверх этого он считает то, чего в интерфейсе не видно одним взглядом: какие PR дольше всех ждут ревью и кого стоит подтолкнуть, на каком коммите и на каком шаге сломалась сборка, что за сутки открылось и закрылось по репозиторию.",
        "У прогона Actions статус и заключение не одно и то же: событие о завершении workflow означает, что прогон закончился, а не что он прошёл, поэтому агент смотрит на результат отдельно и не записывает упавшую сборку в зелёные. С событиями та же логика: сам по себе pull_request ни о чём не говорит, значение несёт действие: открыт, переоткрыт, закрыт, обновлён новым коммитом или запрошено ревью.",
        "События приходят вебхуком, подписанным HMAC-SHA256: без общего секрета доставка отклоняется, а повторную доставку одного и того же события агент отсекает по её идентификатору. Поэтому опрашивать API по кругу не нужно. На запись агент осторожен: комментарий в PR, новый issue, перезапуск упавшего прогона или закрытие задачи выполняются отдельными действиями по вашему явному запросу, а не побочным эффектом разбора.",
        "Видимость агента ограничена установкой приложения: репозитория, которого в ней нет, для него не существует, и вместо пустой сводки он скажет, что доступа туда не выдано. Историю он читает страницами и по одному репозиторию за раз, а не всю организацию сразу, и держит частоту запросов в пределах лимитов GitHub, поэтому большой отчёт собирается дольше, чем короткий вопрос про один pull request. Прав у агента ровно столько, сколько у установки."
      ],
      "requirements": [
        "Роль владельца организации или её согласие на установку приложения",
        "Список репозиториев, к которым агент получит доступ"
      ],
      "faq": [
        {
          "q": "Как подключить GitHub?",
          "a": "Входом через GitHub: нажмите кнопку подключения и подтвердите установку приложения, ключи вводить не нужно. В организации приложение ставит владелец, а при SAML SSO сначала откройте сессию на github.com/orgs/ORG/sso, иначе организации не будет в списке."
        },
        {
          "q": "Что агент видит в GitHub?",
          "a": "Только репозитории, отмеченные при установке: issues, pull request, комментарии, коммиты и прогоны GitHub Actions по ним."
        },
        {
          "q": "Как расширить доступ?",
          "a": "При установке выбирается «All repositories» или «Only select repositories». Список можно поменять позже через «Configure» у приложения, и агент сразу начнёт видеть добавленные репозитории."
        },
        {
          "q": "Что с событиями и лимитами?",
          "a": "Вебхук приносит push, PR, issues, ревью и завершённые workflow, поэтому опрашивать API не нужно. Сами запросы идут не чаще 10 в секунду, чтобы не упереться в лимиты GitHub."
        }
      ]
    },
    "seo_en": {
      "title": "GitHub AI agent: why the build on main failed",
      "description": "Finds the step and commit where a workflow failed and the PR whose merge started the red runs; lists what shipped between two tags. Installs as a GitHub App.",
      "headline": "Clear stuck pull requests and failed GitHub builds from chat",
      "scenarios": [
        {
          "title": "What is stuck without a review",
          "desc": "The agent collects the open pull requests across your repositories and shows what has been waiting for review the longest and who is worth a nudge."
        },
        {
          "title": "Digging into failing builds",
          "desc": "The agent finds failed GitHub Actions runs and shows which commit and which step the build broke on."
        },
        {
          "title": "Repository digest",
          "desc": "The agent sends a daily digest: new PRs, closed issues and build status, on whatever schedule you agree with it."
        },
        {
          "title": "Events straight into the team chat",
          "desc": "The agent catches a push, a new issue or a review request over a webhook and posts it to the team chat right away instead of the next morning."
        },
        {
          "title": "What went into the release",
          "desc": "The agent gathers the commits and merged pull requests between two tags and shows what actually shipped and who authored each change."
        },
        {
          "title": "Issues everyone forgot about",
          "desc": "The agent walks the repository issues and shows the ones sitting with no assignee and no comments for over a month, with the author and the last activity."
        }
      ],
      "how_it_works": [
        "The agent works with GitHub through its API: repositories, issues, pull requests with their comments and reviews, commits and GitHub Actions runs. On top of that it computes what the interface does not show at a glance: which PRs have been waiting for review the longest and who is worth a nudge, which commit and which step the build broke on, what was opened and closed in a repository over the day.",
        "For an Actions run the status and the conclusion are different things: a workflow completion event means the run finished, not that it passed, so the agent looks at the outcome separately and does not count a failed build as green. Events follow the same logic: pull_request on its own says nothing, the meaning is in the action: opened, reopened, closed, updated with a new commit or a review requested.",
        "Events arrive over a webhook signed with HMAC-SHA256: without a shared secret the delivery is rejected, and a repeat delivery of the same event is dropped by its delivery identifier. That is why there is no need to poll the API in circles. The agent is careful about writing: a comment on a PR, a new issue, a re-run of a failed workflow or closing a task are separate actions on your explicit request, not a side effect of the analysis.",
        "The agent's visibility is bounded by the app installation: a repository outside it does not exist for the agent, and instead of an empty digest it says that access there was never granted. History is read page by page and one repository at a time rather than a whole organisation at once, and the request rate is kept within GitHub limits, so a large report takes longer to assemble than a quick question about one pull request. The agent has exactly the rights the installation has."
      ],
      "requirements": [
        "Organisation owner role, or the owner's consent to install the app",
        "The list of repositories the agent will be given access to"
      ],
      "faq": [
        {
          "q": "How do I connect GitHub?",
          "a": "By signing in through GitHub: press the connect button and approve the app installation, with no keys to type in. In an organisation the owner installs the app, and with SAML SSO open a session at github.com/orgs/ORG/sso first, otherwise the organisation will not appear in the list."
        },
        {
          "q": "What can the agent see in GitHub?",
          "a": "Only the repositories ticked during installation: their issues, pull requests, comments, commits and GitHub Actions runs."
        },
        {
          "q": "How do I widen the access?",
          "a": "At installation you choose All repositories or Only select repositories. The list can be changed later through Configure on the app, and the agent starts seeing the added repositories straight away."
        },
        {
          "q": "What about events and limits?",
          "a": "The webhook delivers pushes, PRs, issues, reviews and completed workflows, so there is no need to poll the API. Requests themselves go out no faster than 10 per second to stay clear of GitHub rate limits."
        }
      ]
    }
  },
  {
    "key": "gmail",
    "name": "Gmail",
    "name_en": "Gmail",
    "description": "Почта Gmail и Google Workspace по паролю приложения: письма, папки, отправка и пересылка",
    "category": "mail",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "gmail",
    "description_en": "Gmail and Google Workspace mail by app password: messages, folders, sending and forwarding",
    "search_terms": [
      "гмейл",
      "джимейл",
      "гугл почта",
      "google mail",
      "workspace"
    ],
    "guide": {
      "url": "https://myaccount.google.com/apppasswords",
      "steps": [
        {
          "title": "Включите двухэтапную проверку",
          "desc": "В аккаунте Google, который подключаете, откройте «Безопасность» и включите двухэтапную проверку. Без неё пароли приложений недоступны.",
          "title_en": "Turn on 2-Step Verification",
          "desc_en": "In the Google Account you are connecting, open Security and turn on 2-Step Verification. App passwords are unavailable without it."
        },
        {
          "title": "Откройте «Пароли приложений»",
          "desc": "Перейдите на myaccount.google.com/apppasswords, введите любое название и нажмите «Создать». Google покажет пароль из 16 символов один раз.",
          "title_en": "Open App passwords",
          "desc_en": "Go to myaccount.google.com/apppasswords, enter any name and click Create. Google shows the 16-character password once."
        },
        {
          "title": "Вставьте пароль с полным адресом",
          "desc": "Скопируйте пароль в подключение вместе с полным адресом ящика. Основной пароль аккаунта Google здесь не подходит.",
          "title_en": "Paste the password with the full address",
          "desc_en": "Paste the password into the connection together with the full mailbox address. The main Google Account password does not work here."
        },
        {
          "title": "Google Workspace: спросите администратора",
          "desc": "В аккаунте Google Workspace пароли приложений может запретить администратор. Если страница их не предлагает, попросите его разрешить.",
          "title_en": "Google Workspace: ask the administrator",
          "desc_en": "In a Google Workspace account the administrator may turn app passwords off. If the page does not offer them, ask the administrator to allow them."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Gmail с ИИ-агентом: ответ в нужную ветку",
      "description": "Ответ клиенту уходит прямо в его ветку переписки, а счета за месяц собираются из писем с общей суммой. Gmail подключается по IMAP и паролю приложения из 16 символов.",
      "headline": "Разбирайте входящие Gmail, не открывая почтовый ящик",
      "scenarios": [
        {
          "title": "Утренний разбор входящих",
          "desc": "Агент пройдёт по непрочитанным письмам и покажет, какие ждут ответа, с темой, отправителем и датой, не открывая Gmail."
        },
        {
          "title": "Счета и договоры из вложений",
          "desc": "Агент найдёт письмо по отправителю или теме, скачает вложение (счёт, акт или договор) и разберёт, что в нём написано."
        },
        {
          "title": "Ответ в переписку",
          "desc": "Агент напишет ответ в нужную ветку, перешлёт письмо коллеге или отправит новое письмо с вашего адреса Gmail."
        },
        {
          "title": "Порядок в ярлыках",
          "desc": "Агент разложит письма по ярлыкам, отметит разобранные прочитанными и уберёт лишнее в корзину."
        },
        {
          "title": "История переписки с клиентом",
          "desc": "Агент соберёт письма с одним адресатом за период, выстроит их по датам и покажет, о чём договорились и что осталось без ответа."
        },
        {
          "title": "Кто наполняет ящик",
          "desc": "Агент посчитает письма за месяц по отправителям и покажет, кто пишет чаще всего и сколько из этого так и не открыто."
        }
      ],
      "how_it_works": [
        "Агент подключается к ящику Gmail по IMAP и SMTP. Сначала он читает список папок, а дальше работает с самими письмами: темой, отправителем, датой, текстом и вложениями. Он находит письмо по отправителю или теме и открывает вложенный счёт, акт или договор, чтобы разобрать содержимое, а не пересказать имя файла.",
        "Подключается не пароль от аккаунта Google, а пароль приложения из 16 символов. Его создают на странице «Пароли приложений» после включения двухэтапной проверки. Одна пара адреса и пароля обслуживает и чтение, и отправку. Отзывается доступ удалением этого пароля. Смена основного пароля Google тоже отзывает пароли приложений, и подключение нужно обновить. В рабочем аккаунте паролей приложений может не быть.",
        "Папки Gmail это ярлыки: одно письмо может лежать под несколькими, а названия служебных папок зависят от языка аккаунта. Поэтому агент берёт имена папок из самого ящика, а не угадывает их. Удалённое письмо уходит в корзину Gmail, а отправленное Gmail сам сохраняет в «Отправленных».",
        "У отправки есть лимиты Google: около 500 получателей в сутки у личного аккаунта, у Google Workspace 2000 писем в сутки и 100 получателей на письмо через SMTP, письмо до 25 МБ. Если ящик или письмо упёрлись в ограничение, агент говорит об этом прямо."
      ],
      "requirements": [
        "Полный адрес Gmail или Google Workspace и включённая двухэтапная проверка.",
        "Агент читает все папки ящика и отправляет письма от вашего имени."
      ],
      "faq": [
        {
          "q": "Как подключить Gmail?",
          "a": "Адресом ящика и паролем приложения. Включите двухэтапную проверку в аккаунте Google, откройте myaccount.google.com/apppasswords, создайте пароль и вставьте его в подключение."
        },
        {
          "q": "Почему не подходит обычный пароль от Google?",
          "a": "Google не пускает почтовые программы по основному паролю. Для них нужен отдельный пароль приложения из 16 символов, который можно удалить в любой момент. Смена основного пароля Google отзывает все пароли приложений."
        },
        {
          "q": "Что делать, если страница паролей приложений не открывается?",
          "a": "Проверьте, что двухэтапная проверка включена. В рабочем аккаунте паролей приложений может не быть: их может запретить администратор, тогда включает он."
        },
        {
          "q": "Сколько писем агент может отправить?",
          "a": "Столько, сколько разрешает Google: около 500 получателей в сутки у личного аккаунта, у Google Workspace 2000 писем в сутки и 100 получателей на письмо через SMTP, письмо до 25 МБ."
        }
      ]
    },
    "seo_en": {
      "title": "Gmail AI agent: reply in the right thread, collect invoices",
      "description": "A reply to a client lands in their thread, and a month of invoices is pulled from your mail with the total. Connects over IMAP with a 16-character app password.",
      "headline": "Triage your Gmail inbox without opening the mailbox",
      "scenarios": [
        {
          "title": "Morning inbox triage",
          "desc": "The agent goes through unread messages and shows which ones are waiting for a reply, with subject, sender and date, without opening Gmail."
        },
        {
          "title": "Invoices and contracts out of attachments",
          "desc": "The agent finds a message by sender or subject, downloads the attachment (an invoice, an act or a contract) and reads what it says."
        },
        {
          "title": "Replying in a thread",
          "desc": "The agent writes a reply in the right thread, forwards a message to a colleague or sends a new email from your Gmail address."
        },
        {
          "title": "Tidy labels",
          "desc": "The agent sorts messages under labels, marks the handled ones as read and moves the clutter to the trash."
        },
        {
          "title": "A client's correspondence",
          "desc": "The agent gathers the messages with one contact over a period, lines them up by date and shows what was agreed and what was left unanswered."
        },
        {
          "title": "Who fills the inbox",
          "desc": "The agent counts a month of mail by sender and shows who writes the most and how much of it was never opened."
        }
      ],
      "how_it_works": [
        "The agent connects to the Gmail mailbox over IMAP and SMTP. It reads the folder list first, then works with the messages themselves: subject, sender, date, text and attachments. It finds a message by sender or subject and opens the attached invoice, act or contract to read what is inside rather than retell the file name.",
        "What gets connected is not the Google Account password but a 16-character app password. It is created on the App passwords page once 2-Step Verification is on. One pair of address and password serves both reading and sending. Access is revoked by deleting that password. Changing the main Google password also revokes app passwords, and the connection then needs updating. A work account may not have app passwords.",
        "Gmail folders are labels: one message can sit under several, and the names of the system folders depend on the account language. So the agent takes folder names from the mailbox itself rather than guessing them. A deleted message goes to the Gmail trash, and Gmail saves a sent message to Sent on its own.",
        "Sending is capped by Google: about 500 recipients a day for a personal account, 2,000 messages a day and 100 recipients per message over SMTP for Google Workspace, with a message up to 25 MB. When the mailbox or a message hits a limit, the agent says so directly."
      ],
      "requirements": [
        "The full Gmail or Google Workspace address with 2-Step Verification turned on.",
        "The agent reads every folder and sends mail on your behalf."
      ],
      "faq": [
        {
          "q": "How do I connect Gmail?",
          "a": "With the mailbox address and an app password. Turn on 2-Step Verification in your Google Account, open myaccount.google.com/apppasswords, create a password and paste it into the connection."
        },
        {
          "q": "Why doesn't my regular Google password work?",
          "a": "Google does not let mail programs in with the main password. They need a separate 16-character app password, which can be deleted at any time. Changing the main Google password revokes all app passwords."
        },
        {
          "q": "What if the App passwords page does not open?",
          "a": "Check that 2-Step Verification is on. A work account may not have app passwords: the administrator may turn them off, and then the administrator turns them back on."
        },
        {
          "q": "How much mail can the agent send?",
          "a": "As much as Google allows: about 500 recipients a day for a personal account, 2,000 messages a day and 100 recipients per message over SMTP for Google Workspace, with messages up to 25 MB."
        }
      ]
    }
  },
  {
    "key": "google_calendar",
    "name": "Google Calendar",
    "name_en": "Google Calendar",
    "description": "Календарь и события Google Workspace",
    "category": "calendar",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "google-calendar",
    "description_en": "Google Workspace calendars and events",
    "search_terms": [
      "гугл календарь"
    ],
    "guide": {
      "url": "https://calendar.google.com",
      "steps": [
        {
          "title": "Выберите аккаунт, из которого ведёте встречи",
          "desc": "В окне выбора аккаунта укажите почту, из которой вы ведёте встречи. Доступ выдаётся ровно ему: календари второго профиля в том же браузере в выдачу не попадут.",
          "title_en": "Pick the account you run meetings from",
          "desc_en": "In the account chooser pick the mailbox you run your meetings from. Calendars of a second profile in the same browser stay invisible."
        },
        {
          "title": "В «Другие календари» подпишитесь на чужие",
          "desc": "Видны только календари из списка слева. Чужой подпишите заранее: «Другие календари» → «Подписаться на календарь» → адрес владельца.",
          "title_en": "Subscribe to others under “Other calendars”",
          "desc_en": "Only calendars on the left-hand list are visible. Subscribe to a colleague's one first: “Other calendars” → “Subscribe to calendar” → the owner's address."
        },
        {
          "title": "Попросите право «Изменять» в «Имеют доступ»",
          "desc": "Владелец: «Настройки и общий доступ» → «Имеют доступ» → «Изменять и просматривать все сведения о мероприятиях». Иначе видна только занятость без названий.",
          "title_en": "Ask for edit rights under “Shared with”",
          "desc_en": "The owner opens “Settings and sharing” → “Shared with” and sets “Make changes to events”. Otherwise only busy blocks are visible: no titles, no new events."
        },
        {
          "title": "Админ: снимите запрет в «Управление API»",
          "desc": "Админ домена открывает «Безопасность» → «Контроль доступа и данных» → «Управление API» и снимает ограничение с Календаря.",
          "title_en": "Admin: lift the block under “API controls”",
          "desc_en": "The domain admin opens “Security” → “Access and data control” → “API controls” and lifts the restriction on Calendar."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Google Calendar с ИИ: общее окно на троих",
      "description": "Часовое окно для встречи втроём находится по занятости всех календарей, и событие сразу заводится с участниками. За месяц видно, сколько часов ушло на встречи.",
      "headline": "Планируйте встречи по календарям Google Workspace",
      "scenarios": [
        {
          "title": "План на сегодня и завтра",
          "desc": "Агент пройдёт по календарям аккаунта, включая подписанные командные, и назовёт, что назначено на сегодня и завтра и где накладки."
        },
        {
          "title": "Свободное окно под встречу",
          "desc": "Агент проверит занятость по нескольким календарям сразу и найдёт свободное окно нужной длины для всех участников."
        },
        {
          "title": "Событие с участниками и местом",
          "desc": "Агент заведёт встречу с участниками, местом, описанием и напоминанием, а при переносе сдвинет её вместе с приглашениями."
        },
        {
          "title": "Утренняя сводка по расписанию",
          "desc": "Агент пришлёт по расписанию сводку дня: сколько встреч, где наложения и какие часы остались свободными."
        },
        {
          "title": "Куда ушёл месяц",
          "desc": "Агент пройдёт по календарям за месяц окнами по датам, посчитает часы во встречах и покажет, какие регулярные созвоны съедают больше всего времени."
        },
        {
          "title": "Перенос повторяющейся серии",
          "desc": "Агент найдёт нужный экземпляр повторяющейся встречи, уточнит, править одну дату или всю цепочку, и перенесёт её только после вашего подтверждения."
        }
      ],
      "how_it_works": [
        "Агент ходит в Google Calendar API v3 по вашему запросу: читает список календарей аккаунта, события с участниками, местом, описанием и напоминаниями, экземпляры повторяющихся встреч и занятость сразу по нескольким календарям. Из этого он собирает план на сегодня и завтра, находит накладки, подбирает свободное окно нужной длины для всех участников и по расписанию присылает сводку дня с остатком свободных часов.",
        "Календарь Google устроен вокруг списка календарей конкретного аккаунта: агент видит ровно то, что в этом списке лежит, и обращается к каждому календарю отдельным запросом по его идентификатору. Уровень доступа тоже решает многое: на доступе к свободному времени видны только занятые интервалы без названий и участников, и накладку агент назовёт, а её причину не назовёт. Повторяющуюся встречу API отдаёт правилом, поэтому конкретные даты серии агент разворачивает сам.",
        "На запись агент создаёт события с участниками, местом, описанием и напоминанием, переносит их и удаляет. Здесь он осторожен: перенос и отмена рассылают приглашённым письма, поэтому изменение чужой встречи агент подтверждает до отправки, а у повторяющейся серии отдельно уточняет, править один экземпляр или всю цепочку. Правки пачкой он делает по одной встрече и показывает список до того, как хоть одно письмо уйдёт.",
        "Подключение идёт через вход в аккаунт Google в отдельном окне, ключи копировать не нужно: доступ живёт токеном, который обновляется сам и гаснет, как только вы отзываете разрешение на странице доступа аккаунта. Частоту запросов агент выдерживает сам, чтобы не упереться в квоту Google, а длинные периоды забирает окнами по датам. Если календарь недоступен, доступ отозван или день действительно пуст, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Согласие на доступ ко всем календарям аккаунта: по одному выдать нельзя.",
        "В Google Workspace сторонние приложения не запрещены администратором."
      ],
      "faq": [
        {
          "q": "Как подключить Google Calendar?",
          "a": "Входом в аккаунт Google в отдельном окне: вы подтверждаете доступ, ключи копировать не нужно. Видны только календари из списка этого аккаунта, поэтому чужой подпишите заранее: «Другие календари» → «Подписаться на календарь»."
        },
        {
          "q": "Что агент видит в календаре?",
          "a": "Список календарей аккаунта, события с участниками, местом и описанием, экземпляры повторяющихся встреч и занятость по нескольким календарям сразу."
        },
        {
          "q": "Пишет ли агент в календарь?",
          "a": "Да: создаёт, переносит и удаляет события, если владелец выдал уровень «Изменять и просматривать все сведения о мероприятиях». На уровне доступа к свободному времени видна только занятость без названий."
        },
        {
          "q": "Что делать на корпоративном домене?",
          "a": "В Google Workspace администратор может закрыть сторонние приложения. Тогда окно авторизации заканчивается блокировкой, и доступ открывается в консоли администратора в разделе «Управление API»."
        }
      ]
    },
    "seo_en": {
      "title": "Google Calendar AI agent: find a free hour for three people",
      "description": "A free hour for three people is found across everyone's busy time, and the event is booked with attendees. You also see how many hours meetings took this month.",
      "headline": "Plan meetings across your Google Workspace calendars",
      "scenarios": [
        {
          "title": "Your plan for today and tomorrow",
          "desc": "The agent walks through the calendars in the account, subscribed team ones included, and tells you what is scheduled today and tomorrow and where the clashes are."
        },
        {
          "title": "A free slot for a meeting",
          "desc": "The agent checks busy time across several calendars at once and finds a free slot of the length you need for everyone involved."
        },
        {
          "title": "An event with attendees and a place",
          "desc": "The agent books a meeting with attendees, location, description and a reminder, and moves it together with the invitations when the time changes."
        },
        {
          "title": "Morning schedule summary",
          "desc": "The agent sends a scheduled summary of the day: how many meetings there are, where they overlap and which hours are still free."
        },
        {
          "title": "Where the month went",
          "desc": "The agent walks a month of calendars in date windows, counts the hours spent in meetings and shows which recurring calls eat the most time."
        },
        {
          "title": "Moving a recurring series",
          "desc": "The agent finds the right instance of a recurring meeting, asks whether to edit one date or the whole chain, and moves it only after you confirm."
        }
      ],
      "how_it_works": [
        "The agent calls the Google Calendar API v3 on your request: it reads the account calendar list, events with attendees, location, description and reminders, instances of recurring meetings and busy time across several calendars at once. Out of that it assembles the plan for today and tomorrow, finds the clashes, picks a free slot of the length everyone involved needs and sends a scheduled summary of the day with the free hours left.",
        "Google Calendar is built around the calendar list of one specific account: the agent sees exactly what that list holds and queries each calendar separately by its identifier. The access level decides a lot too: at the free/busy level only busy intervals are visible, without titles or attendees, so the agent will name a clash but not its reason. A recurring meeting arrives as a rule, so the agent expands the concrete dates of the series itself.",
        "For writing, the agent creates events with attendees, location, description and a reminder, moves them and deletes them. It is careful here: a move or a cancellation mails everyone invited, so a change to someone else meeting is confirmed before it goes out, and on a recurring series the agent asks separately whether to edit a single instance or the whole chain. Batched edits go one meeting at a time, with the list shown before a single mail leaves.",
        "Connecting is a sign-in to a Google account in a separate window, with no keys to copy: access lives as a token that refreshes itself and dies the moment you revoke the grant on the account access page. The agent holds the request rate itself so as not to run into the Google quota, and fetches long periods in date windows. If a calendar is unavailable, the grant was revoked or the day really is empty, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Consent covering every calendar of the account: single ones cannot be excluded.",
        "In Google Workspace, third-party apps are not blocked by the admin."
      ],
      "faq": [
        {
          "q": "How do I connect Google Calendar?",
          "a": "By signing in to your Google account in a separate window: you approve access, there are no keys to copy. Only calendars from that account list are visible, so subscribe to someone else calendar in advance: Other calendars → Subscribe to calendar."
        },
        {
          "q": "What does the agent see in the calendar?",
          "a": "The list of calendars in the account, events with attendees, location and description, instances of recurring meetings, and busy time across several calendars at once."
        },
        {
          "q": "Does the agent write to the calendar?",
          "a": "Yes: it creates, moves and deletes events if the owner granted the Make changes to events level. At the free/busy access level only busy time is visible, without titles."
        },
        {
          "q": "What should I do on a corporate domain?",
          "a": "In Google Workspace the administrator can block third-party apps. The authorization window then ends in a block, and access is opened in the admin console under API controls."
        }
      ]
    }
  },
  {
    "key": "google_docs",
    "name": "Google Docs",
    "name_en": "Google Docs",
    "description": "Создание, редактирование и совместная работа над документами",
    "category": "files",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "google-docs",
    "description_en": "Create, edit and collaborate on documents",
    "search_terms": [
      "гугл документы",
      "гугл доки"
    ],
    "guide": {
      "url": "https://docs.google.com",
      "steps": [
        {
          "title": "Войдите под нужным аккаунтом Google",
          "desc": "Доступ выдаётся аккаунту, активному в браузере. Если аккаунтов несколько, выберите тот, у которого уже есть доступ к рабочим документам.",
          "title_en": "Sign in with the right Google account",
          "desc_en": "Access is granted to whichever account is active in the browser. With several accounts, pick the one that already has access to your working documents."
        },
        {
          "title": "В «Средствах управления API» снимите запрет",
          "desc": "В Google Workspace доступ сторонних приложений бывает закрыт: администратор открывает его на admin.google.com в разделе «Средства управления API».",
          "title_en": "Admin: allow access under “API controls”",
          "desc_en": "In Google Workspace third-party app access can be switched off: an admin turns it on at admin.google.com under “Security” → “API controls”."
        },
        {
          "title": "В «Открыть доступ» дайте роль «Редактор»",
          "desc": "Откройте документ, нажмите «Открыть доступ», добавьте аккаунт и назначьте роль «Редактор». С ролями «Читатель» и «Комментатор» правки не пройдут.",
          "title_en": "Under “Share” give the account “Editor”",
          "desc_en": "Open the document, click “Share”, add the chosen account and set its role to “Editor”. With “Viewer” or “Commenter” the edits are rejected."
        },
        {
          "title": "Соберите ссылки на нужные документы",
          "desc": "Скопируйте адреса вида https://docs.google.com/document/d/DOCUMENT_ID/edit: идентификатор стоит между /d/ и /edit. Поиска по названию нет.",
          "title_en": "Collect links to the documents you need",
          "desc_en": "Copy addresses shaped like https://docs.google.com/document/d/DOCUMENT_ID/edit; the identifier sits between /d/ and /edit. There is no search by title."
        }
      ]
    },
    "seo": {
      "title": "Google Docs с ИИ: замена реквизитов по всему договору",
      "description": "Новые ИНН, КПП и счёт встают во все 14 мест договора, включая колонтитул, а старые не остаются нигде. Вход через аккаунт Google, документ по ссылке.",
      "headline": "Собирайте договоры и отчёты в Google Docs по вводным",
      "scenarios": [
        {
          "title": "Черновик договора или отчёта",
          "desc": "Агент соберёт документ по вашим вводным (с разделами, таблицами и списками) и вернёт ссылку на готовый файл."
        },
        {
          "title": "Правки в документе по ссылке",
          "desc": "Агент внесёт изменения в существующий документ: перепишет разделы, обновит таблицы и заголовки, поправит стили абзацев."
        },
        {
          "title": "Замена цифр и дат по шаблону",
          "desc": "Агент найдёт по всему документу повторяющиеся значения и заменит их разом, и суммы, даты и реквизиты не придётся править вручную."
        },
        {
          "title": "Регулярное обновление файла",
          "desc": "Агент по расписанию перепишет один и тот же документ свежими данными, и ссылка на него у получателей не изменится."
        },
        {
          "title": "Пересказ длинного документа",
          "desc": "Агент прочитает файл по ссылке, пройдёт по заголовкам, спискам и таблицам и вернёт выжимку: о чём разделы, какие сроки и суммы в них зашиты."
        },
        {
          "title": "Единый вид перед отправкой",
          "desc": "Агент сверит стили заголовков и абзацев по всему документу, приведёт их к одному виду и добавит колонтитулы и разрывы страниц там, где их не хватает."
        }
      ],
      "how_it_works": [
        "Агент работает с Google Docs API v1 и открывает документ по ссылке или идентификатору: читает текст и абзацы, таблицы, списки, колонтитулы, именованные диапазоны и стили. На этом он собирает черновик договора или отчёта по вашим вводным, переписывает разделы существующего файла, обновляет таблицы и заголовки и разом меняет по всему документу повторяющиеся суммы, даты и реквизиты.",
        "Документ для API это не сплошной текст, а последовательность элементов с числовыми позициями, и любая вставка сдвигает всё, что идёт следом. Поэтому агент не правит вслепую: сначала перечитывает структуру, выстраивает изменения так, чтобы соседние не ломали позиции друг друга, и отправляет их одной пачкой. Замена по всему файлу идёт по точному совпадению: часть слова или иной регистр под неё не попадут.",
        "На запись агент вставляет и удаляет текст по месту, меняет стили текста и абзацев, добавляет таблицы, списки, разрывы страниц и колонтитулы. Правка попадает сразу в живой документ, и отменить её через API нельзя, остаётся только история версий Google. Поэтому перед переписыванием целого раздела агент проговаривает, что именно заменяет, а после правки перечитывает файл и показывает результат.",
        "Подключение идёт входом в аккаунт Google в отдельном окне; запрашиваются права на документы и на адрес аккаунта. Google Диск в доступ не входит, поэтому найти документ по названию нельзя: нужна ссылка вида docs.google.com/document/d/ID/edit или сам идентификатор. Отказ по правам API возвращает кодом, а не пустым документом, и агент передаёт его как есть, вместо того чтобы сделать вид, что сохранил. Длинную правку он режет на пачки и выдерживает паузу между ними, чтобы не упереться в лимит запросов."
      ],
      "requirements": [
        "Документы в формате Google Docs, а не загруженные файлы .docx",
        "Право делиться документом: вы его владелец или редактор",
        "Личный аккаунт Google либо доступ к администратору домена"
      ],
      "faq": [
        {
          "q": "Как подключить Google Docs?",
          "a": "Входом в аккаунт Google в отдельном окне: вы подтверждаете доступ к документам, ключи копировать не нужно. На каждом рабочем документе назначьте этому аккаунту роль «Редактор»: с ролями «Читатель» и «Комментатор» правки не пройдут."
        },
        {
          "q": "Что агент видит в документе?",
          "a": "Структуру документа по ссылке: текст и абзацы, таблицы, списки, колонтитулы, именованные диапазоны и стили. Соседние документы аккаунта в выдачу не попадают."
        },
        {
          "q": "Пишет ли агент в документ?",
          "a": "Да: вставляет и удаляет текст по месту, заменяет значения по всему файлу, меняет стили текста и абзацев, добавляет таблицы, списки, разрывы страниц и колонтитулы."
        },
        {
          "q": "Почему нужна ссылка на документ?",
          "a": "Запрашиваемый доступ не включает Google Диск, поэтому поиска по названию нет. Документ адресуется ссылкой вида docs.google.com/document/d/ID/edit или самим идентификатором."
        }
      ]
    },
    "seo_en": {
      "title": "Google Docs AI agent: swap contract details everywhere",
      "description": "New tax IDs and bank account land in all 14 spots of the contract, footer included, and the old ones vanish. You sign in with Google and share the doc by link.",
      "headline": "Draft contracts and reports in Google Docs from your notes",
      "scenarios": [
        {
          "title": "A draft contract or report",
          "desc": "The agent assembles a document from your input (with sections, tables and lists) and returns a link to the finished file."
        },
        {
          "title": "Edits in a document you link to",
          "desc": "The agent changes an existing document: rewrites sections, updates tables and headings, and fixes paragraph styles."
        },
        {
          "title": "Swapping figures and dates in a template",
          "desc": "The agent finds repeated values across the whole document and replaces them in one pass, so amounts, dates and legal details no longer need editing by hand."
        },
        {
          "title": "Scheduled refresh of a file",
          "desc": "On a schedule the agent rewrites the same document with fresh data, and the link recipients already have stays unchanged."
        },
        {
          "title": "A recap of a long document",
          "desc": "The agent reads the file you link to, walks its headings, lists and tables and returns a digest: what each section covers, which dates and amounts sit inside."
        },
        {
          "title": "One consistent look before sending",
          "desc": "The agent compares heading and paragraph styles across the document, brings them to a single look and adds headers, footers and page breaks where they are missing."
        }
      ],
      "how_it_works": [
        "The agent works with the Google Docs API v1 and opens a document by link or identifier: it reads text and paragraphs, tables, lists, headers and footers, named ranges and styles. On that basis it assembles a draft contract or report from your input, rewrites sections of an existing file, updates tables and headings, and swaps repeated amounts, dates and legal details across the whole document in one pass.",
        "To the API a document is not continuous text but a sequence of elements with numeric positions, and any insertion shifts everything that follows. So the agent does not edit blind: it re-reads the structure first, arranges the changes so that neighbouring ones do not break each other positions, and sends them as a single batch. A replacement across the file goes by exact match: part of a word or a different letter case will not be caught by it.",
        "For writing, the agent inserts and deletes text in place, changes text and paragraph styles, and adds tables, lists, page breaks, headers and footers. An edit lands straight in the live document and cannot be undone through the API, and only the Google version history remains. That is why, before rewriting a whole section, the agent spells out what exactly it is replacing, and after the edit it re-reads the file and shows the result.",
        "Connecting is a sign-in to a Google account in a separate window; access to documents and to the account address is requested. Google Drive is not part of that access, so a document cannot be found by title: it takes a link like docs.google.com/document/d/ID/edit or the identifier itself. A refusal on permissions comes back from the API as a code rather than as an empty document, and the agent passes it on as it is instead of pretending it saved. A long edit is cut into batches with a pause between them, so the request quota is not exhausted mid-way."
      ],
      "requirements": [
        "Native Google Docs files, not uploaded .docx documents",
        "The right to share the document: you own it or edit it",
        "A personal Google account, or an admin you can reach"
      ],
      "faq": [
        {
          "q": "How do I connect Google Docs?",
          "a": "By signing in to your Google account in a separate window: you approve access to documents, there are no keys to copy. Give that account the Editor role on every working document: with the Viewer and Commenter roles the edits will not go through."
        },
        {
          "q": "What does the agent see in a document?",
          "a": "The structure of the document you link to: text and paragraphs, tables, lists, headers and footers, named ranges and styles. Other documents in the account never show up in the results."
        },
        {
          "q": "Does the agent write to a document?",
          "a": "Yes: it inserts and deletes text in place, replaces values across the whole file, changes text and paragraph styles, and adds tables, lists, page breaks, headers and footers."
        },
        {
          "q": "Why does it need a link to the document?",
          "a": "The access we request does not include Google Drive, so there is no search by title. A document is addressed by a link like docs.google.com/document/d/ID/edit or by the identifier itself."
        }
      ]
    }
  },
  {
    "key": "google_sheets",
    "name": "Google Sheets",
    "name_en": "Google Sheets",
    "description": "Листы, ячейки, диапазоны",
    "category": "files",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "google-sheets",
    "description_en": "Sheets, cells and ranges",
    "search_terms": [
      "гугл таблицы"
    ],
    "guide": {
      "url": "https://sheets.google.com",
      "steps": [
        {
          "title": "На sheets.google.com проверьте нужные файлы",
          "desc": "Откройте sheets.google.com и проверьте, что нужные файлы видны под этим аккаунтом: агент увидит ровно те таблицы, что видит он.",
          "title_en": "Check the files show at sheets.google.com",
          "desc_en": "Open sheets.google.com and check the files you need are visible under that account: the agent sees exactly what that account sees."
        },
        {
          "title": "Попросите «Редактора» через «Открыть доступ»",
          "desc": "Попросите владельца файла нажать «Открыть доступ» и добавить ваш адрес с ролью «Редактор». На ролях «Читатель» и «Комментатор» запись в ячейки не пройдёт.",
          "title_en": "Ask the owner for “Editor” via “Share”",
          "desc_en": "Ask the file owner to click “Share” and add your address with the “Editor” role. With “Viewer” or “Commenter” the agent only reads: writing cells will fail."
        },
        {
          "title": "Excel: в «Файл» сохраните как таблицу Google",
          "desc": "Загруженный .xlsx открывается в браузере, но по API отдаёт ошибку. Откройте файл, выберите «Файл» → «Сохранить как таблицу Google» и работайте с копией.",
          "title_en": "Excel: “File”, then “Save as Google Sheets”",
          "desc_en": "An uploaded .xlsx opens in the browser but returns an error over the API. Open it, pick “File” → “Save as Google Sheets” and work with the resulting copy."
        },
        {
          "title": "В «Управление API» отметьте «Доверенное»",
          "desc": "Если домен корпоративный, администратор открывает «Безопасность» → «Контроль доступа и данных» → «Управление API» и присваивает приложению статус «Доверенное».",
          "title_en": "Mark the app “Trusted” under API controls",
          "desc_en": "In a corporate domain an admin opens “Security” → “Access and data control” → “API controls” in the Admin console and marks the app as “Trusted”."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Google Sheets с ИИ: сверка двух листов",
      "description": "Два листа сверяются по артикулам, и 27 расхождений из 1 340 строк ложатся на лист «Сверка». Итоги дня дописываются в конец, внесённое руками не стирается.",
      "headline": "ИИ для Google Таблиц: считайте отчёты и спрашивайте по цифрам",
      "scenarios": [
        {
          "title": "Готовый отчёт в таблице",
          "desc": "Агент соберёт цифры, заведёт лист и запишет отчёт диапазонами, с шапкой, автошириной колонок и подсветкой значений выше порога."
        },
        {
          "title": "Ответы по данным листа",
          "desc": "Агент прочитает нужные листы и диапазоны и ответит на вопрос по цифрам, не заставляя открывать файл и листать вкладки."
        },
        {
          "title": "Дозапись итогов по расписанию",
          "desc": "Агент допишет строку с итогами дня в конец сводного листа по расписанию, не трогая то, что уже внесено руками выше."
        },
        {
          "title": "Сверка двух листов",
          "desc": "Агент сопоставит два диапазона по ключу, соберёт расхождения на отдельный лист и отсортирует их по величине разницы."
        },
        {
          "title": "Перезапись без потерь",
          "desc": "Агент перед перезаписью диапазона прочитает, что в нём лежит, и покажет, какие формулы сотрутся, а заменит значения только после вашего подтверждения."
        },
        {
          "title": "Формулы и их значения",
          "desc": "Агент покажет, где в ячейке лежит формула, а где вбитое руками число, и вернёт то из двух, что нужно задаче, без подмены расчёта результатом."
        }
      ],
      "how_it_works": [
        "Агент ходит в Google Sheets API v4 и работает с той таблицей, ссылку или идентификатор которой вы дали: читает листы, диапазоны и значения ячеек. По ним он отвечает на вопрос по цифрам без открытия файла, собирает готовый отчёт с шапкой, автошириной колонок и подсветкой значений выше порога, сопоставляет два диапазона по ключу и выносит расхождения на отдельный лист, отсортировав по величине разницы.",
        "Списка файлов у Sheets API нет: он открывает ровно ту таблицу, адрес которой вы назвали, и по названию она не ищется. Отдельная ловушка Google: загруженный .xlsx в браузере открывается, а по API отдаёт ошибку, пока он не пересохранён в формат Google Таблиц. И ячейка с формулой хранит две вещи сразу (саму формулу и посчитанное значение), так что агент запрашивает то из них, что нужно задаче.",
        "Дописать и перезаписать это разные операции, и агент их не путает: дозапись итогов дня добавляет строку в конец листа, не трогая внесённое руками выше, а перезапись диапазона стирает всё, что в нём было, включая формулы. Поэтому перед перезаписью агент читает диапазон, а когда исходные данные лучше не трогать, складывает результат на отдельный лист: сверка двух диапазонов не портит ни один из них.",
        "Подключение идёт входом в аккаунт Google в отдельном окне; запрашиваются права на таблицы и на адрес аккаунта, Google Диск в доступ не входит. Диапазоны агент адресует нотацией A1 и забирает их пачкой за один запрос, а не по ячейке, поэтому широкий отчёт не упирается в лимит частоты на середине. Если доступа к файлу нет или лист пуст, он говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Ссылка на таблицу или её идентификатор: по названию агент не ищет.",
        "Права на таблицы и адрес аккаунта: Google Диск в доступ не входит."
      ],
      "faq": [
        {
          "q": "Как подключить Google Sheets?",
          "a": "Входом в аккаунт Google в отдельном окне: вы подтверждаете доступ к таблицам, копировать ключи не нужно. Агент увидит ровно те файлы, что видит этот аккаунт, поэтому чужие таблицы попросите открыть кнопкой «Открыть доступ» с ролью «Редактор»."
        },
        {
          "q": "Что агент видит в таблицах?",
          "a": "Листы, диапазоны и значения ячеек той таблицы, ссылку на которую вы дали. Списка файлов у Sheets API нет, поэтому таблица адресуется только ссылкой или идентификатором из неё."
        },
        {
          "q": "Пишет ли агент в таблицу?",
          "a": "Да: перезаписывает диапазоны, дописывает строки в конец листа, очищает ячейки, добавляет и переименовывает листы, ставит форматирование, сортировку и условные правила."
        },
        {
          "q": "Почему не читается загруженный Excel?",
          "a": "Файл .xlsx открывается в браузере, но по API не читается и отдаёт ошибку. Откройте его и выберите «Файл» → «Сохранить как таблицу Google», и дальше агент работает с полученной копией."
        },
        {
          "q": "Работает ли агент с гугл-таблицами?",
          "a": "Гугл-таблицы и есть Google Sheets: агент читает листы и диапазоны той таблицы, ссылку на которую вы дали, отвечает по цифрам и записывает результат обратно: дозаписью в конец листа или перезаписью диапазона после вашего подтверждения."
        }
      ]
    },
    "seo_en": {
      "title": "Google Sheets AI agent: reconcile two sheets by SKU",
      "description": "Two sheets are matched by SKU, and 27 mismatches out of 1,340 rows land on a separate tab. Daily totals are appended at the end, so rows typed by hand stay intact.",
      "headline": "Crunch reports in Google Sheets and ask about the numbers",
      "scenarios": [
        {
          "title": "A finished report in a spreadsheet",
          "desc": "The agent gathers the numbers, creates a sheet and writes the report range by range, with a header row, auto-sized columns and values above your threshold highlighted."
        },
        {
          "title": "Answers from the data on a sheet",
          "desc": "The agent reads the sheets and ranges it needs and answers your question about the numbers, without making you open the file and flip through tabs."
        },
        {
          "title": "Scheduled append of daily totals",
          "desc": "On a schedule the agent appends a row with the totals of the day to the end of the summary sheet, leaving everything entered by hand above it untouched."
        },
        {
          "title": "Reconciling two sheets",
          "desc": "The agent matches two ranges by key, collects the discrepancies on a separate sheet and sorts them by the size of the difference."
        },
        {
          "title": "Overwriting a range without losses",
          "desc": "The agent reads a range before overwriting it and shows which formulas would be erased, replacing the values only once you have confirmed the change."
        },
        {
          "title": "Formulas and their values",
          "desc": "The agent shows where a cell holds a formula and where a hand-typed number, and returns whichever of the two the task needs instead of quietly swapping one for the other."
        }
      ],
      "how_it_works": [
        "The agent calls the Google Sheets API v4 and works with the spreadsheet whose link or identifier you gave: it reads sheets, ranges and cell values. From those it answers your question about the numbers without the file being opened, assembles a finished report with a header row, auto-sized columns and values above your threshold highlighted, matches two ranges by key and puts the discrepancies on a separate sheet sorted by the size of the difference.",
        "The Sheets API has no file listing: it opens exactly the spreadsheet you addressed, and it is not searchable by title. One Google trap of its own: an uploaded .xlsx opens in the browser but returns an error over the API until it has been re-saved into the Google Sheets format. And a cell with a formula holds two things at once (the formula itself and the calculated value), so the agent requests whichever of them the task needs.",
        "Appending and overwriting are different operations, and the agent does not confuse them: appending the totals of the day adds a row at the end of the sheet and leaves what was entered by hand above it untouched, while overwriting a range erases everything that was in it, formulas included. So before an overwrite the agent reads the range, and when the source data is better left alone it puts the result on a separate sheet: reconciling two ranges spoils neither of them.",
        "Connecting is a sign-in to a Google account in a separate window; access to spreadsheets and to the account address is requested, and Google Drive is not part of it. The agent addresses ranges in A1 notation and fetches them in one batched call rather than cell by cell, so a wide report does not run into the rate limit halfway through. If there is no access to the file or the sheet is empty, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A link to the spreadsheet or its ID: the agent cannot search by title.",
        "Access to spreadsheets and the account address; Google Drive is not included."
      ],
      "faq": [
        {
          "q": "How do I connect Google Sheets?",
          "a": "By signing in to your Google account in a separate window: you approve access to spreadsheets, there are no keys to copy. The agent sees exactly the files that account sees, so ask for other people spreadsheets to be opened up with the Share button and the Editor role."
        },
        {
          "q": "What does the agent see in spreadsheets?",
          "a": "Sheets, ranges and cell values of the spreadsheet you gave a link to. The Sheets API has no file listing, so a spreadsheet is addressed only by a link or the identifier inside it."
        },
        {
          "q": "Does the agent write to a spreadsheet?",
          "a": "Yes: it overwrites ranges, appends rows to the end of a sheet, clears cells, adds and renames sheets, and applies formatting, sorting and conditional rules."
        },
        {
          "q": "Why is an uploaded Excel file not readable?",
          "a": "An .xlsx file opens in the browser but cannot be read over the API and returns an error. Open it and choose File → Save as Google Sheets, and the agent then works with the resulting copy."
        },
        {
          "q": "Does the agent work with Google spreadsheets?",
          "a": "Google spreadsheets are exactly what it works with: the agent reads the sheets and ranges of the spreadsheet you gave a link to, answers on the figures and writes the result back: appending to the end of a sheet, or overwriting a range after your confirmation."
        }
      ]
    }
  },
  {
    "key": "google_slides",
    "name": "Google Slides",
    "name_en": "Google Slides",
    "description": "Создание, редактирование и совместная работа над презентациями",
    "category": "files",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "google-slides",
    "description_en": "Create, edit and collaborate on presentations",
    "search_terms": [
      "гугл презентации",
      "гугл слайды"
    ],
    "guide": {
      "url": "https://slides.google.com",
      "steps": [
        {
          "title": "На slides.google.com проверьте аватар",
          "desc": "Откройте slides.google.com и проверьте аватар справа вверху: подключение увидит колоды только этого аккаунта. Для рабочих колод входите под Google Workspace.",
          "title_en": "Check the avatar at slides.google.com",
          "desc_en": "Open slides.google.com and check the avatar top-right: the connection sees decks from this account only. For work decks sign in with Google Workspace."
        },
        {
          "title": "В «Настройки доступа» дайте роль «Редактор»",
          "desc": "Для чужой колоды владелец открывает её → «Настройки доступа» → добавляет ваш адрес с ролью «Редактор». С ролью «Читатель» агент только прочитает слайды.",
          "title_en": "Under “Share” give the account “Editor”",
          "desc_en": "For someone else's deck the owner opens it → “Share” → adds your address with the “Editor” role. With “Viewer” the agent can only read the slides."
        },
        {
          "title": "Скопируйте ссылку на презентацию",
          "desc": "Идентификатор колоды это часть ссылки между https://docs.google.com/presentation/d/ и /edit. Доступ не включает Google Диск: по названию колода не ищется.",
          "title_en": "Copy the link to the presentation",
          "desc_en": "The deck ID is the part of the link between https://docs.google.com/presentation/d/ and /edit. The access excludes Google Drive: no search by name."
        },
        {
          "title": "В «Средствах управления API» снимите запрет",
          "desc": "Вход может быть запрещён политикой. Администратор снимает запрет: «Безопасность» → «Управление доступом и данными» → «Средства управления API».",
          "title_en": "Admin: allow access under “API controls”",
          "desc_en": "In a corporate account sign-in can be blocked. The admin opens “Menu → Security → Access and data control” and allows access under “API controls”."
        }
      ]
    },
    "seo": {
      "title": "Google Slides и ИИ-агент: свежие цифры в квартальной колоде",
      "description": "Цифры квартальной презентации обновляются на 9 слайдах из 22, вёрстка остаётся прежней. Черновик колоды собирается из текста, ежемесячная выходит по расписанию.",
      "headline": "Превращайте текст в презентацию Google Slides",
      "scenarios": [
        {
          "title": "Черновик презентации из текста",
          "desc": "Агент разложит ваш текст по слайдам (титульный, тезисы, итоги) и вернёт ссылку на собранную колоду."
        },
        {
          "title": "Обновление цифр в колоде",
          "desc": "Агент обновит показатели и подписи сразу по всем слайдам существующей презентации, не перебирая их вручную и не ломая вёрстку."
        },
        {
          "title": "Заполнение шаблона слайдов",
          "desc": "Агент подставит данные в готовый шаблон: заменит текст в плейсхолдерах и картинки, оставив оформление колоды нетронутым."
        },
        {
          "title": "Ежемесячная презентация по расписанию",
          "desc": "Агент по расписанию пересоберёт отчётную колоду свежими цифрами: шаблон согласуете один раз, дальше обновление идёт само."
        },
        {
          "title": "Пересказ чужой колоды",
          "desc": "Агент прочитает слайды по ссылке (текст фигур, таблицы и подписи) и перескажет, о чём колода и какие цифры в ней заявлены, вместо листания шестидесяти страниц."
        },
        {
          "title": "Короткая версия колоды",
          "desc": "Агент уберёт слайды, которые не нужны этой аудитории: покажет список на удаление, дождётся подтверждения и сверит состав получившейся колоды."
        }
      ],
      "how_it_works": [
        "Агент работает с Google Slides API v1 и открывает колоду по ссылке или идентификатору между /presentation/d/ и /edit: читает слайды, текст в фигурах и таблицах, изображения, оформление страниц и миниатюры отдельных слайдов. На этом он раскладывает ваш текст по слайдам (титульный, тезисы, итоги), обновляет показатели и подписи сразу по всей колоде и подставляет данные в готовый шаблон, не трогая его оформление.",
        "Презентация устроена иначе, чем документ: это не поток текста, а страницы с объектами, у каждого из которых своё место и размер, а сам текст живёт внутри фигур и ячеек таблиц. Поэтому «заменить по всей колоде» для агента означает пройти по текстовым фигурам каждого слайда. Вид страницы задают макет и тема: слайд, добавленный по макету шаблона, наследует оформление, а собранный из голых фигур не наследует.",
        "Отсюда и осторожность на записи. Агент добавляет, дублирует и удаляет слайды, вставляет и заменяет текст, создаёт фигуры, таблицы и картинки, меняет стили текста и заливку страниц, но для отчётной колоды предпочитает продублировать слайд шаблона и подменить в нём текст, а не верстать заново координатами. Удаление слайда через API не отменить, поэтому его агент подтверждает, а результат сверяет по составу и геометрии слайдов.",
        "Подключение идёт через вход в аккаунт Google в отдельном окне; запрашиваются права на презентации и на адрес аккаунта. Google Диск в доступ не входит, поэтому по названию колоду не найти, нужна ссылка или идентификатор. Правки уходят пачкой: несколько операций над колодой отправляются одним запросом, и если хоть одна из них не проходит, не применяется ни одна, так что колода не остаётся переделанной наполовину. Частоту запросов агент держит сам, а о нехватке прав или пустом шаблоне говорит прямо."
      ],
      "requirements": [
        "Аккаунт Google, в котором лежат нужные презентации",
        "Разрешённый доступ сторонних приложений в Google Workspace"
      ],
      "faq": [
        {
          "q": "Как подключить Google Slides?",
          "a": "Входом в аккаунт Google в отдельном окне: вы подтверждаете доступ к презентациям, ключи копировать не нужно. Для чужой колоды владелец даёт этому аккаунту роль «Редактор» через «Настройки доступа», иначе агент только прочитает слайды."
        },
        {
          "q": "Что агент видит в презентации?",
          "a": "Слайды колоды по ссылке: текст в фигурах и таблицах, изображения, оформление страниц и миниатюры отдельных слайдов. Другие презентации аккаунта не видны."
        },
        {
          "q": "Пишет ли агент в презентацию?",
          "a": "Да: добавляет, дублирует и удаляет слайды, вставляет и заменяет текст, создаёт фигуры, таблицы и картинки, меняет стили текста и заливку страниц."
        },
        {
          "q": "Почему нужна ссылка на колоду?",
          "a": "Запрашиваемый доступ не включает Google Диск, поэтому найти презентацию по названию нельзя. Нужна ссылка или идентификатор между /presentation/d/ и /edit."
        }
      ]
    },
    "seo_en": {
      "title": "Google Slides AI agent: fresh numbers in a quarterly deck",
      "description": "Numbers in the quarterly deck get updated on 9 of 22 slides, layout untouched. A draft deck is built from your text, and the monthly one goes out on schedule.",
      "headline": "Turn your text into a Google Slides deck",
      "scenarios": [
        {
          "title": "A draft deck from your text",
          "desc": "The agent lays your text out across slides (title, key points, conclusions) and returns a link to the assembled deck."
        },
        {
          "title": "Refreshing the numbers in a deck",
          "desc": "The agent updates metrics and captions across every slide of an existing deck at once, without going through them by hand and without breaking the layout."
        },
        {
          "title": "Filling in a slide template",
          "desc": "The agent drops your data into a ready template: it replaces text in placeholders and images, leaving the design of the deck untouched."
        },
        {
          "title": "A monthly deck on schedule",
          "desc": "On a schedule the agent rebuilds the reporting deck with fresh numbers: you approve the template once, and the updates run on their own after that."
        },
        {
          "title": "Someone else's deck, retold",
          "desc": "The agent reads the slides you link to (shape text, tables and captions) and retells what the deck argues and which numbers it claims, instead of you clicking through sixty pages."
        },
        {
          "title": "A shorter cut of the deck",
          "desc": "The agent drops the slides this audience does not need: it lists what would be deleted, waits for your confirmation and checks the result against the thumbnails."
        }
      ],
      "how_it_works": [
        "The agent works with the Google Slides API v1 and opens a deck by link or by the identifier between /presentation/d/ and /edit: it reads slides, text in shapes and tables, images, page design and thumbnails of individual slides. On that basis it lays your text out across slides (title, key points, conclusions), refreshes metrics and captions across the whole deck at once, and drops data into a ready template without touching its design.",
        "A presentation is built differently from a document: it is not a stream of text but pages of objects, each with its own position and size, and the text itself lives inside shapes and table cells. So replacing something across the whole deck means, for the agent, walking the text shapes of every slide. The look of a page comes from its layout and theme: a slide added from a template layout inherits the design, one assembled out of bare shapes does not.",
        "Hence the caution when writing. The agent adds, duplicates and deletes slides, inserts and replaces text, creates shapes, tables and images, and changes text styles and page backgrounds, but for a reporting deck it prefers to duplicate a template slide and swap the text inside it rather than lay the slide out again by coordinates. Deleting a slide cannot be undone through the API, so the agent confirms it and checks the result against the thumbnail.",
        "Connecting is a sign-in to a Google account in a separate window; access to presentations and to the account address is requested. Google Drive is not part of it, so a deck cannot be found by title: a link or an identifier is needed. Edits travel in a batch: several operations on a deck go out as one request, and if any of them fails none is applied, so the deck is never left half-rebuilt. The agent holds the request rate itself, and states missing permissions or an empty template directly."
      ],
      "requirements": [
        "A Google account that holds the presentations you need",
        "Third-party app access allowed in Google Workspace"
      ],
      "faq": [
        {
          "q": "How do I connect Google Slides?",
          "a": "By signing in to your Google account in a separate window: you approve access to presentations, there are no keys to copy. For someone else deck the owner grants that account the Editor role in the sharing settings, otherwise the agent can only read the slides."
        },
        {
          "q": "What does the agent see in a presentation?",
          "a": "The slides of the deck you link to: text in shapes and tables, images, page design and thumbnails of individual slides. Other presentations in the account are not visible."
        },
        {
          "q": "Does the agent write to a presentation?",
          "a": "Yes: it adds, duplicates and deletes slides, inserts and replaces text, creates shapes, tables and images, and changes text styles and page backgrounds."
        },
        {
          "q": "Why does it need a link to the deck?",
          "a": "The access we request does not include Google Drive, so a presentation cannot be found by title. You need a link or the identifier between /presentation/d/ and /edit."
        }
      ]
    }
  },
  {
    "key": "gravitel",
    "name": "Гравител Облачная АТС",
    "name_en": "Gravitel Cloud PBX",
    "description": "Облачная АТС: звонки, SMS, история, сотрудники, номера, АОН, кампании обзвона",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "gravitel",
    "description_en": "Cloud PBX: calls, SMS, history, employees, numbers, caller ID and call campaigns",
    "signup_url": "https://gravitel.ru/signup/",
    "guide": {
      "url": "https://gravitel.ru/auth/",
      "steps": [
        {
          "title": "На gravitel.ru нажмите «Войти в АТС»",
          "desc": "На gravitel.ru нажмите «Войти в АТС» и войдите учётной записью компании. Дальше всё происходит в кабинете АТС, интерфейс русскоязычный.",
          "title_en": "On gravitel.ru click «Войти в АТС»",
          "desc_en": "On gravitel.ru click «Войти в АТС» and sign in with your company account. Everything below happens in the PBX dashboard, which is Russian-only."
        },
        {
          "title": "Установите «Интеграция по REST API»",
          "desc": "Меню «Интеграции» → «Интеграция по REST API» → «Установить». Соседний «Интеграция по API Гравител» из прошлого поколения, он не подойдёт.",
          "title_en": "Install «Интеграция по REST API»",
          "desc_en": "Menu «Интеграции» → «Интеграция по REST API» → «Установить». The neighbouring «Интеграция по API Гравител» is the old generation."
        },
        {
          "title": "Откройте «Настройки» установленной интеграции",
          "desc": "«Интеграция по REST API» → «Настройки». «Название интеграции»: любое имя. «Адрес вашей CRM» и «Ключ для авторизации в Вашей CRM» заполнять не нужно.",
          "title_en": "Open «Настройки» of the installed integration",
          "desc_en": "«Интеграция по REST API» → «Настройки». Leave «Адрес вашей CRM» and «Ключ для авторизации в Вашей CRM» empty: that is the reverse direction."
        },
        {
          "title": "Скопируйте адрес и ключ в «Авторизация»",
          "desc": "В подразделе «Авторизация» лежат адрес и ключ АТС. Из адреса нужен только домен вашей АТС (участок пути после /v1/), а не весь URL.",
          "title_en": "Copy the address and key from «Авторизация»",
          "desc_en": "The «Авторизация» subsection holds the PBX address and key. From the address you only need your PBX domain: the path segment after /v1/, not the whole URL."
        }
      ]
    },
    "seo": {
      "title": "Гравител Облачная АТС с ИИ: баланс и звонок клиенту",
      "description": "Скажет остаток на счёте АТС и на сколько дней его хватит, наберёт клиента с добавочного сотрудника и отправит SMS. Подключается API-ключом и доменом АТС.",
      "headline": "Считайте пропущенные звонки Гравител, не открывая кабинет АТС",
      "scenarios": [
        {
          "title": "Пропущенные и принятые звонки",
          "desc": "Агент поднимет историю звонков за нужный период и покажет, сколько вызовов приняли, сколько пропустили и по каким номерам."
        },
        {
          "title": "Звонок и SMS клиенту",
          "desc": "Агент позвонит клиенту с добавочного сотрудника, при необходимости подменит АОН и отправит SMS прямо из диалога, без входа в кабинет АТС."
        },
        {
          "title": "Кампании обзвона роботом",
          "desc": "Агент запустит звонок робота клиенту в кампании обзвона, проверит статус вызова и уберёт из очереди тех, кому звонить уже не нужно."
        },
        {
          "title": "Баланс и структура АТС",
          "desc": "Агент покажет остаток на счёте АТС, список сотрудников с добавочными, отделы и номера, чтобы понимать, кто на какой линии сидит."
        },
        {
          "title": "Кому так и не перезвонили",
          "desc": "Агент пройдёт по пропущенным за день и вычтет тех, кому уже перезвонили, и останется короткий список клиентов, до которых так и не дошли."
        },
        {
          "title": "Нагрузка по отделам",
          "desc": "Агент разложит звонки за неделю по отделам и добавочным и покажет, на кого приходится основной поток, а кто почти не поднимает трубку."
        }
      ],
      "how_it_works": [
        "Агент обращается к REST API Гравител и начинает со структуры АТС: сотрудники с добавочными, отделы, номера, персональные АОН и остаток на счёте. Дальше идёт история звонков за нужный период (сколько вызовов приняли, сколько пропустили и по каким номерам), а рядом лежат очереди кампаний обзвона, так что видно и живые разговоры, и то, кому робот ещё не дозвонился.",
        "Звонок в облачной АТС никогда не уходит «из системы»: он инициируется от добавочного конкретного сотрудника, и АТС сначала поднимает его линию, а уже потом соединяет с клиентом. Поэтому результат не известен в момент запуска, и агент проверяет статус вызова отдельным шагом. Пропущенные он тоже считает по истории за период, а не по счётчику на экране: только в истории видно, кто перезвонил, а кто нет.",
        "На запись агент звонит клиенту с добавочного сотрудника, отправляет SMS прямо из диалога, задаёт или снимает сотруднику персональный АОН и управляет звонками в кампании обзвона: запускает вызов робота и убирает из очереди тех, кому звонить уже не нужно. Подмену АОН он берёт из номеров вашей же АТС. По умолчанию агент работает на чтение, а перед звонком и SMS называет номер и текст.",
        "Ключ уходит в заголовке каждого запроса, отдельного логина у коннектора нет, а объём доступного равен объёму самой АТС: сотрудники, номера и история звонков той организации, на которую ключ выпущен. Историю за длинный период агент забирает страницами, а не одним запросом, и держит частоту в рамках лимита. Если данных за период нет, он скажет это прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права администратора в кабинете Облачной АТС Гравител",
        "Сотрудники и номера заведены в АТС"
      ],
      "faq": [
        {
          "q": "Как подключить Гравител Облачную АТС?",
          "a": "API-ключом и доменом АТС. В кабинете установите «Интеграция по REST API» в меню «Интеграции», откройте её «Настройки» → подраздел «Авторизация» и скопируйте ключ и адрес. Из адреса нужен только домен вашей АТС."
        },
        {
          "q": "Что агент видит в Гравител?",
          "a": "Сотрудников с добавочными, отделы, номера АТС, историю и пропущенные звонки, персональные АОН, остаток на счёте и очереди кампаний обзвона."
        },
        {
          "q": "Пишет ли агент в АТС?",
          "a": "Может: инициировать звонок, отправить SMS, задать или снять персональный АОН сотруднику и управлять звонками в кампании обзвона. По умолчанию работает на чтение."
        },
        {
          "q": "Какая интеграция нужна в кабинете?",
          "a": "Именно «Интеграция по REST API». Соседний пункт «Интеграция по API Гравител» относится к предыдущему поколению API, с ним подключение не заработает."
        }
      ]
    },
    "seo_en": {
      "title": "Gravitel Cloud PBX AI agent: balance and client calls",
      "description": "Tells you the PBX balance and how many days it will last, dials a client from an employee's extension and sends an SMS. Connects with an API key and the PBX domain.",
      "headline": "Count missed Gravitel calls without opening the PBX console",
      "scenarios": [
        {
          "title": "Missed and answered calls",
          "desc": "The agent pulls up call history for the period you need and shows how many calls were answered, how many were missed and from which numbers."
        },
        {
          "title": "A call and an SMS to a customer",
          "desc": "The agent dials a customer from an employee extension, substitutes the caller ID if needed and sends an SMS straight from the chat, without logging into the PBX account."
        },
        {
          "title": "Robot dialing campaigns",
          "desc": "The agent launches a robot call to a customer inside a dialing campaign, checks the call status and drops from the queue everyone who no longer needs a call."
        },
        {
          "title": "PBX balance and structure",
          "desc": "The agent shows the balance of the PBX account, the list of employees with extensions, departments and numbers, so you know who sits on which line."
        },
        {
          "title": "Who never got a call back",
          "desc": "The agent goes through the day's missed calls and subtracts everyone already called back, leaving a short list of customers nobody has reached."
        },
        {
          "title": "Load across departments",
          "desc": "The agent breaks the week's calls down by department and extension and shows who carries the main flow and who barely picks up the phone."
        }
      ],
      "how_it_works": [
        "The agent calls the Gravitel REST API and starts with the structure of the PBX: employees with extensions, departments, numbers, personal caller IDs and the account balance. Then comes call history for the period you need (how many calls were answered, how many were missed and from which numbers), and next to it sit the dialing campaign queues, so both live conversations and the people the robot has not reached yet are visible.",
        "A call in a cloud PBX never goes out «from the system»: it is started from the extension of a specific employee, and the PBX first raises their line and only then connects the customer. So the outcome is not known at launch, and the agent checks the call status as a separate step. Missed calls are likewise counted from the history for the period rather than from an on-screen counter: only the history shows who called back and who did not.",
        "On the write side the agent dials a customer from an employee extension, sends an SMS straight from the chat, sets or clears a personal caller ID for an employee and manages calls inside a dialing campaign: launching a robot call and dropping from the queue everyone who no longer needs one. A substituted caller ID is taken from the numbers of your own PBX. By default the agent works read-only, and before a call or an SMS it names the number and the text.",
        "The key travels in the header of every request, the connector has no separate login of its own, and the scope available equals the scope of the PBX itself: the employees, numbers and call history of the organization the key was issued for. History over a long period is fetched page by page rather than in one request, and the rate is kept inside the limit. If there is no data for the period, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Administrator rights in the Gravitel cloud PBX cabinet",
        "Employees and phone numbers already set up in the PBX"
      ],
      "faq": [
        {
          "q": "How do I connect Gravitel Cloud PBX?",
          "a": "With an API key and the PBX domain. In the account install Integration over REST API from the Integrations menu, open its Settings → the Authorization subsection and copy the key and the address. From that address you only need the domain of your PBX."
        },
        {
          "q": "What does the agent see in Gravitel?",
          "a": "Employees with extensions, departments, PBX numbers, call history and missed calls, personal caller IDs, the account balance and dialing campaign queues."
        },
        {
          "q": "Does the agent write to the PBX?",
          "a": "It can: start a call, send an SMS, set or clear a personal caller ID for an employee and manage calls inside a dialing campaign. By default it works read-only."
        },
        {
          "q": "Which integration do I need in the account?",
          "a": "Integration over REST API specifically. The neighbouring item, Integration over Gravitel API, is the previous generation of the API and the connection will not work with it."
        }
      ]
    }
  },
  {
    "key": "headhunter",
    "name": "HeadHunter (hh.ru)",
    "name_en": "HeadHunter (hh.ru)",
    "description": "Вакансии, отклики и база резюме",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "headhunter",
    "short_name": "HeadHunter",
    "short_name_en": "HeadHunter",
    "description_en": "Vacancies, applications and the resume database",
    "search_terms": [
      "хедхантер",
      "хх"
    ],
    "guide": {
      "url": "https://hh.ru",
      "steps": [
        {
          "title": "Войдите на hh.ru аккаунтом работодателя",
          "desc": "Токен получит та учётка, под которой браузер авторизован в момент подтверждения. Нужен аккаунт работодателя, а не соискателя.",
          "title_en": "Sign in to hh.ru as an employer",
          "desc_en": "The token goes to whichever account your browser is signed in as when approving. It must be an employer account, not a seeker one."
        },
        {
          "title": "Найдите себя в «Менеджеры» в профиле",
          "desc": "В профиле откройте «Управление и автоматизация» → «Менеджеры» и найдите себя в списке: нового менеджера добавляет только администратор.",
          "title_en": "Find yourself under «Менеджеры» in profile",
          "desc_en": "In your profile open «Управление и автоматизация» → «Менеджеры» and find yourself in the list. Only the administrator adds a manager."
        },
        {
          "title": "В меню «…» включите доступ к вакансиям",
          "desc": "На странице «Менеджеры вакансий» в меню «…» рядом с именем включите «К активным вакансиям» и «К архиву вакансий», иначе видны только личные вакансии.",
          "title_en": "In the “…” menu enable access to vacancies",
          "desc_en": "On «Менеджеры вакансий» use the “…” menu next to the name to enable «К активным вакансиям» and «К архиву вакансий», otherwise only assigned vacancies show."
        },
        {
          "title": "В том же меню откройте контакты в резюме",
          "desc": "Там же включите «Открытие контактов в резюме из базы», иначе резюме придут без телефонов и почты. Поиск по базе идёт в пределах 500 резюме в сутки.",
          "title_en": "In the same menu enable resume contacts",
          "desc_en": "In the same menu enable «Открытие контактов в резюме из базы», otherwise resumes arrive with no phone or email. Search stays within 500 resumes a day."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для HeadHunter: разбор откликов по вакансиям",
      "description": "Интеграция с hh.ru через официальный API: по 47 откликам на 5 вакансий агент соберёт короткий список из 6 кандидатов на интервью, прочитав переписку и резюме.",
      "headline": "Разбирайте отклики на вакансии и зовите сильных первыми",
      "scenarios": [
        {
          "title": "Разбор откликов",
          "desc": "Агент соберёт свежие отклики по активным вакансиям, разложит их по вакансиям и покажет, кого звать на интервью первым."
        },
        {
          "title": "Подбор по базе резюме",
          "desc": "Агент найдёт в базе резюме hh.ru кандидатов под открытую вакансию и вернёт короткий список с причиной по каждому."
        },
        {
          "title": "Переписка с кандидатами",
          "desc": "Агент напишет кандидату в отклике, отправит приглашение на интервью или переведёт отклик в отказ по вашему решению."
        },
        {
          "title": "Сводка по вакансиям",
          "desc": "Агент каждое утро пришлёт, сколько откликов пришло за сутки, по каким вакансиям тишина и что скоро уйдёт в архив."
        },
        {
          "title": "Просмотры против откликов",
          "desc": "Агент сопоставит статистику просмотров вакансии с числом откликов и покажет, где описание не цепляет: смотрят сотни, а доходит до отклика один-два."
        },
        {
          "title": "Продлить или убрать в архив",
          "desc": "Агент покажет вакансии на исходе срока, предложит продлить те, что ещё дают отклики, и уберёт в архив закрытые после вашего подтверждения."
        }
      ],
      "how_it_works": [
        "Агент работает с hh.ru через официальный API api.hh.ru: активные и архивные вакансии, отклики вместе с перепиской по ним, статистику просмотров, базу резюме и список менеджеров компании. Из этого складывается разбор откликов по вакансиям, короткий список кандидатов под открытую позицию с причиной по каждому имени и утренняя сводка: сколько откликов пришло за сутки, по каким вакансиям тишина и что скоро уйдёт в архив.",
        "Отклик на hh.ru это не письмо, а отдельная сущность с собственной перепиской, поэтому агент читает ветку целиком, а не последнее сообщение, и различает, ответили кандидату или только открыли резюме. База резюме живёт отдельно от откликов: там своя выдача с фильтрами и своей постраничностью, а карточка приходит обезличенной, пока контакты не открыты. Поэтому кандидатов из поиска и кандидатов из откликов агент держит разными списками и не выдаёт одних за других.",
        "На запись агент умеет многое: создать и обновить вакансию, продлить её или убрать в архив, ответить в отклике, пригласить на интервью, перевести отклик в отказ. Делает он это по вашему решению, а не сам: приглашение и отказ уходят кандидату вживую и назад не отыгрываются, поэтому агент сначала показывает, кому и что собирается написать, и отправляет после подтверждения.",
        "Доступ выдаётся входом через hh.ru: вы подтверждаете его во всплывающем окне, токен возвращается сам и продлевается без вашего участия. Видит агент ровно то, что разрешено вашему менеджеру, частоту запросов к API держит в допустимых пределах, а поиск по базе укладывает в суточный лимит (500 уникальных резюме на менеджера), поэтому сужает фильтры, а не выгребает базу подряд. Если данных нет из-за прав или лимита, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Аккаунт работодателя на hh.ru, а не соискателя",
        "Права администратора компании для выдачи прав менеджеру",
        "Запас суточного лимита: 500 резюме на менеджера"
      ],
      "faq": [
        {
          "q": "Как подключить HeadHunter (hh.ru)?",
          "a": "Входом через hh.ru: нажмите «Подключить» и подтвердите доступ во всплывающем окне, токен вернётся сам, вводить его руками не нужно. Подтверждайте под аккаунтом работодателя: доступ получит та учётка, под которой вы сидите в браузере."
        },
        {
          "q": "Что агент видит в hh.ru?",
          "a": "Активные и архивные вакансии, отклики и переписку по ним, статистику просмотров, базу резюме и список менеджеров компании в пределах прав вашего менеджера."
        },
        {
          "q": "Пишет ли агент в hh.ru?",
          "a": "Может: создавать и обновлять вакансии, продлевать их и убирать в архив, отвечать в откликах, приглашать на интервью и менять статус отклика."
        },
        {
          "q": "Почему в резюме нет контактов?",
          "a": "Менеджеру не включено «Открытие контактов в резюме из базы» на странице «Менеджеры вакансий». Поиск по базе идёт в пределах суточного лимита: 500 уникальных резюме на менеджера."
        }
      ]
    },
    "seo_en": {
      "title": "HeadHunter AI agent: a shortlist from vacancy responses",
      "description": "Six candidates worth an interview out of 47 responses to 5 vacancies. The agent reads responses, chats and the resume database via the official hh.ru API.",
      "headline": "Triage vacancy responses and call the strongest ones first",
      "scenarios": [
        {
          "title": "Triaging responses",
          "desc": "The agent collects fresh responses to your active vacancies, groups them by vacancy and shows who to call in for an interview first."
        },
        {
          "title": "Sourcing from the resume database",
          "desc": "The agent finds candidates for an open vacancy in the HeadHunter resume database and returns a shortlist with a reason for every name."
        },
        {
          "title": "Messaging candidates",
          "desc": "The agent writes to a candidate inside a response, sends an interview invitation or moves the response to rejected once you decide."
        },
        {
          "title": "Vacancy digest",
          "desc": "Every morning the agent reports how many responses came in over the last day, which vacancies are silent and what is about to go into the archive."
        },
        {
          "title": "Views against responses",
          "desc": "The agent puts vacancy view statistics next to the number of responses and shows where the description falls flat: hundreds look, one or two actually apply."
        },
        {
          "title": "Prolong it or archive it",
          "desc": "The agent shows the vacancies running out of time, suggests prolonging the ones still bringing responses and archives the closed ones once you confirm."
        }
      ],
      "how_it_works": [
        "The agent works with hh.ru through the official api.hh.ru API: active and archived vacancies, responses together with the correspondence inside them, view statistics, the resume database and the list of company managers. Out of that come a triage of responses by vacancy, a shortlist of candidates for an open position with a reason for every name, and a morning digest: how many responses came in over the last day, which vacancies are silent and what is about to go into the archive.",
        "A response on hh.ru is not a letter but a separate entity with its own correspondence, so the agent reads the whole thread rather than the last message, and tells apart a candidate who was answered from one whose resume was merely opened. The resume database lives apart from responses: it has its own result list with filters and its own paging, and a card arrives depersonalised until the contacts are opened. So the agent keeps candidates from search and candidates from responses in separate lists and never passes one off as the other.",
        "On the writing side the agent can do a lot: create and update a vacancy, prolong it or move it to the archive, reply inside a response, invite a candidate to an interview, move a response to rejected. It does this on your decision, not on its own: an invitation and a rejection reach the candidate for real and cannot be played back, so the agent first shows who it is about to write to and what, and sends only after confirmation.",
        "Access is granted by signing in through hh.ru: you approve it in the popup, the token comes back on its own and is renewed without your involvement. The agent sees exactly what your manager account is allowed to see, holds the API request rate within the permitted range, and fits database search into the daily cap (500 unique resumes per manager), so it narrows the filters instead of sweeping the database row by row. If data is missing because of permissions or the cap, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "An employer account on hh.ru, not a job seeker one",
        "Company administrator rights to grant manager permissions",
        "Room in the daily cap of 500 resumes per manager"
      ],
      "faq": [
        {
          "q": "How do I connect HeadHunter (hh.ru)?",
          "a": "By signing in through hh.ru: click Connect and approve access in the popup: the token comes back on its own, there is nothing to type by hand. Approve it under the employer account: access goes to whichever account you are signed into in the browser."
        },
        {
          "q": "What does the agent see in HeadHunter?",
          "a": "Active and archived vacancies, responses and the correspondence inside them, view statistics, the resume database and the list of company managers, within the permissions of your manager account."
        },
        {
          "q": "Does the agent write to HeadHunter?",
          "a": "It can: create and update vacancies, prolong them and move them to the archive, reply inside responses, invite candidates to interviews and change the status of a response."
        },
        {
          "q": "Why are there no contacts in a resume?",
          "a": "The manager does not have Opening contacts in resumes from the database enabled on the Vacancy managers page. Database search also runs within a daily cap of 500 unique resumes per manager."
        }
      ]
    }
  },
  {
    "key": "hrlink",
    "name": "HRlink КЭДО",
    "name_en": "HRlink",
    "description": "Кадровый ЭДО: документы, заявления, сотрудники",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "hrlink",
    "short_name": "HRlink",
    "short_name_en": "HRlink",
    "description_en": "HR e-documents: documents, employee requests and employees",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://portal.hr-link.ru",
      "steps": [
        {
          "title": "Войдите под ролью «Кадровик»",
          "desc": "Авторизуйтесь под сотрудником с ролью «Кадровик» (HR): у остальных ролей реестры сотрудников и документов отвечают 403, а выдача токена в меню не появляется.",
          "title_en": "Sign in with the «Кадровик» (HR) role",
          "desc_en": "Log in as a user with the «Кадровик» (HR) role: for other roles the employee and document registries return 403 and the token item never appears in the menu."
        },
        {
          "title": "Запишите адрес своего тенанта HRlink",
          "desc": "Это адрес, по которому вы входите в кабинет, вида company.hr-link.ru. Общий portal.hr-link.ru чужому тенанту не подойдёт.",
          "title_en": "Write down your HRlink tenant address",
          "desc_en": "It is the address you sign in at, shaped like company.hr-link.ru. The shared portal.hr-link.ru will not match another tenant."
        },
        {
          "title": "Выпустите API-токен в меню профиля",
          "desc": "Иконка с инициалами в правом верхнем углу → «Получить API-токен», в диалоге «Скопировать». Токен действует год.",
          "title_en": "Issue the API token from the profile menu",
          "desc_en": "Initials icon in the top right corner → «Получить API-токен» (Get API token) → «Скопировать» (Copy). The token lasts a year."
        },
        {
          "title": "Возьмите clientId из GET /api/v2/currentUser",
          "desc": "Вызовите GET /api/v2/currentUser на своём адресе с заголовком User-Api-Token и возьмите currentUser.clientUsers[].client.id, это UUID.",
          "title_en": "Get clientId from GET /api/v2/currentUser",
          "desc_en": "Call GET /api/v2/currentUser on your tenant address with the User-Api-Token header and take currentUser.clientUsers[].client.id, a UUID."
        }
      ]
    },
    "seo": {
      "title": "Подключение к КЭДО HRlink: документы, ждущие подписи",
      "description": "Интеграция КЭДО HRlink по API: агент найдёт 47 кадровых документов, которые ждут подписи, и 31 сотрудника, не ознакомленного с ЛНА, и сверит реестр сотрудников.",
      "headline": "ИИ для HR: находите кадровые документы, зависшие без подписи",
      "scenarios": [
        {
          "title": "Документы без подписи",
          "desc": "Агент покажет, какие кадровые документы зависли без подписи и за кем из сотрудников числится задержка."
        },
        {
          "title": "Сверка реестра сотрудников",
          "desc": "Агент сверит сотрудников по юрлицам, подразделениям и должностям и найдёт пропуски в карточках."
        },
        {
          "title": "Заявления и график отпусков",
          "desc": "Агент соберёт поданные заявления и график отпусков и покажет, чьи отпуска начинаются на ближайшей неделе."
        },
        {
          "title": "Ознакомление с ЛНА",
          "desc": "Агент сверит реестр локальных нормативных актов с документами сотрудников и назовёт тех, кто ещё не ознакомлен."
        },
        {
          "title": "Печатная форма документа",
          "desc": "Агент найдёт нужный приказ или допсоглашение по сотруднику и дате, поднимет печатную форму и перескажет, что именно в ней записано."
        },
        {
          "title": "Понедельничная сводка кадровика",
          "desc": "Агент по понедельникам собирает свежие заявления, новые документы и просроченные подписания по всем юрлицам и присылает одним списком."
        }
      ],
      "how_it_works": [
        "Агент ходит в API HRlink на адрес вашего тенанта (по умолчанию portal.hr-link.ru) и читает кадровый контур целиком: документы и их печатные формы, заявления, сотрудников, юрлица, подразделения и должности, типы документов, реестр ЛНА, доверенности и график отпусков. Из этих реестров он собирает то, ради чего их обычно и открывают: что зависло без подписи, у кого пропуски в карточке и чьи отпуска начинаются на ближайшей неделе.",
        "В КЭДО общий статус документа мало что говорит: подписание это маршрут, и задержка всегда персональна. Поэтому агент раскрывает документ по участникам и называет конкретного сотрудника, за которым числится ожидание, а не просто помечает пачку неподписанной. Ознакомление с ЛНА устроено так же: отдельного флажка «ознакомлен» нет, есть документ у сотрудника, и агент сверяет реестр актов со списками документов, чтобы найти пропущенных.",
        "Всё, что меняет данные в HRlink, агент делает только после вашего подтверждения в чате: отправить черновики на подписание, напомнить следующему подписанту, запустить аннулирование, уволить сотрудника датой или загрузить справочники из учётной системы. Подписывать за сотрудников он не может: подпись ставит сам сотрудник в HRlink. На выходе он даёт сведённый список: кто задерживает, чего не хватает в карточках, кого нужно догнать по ЛНА, со ссылками на конкретные документы.",
        "Реестры HRlink отдаются страницами, и агент дочитывает выборку до конца: иначе зависших документов оказалось бы ровно столько, сколько поместилось в один ответ. Печатные формы он поднимает только по тем документам, о которых спросили, а не выкачивает архив целиком. Объём видимого задаёт владелец токена: агент работает с теми юрлицами и подразделениями, что открыты ему. Частоту запросов он выдерживает сам, а про нехватку прав говорит прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Действующая лицензия HRlink КЭДО у вашей компании.",
        "Роль «Кадровик» у сотрудника, чьим токеном подключаетесь."
      ],
      "faq": [
        {
          "q": "Как подключить HRlink КЭДО?",
          "a": "Тремя полями: clientId, API-токен и адрес тенанта. Токен выпускает сотрудник с ролью «Кадровик» в меню профиля («Получить API-токен»), действует он год. clientId возьмите из ответа GET /api/v2/currentUser, а адрес укажите, если ваш тенант отличается от portal.hr-link.ru. Вместо токена кадровика подойдёт мастер-токен интеграции HRlink: с ним укажите ещё пользователя, от чьего имени работает агент (ID в HRlink, СНИЛС или внешний ID)."
        },
        {
          "q": "Что агент видит в HRlink?",
          "a": "Кадровые документы и их печатные формы, заявления, сотрудников, юрлица, подразделения и должности, типы документов, реестр ЛНА, доверенности и график отпусков."
        },
        {
          "q": "Пишет ли агент в HRlink?",
          "a": "Только после вашего подтверждения в чате: отправка на подписание, напоминание подписанту, аннулирование, увольнение датой и загрузка справочников. Подписывать документы за сотрудников агент не может."
        },
        {
          "q": "Почему реестры отвечают 403?",
          "a": "У сотрудника, чьим токеном подключён HRlink, нет роли «Кадровик» в юрлице. Без неё пункт выдачи токена не появляется в меню, а реестры сотрудников и документов закрыты."
        },
        {
          "q": "Что делают ИИ-агенты для HR?",
          "a": "Агенты ведут рутину кадрового контура: показывают документы, зависшие без подписи, и называют, за кем именно задержка; сверяют реестр сотрудников по юрлицам, подразделениям и должностям; собирают заявления и график отпусков; находят тех, кто не ознакомлен с ЛНА. Подписывать за сотрудников агент не будет: подпись ставит сам сотрудник."
        },
        {
          "q": "Подойдёт ли ИИ для отдела кадров?",
          "a": "Да, если кадровый документооборот у вас ведётся в HRlink. Отдел кадров получает понедельничную сводку по свежим заявлениям, новым документам и просроченным подписаниям сразу по всем юрлицам вместо ручного обхода реестров по каждому."
        }
      ]
    },
    "seo_en": {
      "title": "HRlink and AI agent: HR documents waiting for a signature",
      "description": "47 HR documents waiting for signatures and 31 employees who have not acknowledged policies: the agent finds them in HRlink through your tenant's API.",
      "headline": "Find the HR documents stuck without a signature",
      "scenarios": [
        {
          "title": "Documents left unsigned",
          "desc": "The agent shows which HR documents are stuck without a signature and which employees the delay sits with."
        },
        {
          "title": "Checking the employee register",
          "desc": "The agent cross-checks employees against legal entities, departments and positions and finds the gaps in their records."
        },
        {
          "title": "Applications and the vacation schedule",
          "desc": "The agent collects submitted applications and the vacation schedule and shows whose time off starts in the coming week."
        },
        {
          "title": "Acknowledgement of internal policies",
          "desc": "The agent compares the register of local regulations with employee documents and names everyone who has not acknowledged them yet."
        },
        {
          "title": "The printable form of a document",
          "desc": "The agent finds the order or addendum you need by employee and date, pulls up its printable form and retells what is actually written in it."
        },
        {
          "title": "Monday digest for HR",
          "desc": "The agent collects fresh applications, new documents and overdue signatures across every legal entity each Monday and sends them over as one list."
        }
      ],
      "how_it_works": [
        "The agent calls the HRlink API at your tenant address (portal.hr-link.ru by default) and reads the whole HR perimeter: documents and their printable forms, applications, employees, legal entities, departments and positions, document types, the register of local regulations, powers of attorney and the vacation schedule. Out of those registers it assembles what people usually open them for: what is stuck without a signature, whose record has gaps and whose time off starts in the coming week.",
        "In HR document flow the overall document status says little: signing is a route, and a delay is always personal. So the agent breaks a document down by participant and names the specific employee the wait sits with, instead of simply marking a batch as unsigned. Acknowledgement of local regulations works the same way: there is no separate acknowledged flag, there is a document on the employee's side, and the agent compares the register of regulations against document lists to find who was missed.",
        "Anything that changes data in HRlink the agent does only after you confirm it in the chat: sending drafts out for signing, reminding the next signer, starting an annulment, dismissing an employee as of a date or loading reference data from your accounting system. It cannot sign on behalf of employees: each employee signs in HRlink themselves. Its output is a reconciled list: who is holding things up, what is missing from records, who still has to be caught up on the regulations, with links to the specific documents.",
        "HRlink hands its registers back in pages, and the agent reads a selection to the end: otherwise there would be exactly as many stuck documents as fitted into one response. Printable forms are pulled only for the documents actually asked about, rather than downloading the whole archive. The scope of what is visible is set by the token's owner: the agent works with the legal entities and departments open to them. It holds the request rate itself, and about missing permissions it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "An active HRlink HR EDF licence for your company.",
        "The HR officer role for the employee whose token you use."
      ],
      "faq": [
        {
          "q": "How do I connect HRlink HR EDF?",
          "a": "With three fields: clientId, an API token and the tenant address. The token is issued by an employee with the HR officer role from the profile menu (Get API token), and it is valid for a year. Take clientId from the response of GET /api/v2/currentUser, and enter the address if your tenant differs from portal.hr-link.ru. An HRlink integration master token works instead of the HR officer's token: with it, also name the user the agent acts as (HRlink ID, SNILS or external ID)."
        },
        {
          "q": "What does the agent see in HRlink?",
          "a": "HR documents and their printable forms, applications, employees, legal entities, departments and positions, document types, the register of local regulations, powers of attorney and the vacation schedule."
        },
        {
          "q": "Does the agent write to HRlink?",
          "a": "Only after you confirm it in the chat: sending for signing, reminding a signer, annulment, dismissal as of a date and loading reference data. The agent cannot sign documents on behalf of employees."
        },
        {
          "q": "Why do the registers return 403?",
          "a": "The employee whose token connects HRlink has no HR officer role in the legal entity. Without it the token issue item never appears in the menu, and the employee and document registers stay closed."
        },
        {
          "q": "What do AI agents do for HR?",
          "a": "They carry the routine of the HR circuit: they show the documents stuck without a signature and name exactly who the delay sits with; reconcile the employee register across legal entities, departments and positions; collect applications and the vacation schedule; and find who has not acknowledged the local regulations. The agent will not sign on behalf of employees: each employee signs themselves."
        },
        {
          "q": "Does it suit a personnel department?",
          "a": "Yes, if your HR document flow runs in HRlink. The personnel department gets a Monday digest of fresh applications, new documents and overdue signings across every legal entity at once, instead of walking the registers by hand for each one."
        }
      ]
    }
  },
  {
    "key": "iec104",
    "name": "IEC 60870-5-104",
    "name_en": "IEC 60870-5-104",
    "description": "Телемеханика подстанций и КП по МЭК 60870-5-104 через сервер сбора на объекте, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "iec104",
    "description_en": "Read-only substation and RTU telemetry over IEC 60870-5-104 through an on-site collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Выделите сбору отдельное соединение",
          "desc": "На КП или ЦППС заведите подключение ведущего для программы сбора данных. Соединение SCADA занимать нельзя: STARTDT на нём заберёт события у диспетчера.",
          "title_en": "Give data collection its own connection",
          "desc_en": "On the outstation or the data concentrator, set up a master connection for data collection. Do not take the SCADA's one: a STARTDT on it takes events away from dispatch."
        },
        {
          "title": "Откройте TCP 2404 до станции",
          "desc": "Программа сбора подключается к станции по TCP, по умолчанию на порт 2404. Если станция принимает ведущих только с известных адресов, добавьте адрес сервера сбора.",
          "title_en": "Open TCP 2404 to the station",
          "desc_en": "The program connects to the station over TCP, port 2404 by default. If the station accepts masters only from known addresses, add the collection server's address."
        },
        {
          "title": "Возьмите перечень сигналов станции",
          "desc": "Общий адрес ASDU, адрес объекта и вид каждого сигнала (ТС, ТИ, ТИИ) берутся из перечня, который составил наладчик: каталога сигналов протокол не отдаёт.",
          "title_en": "Get the station's signal list",
          "desc_en": "Each signal's common ASDU address, object address and kind come from the list the integrator wrote: the protocol offers no catalog of signals."
        },
        {
          "title": "Узнайте, в каком поясе часы станции",
          "desc": "Метки времени МЭК 60870-5-104 не несут часового пояса. Уточните, ставит станция метки в UTC или по местному времени, и укажите это в подключении.",
          "title_en": "Check the time zone of the station's clock",
          "desc_en": "IEC 104 time tags carry no time zone. Find out whether the station stamps in UTC or local time, and enter it in the connection."
        },
        {
          "title": "Для нескольких ведущих: адрес источника",
          "desc": "Если станция обслуживает несколько ведущих и направляет ответы по адресу источника, узнайте адрес, выделенный программе сбора, от 0 до 255.",
          "title_en": "For several masters: originator address",
          "desc_en": "If the station serves several masters and routes answers by originator address, find out the address set aside for the collection program, from 0 to 255."
        }
      ]
    },
    "seo": {
      "title": "IEC 60870-5-104 и ИИ: энергия подстанции за сутки",
      "description": "Энергия по вводу за сутки и пик мощности из счётчиков телемеханики МЭК 104, положение выключателей подстанции. Опрашивает программа сбора на объекте, только чтение.",
      "headline": "Телемеханика подстанции по МЭК 60870-5-104 прямо в чате",
      "scenarios": [
        {
          "title": "Положение выключателей",
          "desc": "Агент прочитает положение выключателей и разъединителей по двухпозиционным ТС, а промежуточное или неопределённое положение покажет как недостоверное."
        },
        {
          "title": "Телеизмерения",
          "desc": "Агент покажет текущие мощности, токи и напряжения из перечня сигналов станции с единицами, которые заданы в подключении."
        },
        {
          "title": "Счётчики энергии",
          "desc": "Агент прочитает интегральные суммы ТИИ и посчитает расход за смену или сутки по их истории, не фиксируя счётчики на станции."
        },
        {
          "title": "Недостоверные сигналы",
          "desc": "Агент найдёт сигналы с флагами IV, NT, SB или BL: недостоверные, неактуальные, замещённые оператором и заблокированные."
        },
        {
          "title": "История переключений",
          "desc": "Агент поднимет, когда выключатель менял положение за период, по меткам времени, которые ставит сама станция."
        },
        {
          "title": "Задача по порогу",
          "desc": "Агент заведёт задачу по событию: например, мощность присоединения выше порога дольше пяти минут. Задача сработает на начале и на снятии условия."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и отправляет данные наружу только исходящим соединением. В подключении указывается адрес станции вида tcp://10.0.12.5:2404 и перечень сигналов: путь, общий адрес и адрес объекта, вид сигнала (sp, dp, me или it).",
        "Программа сбора работает как ведущий: держит соединение открытым, после STARTDT делает общий опрос и затем принимает спорадические изменения, которые станция шлёт сама. Общий опрос повторяется раз в 15 минут и после рестарта станции, опрос счётчиков включается отдельно. Подключение считается живым, только когда станция подтвердила STARTDT и отвечает в пределах таймеров t1 и t3 стандарта.",
        "Подключение только читает. Программа сбора отправляет станции ровно два вида запросов: общий опрос и опрос счётчиков без фиксации. Команд телеуправления, уставок, синхронизации часов, фиксации или сброса счётчиков он не формирует, поэтому агент не может ни переключить выключатель, ни сдвинуть регистр, который читает учёт.",
        "Флаги качества переходят в значение: IV делает его недостоверным, NT, SB, BL и переполнение делают сомнительным. Метки времени CP56Time2a читаются в поясе, указанном в подключении, а значение без метки получает время сервера сбора. Если станция отказала в общем опросе, сигналы этой станции без значения помечаются недостоверными с причиной отказа."
      ],
      "requirements": [
        "Станция, КП или ЦППС с МЭК 60870-5-104 (IEC 104) по TCP",
        "Отдельное соединение ведущего на станции для программы сбора",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к станции по TCP 2404",
        "Перечень сигналов станции: общий адрес, адрес объекта и вид сигнала"
      ],
      "faq": [
        {
          "q": "Как подключить МЭК 60870-5-104?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите МЭК 60870-5-104 и укажите адрес станции, например tcp://10.0.12.5:2404, и перечень сигналов по строке на сигнал: путь, общий адрес:адрес объекта и вид, например 1:4001 me. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в МЭК 60870-5-104?",
          "a": "Одно- и двухпозиционные ТС, телеизмерения (нормализованные, масштабированные и с плавающей точкой) и интегральные суммы ТИИ из вашего перечня, с флагами качества, метками времени станции и историей значений."
        },
        {
          "q": "Может ли агент переключить выключатель?",
          "a": "Нет. Программа сбора не формирует ни одной команды телеуправления, уставки или синхронизации часов: он отправляет станции только общий опрос и опрос счётчиков без фиксации, которые ничего на станции не меняют."
        },
        {
          "q": "Метки времени сдвинуты на несколько часов. Что не так?",
          "a": "Метка CP56Time2a не несёт часового пояса, и станции ставят её по-разному: в UTC или по местному времени. Укажите в подключении utc или постоянное смещение, например +03:00, в котором ставит метки ваша станция."
        }
      ]
    },
    "seo_en": {
      "title": "IEC 60870-5-104 and AI: substation energy per day",
      "description": "Daily energy per incomer and the power peak from IEC 104 telecontrol totals, plus substation breaker positions. An on-site collection program polls them, read-only.",
      "headline": "Substation telemetry over IEC 60870-5-104 right in the chat",
      "scenarios": [
        {
          "title": "Breaker positions",
          "desc": "The agent reads the position of breakers and disconnectors from double points, and shows an intermediate or indeterminate position as bad."
        },
        {
          "title": "Measured values",
          "desc": "The agent shows current power, currents and voltages from the station's signal list with the units set in the connection."
        },
        {
          "title": "Energy counters",
          "desc": "The agent reads integrated totals and works out consumption per shift or day from their history, without freezing the counters at the station."
        },
        {
          "title": "Invalid signals",
          "desc": "The agent finds signals flagged IV, NT, SB or BL: invalid, not topical, substituted by an operator and blocked."
        },
        {
          "title": "Switching history",
          "desc": "The agent pulls when a breaker changed position over a period, by the time tags the station itself sets."
        },
        {
          "title": "Threshold task",
          "desc": "The agent sets up an event task: for example, a feeder's power above a threshold for more than five minutes. The task fires when the condition starts and when it clears."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server in the site network and sends data out over an outgoing connection only. The connection takes the station address, such as tcp://10.0.12.5:2404, and the signal list: path, common address and object address, signal kind (sp, dp, me or it).",
        "The collection program acts as the controlling station: it keeps the connection open, runs a general interrogation after STARTDT and then takes the spontaneous changes the station sends on its own. The general interrogation repeats every 15 minutes and after a station restart, and the counter interrogation is turned on separately. The connection counts as live only once the station has confirmed STARTDT and answers within the standard's t1 and t3 timers.",
        "The connection only reads. The program sends the station exactly two kinds of request: the general interrogation and the counter interrogation without freeze. It frames no control commands, setpoints, clock synchronisation, counter freezes or resets, so the agent can neither switch a breaker nor move the register that metering reads.",
        "Quality flags pass into the value: IV makes it bad, while NT, SB, BL and overflow make it uncertain. CP56Time2a time tags are read in the zone set in the connection, and a value without a time tag gets the collection server's time. If the station refuses the general interrogation, its signals without a value are marked bad with the refusal cause."
      ],
      "requirements": [
        "A station, RTU or data concentrator with IEC 60870-5-104 over TCP",
        "A separate master connection on the station for the collection program",
        "A collection server in the site network: Windows or Linux with Docker",
        "Access from the collection server to the station over TCP 2404",
        "The station's signal list: common address, object address and signal kind"
      ],
      "faq": [
        {
          "q": "How do I connect IEC 60870-5-104?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick IEC 60870-5-104 and enter the station address, for example tcp://10.0.12.5:2404, and the signal list with one line per signal: path, common address:object address and kind, for example 1:4001 me. The collection server is assigned automatically; if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in IEC 60870-5-104?",
          "a": "Single and double points, measured values (normalized, scaled and floating point) and integrated totals from your list, with quality flags, the station's time tags and the value history."
        },
        {
          "q": "Can the agent switch a breaker?",
          "a": "No. The collection program frames no control, setpoint or clock synchronisation commands: it sends the station only the general interrogation and the counter interrogation without freeze, which change nothing at the station."
        },
        {
          "q": "Time tags are off by a few hours. What is wrong?",
          "a": "A CP56Time2a time tag carries no time zone, and stations differ: some stamp in UTC, some in local time. Enter utc or a fixed offset, for example +03:00, matching how your station stamps its times."
        }
      ]
    }
  },
  {
    "key": "ignition",
    "name": "Ignition",
    "name_en": "Ignition",
    "description": "Теги и история Ignition через модуль WebDev и программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ignition",
    "description_en": "Read-only Ignition tags and history through the WebDev module and a data collection program",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Проверьте модуль WebDev",
          "desc": "Программа сбора данных читает Ignition через ресурсы модуля WebDev. Убедитесь, что модуль установлен на гейтвее Ignition 8.1 или 8.3.",
          "title_en": "Check the WebDev module",
          "desc_en": "The data collection program reads Ignition through WebDev module resources. Make sure the module is installed on the Ignition 8.1 or 8.3 gateway."
        },
        {
          "title": "Импортируйте ресурсы в проект",
          "desc": "В Designer добавьте библиотеку проекта equipment_gateway и в WebDev папку equipment-gateway с ресурсами about, tags, values, history, у каждого только doGet.",
          "title_en": "Import the resources into a project",
          "desc_en": "In Designer add the project library equipment_gateway and, in WebDev, a folder equipment-gateway with resources about, tags, values, history, each with doGet only."
        },
        {
          "title": "Заведите учётку без права записи",
          "desc": "Включите для ресурсов аутентификацию по источнику пользователей и заведите учётку без права записи тегов. Её логин и пароль впишите в подключение.",
          "title_en": "Add an account without write rights",
          "desc_en": "Require authentication with a user source for the resources and add an account with no right to write tags. Enter its login and password in the connection."
        },
        {
          "title": "Включите историю нужных тегов",
          "desc": "История читается у тегов с включённой History Enabled. Остальные теги программа сбора читает по текущему значению.",
          "title_en": "Enable history on the tags you need",
          "desc_en": "History is read for tags with History Enabled. The collection program reads other tags by their current value."
        },
        {
          "title": "Откройте веб-порт гейтвея",
          "desc": "Серверу сбора нужен доступ к веб-порту Ignition, по умолчанию 8088. Адрес папки: http://хост:8088/system/webdev/Project/equipment-gateway.",
          "title_en": "Open the Ignition gateway web port",
          "desc_en": "The collection server needs access to the Ignition web port, 8088 by default. The folder address is http://host:8088/system/webdev/Project/equipment-gateway."
        }
      ]
    },
    "seo": {
      "title": "Теги Ignition и ИИ-агент: качество bad и тренд за смену",
      "description": "Какие теги Ignition сейчас с качеством bad или uncertain и с какого времени, плюс тренд историана за смену. Чтение через модуль WebDev и программу сбора.",
      "headline": "Теги и история Ignition прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги провайдера по имени или описанию и покажет текущие значения с единицами, временем и качеством."
        },
        {
          "title": "Тренд за смену",
          "desc": "Агент прочитает историю тега из историана Ignition за смену или неделю и назовёт минимум, максимум, среднее и выходы за диапазон."
        },
        {
          "title": "Теги с плохим качеством",
          "desc": "Агент найдёт теги с качеством bad или uncertain и покажет код качества Ignition и время, с которого он стоит."
        },
        {
          "title": "Сравнение линий",
          "desc": "Агент сравнит одинаковые теги разных папок или линий за период и покажет, где значения расходятся."
        },
        {
          "title": "Сообщение о пороге",
          "desc": "В задаче «По событию» агент сообщит, когда значение тега выйдет за порог и продержится заданное время, и когда вернётся в норму."
        },
        {
          "title": "Связь с объектом",
          "desc": "Агент скажет, когда сервер сбора пропал со связи и когда вернулся. Историю за перерыв программа сбора дочитает из архива Ignition."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и обращается к гейтвею Ignition по HTTP, а наружу отправляет данные только исходящим соединением. Значения и история читаются через четыре ресурса WebDev, которые импортируются в один проект: about, tags, values и history. В подключении указывается адрес их папки, логин и пароль учётки, провайдер тегов и, при желании, папка, с которой начинать.",
        "Gateway REST API в Ignition 8.3 настраивает гейтвей, но не отдаёт ни значений тегов, ни истории, а сервер OPC UA в Ignition не поддерживает HistoryRead. Поэтому ресурсы вызывают system.tag.readBlocking и system.historian.queryRawPoints в 8.3 или system.tag.queryTagHistory в 8.1. История читается окнами по 15 минут, так что SQL Historian не перечитывает весь период на каждой странице.",
        "Каждый ресурс отвечает только на GET, и ни один не пишет теги, а учётке подключения права записи не дают. Программа сбора не ходит через прокси и не следует переадресациям, чтобы не унести учётку на другой хост. Массивы, DataSet и Document не объявляются: значения, которое она переносит, у них нет.",
        "Программа сбора читает архив каждого тега вперёд от места, где остановился, с запасом в минуту, поэтому событие, которое store-and-forward Ignition записал с опозданием, тоже дойдёт. После простоя она дочитывает пропущенное, но не дальше недели назад. Теги без истории читаются по текущему значению с периодом опроса, по умолчанию 10 секунд."
      ],
      "requirements": [
        "Ignition 8.1 или 8.3 с модулем WebDev",
        "Ресурсы программы сбора, импортированные в один проект Ignition",
        "Учётка источника пользователей без права записи тегов",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к веб-порту гейтвея Ignition (по умолчанию 8088)"
      ],
      "faq": [
        {
          "q": "Как подключить Ignition?",
          "a": "Импортируйте в проект библиотеку equipment_gateway и папку WebDev equipment-gateway с ресурсами about, tags, values и history, включите для неё аутентификацию. В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование»; если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Ignition и укажите адрес папки вида http://10.0.12.5:8088/system/webdev/Project/equipment-gateway, логин и пароль; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Ignition?",
          "a": "Атомарные теги выбранного провайдера и папки с типом, единицами, диапазоном и описанием, их текущие значения с качеством и историю тегов, у которых она включена. Версию Ignition программа сбора читает из ресурса about."
        },
        {
          "q": "Меняет ли агент значения тегов?",
          "a": "Нет. Ресурсы отвечают только на GET и вызывают только функции чтения тегов и истории, а программа сбора не умеет отправлять другие запросы. Учётке подключения права записи тегов не дают."
        },
        {
          "q": "Почему у части тегов нет истории?",
          "a": "Программа сбора читает архив только у тегов с включённой History Enabled. Остальные он читает по текущему значению, и их история копится из этих опросов. Если историан отклонил запрос истории тега, этот тег тоже переходит на чтение текущего значения."
        }
      ]
    },
    "seo_en": {
      "title": "Ignition tags and an AI agent: bad quality and trends",
      "description": "Which Ignition tags report bad or uncertain quality and since when, plus a shift trend from the historian, read via the WebDev module and a collection program.",
      "headline": "Ignition tags and history right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds the provider's tags by name or description and shows current values with units, time and quality."
        },
        {
          "title": "A shift trend",
          "desc": "The agent reads a tag's history from the Ignition historian for a shift or a week and names the minimum, maximum, average and range breaches."
        },
        {
          "title": "Tags with bad quality",
          "desc": "The agent finds tags with bad or uncertain quality and shows the Ignition quality code and the time it has stood since."
        },
        {
          "title": "Comparing lines",
          "desc": "The agent compares the same tags of different folders or lines over a period and shows where the values part."
        },
        {
          "title": "A threshold message",
          "desc": "In an event task the agent tells you when a tag's value crosses a threshold and holds for the set time, and when it is back to normal."
        },
        {
          "title": "Link to the site",
          "desc": "The agent tells you when the collection server went offline and came back. The collection program reads the history of the break from the Ignition archive."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network, reaches the Ignition gateway over HTTP and sends data out only over an outbound connection. Values and history are read through four WebDev resources imported into one project: about, tags, values and history. The connection takes the address of their folder, the account login and password, the tag provider and, if you like, the folder to start from.",
        "The Ignition 8.3 Gateway REST API configures the gateway but returns neither tag values nor history, and the Ignition OPC UA server does not support HistoryRead. So the resources call system.tag.readBlocking and system.historian.queryRawPoints on 8.3, or system.tag.queryTagHistory on 8.1. History is read in 15 minute windows, so a SQL Historian does not reread the whole period on every page.",
        "Every resource answers GET only and none writes a tag, and the connection account gets no write rights. The collection program uses no proxy and follows no redirects, so the account is never carried to another host. Arrays, DataSet and Document tags are not declared: they hold no value the program carries.",
        "The collection program reads each tag's archive forward from where it stopped, with a one minute overlap, so an event Ignition store-and-forward wrote late still arrives. After downtime it reads what it missed, but no further back than a week. Tags without history are read by their current value at the poll interval, 10 seconds by default."
      ],
      "requirements": [
        "Ignition 8.1 or 8.3 with the WebDev module",
        "The collection program resources imported into one Ignition project",
        "A user source account with no right to write tags",
        "A collection server on the site network: Windows or Linux with Docker",
        "Collection server access to the Ignition gateway web port (8088 by default)"
      ],
      "faq": [
        {
          "q": "How do I connect Ignition?",
          "a": "Import the equipment_gateway library and the WebDev folder equipment-gateway with resources about, tags, values and history into a project and require authentication for it. In Integrations → \"Equipment\" click \"Connect equipment\"; if there is no collection server yet, install the data collection program with one command from the window. Then pick Ignition and enter the folder address such as http://10.0.12.5:8088/system/webdev/Project/equipment-gateway, a login and password; the collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in Ignition?",
          "a": "Atomic tags of the chosen provider and folder with type, units, range and description, their current values with quality, and the history of tags that have it enabled. The collection program reads the Ignition version from the about resource."
        },
        {
          "q": "Does the agent change tag values?",
          "a": "No. The resources answer GET only and call only tag and history read functions, and the collection program cannot send any other request. The connection account gets no right to write tags."
        },
        {
          "q": "Why do some tags have no history?",
          "a": "The collection program reads the archive only for tags with History Enabled. Others it reads by current value, and their history builds up from those polls. If the historian refuses a tag's history request, that tag also switches to current value reads."
        }
      ]
    }
  },
  {
    "key": "imap_mail",
    "name": "Почта по IMAP",
    "name_en": "IMAP Mail",
    "description": "Ящик на своём домене или корпоративный сервер по IMAP и SMTP: письма, папки, отправка и пересылка",
    "category": "mail",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "imap-mail",
    "description_en": "A mailbox on your domain or company server over IMAP and SMTP: messages, folders, sending",
    "search_terms": [
      "imap",
      "smtp",
      "имап",
      "почта на домене",
      "корпоративная почта",
      "рег.ру",
      "reg.ru",
      "хостинг",
      "beget",
      "timeweb"
    ],
    "guide": {
      "steps": [
        {
          "title": "Возьмите адрес и пароль ящика",
          "desc": "У ящика на хостинге это обычно пароль самого ящика из панели. Почтовому сервису с двухэтапной проверкой нужен пароль приложения.",
          "title_en": "Get the mailbox address and password",
          "desc_en": "At a hosting provider this is usually the mailbox's own password from the panel. A mail service with 2-step verification needs an app password."
        },
        {
          "title": "Сначала сохраните только адрес и пароль",
          "desc": "При сохранении сервер ищется по домену адреса. Не нашёлся: в «Дополнительно» впишите серверы IMAP и SMTP из панели хостинга.",
          "title_en": "Save with the address and password first",
          "desc_en": "Saving looks up the server from the address domain. If it is not found, enter the IMAP and SMTP servers from the hosting panel under Advanced."
        },
        {
          "title": "Корпоративный сервер: доступ из интернета",
          "desc": "Сервер только во внутренней сети не подключится. Microsoft 365 паролем не подключается: для него есть Outlook Почта.",
          "title_en": "Corporate server: reachable from the internet",
          "desc_en": "A server only on an internal network will not connect. Microsoft 365 does not connect with a password: use Outlook Mail for it."
        }
      ]
    },
    "seo": {
      "title": "Почта по IMAP и ИИ-агент: заявки с сайта без ответа",
      "description": "За неделю видно, сколько заявок с формы сайта пришло на info@ и какие остались без ответа. Подходит ящик на своём домене или корпоративный сервер.",
      "headline": "Подключите почту на своём домене к агенту по IMAP",
      "scenarios": [
        {
          "title": "Разбор входящих за утро",
          "desc": "Агент пройдёт по непрочитанным письмам в ящике компании и покажет, какие ждут ответа, с темой, отправителем и датой."
        },
        {
          "title": "Заявки с сайта в одну таблицу",
          "desc": "Агент найдёт письма с формы сайта за период, достанет из них имя, телефон и вопрос и соберёт таблицу заявок."
        },
        {
          "title": "Счета и акты из вложений",
          "desc": "Агент найдёт письмо по отправителю или теме, достанет вложенный счёт, акт или договор и разберёт его содержимое."
        },
        {
          "title": "Ответ клиенту с адреса компании",
          "desc": "Агент напишет ответ в переписку, перешлёт письмо коллеге или отправит новое письмо с вашего адреса на домене через SMTP."
        },
        {
          "title": "Порядок в папках",
          "desc": "Агент разложит письма по папкам, отметит разобранные прочитанными и удалит то, что не нужно хранить."
        },
        {
          "title": "Кто пишет чаще всего",
          "desc": "Агент посчитает месяц почты по отправителям и покажет, кто наполняет ящик и сколько писем так и не открыто."
        }
      ],
      "how_it_works": [
        "Подключается ящик с доступом по IMAP и SMTP из интернета: почта на своём домене у хостинга (REG.RU, Beget, Timeweb и другие), корпоративный почтовый сервер или почтовый сервис. Сервер только во внутренней сети не подключится, а Microsoft 365 подключается через Outlook Почту, не паролем. Агент читает список папок, а дальше работает с письмами: темой, отправителем, датой, текстом и вложениями.",
        "Для подключения нужны адрес и пароль ящика. При сохранении сервер ищется по домену адреса и записывается в подключение. Если он не нашёлся, имена серверов IMAP и SMTP берутся из панели хостинга и вписываются в разделе «Дополнительно». Там же порт, шифрование и отдельный логин.",
        "IMAP это сам ящик, а не его копия: отметка о прочтении, перенос в папку и удаление применяются на сервере и сразу видны во всех почтовых программах. Удаление по умолчанию переносит письмо в корзину ящика, а не стирает его. POP3 не поддерживается.",
        "Доступ ограничен одним ящиком, тем, чей адрес и пароль подключены. Если вход не прошёл, сервер не ответил или письма по запросу не нашлись, агент говорит об этом прямо, а не показывает вместо них пустой список."
      ],
      "requirements": [
        "Адрес ящика и его пароль.",
        "Включённый доступ по IMAP и SMTP на сервере, доступном из интернета.",
        "Агент читает все папки ящика и отправляет письма от вашего имени."
      ],
      "faq": [
        {
          "q": "Какую почту можно подключить?",
          "a": "Ящик с доступом по IMAP и SMTP из интернета: почту на своём домене у хостинга, корпоративный сервер или почтовый сервис. Сервер только во внутренней сети не подключится. Microsoft 365 подключается через Outlook Почту, не паролем. POP3 не поддерживается."
        },
        {
          "q": "Где взять адрес сервера?",
          "a": "При сохранении сервер ищется по адресу ящика. Если он не нашёлся, имена серверов IMAP и SMTP указаны в панели хостинга, их вписывают в разделе «Дополнительно». Например, у REG.RU это mail.hosting.reg.ru, IMAP 993 и SMTP 465 с SSL."
        },
        {
          "q": "Какой пароль вводить?",
          "a": "Пароль самого ящика. Если почтовый сервис требует двухэтапную проверку, нужен пароль приложения из его настроек."
        },
        {
          "q": "Почему агент не видит старые письма?",
          "a": "Скорее всего, ящик забирает Outlook по POP3 и удаляет письма с сервера. В настройках учётной записи Outlook включите хранение копий сообщений на сервере."
        }
      ]
    },
    "seo_en": {
      "title": "IMAP Mail and AI agent: unanswered website leads",
      "description": "See how many website form leads reached info@ this week and which are still unanswered. Works with a mailbox on your own domain or a company mail server.",
      "headline": "Connect the mailbox on your own domain to the agent over IMAP",
      "scenarios": [
        {
          "title": "Morning inbox triage",
          "desc": "The agent goes through unread messages in the company mailbox and shows which ones are waiting for a reply, with subject, sender and date."
        },
        {
          "title": "Website leads in one table",
          "desc": "The agent finds the website form messages over a period, pulls out the name, phone and question and builds a table of leads."
        },
        {
          "title": "Invoices and acts out of attachments",
          "desc": "The agent finds a message by sender or subject, pulls out the attached invoice, act or contract and reads what is inside."
        },
        {
          "title": "Replying from the company address",
          "desc": "The agent writes a reply in the thread, forwards a message to a colleague or sends a new email from your domain address over SMTP."
        },
        {
          "title": "Tidy folders",
          "desc": "The agent sorts messages into folders, marks the handled ones as read and deletes what does not need keeping."
        },
        {
          "title": "Who writes the most",
          "desc": "The agent counts a month of mail by sender and shows who fills the mailbox and how many messages were never opened."
        }
      ],
      "how_it_works": [
        "A mailbox with IMAP and SMTP access from the internet connects: mail on your own domain at a hosting provider (REG.RU, Beget, Timeweb and others), a corporate mail server or a mail service. A server only on an internal network will not connect, and Microsoft 365 connects through Outlook Mail, not with a password. The agent reads the folder list, then works with the messages: subject, sender, date, text and attachments.",
        "Connecting takes the mailbox address and password. Saving looks up the server from the address domain and writes it into the connection. If it is not found, the IMAP and SMTP server names come from the hosting panel and go under Advanced, along with the port, encryption and a separate login.",
        "IMAP is the mailbox itself, not a copy: a read flag, a move to a folder and a deletion are applied on the server and show up in every mail program at once. Deleting moves a message to the mailbox Trash by default rather than erasing it. POP3 is not supported.",
        "Access is limited to one mailbox, the one whose address and password are connected. If sign-in fails, the server does not answer or the messages you asked for were not found, the agent says so directly instead of showing an empty list."
      ],
      "requirements": [
        "The mailbox address and its password.",
        "IMAP and SMTP access turned on, on a server reachable from the internet.",
        "The agent reads every folder and sends mail on your behalf."
      ],
      "faq": [
        {
          "q": "Which mail can I connect?",
          "a": "A mailbox with IMAP and SMTP access from the internet: mail on your own domain at a hosting provider, a corporate server or a mail service. A server only on an internal network will not connect. Microsoft 365 connects through Outlook Mail, not with a password. POP3 is not supported."
        },
        {
          "q": "Where do I find the server address?",
          "a": "Saving looks it up from the mailbox address. If it is not found, the IMAP and SMTP server names are listed in your hosting panel and go under Advanced. For example, REG.RU uses mail.hosting.reg.ru, IMAP 993 and SMTP 465 with SSL."
        },
        {
          "q": "Which password do I enter?",
          "a": "The mailbox's own password. If the mail service requires 2-step verification, you need an app password from its settings."
        },
        {
          "q": "Why doesn't the agent see older messages?",
          "a": "Most likely Outlook collects the mailbox over POP3 and deletes messages from the server. In the Outlook account settings turn on keeping copies of messages on the server."
        }
      ]
    }
  },
  {
    "key": "kaiten",
    "name": "Kaiten",
    "name_en": "Kaiten",
    "description": "Доски, карточки, спринты, пространства",
    "category": "pm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "kaiten",
    "description_en": "Boards, cards, sprints and spaces",
    "search_terms": [
      "кайтен"
    ],
    "signup_url": "https://passport.kaiten.ru/ru/registration",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://kaiten.ru",
      "steps": [
        {
          "title": "Войдите под аккаунтом с нужными досками",
          "desc": "Ключ наследует права создателя: агент увидит ровно те пространства, доски и карточки, что открыты этому пользователю.",
          "title_en": "Sign in with an account that sees the boards",
          "desc_en": "The key inherits the rights of whoever created it: the agent sees exactly the spaces, boards and cards that user can open. A private space stays invisible."
        },
        {
          "title": "Скопируйте адрес Kaiten из адресной строки",
          "desc": "В облаке это https://ваша-компания.kaiten.ru, без пути и слэша в конце. Если Kaiten стоит на своих серверах, возьмите домен, по которому вы открываете доски.",
          "title_en": "Copy your Kaiten address from the browser bar",
          "desc_en": "In the cloud it looks like https://your-company.kaiten.ru, with no path and no trailing slash. If Kaiten is self-hosted, use the domain you open your boards at."
        },
        {
          "title": "Откройте «Ключ доступа API» в профиле",
          "desc": "Аватар в правом верхнем углу → «Настройки профиля», затем в левом меню «Ключ доступа API». Тот же экран открывается напрямую по адресу /profile/api-key.",
          "title_en": "Open \"API access key\" in your profile",
          "desc_en": "Avatar in the top right corner → \"Profile settings\", then \"API access key\" in the left menu. The same screen opens directly at /profile/api-key."
        },
        {
          "title": "Нажмите «+ Создать ключ» и скопируйте ключ",
          "desc": "Готовый ключ копируется иконкой рядом со строкой. Это UUID из 36 символов с дефисами вида 296a5709-99bc-49a7-96e0-c0a1b236091f; если нет, вы взяли не то поле.",
          "title_en": "Click \"Create key\" and copy the value",
          "desc_en": "Copy the generated key with the icon next to it: a 36-character UUID with hyphens, like 296a5709-99bc-49a7-96e0-c0a1b236091f."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Кайтен (Kaiten) с ИИ: просроченные карточки",
      "description": "Кайтен (Kaiten), облачный или на вашем сервере: агент найдёт 41 просроченную карточку на семи досках, 12 без ответственного, и заведёт карточки из обсуждения.",
      "headline": "Разбирайте карточки Kaiten по доскам и держите сроки",
      "scenarios": [
        {
          "title": "Разбор карточек по доскам",
          "desc": "Агент соберёт карточки по всем доступным доскам и покажет, что просрочено и что висит без ответственного."
        },
        {
          "title": "Карточка из обсуждения",
          "desc": "Агент заведёт карточку в нужном пространстве и колонке, проставит ответственного, срок и теги и допишет комментарий."
        },
        {
          "title": "Движение по колонкам",
          "desc": "Агент перенесёт карточку в другую колонку, обновит её поля и уберёт в архив то, что команда уже сделала."
        },
        {
          "title": "Утренняя сводка по доске",
          "desc": "Агент пришлёт сводку по доске к началу дня и отдельно предупредит о новой карточке, комментарии или файле."
        },
        {
          "title": "Кто чем загружен",
          "desc": "Агент разложит карточки пространства по ответственным и покажет, у кого сколько в работе и чьи сроки горят на этой неделе."
        },
        {
          "title": "Что решили в комментариях",
          "desc": "Агент прочитает комментарии и вложения по карточке, соберёт из обсуждения принятые решения и покажет, что осталось несогласованным."
        }
      ],
      "how_it_works": [
        "Агент ходит в API вашего Kaiten по адресу, который вы указали при подключении: облачный https://ваша-компания.kaiten.ru или собственный домен, если Kaiten стоит на ваших серверах. Он читает пространства, доски и колонки, карточки со сроками, ответственными, тегами, чек-листами и пользовательскими свойствами, комментарии и приложенные файлы, а из этого собирает разбор по доскам: что просрочено, что висит без ответственного, что не двигалось.",
        "Устройство Kaiten агент учитывает буквально: состояние работы здесь задаётся не отдельным полем статуса, а колонкой, в которой лежит карточка, поэтому «сделано» он определяет по положению на доске, а не по надписи в самой карточке. Структуру он читает так же буквально: пространство, доска, колонка, карточка, то есть четыре уровня, и один и тот же вопрос про просроченное на уровне доски и на уровне пространства даёт разные списки, поэтому агент всегда называет срез, по которому считал.",
        "На запись агент делает ровно то, о чём его попросили: заводит карточку в нужном пространстве и колонке, проставляет ответственного, срок и теги, дописывает комментарий, переносит карточку между колонками и досками, убирает готовое в архив. Перед переносом он проверяет, что доска и колонка существуют и открыты ключу, а после изменения перечитывает карточку, чтобы показать её фактическое состояние, а не то, что отправил.",
        "Частоту обращений агент выдерживает сам, чтобы не упереться в ограничения сервера, и большие доски забирает страницами, а не одним запросом. О новых карточках, комментариях и файлах он узнаёт вебхуками Kaiten, а не опросом по кругу, поэтому свежая карточка попадает в сводку без задержки на следующий обход. Если данных нет или ключ их не видит, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права на нужные пространства и доски у вашей учётной записи",
        "Вебхуки Kaiten, если о новой карточке нужно узнавать сразу"
      ],
      "faq": [
        {
          "q": "Как подключить Kaiten?",
          "a": "Двумя полями: API-ключ и адрес вашего Kaiten. Ключ создаётся в «Настройки профиля» → «Ключ доступа API» → «+ Создать ключ» и выглядит как UUID из 36 символов. Адрес возьмите из адресной строки: это https://ваша-компания.kaiten.ru или свой домен, если Kaiten стоит на ваших серверах."
        },
        {
          "q": "Что агент видит в Kaiten?",
          "a": "Пространства, доски, карточки, комментарии, чек-листы, теги, пользовательские свойства и участников, ровно те, что открыты владельцу ключа."
        },
        {
          "q": "Пишет ли агент в Kaiten?",
          "a": "Да: создаёт и обновляет карточки, переносит их между колонками и досками, добавляет комментарии и убирает готовые карточки в архив."
        },
        {
          "q": "Узнает ли агент о новой карточке сам?",
          "a": "Да, если настроить вебхуки Kaiten: агент получает события о создании и обновлении карточек, новых комментариях и приложенных файлах."
        }
      ]
    },
    "seo_en": {
      "title": "Kaiten integration with AI: overdue cards with no owner",
      "description": "41 overdue cards across seven boards, 12 with no owner. The agent walks your Kaiten boards, cloud or self-hosted, and turns a discussion into a new card.",
      "headline": "Triage Kaiten cards across boards and hold the deadlines",
      "scenarios": [
        {
          "title": "Card triage across boards",
          "desc": "The agent pulls cards from every board you can access and shows what is overdue and what has no assignee."
        },
        {
          "title": "A card straight from the discussion",
          "desc": "The agent creates a card in the right space and column, sets the assignee, due date and tags, and adds a comment."
        },
        {
          "title": "Moving cards through columns",
          "desc": "The agent moves a card to another column, updates its fields and archives whatever the team has already finished."
        },
        {
          "title": "Morning board digest",
          "desc": "The agent sends a board digest at the start of the day and pings you separately about a new card, comment or file."
        },
        {
          "title": "Who is carrying what",
          "desc": "The agent breaks the cards of a space down by assignee and shows how much each person has in flight and whose deadlines are burning this week."
        },
        {
          "title": "What was agreed in the comments",
          "desc": "The agent reads the comments and attachments on a card, pulls the decisions out of the discussion and shows what is still unsettled."
        }
      ],
      "how_it_works": [
        "The agent calls the API of your Kaiten at the address you entered when connecting: the cloud https://your-company.kaiten.ru or your own domain if Kaiten runs on your servers. It reads spaces, boards and columns, cards with their due dates, assignees, tags, checklists and custom properties, comments and attached files, and out of that assembles a triage across boards: what is overdue, what has no assignee, what has not moved.",
        "The agent takes the way Kaiten is built literally: the state of work here is set not by a separate status field but by the column the card sits in, so it reads «done» from the position on the board rather than from a label inside the card itself. It reads the structure just as literally: space, board, column and card are four levels, and the same question about what is overdue gives different lists at board level and at space level, so the agent always names the slice it counted on.",
        "When writing, the agent does exactly what it was asked for: it creates a card in the right space and column, sets the assignee, due date and tags, adds a comment, moves the card between columns and boards, and archives what is finished. Before a move it checks that the board and the column exist and are open to the key, and after a change it re-reads the card, so it shows the actual state rather than what it sent.",
        "The agent holds the request rate itself so as not to run into the server limits, and takes large boards page by page rather than in a single call. About new cards, comments and files it learns from Kaiten webhooks rather than by polling in circles, so a fresh card reaches the digest without waiting for the next sweep. If data is missing or the key cannot see it, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Rights to the spaces and boards you need on your account",
        "Kaiten webhooks, if new cards must reach you immediately"
      ],
      "faq": [
        {
          "q": "How do I connect Kaiten?",
          "a": "Two fields: an API key and the address of your Kaiten. Create the key under Profile settings, then API access key, then Create key; it looks like a 36-character UUID. Take the address from the address bar: it is https://your-company.kaiten.ru or your own domain if Kaiten runs on your servers."
        },
        {
          "q": "What does the agent see in Kaiten?",
          "a": "Spaces, boards, cards, comments, checklists, tags, custom properties and members, exactly the ones the key owner can open."
        },
        {
          "q": "Does the agent write to Kaiten?",
          "a": "Yes: it creates and updates cards, moves them between columns and boards, adds comments and archives finished cards."
        },
        {
          "q": "Will the agent notice a new card on its own?",
          "a": "Yes, if you set up Kaiten webhooks: the agent receives events about created and updated cards, new comments and attached files."
        }
      ]
    }
  },
  {
    "key": "kaspi",
    "name": "Kaspi.kz",
    "name_en": "Kaspi.kz",
    "description": "Казахстан: заказы, товары, отзывы, города и точки выдачи",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "kaspi",
    "description_en": "Kazakhstan: orders, products, reviews, cities and pickup points",
    "search_terms": [
      "каспи"
    ],
    "guide": {
      "url": "https://kaspi.kz/mc/",
      "steps": [
        {
          "title": "Войдите в кабинет на kaspi.kz/mc в браузере",
          "desc": "Кабинет открывается на kaspi.kz/mc по тому же телефону и паролю, что и приложение Kaspi Pay. В мобильном приложении раздела с токеном нет.",
          "title_en": "Sign in at kaspi.kz/mc in a browser",
          "desc_en": "The account opens at kaspi.kz/mc with the same phone and password as the Kaspi Pay app. The mobile app has no token section, so use a browser."
        },
        {
          "title": "Войдите под учётной записью руководителя",
          "desc": "Токен выдаётся только руководителю компании: у сотрудника нужного пункта в настройках просто не будет. Тогда попросите руководителя выпустить ключ.",
          "title_en": "Sign in as the company's head",
          "desc_en": "Only the company's head can issue the token: an employee account will not show the menu item. If a manager uses the account, ask the head to generate it."
        },
        {
          "title": "В «Настройки» откройте «Токен API»",
          "desc": "В меню кабинета выберите «Настройки», затем «Токен API». Это единственное место, где выпускается ключ: заявку писать и ждать одобрения не нужно.",
          "title_en": "Under «Настройки» open «Токен API»",
          "desc_en": "In the account menu pick «Настройки» (Settings), then «Токен API» (API token). This is the only place the key is issued: no form and no acceptance wait."
        },
        {
          "title": "Нажмите «Сформировать» и скопируйте токен",
          "desc": "Токен приходит одной строкой и не меняется: если потеряли, вернитесь на ту же страницу и скопируйте снова. Он открывает заказы и товары магазина.",
          "title_en": "Click «Сформировать» and copy the token",
          "desc_en": "The token comes as a single string and does not rotate: if you lose it, return to the same page and copy it again. It exposes your orders and products."
        }
      ]
    },
    "seo": {
      "title": "Kaspi.kz и ИИ-агент: заказы на грани просрочки",
      "description": "Найдёт заказы Kaspi.kz, у которых передача в доставку истекает сегодня, и сведёт выручку по категориям в тенге. Доступ по токену Shop API, без входа в кабинет.",
      "headline": "Держите заказы Kaspi под контролем прямо в чате",
      "scenarios": [
        {
          "title": "Контроль заказов Kaspi по статусам",
          "desc": "Агент проверит новые заказы, найдёт зависшие в обработке и напомнит, где горят сроки передачи в доставку."
        },
        {
          "title": "Анализ продаж магазина",
          "desc": "Агент сведёт продажи по товарам и периодам, покажет топ-позиции и динамику выручки в тенге."
        },
        {
          "title": "Мониторинг отзывов",
          "desc": "Агент соберёт свежие отзывы по товарам, выделит негатив и подготовит ответы."
        },
        {
          "title": "Города и точки выдачи",
          "desc": "Агент разложит заказы по городам и точкам выдачи и покажет, где забирают чаще всего, а в какие точки доставка почти не идёт."
        },
        {
          "title": "Что в среднем чеке",
          "desc": "Агент пройдёт по позициям заказов, посчитает средний чек и число товаров в заказе и покажет, какие позиции чаще всего берут вместе."
        },
        {
          "title": "Разбор отказов",
          "desc": "Агент отберёт заказы в отменённых состояниях, сведёт их по карточкам товаров и покажет, на каких позициях отказы повторяются чаще остальных."
        }
      ],
      "how_it_works": [
        "Агент работает с магазином через Shop API v2, тот же интерфейс, что стоит за кабинетом продавца Kaspi.kz. Он читает заказы и их позиции, карточки товаров, отзывы, города и точки выдачи, а суммы считает в тенге, как они и приходят из казахстанского кабинета. Продажи сводятся по товарам и периодам, заказы по статусам, и в ответ вы получаете разбор, а не выгрузку, которую нужно открывать в таблице.",
        "Устройство данных здесь трёхступенчатое: сам заказ не несёт списка товаров, поэтому сначала агент забирает его позиции, а от каждой позиции переходит к карточке товара. Поэтому вопрос «что именно у нас купили за неделю» стоит нескольких обходов, и агент проходит их постранично, а не пытается вытянуть всё одним запросом. Фильтр по состоянию заказа он ставит на стороне Kaspi, чтобы не тащить архив ради свежих сделок.",
        "Уведомлений Kaspi не присылает, так что новые и зависшие заказы агент видит в момент, когда вы спрашиваете или когда он проверяет их по расписанию. Прежде чем назвать заказ проблемным, он перечитывает текущее состояние: статус в Kaspi меняется быстрее, чем успевает устареть прошлая сводка. Ответы на отзывы агент готовит текстом и показывает вам: публикация остаётся вашим шагом в кабинете.",
        "Токен уходит отдельным заголовком, без OAuth и без входа под вашей учётной записью, и отзывается в любой момент, что мгновенно закрывает агенту доступ. Видит агент ровно тот магазин, которому принадлежит токен, и чужой заказ по номеру он не достанет. Выборки идут постранично и с фильтром по датам на стороне Kaspi, поэтому длинный период не превращается в одну неподъёмную выгрузку. Частоту запросов агент выдерживает сам, а если раздел пуст или токен отозван, скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Статус продавца Kaspi.kz с доступом в кабинет магазина",
        "Магазин в казахстанском кабинете: суммы и заказы берутся оттуда"
      ],
      "faq": [
        {
          "q": "Что нужно для подключения Kaspi.kz?",
          "a": "API-токен из кабинета продавца Kaspi (Shop API v2). Токен хранится в зашифрованном виде и отзывается в кабинете в любой момент."
        },
        {
          "q": "Какие разделы кабинета видит агент?",
          "a": "Заказы и позиции, товары, отзывы, города и точки выдачи: то, что отдаёт Shop API. Агент работает с данными по запросу и не выгружает их «про запас»."
        },
        {
          "q": "Подходит ли для продавцов из Казахстана?",
          "a": "Да, коннектор рассчитан на продавцов Kaspi.kz: суммы в тенге, статусы заказов и логика точек выдачи соответствуют казахстанскому кабинету."
        }
      ]
    },
    "seo_en": {
      "title": "Kaspi.kz AI agent: orders about to miss handover",
      "description": "Finds Kaspi.kz orders whose delivery handover expires today and breaks down shop revenue by category in tenge. Access by a Shop API token, no cabinet sign-in.",
      "headline": "Keep Kaspi orders under control right in the chat",
      "scenarios": [
        {
          "title": "Kaspi order control by status",
          "desc": "The agent checks new orders, finds the ones stuck in processing and reminds you where the handover-to-delivery deadlines are running out."
        },
        {
          "title": "Shop sales analysis",
          "desc": "The agent aggregates sales by product and period, shows the top positions and the revenue trend in tenge."
        },
        {
          "title": "Review monitoring",
          "desc": "The agent collects fresh product reviews, highlights the negative ones and drafts replies."
        },
        {
          "title": "Cities and pickup points",
          "desc": "The agent breaks orders down by city and pickup point and shows where buyers collect most often and which points barely see any deliveries."
        },
        {
          "title": "What the average basket holds",
          "desc": "The agent walks the order entries, works out the average check and the number of items per order and shows which products are bought together most often."
        },
        {
          "title": "Digging into refusals",
          "desc": "The agent picks out orders in cancelled states, aggregates them by product card and shows which positions get refused more often than the rest."
        }
      ],
      "how_it_works": [
        "The agent works with the shop through Shop API v2, the same interface that sits behind the Kaspi.kz seller account. It reads orders and their entries, product cards, reviews, cities and pickup points, and counts amounts in tenge, exactly as they come from the Kazakh account. Sales are aggregated by product and period, orders by status, and what you get back is an analysis rather than an export you then have to open in a spreadsheet.",
        "The data here is built in three steps: an order itself carries no list of goods, so the agent first fetches its entries, and from every entry moves on to the product card. So the question of what exactly was bought over the week costs several passes, and the agent walks them page by page instead of trying to pull everything in one request. The order state filter is applied on the Kaspi side, so the archive is not dragged along for the sake of recent deals.",
        "Kaspi sends no notifications, so the agent sees new and stuck orders at the moment you ask or when it checks them on a schedule. Before calling an order a problem, it re-reads the current state: a status in Kaspi changes faster than the previous summary manages to go stale. Replies to reviews the agent prepares as text and shows to you: publishing them stays your step in the account.",
        "The token travels in a header of its own, with no OAuth and no sign-in under your account, and it can be revoked at any moment, which cuts the agent off instantly. The agent sees exactly the shop the token belongs to, and someone else's order will not come back by number. Selections run page by page with the date filter applied on the Kaspi side, so a long period never turns into one unliftable export. The agent holds the request rate itself, and if a section is empty or the token has been revoked it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Kaspi.kz seller status with access to the shop account",
        "A store in the Kazakh account: amounts and orders come from there"
      ],
      "faq": [
        {
          "q": "What do I need to connect Kaspi.kz?",
          "a": "An API token from the Kaspi seller account (Shop API v2). The token is stored encrypted and can be revoked in the account at any moment."
        },
        {
          "q": "Which parts of the account does the agent see?",
          "a": "Orders and their entries, products, reviews, cities and pickup points: whatever Shop API returns. The agent works with the data on request and never exports it just in case."
        },
        {
          "q": "Is it suitable for sellers in Kazakhstan?",
          "a": "Yes, the connector is built for Kaspi.kz sellers: amounts in tenge, order statuses and pickup point logic all match the Kazakh seller account."
        }
      ]
    }
  },
  {
    "key": "kontur_extern",
    "name": "Контур.Экстерн",
    "name_en": "Kontur.Extern",
    "description": "Электронная отчётность: черновики, документообороты, организации, сертификаты",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "kontur-extern",
    "description_en": "Electronic reporting: drafts, filings, organizations and certificates",
    "guide": {
      "url": "https://kontur.ru/extern/api",
      "steps": [
        {
          "title": "На kontur.ru/extern/api отправьте заявку",
          "desc": "Форма «Отправить заявку» на kontur.ru/extern/api: менеджер пришлёт письмо с client_id и ссылкой на выпуск ключа.",
          "title_en": "Submit the request at kontur.ru/extern/api",
          "desc_en": "Use the «Отправить заявку» (Submit request) form at kontur.ru/extern/api. A manager emails the client_id and a key-issuing link."
        },
        {
          "title": "По ссылке из письма нажмите «Выпустить ключ»",
          "desc": "Ссылка ведёт на integrations.kontur.ru, там нажмите «Выпустить ключ». Значение выглядит как GUID: 8-4-4-4-12 шестнадцатеричных символов через дефисы.",
          "title_en": "Press «Выпустить ключ» on the emailed link",
          "desc_en": "The link opens integrations.kontur.ru, where you press «Выпустить ключ» (Issue key). The value is a GUID: 8-4-4-4-12 hex characters separated by hyphens."
        },
        {
          "title": "Для боевой площадки заключите договор",
          "desc": "Ключ из первого письма работает только на тестовой площадке testkontur.ru. Боевой ключ выпускается так же, кнопкой «Выпустить ключ», после договора с Контуром.",
          "title_en": "Sign a contract for production",
          "desc_en": "The key from the first email works only on the testkontur.ru sandbox. The production key is issued with the same «Выпустить ключ» (Issue key) after a contract."
        },
        {
          "title": "Вставьте client_id и api-key",
          "desc": "client_id это сервисное имя из письма, api-key это выпущенный ключ. Токен доступа на identity.kontur.ru выпускается и обновляется каждый час автоматически.",
          "title_en": "Paste the client_id and the api-key",
          "desc_en": "The client_id is the service name from the email, the api-key is the key you issued. The access token is issued at identity.kontur.ru and renewed hourly automatically."
        }
      ]
    },
    "seo": {
      "title": "Контур.Экстерн и ИИ: квитанции по отчётам всех организаций",
      "description": "Сведёт статусы отчётности по всем организациям: по 11 принято 34 отчёта, 2 отклонены, 3 ждут квитанцию. Сам не отправляет: подпись КЭП остаётся за вами.",
      "headline": "ИИ для налоговой: держите сроки ответа по всем организациям",
      "scenarios": [
        {
          "title": "Сроки ответа контролирующим органам",
          "desc": "Агент соберёт документообороты по всем организациям учётной записи и покажет, где срок ответа налоговой или фонду истекает первым."
        },
        {
          "title": "Статусы сданной отчётности",
          "desc": "Агент покажет по каждому отправленному отчёту, принят он, отклонён или ждёт квитанции, и соберёт причины отказов в один список."
        },
        {
          "title": "Истекающие сертификаты подписи",
          "desc": "Агент найдёт организации, у которых сертификат подписанта истекает в ближайший месяц, раньше, чем на нём встанет отправка."
        },
        {
          "title": "Черновики, которые не отправлены",
          "desc": "Агент сведёт черновики отчётов по организациям и формам и покажет, какие остались неотправленными к отчётной дате."
        },
        {
          "title": "Черновик перед подписью",
          "desc": "Агент проверит комплектность черновика и вложенных документов, сверит организацию и форму, поднимет найденные ошибки и остановится перед подписанием."
        },
        {
          "title": "Репетиция на песочнице",
          "desc": "Агент пройдёт весь путь отчёта на тестовой площадке testkontur.ru с тестовым сертификатом, ничего не сдавая в налоговую и не трогая боевые данные."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Экстерна сразу по всем организациям учётной записи: читает черновики отчётов и вложенные в них документы, документообороты с налоговой и фондами вместе с ответными квитанциями и список сертификатов подписантов. Из этого он строит картину, которой в кабинете нет одним экраном: где срок ответа контролирующему органу истекает первым, какие отчёты приняты, какие отклонены и какие черновики не ушли к отчётной дате.",
        "В электронной отчётности отправка не событие, а цепочка: отчёт уходит, потом приходит подтверждение оператора, потом квитанция о приёме или отказ, и между шагами проходят часы. Поэтому отправленный отчёт ещё не сданный, и агент различает эти состояния, а причины отказов собирает в один список, а не оставляет каждую внутри своего документооборота. Истекающий сертификат подписанта он показывает заранее, до того как на нём встанет отправка.",
        "Отправить отчёт за вас агент не берётся: сдача идёт цепочкой асинхронных задач и требует подписи КЭП, которую Экстерн сам не создаёт. Агент проверяет комплектность черновика, сверяет организацию и форму, поднимает найденные ошибки и останавливается перед подписанием, а дальше действует человек с сертификатом. Пройти сценарий целиком, ничего не сдав, можно на отдельной песочнице testkontur.ru с тестовым сертификатом.",
        "Каждый запрос агент подписывает токеном доступа, который интеграция получает у Контура по вашим client_id и api-key, а когда час жизни токена истекает, получает новый сама, не прерывая разбор. Видит он ровно те организации, которые открыты учётной записи, и по каждой ходит отдельно: сводка по группе компаний складывается из нескольких обходов и занимает больше времени, чем вопрос про одно юрлицо. Если по организации за период ничего нет, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Договор с Контуром: без него боевая площадка закрыта",
        "Учётная запись Контура с доступом к нужным организациям",
        "Действующий сертификат электронной подписи у подписанта"
      ],
      "faq": [
        {
          "q": "Как подключить Контур.Экстерн?",
          "a": "Двумя значениями: client_id (сервисным именем приложения) и api-key вида GUID, который выпускается на integrations.kontur.ru. И то и другое открывает менеджер по заявке на сайте Экстерна. Токен доступа интеграция получает и обновляет сама."
        },
        {
          "q": "Что агент видит в Экстерне?",
          "a": "Организации учётной записи, черновики отчётов и вложенные в них документы, документообороты с контролирующими органами и ответные квитанции, а также список сертификатов в пределах прав учётной записи."
        },
        {
          "q": "Может ли агент отправить отчёт?",
          "a": "Отправка идёт цепочкой асинхронных задач и требует подписи КЭП, которую Экстерн не создаёт сам. Агент проверяет и собирает данные, а подписание и отправку оставляет человеку с сертификатом."
        },
        {
          "q": "Есть ли тестовая площадка?",
          "a": "Да, у подключения предусмотрен отдельный адрес песочницы на testkontur.ru с собственной учётной записью и тестовым сертификатом. Боевая площадка открывается по договору с Контуром."
        },
        {
          "q": "Поможет ли ИИ с ответом на требование налоговой?",
          "a": "Требование агент найдёт среди документооборотов, покажет срок ответа и соберёт по нему картину: что запрошено, какие документы уже есть в базе, чего не хватает. Подписание КЭП и саму отправку он не делает: это остаётся человеку с сертификатом."
        }
      ]
    },
    "seo_en": {
      "title": "Kontur.Extern and an AI agent: receipts across companies",
      "description": "Collects filing statuses across every organisation: 34 reports accepted for 11 of them, 2 rejected, 3 awaiting a receipt. Signing stays with you.",
      "headline": "Keep tax response deadlines in view across all organisations",
      "scenarios": [
        {
          "title": "Response deadlines for regulators",
          "desc": "The agent collects docflows across every organisation in the account and shows where the deadline to answer the tax office or a fund runs out first."
        },
        {
          "title": "Status of filed reporting",
          "desc": "For each submitted report the agent shows whether it was accepted, rejected or is still waiting for a receipt, and gathers the rejection reasons into one list."
        },
        {
          "title": "Signing certificates about to expire",
          "desc": "The agent finds organisations whose signer certificate expires within the next month, before it blocks submissions."
        },
        {
          "title": "Drafts that were never sent",
          "desc": "The agent aggregates report drafts by organisation and form and shows which ones are still unsent as the filing date arrives."
        },
        {
          "title": "A draft before signing",
          "desc": "The agent checks that the draft and its attached documents are complete, verifies the organisation and the form, raises the errors it finds and stops before signing."
        },
        {
          "title": "A dry run in the sandbox",
          "desc": "The agent walks the whole reporting path on the testkontur.ru sandbox with a test certificate, filing nothing with the tax office and touching no production data."
        }
      ],
      "how_it_works": [
        "The agent calls the Extern API across every organisation in the account at once: it reads report drafts and the documents attached to them, the docflows with the tax office and the funds together with their response receipts, and the list of signer certificates. Out of that it builds the picture the account never shows on one screen: where the deadline to answer a regulator runs out first, which reports were accepted, which were rejected and which drafts never left before the filing date.",
        "In electronic reporting a submission is not an event but a chain: the report goes out, then the operator confirmation arrives, then an acceptance receipt or a refusal, with hours passing between the steps. A submitted report is therefore not yet a filed one, and the agent keeps those states apart, gathering the rejection reasons into a single list instead of leaving each one buried inside its own docflow. An expiring signer certificate is surfaced early, before it blocks a submission.",
        "The agent does not take on submitting a report for you: filing runs as a chain of asynchronous tasks and requires a qualified electronic signature, which Extern does not create by itself. The agent checks that a draft is complete, verifies the organisation and the form, raises the errors it finds and stops before signing, and from there a person with the certificate acts. The whole scenario can be walked through without filing anything on the separate testkontur.ru sandbox with a test certificate.",
        "Every request carries an access token the integration obtains from Kontur with your client_id and api-key, and when the token's hour runs out it gets a new one itself without interrupting the analysis. It sees exactly the organisations the account has access to, and walks each of them separately: a summary across a group of companies is assembled from several passes and takes longer than a question about one legal entity. If there is nothing for an organisation over the period, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A contract with Kontur: without it production stays closed",
        "A Kontur account with access to the organisations you need",
        "A valid electronic signature certificate for the signer"
      ],
      "faq": [
        {
          "q": "How do I connect Kontur.Extern?",
          "a": "With two values: the client_id (the application's service name) and a GUID-style api-key issued at integrations.kontur.ru. Both are opened by a manager after a request on the Extern website. The integration obtains and renews the access token itself."
        },
        {
          "q": "What does the agent see in Extern?",
          "a": "Organisations in the account, report drafts and the documents attached to them, docflows with the regulators and their response receipts, plus the list of certificates, within the permissions of the account."
        },
        {
          "q": "Can the agent submit a report?",
          "a": "Submission runs as a chain of asynchronous tasks and requires a qualified electronic signature, which Extern does not create by itself. The agent checks and assembles the data, and leaves signing and submission to a person with the certificate."
        },
        {
          "q": "Is there a test environment?",
          "a": "Yes, the connection supports a separate sandbox address on testkontur.ru with its own account and a test certificate. The production environment is opened under a contract with Kontur."
        },
        {
          "q": "Can the AI help answer a tax authority demand?",
          "a": "The agent finds the demand among the docflows, shows the response deadline and assembles the picture around it: what was asked for, which documents already exist, what is missing. Signing with a qualified certificate and the submission itself stay with a person who holds the certificate."
        }
      ]
    }
  },
  {
    "key": "kontur_focus",
    "name": "Контур.Фокус",
    "name_en": "Kontur.Focus",
    "description": "Проверка контрагентов по ИНН/ОГРН: реквизиты, аналитика рисков, мониторинг",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "kontur-focus",
    "description_en": "Counterparty checks by INN/OGRN: company details, risk analytics and monitoring",
    "guide": {
      "url": "https://focus.kontur.ru/site/api",
      "steps": [
        {
          "title": "На focus.kontur.ru/site/api оставьте заявку",
          "desc": "На focus.kontur.ru/site/api нажмите «Бесплатная консультация» и укажите ИНН компании и контакты: ключ открывает менеджер.",
          "title_en": "Request access at focus.kontur.ru/site/api",
          "desc_en": "At focus.kontur.ru/site/api click «Бесплатная консультация» (Free consultation) and give your company tax ID and contacts."
        },
        {
          "title": "Закажите метод «Реквизиты» (/api3/req)",
          "desc": "Скажите, что нужна проверка компаний и ИП по ИНН и ОГРН: без метода «Реквизиты» (/api3/req) запросы вернут отказ по правам.",
          "title_en": "Ask for the «Реквизиты» (/api3/req) method",
          "desc_en": "Say you need lookups of companies and sole traders by tax ID and company registration number: without «Реквизиты» (/api3/req) requests are rejected."
        },
        {
          "title": "Заберите ключ из письма Контура",
          "desc": "Ключ приходит письмом на адрес из договора, в интерфейсе Фокуса он нигде не показывается. Это длинная строка из цифр и латинских букв без дефисов и пробелов.",
          "title_en": "Take the key from the Kontur email",
          "desc_en": "The key arrives by email to the contract address: a long string of digits and Latin letters, with no dashes or spaces."
        },
        {
          "title": "Проверьте ключ на focus-api.kontur.ru",
          "desc": "Откройте focus-api.kontur.ru/api3/req/userform, вставьте ключ в поле «Ключ доступа» и любой ИНН, и вернутся реквизиты.",
          "title_en": "Test the key on focus-api.kontur.ru",
          "desc_en": "Open focus-api.kontur.ru/api3/req/userform, paste the key into the «Ключ доступа» (Access key) field and any tax ID. Company details in the answer mean the key works."
        }
      ]
    },
    "seo": {
      "title": "Контур.Фокус и ИИ: проверка поставщика по ИНН до договора",
      "description": "Проверит нового поставщика по ИНН до договора: компания действующая, но месяц назад сменила адрес и директора. Прогонит и список, ИНН поставит на мониторинг.",
      "headline": "Проверяйте контрагента по ИНН до того, как подпишете договор",
      "scenarios": [
        {
          "title": "Проверка контрагента перед сделкой",
          "desc": "Агент по ИНН вернёт реквизиты, статус, руководителя, адрес и ОКВЭД и скажет, действующая ли компания и что настораживает."
        },
        {
          "title": "Скрининг списка поставщиков",
          "desc": "Агент прогонит сотни ИНН пачками и вернёт тех, кто ликвидирован, реорганизуется или сменил адрес и руководителя."
        },
        {
          "title": "Суды, банкротства и приставы",
          "desc": "Агент соберёт по компании арбитражные дела, признаки банкротства и исполнительные производства и оценит, чем это грозит сделке."
        },
        {
          "title": "Мониторинг изменений по контрагентам",
          "desc": "Агент по расписанию сверит список мониторинга и пришлёт, у кого с прошлой проверки сменились статус, руководитель или адрес."
        },
        {
          "title": "Связи и общие учредители",
          "desc": "Агент раскрутит связанные организации контрагента (общих учредителей, директоров и адреса) и покажет, не тянется ли цепочка к уже проблемной компании."
        },
        {
          "title": "Масштаб бизнеса по отчётности",
          "desc": "Агент возьмёт финансовые показатели по годам и историю госзакупок и покажет, сходится ли обещанный оборот с тем, что видно в реестрах."
        }
      ],
      "how_it_works": [
        "Агент обращается к API Фокуса по ИНН или ОГРН: тянет реквизиты и сведения ЕГРЮЛ и ЕГРИП, экспресс-отчёт по рискам, аналитику по арбитражным делам, банкротствам, финансам, исполнительным производствам и госзакупкам, связанные организации и списки мониторинга. Списки поставщиков он прогоняет пачками, а не по одному, и возвращает не выгрузку целиком, а тех, кто ликвидирован, реорганизуется или сменил адрес и руководителя.",
        "Фокус служит витриной государственных реестров, и это задаёт границу доверия. Запись в ЕГРЮЛ отстаёт от события: смена директора или адреса появляется после регистрации, а не в день решения, поэтому статус «действующая» отражает состояние реестра, а не доказательство живого бизнеса. Агент читает признаки в связке (дела в судах, производства у приставов, финансы, недостоверность сведений) и объясняет, чем набор грозит сделке, а не выносит вердикт одним словом.",
        "Писать в Фокус почти нечего: данные о компаниях в нём справочные и агентом не меняются. Единственное действие на запись: добавление ИНН в список мониторинга, чтобы отслеживать изменения по контрагенту дальше; по расписанию агент сверяет этот список и присылает, у кого с прошлой проверки сменились статус, руководитель или адрес. Всё остальное сводится к чтению, проверке и сведение фактов в понятный ответ.",
        "Суточный лимит запросов агент считает своим бюджетом: длинный список контрагентов он разбивает на пачки, одну и ту же компанию в пределах проверки не запрашивает дважды и предупреждает, когда остаток лимита подходит к концу. Ответ Фокуса состоит из полей реестра, поэтому агент сводит их в человеческий текст: расшифровывает коды видов деятельности и статусы, а суммы по делам и производствам собирает в итог по контрагенту. Если метод в тариф не входит или данных по компании нет, он говорит об этом прямо, вместо пустого ответа."
      ],
      "requirements": [
        "Договор с Контуром на Фокус, оформленный на вашу компанию.",
        "Тариф Фокуса с суточным лимитом запросов под вашу нагрузку."
      ],
      "faq": [
        {
          "q": "Как подключить Контур.Фокус?",
          "a": "Одним ключом доступа. Ключ приходит письмом от Контура после заявки на сайте Фокуса, в интерфейсе сервиса он не показывается. В заявке сразу просите метод «Реквизиты», иначе запросы вернутся отказом по правам."
        },
        {
          "q": "Что агент видит в Фокусе?",
          "a": "Реквизиты и сведения ЕГРЮЛ и ЕГРИП, экспресс-отчёт по рискам, аналитику по судам, банкротствам, финансам, приставам и госзакупкам, связанные организации и списки мониторинга в пределах методов вашего тарифа."
        },
        {
          "q": "Пишет ли агент что-то в Фокус?",
          "a": "Фокус является справочным сервисом, данные о компаниях в нём не меняются. Единственная запись: добавление ИНН в список мониторинга, чтобы отслеживать изменения по контрагенту."
        },
        {
          "q": "Что с лимитами и набором методов?",
          "a": "Суточный лимит запросов и доступные методы определяются тарифом, а не подключением. Если метод в тариф не входит, агент скажет об этом прямо, а не вернёт пустой ответ."
        }
      ]
    },
    "seo_en": {
      "title": "Kontur.Focus and an AI agent: vet a supplier by tax ID",
      "description": "Checks a new supplier by tax ID before the contract: active, yet it changed both address and director a month ago. Screens whole lists and adds IDs to monitoring.",
      "headline": "Vet a counterparty by tax number before you sign the contract",
      "scenarios": [
        {
          "title": "Vetting a counterparty before a deal",
          "desc": "By tax number the agent returns the company details, status, director, address and activity codes, and tells you whether the company is active and what looks off."
        },
        {
          "title": "Screening a supplier list",
          "desc": "The agent runs hundreds of tax numbers in batches and returns the companies that were liquidated, are being reorganised or changed their address and director."
        },
        {
          "title": "Lawsuits, bankruptcies and bailiffs",
          "desc": "The agent collects arbitration cases, signs of bankruptcy and enforcement proceedings for a company and assesses what that means for the deal."
        },
        {
          "title": "Monitoring changes across counterparties",
          "desc": "On a schedule the agent rechecks the monitoring list and reports whose status, director or address has changed since the last check."
        },
        {
          "title": "Ties and shared founders",
          "desc": "The agent unwinds the related organisations of a counterparty (shared founders, directors and addresses) and shows whether the chain leads to an already troubled company."
        },
        {
          "title": "Business size from the filings",
          "desc": "The agent takes the yearly financials and the public procurement history and shows whether the turnover you were promised matches what the registers actually hold."
        }
      ],
      "how_it_works": [
        "The agent queries the Focus API by tax number or state registration number: it pulls company details and records from the state registers of legal entities and sole traders, an express risk report, analytics on arbitration cases, bankruptcies, financials, enforcement proceedings and public procurement, related organisations and monitoring lists. Supplier lists are run in batches rather than one at a time, and what comes back is not the whole export but the companies that were liquidated, are being reorganised or changed their address and director.",
        "Focus is a window onto state registers, and that sets the limit of trust. A register entry lags behind the event: a change of director or address appears once it is registered, not on the day it was decided, so an active status is the state of the register, not proof of a living business. The agent reads the signals together (court cases, bailiff proceedings, financials, flagged unreliable data) and explains what the combination means for the deal instead of passing a one-word verdict.",
        "There is almost nothing to write into Focus: the company data in it is reference data and the agent does not change it. The only write action is adding a tax number to a monitoring list to keep tracking a counterparty; on a schedule the agent rechecks that list and reports whose status, director or address has changed since the last check. Everything else is reading, verifying and pulling the facts together into a clear answer.",
        "The agent treats the daily request limit as its budget: a long counterparty list is split into batches, the same company is never queried twice within one check, and it warns you when the remaining quota runs low. What Focus returns are register fields, so the agent turns them into readable text: it spells out activity codes and statuses and adds up the amounts across court cases and enforcement proceedings into a single figure per counterparty. If a method is outside the plan or there is no data on a company, it says so directly instead of returning an empty answer."
      ],
      "requirements": [
        "A Kontur contract for Focus signed for your company.",
        "A Focus plan whose daily request limit covers your load."
      ],
      "faq": [
        {
          "q": "How do I connect Kontur.Focus?",
          "a": "With a single access key. Kontur sends the key by email after a request on the Focus website; it is never shown in the service interface. Ask for the Requisites method right in the request, otherwise the queries will come back as permission errors."
        },
        {
          "q": "What does the agent see in Focus?",
          "a": "Company details and records from the state registers of legal entities and sole traders, an express risk report, analytics on lawsuits, bankruptcies, financials, bailiffs and public procurement, related organisations and monitoring lists, within the methods of your plan."
        },
        {
          "q": "Does the agent write anything to Focus?",
          "a": "Focus is a reference service, and company data in it does not change. The only write is adding a tax number to a monitoring list to track changes for a counterparty."
        },
        {
          "q": "What about limits and the set of methods?",
          "a": "The daily request limit and the available methods are set by your plan, not by the connection. If a method is not in the plan, the agent says so directly instead of returning an empty answer."
        }
      ]
    }
  },
  {
    "key": "mailru_cloud",
    "name": "Облако Mail.ru",
    "name_en": "Mail.ru Cloud",
    "description": "Облачное хранилище Mail.ru по WebDAV: папки, файлы, загрузка и выгрузка",
    "category": "files",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mailru-cloud",
    "description_en": "Mail.ru cloud storage over WebDAV: folders, files, uploads and downloads",
    "search_terms": [
      "майл облако",
      "мейл облако"
    ],
    "guide": {
      "url": "https://e.mail.ru/settings/security",
      "steps": [
        {
          "title": "В «Контакты и адреса» привяжите телефон",
          "desc": "Пароль для внешних приложений выдают только ящику с телефоном. Откройте «Настройки» → «Все настройки» → «Контакты и адреса» и добавьте номер, если его нет.",
          "title_en": "Add a phone under «Контакты и адреса»",
          "desc_en": "App passwords are issued only to mailboxes with a phone. Open «Настройки» → «Все настройки» → «Контакты и адреса» and add a number if there is none."
        },
        {
          "title": "В «Безопасность» откройте пароли приложений",
          "desc": "«Настройки» → «Безопасность» → «Пароли для внешних приложений»: этот раздел выдаёт пароли программам, которые подключаются к ящику и Облаку снаружи.",
          "title_en": "Under «Безопасность» open app passwords",
          "desc_en": "«Настройки» → «Безопасность» → «Пароли для внешних приложений»: this section issues the passwords programs use to reach the mailbox and the Cloud from outside."
        },
        {
          "title": "Создайте пароль и скопируйте его сразу",
          "desc": "Нажмите «Создать» и дайте паролю понятное название: по нему его потом отзывают. Пароль показывается один раз и нигде не сохраняется.",
          "title_en": "Create the password and copy it at once",
          "desc_en": "Click «Создать» and give the password a recognizable name: that is how it gets revoked later. It is shown once and stored nowhere."
        },
        {
          "title": "Проверьте свободное место на cloud.mail.ru",
          "desc": "Агент работает с тем же Облаком, что открывается на cloud.mail.ru: читает файлы и кладёт новые. Если свободного места нет, загрузка не пройдёт.",
          "title_en": "Check free space at cloud.mail.ru",
          "desc_en": "The agent works with the same Cloud that opens at cloud.mail.ru: it reads files and puts new ones there. With no free space left an upload will not go through."
        }
      ]
    },
    "seo": {
      "title": "Облако Mail.ru по WebDAV и ИИ: отчёт по выгрузке в папку",
      "description": "Облако Mail.ru (cloud.mail.ru) по WebDAV: агент посчитает выгрузку заказов по строкам и положит отчёт файлом в /Отчёты. Нужен пароль для внешних приложений.",
      "headline": "Разбирайте файлы в Облаке Mail.ru, не открывая браузер",
      "scenarios": [
        {
          "title": "Поиск документа в Облаке",
          "desc": "Агент обойдёт папки, найдёт файл по части названия и назовёт путь, размер и дату изменения, без ручного листания дерева."
        },
        {
          "title": "Расчёт по выгрузке из Облака",
          "desc": "Агент заберёт выгрузку или отчёт прямо из Облака, посчитает по ней цифры и положит результат обратно в нужную папку."
        },
        {
          "title": "Загрузка готового файла",
          "desc": "Агент зальёт подготовленный документ в Облако содержимым, а не ссылкой, и скажет, по какому пути он теперь лежит."
        },
        {
          "title": "Наведение порядка в папках",
          "desc": "Агент заведёт папку, перенесёт или скопирует в неё файлы и уберёт лишнее, называя каждый путь явно."
        },
        {
          "title": "Сколько осталось места",
          "desc": "Агент покажет занятое и свободное место в Облаке, чтобы загрузка не упёрлась в квоту в самый неподходящий момент."
        },
        {
          "title": "Дубли и старые версии",
          "desc": "Агент сверит имена, размеры и даты в рабочей папке и покажет дубли и устаревшие версии одного документа."
        }
      ],
      "how_it_works": [
        "Агент работает с Облаком по протоколу WebDAV через webdav.cloud.mail.ru, тем же способом, которым облако подключают как сетевой диск. Он перечисляет папки и файлы, читает метаданные (имя, размер, тип, дату изменения), находит документ по части названия и показывает, сколько места занято и сколько осталось. Это же даёт разбор выгрузки: файл забирается из Облака целиком и считается, а не пересказывается по имени.",
        "В отличие от Яндекс Диска, файл сюда кладётся содержимым: агент передаёт байты напрямую методом PUT, внешняя ссылка не нужна, поэтому результат расчёта возвращается файлом, а не адресом для скачивания. Копирование и перенос WebDAV выполняет синхронно: ответ приходит, когда операция уже завершилась, и «готово» на полпути тут невозможно в принципе.",
        "У протокола есть и обратная сторона, которую агент не скрывает. Серверного поиска в WebDAV нет: агент обходит дерево папку за папкой и держит обход в границах: по глубине, числу папок и числу совпадений. Упершись в границу, он говорит, что список неполный, вместо того чтобы выдать частичный результат за исчерпывающий. Публичных ссылок и корзины в протоколе тоже нет: это функции самого Облака, не WebDAV.",
        "Подключается не пароль от аккаунта, а отдельный пароль для внешних приложений, и отзывается он в настройках Mail.ru отдельно, без смены основного пароля. Доступ ограничен Облаком того ящика, чей пароль подключён. Перед перезаписью файла с тем же именем и перед удалением агент спрашивает: удаление убирает и файл, и целиком папку со всем содержимым, а вернуть удалённое тем же путём, каким оно ушло, агент не может: восстановления в протоколе нет, и лежит ли копия в Корзине Облака, ему не видно."
      ],
      "requirements": [
        "Полный адрес ящика Mail.ru и доступ к его настройкам.",
        "Место в Облаке под новые файлы.",
        "Публичные ссылки и корзина по WebDAV недоступны."
      ],
      "faq": [
        {
          "q": "Как подключить Облако Mail.ru?",
          "a": "Адресом ящика и паролем для внешних приложений. В «Настройки» → «Безопасность» откройте «Пароли для внешних приложений», создайте пароль и скопируйте его сразу: он показывается один раз."
        },
        {
          "q": "Что агент видит в Облаке?",
          "a": "Папки и файлы Облака того ящика, чей пароль подключён: имя, путь, размер, тип и дату изменения, а также занятое и свободное место."
        },
        {
          "q": "Может ли агент загружать файлы?",
          "a": "Да, содержимым напрямую: агент кладёт файл в Облако методом PUT, создаёт папки, переносит, копирует и удаляет. Внешняя ссылка для загрузки не нужна."
        },
        {
          "q": "Почему агент не даёт публичную ссылку?",
          "a": "Публикация и корзина это функции интерфейса Облака, а не протокола WebDAV. По WebDAV их выразить нечем, поэтому агент за них не берётся и говорит об этом прямо."
        }
      ]
    },
    "seo_en": {
      "title": "Mail.ru Cloud over WebDAV: AI reports from your exports",
      "description": "An orders export in the Cloud gets crunched row by row and the report is saved as a file next to it. Works over WebDAV with your email and an app password.",
      "headline": "Sort out your Mail.ru Cloud files without a browser",
      "scenarios": [
        {
          "title": "Finding a document in the Cloud",
          "desc": "The agent walks the folders, finds a file by part of its name and states the path, size and modification date, with no manual scrolling."
        },
        {
          "title": "Crunching an export from the Cloud",
          "desc": "The agent picks up an export or report straight from the Cloud, runs the numbers on it and files the result back into the right folder."
        },
        {
          "title": "Uploading a finished file",
          "desc": "The agent puts a prepared document into the Cloud as contents rather than a link, and says which path it now sits at."
        },
        {
          "title": "Tidying up the folders",
          "desc": "The agent creates a folder, moves or copies files into it and clears out the rest, naming every path explicitly."
        },
        {
          "title": "How much space is left",
          "desc": "The agent reports used and free space in the Cloud so an upload never hits the quota at the worst possible moment."
        },
        {
          "title": "Duplicates and old versions",
          "desc": "The agent compares names, sizes and dates in a work folder and shows duplicates and stale versions of the same document."
        }
      ],
      "how_it_works": [
        "The agent works with the Cloud over the WebDAV protocol through webdav.cloud.mail.ru, the same way the cloud is mounted as a network drive. It lists folders and files, reads metadata (name, size, type, modification date), finds a document by part of its name and shows how much space is used and how much is left. That is also what makes an export readable: the file is fetched whole and crunched, not retold by its file name.",
        "Unlike Yandex Disk, a file goes in here as contents: the agent sends the bytes directly with PUT, no external link is needed, so the result of a calculation comes back as a file rather than as a download address. Copying and moving are performed synchronously by WebDAV: the response arrives once the operation is already finished, so a half-way «done» is impossible here by construction.",
        "The protocol has a flip side the agent does not hide. WebDAV has no server-side search: the agent walks the tree folder by folder and keeps the walk inside bounds: on depth, on folder count and on the number of matches. Once it hits a bound it says the list is incomplete instead of passing a partial result off as exhaustive. Public links and the trash are absent from the protocol too, since those are features of the Cloud itself, not of WebDAV.",
        "What gets connected is not the account password but a separate app password, and it is revoked in the Mail.ru settings on its own, without changing the main one. Access is limited to the Cloud of the mailbox whose password is connected. The agent asks before overwriting a file with the same name and before deleting: a delete removes a file and a whole folder with everything in it, and the agent cannot bring it back the way it went: the protocol has no restore, and whether a copy sits in the Cloud's own trash is not visible to it."
      ],
      "requirements": [
        "The full Mail.ru mailbox address and access to its settings.",
        "Free space in the Cloud for new files.",
        "Public links and the trash are out of reach over WebDAV."
      ],
      "faq": [
        {
          "q": "How do I connect Mail.ru Cloud?",
          "a": "With the mailbox address and an app password. In Settings, then Security, open the app passwords section, create a password and copy it straight away, as it is shown only once."
        },
        {
          "q": "What does the agent see in the Cloud?",
          "a": "The folders and files of the Cloud belonging to the mailbox whose password is connected: name, path, size, type and modification date, plus used and free space."
        },
        {
          "q": "Can the agent upload files?",
          "a": "Yes, as contents directly: the agent puts a file into the Cloud with PUT, creates folders, moves, copies and deletes. No external link is needed for an upload."
        },
        {
          "q": "Why does the agent not give a public link?",
          "a": "Publishing and the trash are features of the Cloud interface, not of the WebDAV protocol. There is nothing in WebDAV to express them, so the agent does not attempt it and says so directly."
        }
      ]
    }
  },
  {
    "key": "mailru_mail",
    "name": "Mail.ru Почта",
    "name_en": "Mail.ru Mail",
    "description": "Электронная почта Mail.ru: письма, папки, отправка и пересылка",
    "category": "mail",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mailru-mail",
    "description_en": "Mail.ru email: messages, folders, sending and forwarding",
    "search_terms": [
      "майл",
      "мейл"
    ],
    "guide": {
      "url": "https://e.mail.ru/settings/security",
      "steps": [
        {
          "title": "В «Контакты и адреса» привяжите телефон",
          "desc": "Пароль для внешних приложений выдают только ящику с телефоном. Откройте «Настройки» → «Все настройки» → «Контакты и адреса» и добавьте номер, если его нет.",
          "title_en": "Add a phone under «Контакты и адреса»",
          "desc_en": "App passwords are issued only to mailboxes with a phone. Open «Настройки» → «Все настройки» → «Контакты и адреса» and add a number if there is none."
        },
        {
          "title": "В «Внешние сервисы» включите доступ по IMAP",
          "desc": "«Настройки» → «Безопасность» → «Внешние сервисы»: переключатель «Доступ к почте по IMAP, POP и SMTP» должен быть включён, иначе ящик отклонит вход по паролю.",
          "title_en": "Under «Внешние сервисы» enable IMAP access",
          "desc_en": "In «Настройки» → «Безопасность» → «Внешние сервисы» turn on «Доступ к почте по IMAP, POP и SMTP». While it is off, logins are rejected."
        },
        {
          "title": "В «Безопасность» создайте пароль приложения",
          "desc": "В разделе «Безопасность» откройте «Пароли для внешних приложений» → «Создать». Название дайте понятное: по нему пароль потом отзывают.",
          "title_en": "Under «Безопасность» create an app password",
          "desc_en": "In the «Безопасность» section open «Пароли для внешних приложений», click «Создать» (Create), give the password a recognizable name and click «Продолжить»."
        },
        {
          "title": "Выберите «Полный доступ к Почте»",
          "desc": "Тип «Только отправка писем в Почте» папки не откроет. Пароль показывается один раз, скопируйте его сразу вместе с адресом ящика.",
          "title_en": "Pick «Полный доступ к Почте»",
          "desc_en": "The «Только отправка писем в Почте» type reads no folders or messages. The password is shown once and stored nowhere, so copy it with the full mailbox address."
        }
      ]
    },
    "seo": {
      "title": "Mail.ru Почта и ИИ-агент: найти счёт в письмах",
      "description": "Почта Mail.ru подключается к ИИ-агенту паролем для внешних приложений. Агент найдёт счёт поставщика с номером, датой и суммой и покажет, кто заваливает ящик.",
      "headline": "Разбирайте входящие Mail.ru, не открывая почтовый ящик",
      "scenarios": [
        {
          "title": "Разбор входящих за утро",
          "desc": "Агент пройдёт по непрочитанным письмам и покажет, какие ждут ответа, с темой, отправителем и датой, без открытия почтового ящика."
        },
        {
          "title": "Счета и акты из вложений",
          "desc": "Агент найдёт письмо по отправителю или теме, достанет вложение (счёт, акт или договор) и разберёт его содержимое."
        },
        {
          "title": "Ответ и пересылка письма",
          "desc": "Агент напишет ответ в нужную переписку, перешлёт письмо коллеге или отправит новое письмо с вашего ящика через SMTP."
        },
        {
          "title": "Наведение порядка в папках",
          "desc": "Агент разложит письма по папкам, отметит разобранные как прочитанные и удалит то, что явно не нужно хранить дальше."
        },
        {
          "title": "Переписка по сделке",
          "desc": "Агент соберёт письма с нужным адресатом за период, выстроит их по датам и покажет, о чём договорились и что осталось без ответа."
        },
        {
          "title": "Кто пишет чаще всего",
          "desc": "Агент посчитает месяц почты по отправителям и папкам и покажет, кто наполняет ящик и какая часть этих писем так и осталась непрочитанной."
        }
      ],
      "how_it_works": [
        "Агент подключается к ящику по IMAP и SMTP: первым делом читает список папок, а дальше работает с самими письмами: темой, отправителем, датой, телом и вложениями. Он проходит по непрочитанным и показывает, какие ждут ответа, находит письмо по отправителю или теме и достаёт из него счёт, акт или договор, чтобы разобрать содержимое, а не пересказать имя файла.",
        "Подключается не пароль от аккаунта, а отдельный пароль для внешних приложений, и его тип решает всё: с полным доступом к почте агент читает папки и пишет письма, а на отправке без чтения папки не откроются вовсе. Одна пара адреса и пароля обслуживает и IMAP, и SMTP, поэтому для разбора переписки и отправки ответов достаточно подключить один ящик.",
        "IMAP это не копия почты, а сам ящик: отметка о прочтении, перенос в другую папку и удаление применяются на сервере и сразу видны во всех ваших почтовых клиентах. Поэтому агент разбирает входящие по шагам: сначала показывает, что нашёл, и только потом раскладывает, помечает прочитанным или удаляет. Ответ в переписку, пересылку и новое письмо через SMTP он отправляет с вашего адреса.",
        "Доступ ограничен одним ящиком: тем, чей адрес и пароль приложения подключены; чужие ящики и общие папки компании агенту не видны. Сам пароль отзывается в настройках Mail.ru отдельно, без смены пароля от аккаунта. Частоту обращений к серверу агент выдерживает сам, а если письма по запросу не нашлись или папка недоступна, он скажет об этом прямо, а не покажет пустой список."
      ],
      "requirements": [
        "Полный адрес ящика Mail.ru и доступ к его настройкам.",
        "Агент читает все папки ящика и отправляет письма от вашего имени."
      ],
      "faq": [
        {
          "q": "Как подключить Mail.ru Почту?",
          "a": "Адресом ящика и паролем для внешних приложений. В «Настройки» → «Безопасность» включите доступ по IMAP и SMTP, создайте пароль с типом «Полный доступ к Почте» и скопируйте его сразу: он показывается один раз."
        },
        {
          "q": "Что агент видит в почте?",
          "a": "Список папок, письма с темой, отправителем и датой, тела писем и вложения. Всё через IMAP, в объёме того ящика, чей пароль приложения подключён."
        },
        {
          "q": "Пишет ли агент в почту?",
          "a": "Может: отправить письмо, ответить в переписку, переслать сообщение, переложить письмо в другую папку, отметить прочитанным или удалить."
        },
        {
          "q": "Что делать, если вход не проходит?",
          "a": "Проверьте, что к ящику привязан телефон и включён переключатель доступа по IMAP, POP и SMTP. Пароль типа «Только отправка писем» читать папки не даёт."
        }
      ]
    },
    "seo_en": {
      "title": "Mail.ru Mail and AI agent: find an invoice in your inbox",
      "description": "A supplier invoice turns up with its number, date and amount, and a month of mail shows who floods the inbox. Access uses a Mail.ru app password.",
      "headline": "Triage your Mail.ru inbox without opening the mailbox",
      "scenarios": [
        {
          "title": "Morning inbox triage",
          "desc": "The agent goes through unread messages and shows which ones are waiting for a reply, with subject, sender and date, without opening the mailbox."
        },
        {
          "title": "Invoices and acts out of attachments",
          "desc": "The agent finds a message by sender or subject, pulls out the attachment (an invoice, an act or a contract) and reads what is inside."
        },
        {
          "title": "Replying and forwarding",
          "desc": "The agent writes a reply in the right thread, forwards a message to a colleague or sends a new email from your mailbox over SMTP."
        },
        {
          "title": "Tidying up the folders",
          "desc": "The agent sorts messages into folders, marks the handled ones as read and deletes what clearly does not need keeping."
        },
        {
          "title": "The thread behind a deal",
          "desc": "The agent gathers the messages with one contact over a period, lines them up by date and shows what was agreed and what was left unanswered."
        },
        {
          "title": "Who writes the most",
          "desc": "The agent counts a month of mail by sender and folder and shows who fills the mailbox and how much of it was never even opened."
        }
      ],
      "how_it_works": [
        "The agent connects to the mailbox over IMAP and SMTP: the first thing it reads is the folder list, and from there it works with the messages themselves: subject, sender, date, body and attachments. It goes through the unread ones and shows which are waiting for a reply, finds a message by sender or subject and pulls the invoice, act or contract out of it to read what is inside rather than retell the file name.",
        "What gets connected is not the account password but a separate app password, and its type decides everything: with full mailbox access the agent reads folders and writes messages, while on the send-only type the folders do not open at all. One pair of address and password serves both IMAP and SMTP, so connecting one mailbox is enough to read a thread and send the reply.",
        "IMAP is not a copy of the mail but the mailbox itself: a read flag, a move to another folder and a deletion are applied on the server and show up immediately in all of your mail clients. So the agent triages the inbox step by step: first it shows what it found, and only then sorts, marks as read or deletes. A reply in a thread, a forward and a new email over SMTP are sent from your own address.",
        "Access is limited to a single mailbox, the one whose address and app password are connected; other mailboxes and shared company folders stay invisible to the agent. The password itself is revoked separately in the Mail.ru settings, without changing the account password. The agent holds the request rate to the server on its own, and if the messages you asked for were not found or a folder is unavailable, it says so directly instead of showing an empty list."
      ],
      "requirements": [
        "The full Mail.ru mailbox address and access to its settings.",
        "The agent reads every folder and sends mail on your behalf."
      ],
      "faq": [
        {
          "q": "How do I connect Mail.ru Mail?",
          "a": "With the mailbox address and an app password. In Settings, then Security, turn on IMAP and SMTP access, create a password of the Full mailbox access type and copy it straight away, as it is shown only once."
        },
        {
          "q": "What does the agent see in the mailbox?",
          "a": "The folder list, messages with subject, sender and date, message bodies and attachments, all over IMAP, limited to the mailbox whose app password is connected."
        },
        {
          "q": "Does the agent write to the mailbox?",
          "a": "It can: send an email, reply in a thread, forward a message, move a message to another folder, mark it as read or delete it."
        },
        {
          "q": "What should I do if sign-in fails?",
          "a": "Check that a phone number is linked to the mailbox and that access over IMAP, POP and SMTP is switched on. A password of the send-only type does not give access to folders."
        }
      ]
    }
  },
  {
    "key": "mango_office",
    "name": "Mango Office",
    "name_en": "Mango Office",
    "description": "Виртуальная АТС: звонки, callback, SMS, статистика, записи разговоров",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mango-office",
    "description_en": "Virtual PBX: calls, callback, SMS, statistics and call recordings",
    "search_terms": [
      "манго"
    ],
    "signup_url": "https://www.mango-office.ru/products/virtualnaya_ats/price/",
    "guide": {
      "url": "https://lk.mango-office.ru",
      "steps": [
        {
          "title": "Войдите в кабинет lk.mango-office.ru",
          "desc": "Нужна учётная запись владельца или администратора виртуальной АТС: логин и пароль выдают при заключении договора или присылают в письме о регистрации.",
          "title_en": "Sign in to lk.mango-office.ru",
          "desc_en": "You need the owner or administrator account of your virtual PBX. The login and password come with the contract or in the registration email."
        },
        {
          "title": "В «Интеграции» откройте «API коннектор»",
          "desc": "«Интеграции» это раздел меню самого кабинета Mango Office. Пункт «API коннектор» внутри него и есть единственное место, где выдаются реквизиты доступа к API.",
          "title_en": "Under «Интеграции» open «API коннектор»",
          "desc_en": "«Интеграции» (Integrations) is a menu section of the Mango Office account. The «API коннектор» item inside it is the only place issuing API credentials."
        },
        {
          "title": "Нажмите «Подключить API коннектор»",
          "desc": "Если услуга не активна, отметьте «Я принимаю условия» и подтвердите подключение. Пока коннектор выключен, реквизиты не показываются, а запросы не проходят.",
          "title_en": "Click «Подключить API коннектор»",
          "desc_en": "If the service is not active, tick «Я принимаю условия» and confirm. While the connector is off, no credentials are shown and API requests are rejected."
        },
        {
          "title": "Скопируйте код АТС и ключ для подписи",
          "desc": "«Уникальный код вашей АТС» это ключ, «Ключ для создания подписи» это соль. Значения разные: соль участвует в подписи запроса, а не в авторизации.",
          "title_en": "Copy the PBX code and the signing key",
          "desc_en": "«Уникальный код вашей АТС» is the API key, «Ключ для создания подписи» is the salt. They differ: the salt signs requests, it is not the key."
        }
      ]
    },
    "seo": {
      "title": "Mango Office с ИИ: разбор звонков менеджера",
      "description": "Разберёт неделю разговоров менеджера по его добавочному и покажет часы, когда теряются входящие; закажет обратный звонок. Нужны ключ API и соль из «API коннектора».",
      "headline": "Считайте пропущенные звонки и уровень сервиса Mango Office",
      "scenarios": [
        {
          "title": "Пропущенные и уровень сервиса",
          "desc": "Агент закажет статистику звонков за период и покажет, сколько обращений осталось без ответа и в какие часы их теряется больше всего."
        },
        {
          "title": "Разбор работы менеджера",
          "desc": "Агент выгрузит CDR по добавочному сотрудника, соберёт записи его разговоров и расшифрует их через Речевую Аналитику."
        },
        {
          "title": "Конспект разговора с клиентом",
          "desc": "Агент найдёт нужный звонок, возьмёт конспект и тематики разговора и перескажет, о чём договорились с клиентом."
        },
        {
          "title": "Обратный звонок и SMS",
          "desc": "Агент закажет callback клиенту от внутреннего номера или от группы, отправит SMS и при необходимости завершит или переведёт активный вызов."
        },
        {
          "title": "Куда ведут входящие линии",
          "desc": "Агент разберёт входящие линии, группы и схемы переадресации и покажет, на кого падает каждый номер и какие добавочные в схемах давно не берут трубку."
        },
        {
          "title": "Баланс ВАТС под присмотром",
          "desc": "Агент проверит остаток на счёте по расписанию и предупредит заранее, если денег хватит ненадолго, до того как встанут исходящие звонки и SMS."
        }
      ],
      "how_it_works": [
        "Агент работает с API виртуальной АТС Mango Office: читает сотрудников, группы и входящие линии, SIP-аккаунты и схемы переадресации, статистику звонков и CDR, записи разговоров с конспектами и остаток на счёте. На этих данных он считает, сколько обращений осталось без ответа, в какие часы теряется больше всего звонков и как выглядит нагрузка по конкретному добавочному сотрудника.",
        "Статистика в Mango отдаётся не одним ответом: выгрузка двухшаговая. Агент сначала заказывает отчёт за период и получает ключ, затем опрашивает его до готовности и только потом разбирает строки. Поэтому отчёт появляется не мгновенно, зато приходит целиком, а не куском. Записи разговоров лежат отдельными файлами, а конспекты и тематики агент берёт из Речевой Аналитики, если она у вас включена.",
        "На запись агент заказывает клиенту обратный звонок от внутреннего номера или от группы, отправляет SMS, включает запись активного разговора, завершает или переводит вызов и заводит контакт в адресной книге. Действия над живым вызовом отменить нельзя, поэтому перед переводом и завершением агент называет номер и добавочный и ждёт подтверждения. По умолчанию он работает на чтение и отчёты.",
        "Каждый запрос подписывается: ключ и соль складываются с телом запроса в единую хеш-сумму, поэтому подпись зависит от самих данных и годится ровно для одного вызова. Перепутанные местами ключ и соль дают отказ авторизации, а не пустой ответ, и агент называет именно эту причину. Даты API считает по московскому времени, так что границы периода агент приводит к нему сам, а не к вашему часовому поясу. Если данных за период нет, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Учётная запись владельца или администратора виртуальной АТС",
        "Активная виртуальная АТС в аккаунте Mango Office"
      ],
      "faq": [
        {
          "q": "Как подключить Mango Office?",
          "a": "Ключом API и солью для подписи. Откройте личный кабинет Mango Office → «Интеграции» → «API коннектор» и подключите его: «Уникальный код вашей АТС» служит ключом, «Ключ для создания подписи» солью. Путать их нельзя."
        },
        {
          "q": "Что агент видит в Mango Office?",
          "a": "Сотрудников, группы и входящие линии ВАТС, SIP-аккаунты и схемы переадресации, статистику звонков и CDR, записи разговоров с конспектами и остаток на счёте."
        },
        {
          "q": "Пишет ли агент в Mango Office?",
          "a": "Может: заказать обратный звонок, отправить SMS, включить запись активного разговора, завершить или перевести вызов, завести контакт в адресной книге."
        },
        {
          "q": "Почему статистика приходит не сразу?",
          "a": "Выгрузка статистики в API двухшаговая: агент сначала заказывает отчёт и получает ключ, а затем опрашивает его до готовности и только потом разбирает данные."
        }
      ]
    },
    "seo_en": {
      "title": "Mango Office AI agent: review a manager's calls",
      "description": "Reviews a manager's week of calls by extension and shows the hours when inbound calls go unanswered; orders a callback. Needs the API key and the signing salt.",
      "headline": "Count missed calls and service level in Mango Office",
      "scenarios": [
        {
          "title": "Missed calls and service level",
          "desc": "The agent orders call statistics for a period and shows how many enquiries went unanswered and which hours lose the most of them."
        },
        {
          "title": "Reviewing how a manager works",
          "desc": "The agent exports the CDR for an employee extension, collects the recordings of their calls and transcribes them with Speech Analytics."
        },
        {
          "title": "Summary of a client call",
          "desc": "The agent finds the call, takes its summary and conversation topics and retells what was agreed with the client."
        },
        {
          "title": "Callback and SMS",
          "desc": "The agent orders a callback to the client from an internal number or from a group, sends an SMS and, if needed, ends or transfers an active call."
        },
        {
          "title": "Where the inbound lines lead",
          "desc": "The agent walks the inbound lines, groups and forwarding schemes and shows who each number lands on and which extensions in those schemes stopped picking up long ago."
        },
        {
          "title": "Keeping an eye on the balance",
          "desc": "The agent checks the PBX account balance on a schedule and warns you in advance when the money will not last, before outgoing calls and SMS come to a halt."
        }
      ],
      "how_it_works": [
        "The agent works with the Mango Office cloud PBX API: it reads employees, groups and inbound lines, SIP accounts and forwarding schemes, call statistics and CDR, call recordings with their summaries and the account balance. On that data it counts how many enquiries went unanswered, which hours lose the most calls and what the load looks like on a particular employee extension.",
        "Statistics in Mango are not handed over in a single response: the export takes two steps: the agent first orders the report for the period and receives a key, then polls it until it is ready and only then parses the rows. So the report does not appear instantly, but it arrives whole rather than in pieces. Call recordings are separate files, and summaries and conversation topics are taken from Speech Analytics if you have it enabled.",
        "On the write side the agent orders a callback to the client from an internal number or from a group, sends an SMS, starts recording an active call, ends or transfers a call and adds a contact to the address book. Actions on a live call cannot be undone, so before a transfer or a hang-up the agent names the number and the extension and waits for confirmation. By default it works read-only and builds reports.",
        "Every request is signed: the key and the salt are folded together with the request body into a single hash, so the signature depends on the data itself and fits exactly one call. Swapped around, the key and the salt produce an authorisation failure rather than an empty response, and the agent names that reason. The API counts dates in Moscow time, so the agent converts the period boundaries itself instead of leaving them in your time zone. If there is no data for the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "The owner or administrator account of your virtual PBX",
        "An active virtual PBX in your Mango Office account"
      ],
      "faq": [
        {
          "q": "How do I connect Mango Office?",
          "a": "With an API key and a salt for the signature. In your account open Integrations, then API connector, and enable it: the unique code of your PBX is the key, and the signature key is the salt. Do not mix the two up."
        },
        {
          "q": "What does the agent see in Mango Office?",
          "a": "Employees, groups and inbound lines of the cloud PBX, SIP accounts and forwarding schemes, call statistics and CDR, call recordings with their summaries and the account balance."
        },
        {
          "q": "Does the agent write to Mango Office?",
          "a": "It can: order a callback, send an SMS, start recording an active call, end or transfer a call, add a contact to the address book."
        },
        {
          "q": "Why do statistics not arrive right away?",
          "a": "Exporting statistics through the API takes two steps: the agent first orders the report and receives a key, then polls it until it is ready and only then parses the data."
        }
      ]
    }
  },
  {
    "key": "max_messenger",
    "name": "MAX Messenger",
    "name_en": "MAX Messenger",
    "description": "Корпоративный мессенджер: чаты, сообщения, файлы",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "max-messenger",
    "short_name": "MAX",
    "short_name_en": "MAX",
    "description_en": "Company messenger: chats, messages and files",
    "search_terms": [
      "макс"
    ],
    "guide": {
      "url": "https://business.max.ru/self",
      "steps": [
        {
          "title": "Заведите бизнес-профиль на business.max.ru",
          "desc": "Ботов в MAX создают только резиденты РФ: организация, ИП или самозанятый. Профиль проходит верификацию, и без неё раздел «Чат-боты» не даст создать бота.",
          "title_en": "Set up a business profile at business.max.ru",
          "desc_en": "Only Russian residents can create MAX bots: a company, a sole proprietor or a self-employed person. Until the profile is verified, «Чат-боты» stays locked."
        },
        {
          "title": "Создайте бота в разделе «Чат-боты»",
          "desc": "Откройте «Чат-боты» → «Создать» и заполните карточку: логотип 500×500 px, название и описание. Ник подставится сам как idИНН_bot.",
          "title_en": "Create a bot in the «Чат-боты» section",
          "desc_en": "In your profile open «Чат-боты» → «Создать» and fill the card: a 500×500 px logo, a name and a description. The nickname is auto-generated as idИНН_bot."
        },
        {
          "title": "Дождитесь модерации бота",
          "desc": "Проверка занимает до 48 часов по рабочим дням. Статус «создан»: бот готов; «требует исправлений»: поправьте карточку и отправьте заново.",
          "title_en": "Wait for the bot to pass moderation",
          "desc_en": "Review takes up to 48 business hours. The status «создан» means the bot is ready; «требует исправлений» means fix the card and submit it again."
        },
        {
          "title": "Скопируйте токен из карточки бота",
          "desc": "Токен появляется в карточке бота только после успешной модерации. Скопируйте строку целиком и добавьте бота в чаты MAX, где он должен отвечать.",
          "title_en": "Copy the token from the bot card",
          "desc_en": "The token appears in the bot card only after moderation succeeds. Copy the whole string and invite the bot to the MAX chats where it should answer."
        }
      ]
    },
    "seo": {
      "title": "Подключение ИИ-агента к MAX: разбор файлов из чата",
      "description": "Прочитает накладную, присланную в рабочий чат, и сверит позиции с заказом; перескажет, что решили, пока вас не было. Работает ботом с бизнес-профиля MAX.",
      "headline": "Отвечайте в рабочих чатах MAX от имени своего бота",
      "scenarios": [
        {
          "title": "Ответы в рабочем чате",
          "desc": "Агент получит сообщение из чата MAX через вебхук, разберёт вопрос и ответит от имени бота, не дожидаясь, пока вы освободитесь."
        },
        {
          "title": "Разбор присланных файлов",
          "desc": "Агент прочитает вложения из чата (накладную, выгрузку, скриншот отчёта) и ответит по их содержимому прямо в переписке."
        },
        {
          "title": "Сводка по расписанию",
          "desc": "Агент отправит утреннюю сводку в нужный чат MAX в согласованное время, чтобы цифры приходили сами, без напоминаний."
        },
        {
          "title": "Кнопки и уточнения",
          "desc": "Агент задаст вопрос кнопками, обработает нажатие через callback и отредактирует своё сообщение, когда ответ уже не актуален."
        },
        {
          "title": "Что обсуждали без меня",
          "desc": "Агент прочитает историю чата страницами, от свежих сообщений к старым, и перескажет, о чём там договорились, пока вас не было в переписке."
        },
        {
          "title": "Файл прямо в чат",
          "desc": "Агент загрузит готовый отчёт или выгрузку в MAX и назовёт, в какой чат положил файл, а не пришлёт ссылку на сторонний диск."
        }
      ],
      "how_it_works": [
        "Агент работает через Bot API MAX на platform-api2.max.ru, а токен бота передаёт в заголовке авторизации. Первым запросом он вызывает get_me: так проверяется, что токен живой, и видно, от чьего имени будут уходить сообщения. Дальше в работе только те чаты, куда бот добавлен, с их перепиской, вложения и нажатия кнопок: накладную, выгрузку или скриншот отчёта агент читает прямо из ленты сообщений.",
        "Бот в MAX это участник чата, а не наблюдатель со стороны: пока его не добавили в беседу, ни одного сообщения оттуда агент не получит, и никакие права это не обойдут. Входящие приходят не опросом, а вебхуком: адрес регистрируется при подключении, MAX присылает новые сообщения и нажатия кнопок сам, а каждый запрос подписывает секретом в заголовке x-max-bot-api-secret.",
        "На запись это основной режим коннектора. Агент отвечает в переписке, показывает индикатор набора, пока готовит ответ, загружает файлы, задаёт уточняющие вопросы кнопками и обрабатывает нажатие через callback. Редактировать и удалять он может только собственные сообщения (чужие реплики в чате остаются нетронутыми), а сводку по расписанию отправляет в тот чат, который вы указали.",
        "Токен даёт права ровно этого бота и ничего сверх: личная переписка владельца профиля через него недоступна. Историю чата агент читает страницами, от свежих сообщений к старым, вложения забирает по ссылке из события, а частоту запросов выдерживает сам. Файл он отправляет загрузкой в MAX, а не ссылкой на сторонний диск, и называет, в какой чат его положил, вместо короткого «отправлено»."
      ],
      "requirements": [
        "Резидентство РФ: организация, ИП или самозанятый",
        "ИНН организации: из него формируется ник бота",
        "Права администратора в чатах, куда добавляете бота"
      ],
      "faq": [
        {
          "q": "Как подключить MAX Messenger?",
          "a": "Токеном бота. Заведите бизнес-профиль на business.max.ru, создайте бота в разделе «Чат-боты» и дождитесь модерации: токен появляется в карточке бота только после неё. Скопируйте строку целиком."
        },
        {
          "q": "Что агент видит в MAX?",
          "a": "Сообщения и вложения тех чатов, куда добавлен бот, и данные самого бота. Переписку, в которой бота нет, он не читает."
        },
        {
          "q": "Пишет ли агент в MAX?",
          "a": "Да, это основной сценарий: отправляет и редактирует сообщения, удаляет свои, загружает файлы, показывает индикатор набора и отвечает на нажатия кнопок."
        },
        {
          "q": "Кто может создать бота в MAX?",
          "a": "Только резиденты РФ: организация, ИП или самозанятый. Профиль проходит верификацию, а сам бот проходит модерацию до 48 часов по рабочим дням."
        }
      ]
    },
    "seo_en": {
      "title": "MAX AI agent: read invoices sent to work chats",
      "description": "Reads an invoice sent to a work chat and checks its lines against the order; recaps what was decided while you were away. Runs as a bot from a MAX business profile.",
      "headline": "Answer in MAX work chats as your own bot",
      "scenarios": [
        {
          "title": "Replies in a work chat",
          "desc": "The agent receives a message from a MAX chat over a webhook, works out the question and answers as the bot without waiting for you to free up."
        },
        {
          "title": "Reading the files people send",
          "desc": "The agent reads attachments from the chat (a delivery note, an export, a screenshot of a report) and answers on their content right in the thread."
        },
        {
          "title": "Scheduled digest",
          "desc": "The agent posts the morning digest to the right MAX chat at the agreed time, so the numbers arrive on their own, without reminders."
        },
        {
          "title": "Buttons and follow-up questions",
          "desc": "The agent asks a question with buttons, handles the tap through a callback and edits its own message once the answer is no longer relevant."
        },
        {
          "title": "What was discussed without you",
          "desc": "The agent reads chat history page by page, from the newest messages backwards, and retells what was agreed there while you were away from the thread."
        },
        {
          "title": "A file straight into the chat",
          "desc": "The agent uploads a finished report or export into MAX and names the chat it put the file in instead of passing around a link to an outside drive."
        }
      ],
      "how_it_works": [
        "The agent works through the MAX Bot API at platform-api2.max.ru and passes the bot token in the authorization header. Its first request is get_me: that checks the token is alive and shows whose name the messages will go out under. From there only the chats the bot has been added to are in play, with their conversations, attachments and button taps: a delivery note, an export or a screenshot of a report is read by the agent straight from the message feed.",
        "A bot in MAX is a chat participant, not an observer on the side: until it is added to a conversation the agent receives not a single message from there, and no permission gets around that. Incoming messages arrive not by polling but over a webhook: the address is registered at connection time, MAX pushes new messages and button taps itself, and signs every request with a secret in the x-max-bot-api-secret header.",
        "Writing is the main mode for this connector. The agent answers in the thread, shows the typing indicator while it prepares a reply, uploads files, asks follow-up questions with buttons and handles the tap through a callback. It can edit and delete only its own messages (other people's lines in the chat stay untouched), and a scheduled digest goes to the chat you named.",
        "The token carries exactly this bot's rights and nothing beyond: the profile owner's personal correspondence is out of reach through it. Chat history is read page by page, from the newest messages backwards, attachments are fetched by the link from the event, and the agent holds the request rate itself. A file goes out as an upload to MAX rather than a link to an outside drive, and the agent names the chat it landed in instead of a short «sent»."
      ],
      "requirements": [
        "Russian residency: a company, a sole trader or a self-employed person",
        "The company INN: the bot nickname is built from it",
        "Admin rights in the chats where the bot will be added"
      ],
      "faq": [
        {
          "q": "How do I connect MAX Messenger?",
          "a": "With a bot token. Create a business profile at business.max.ru, create a bot in the Chatbots section and wait for moderation: the token appears in the bot card only after it. Copy the whole string."
        },
        {
          "q": "What does the agent see in MAX?",
          "a": "Messages and attachments in the chats the bot has been added to, and the data of the bot itself. It does not read conversations where the bot is absent."
        },
        {
          "q": "Does the agent write to MAX?",
          "a": "Yes, that is the main scenario: it sends and edits messages, deletes its own, uploads files, shows the typing indicator and responds to button taps."
        },
        {
          "q": "Who can create a bot in MAX?",
          "a": "Only residents of Russia: a company, a sole trader or a self-employed person. The profile goes through verification and the bot itself through moderation, which takes up to 48 hours on business days."
        }
      ]
    }
  },
  {
    "key": "megamarket",
    "name": "МегаМаркет",
    "name_en": "Megamarket",
    "description": "Товары, заказы, остатки, цены, FBO-поставки, DBS-доставка, отчёты",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "megamarket",
    "short_name": "Мегамаркет",
    "short_name_en": "Megamarket",
    "description_en": "Products, orders, stock, prices, FBO supplies, DBS delivery and reports",
    "search_terms": [
      "сбермегамаркет"
    ],
    "guide": {
      "url": "https://partner.megamarket.ru",
      "steps": [
        {
          "title": "Войдите на partner.megamarket.ru админом",
          "desc": "Откройте partner.megamarket.ru под учётной записью с правами администратора кабинета: у пользователя с урезанными правами раздел с API не отображается.",
          "title_en": "Sign in to partner.megamarket.ru as admin",
          "desc_en": "Open partner.megamarket.ru with a user that has account administrator rights: with limited permissions the API section is simply not shown."
        },
        {
          "title": "В «Настройки» откройте «Интеграция по API»",
          "desc": "«Настройки» → «Интеграция по API». Если пункта нет, кабинет работает по FBO без API или не хватает прав: доступ включает поддержка в чате.",
          "title_en": "Under «Настройки» open «Интеграция по API»",
          "desc_en": "«Настройки» → «Интеграция по API» (Settings → API integration). Missing? The account is FBO-only or lacks rights: support enables it in chat."
        },
        {
          "title": "Скопируйте «Авторизационный токен»",
          "desc": "На странице есть строка «Авторизационный токен» с кнопкой копирования рядом. Это то самое значение, которое МегаМаркет ждёт в заголовке X-Merchant-Token.",
          "title_en": "Copy the «Авторизационный токен» row",
          "desc_en": "The page shows an «Авторизационный токен» row with a copy button next to it. This is the value Megamarket expects in the X-Merchant-Token header."
        },
        {
          "title": "Убедитесь, что токен боевой",
          "desc": "Для тестовой и боевой среды токены разные: тестовый на боевых запросах вернёт 401. Берите тот, что относится к рабочей среде кабинета.",
          "title_en": "Make sure the token is the production one",
          "desc_en": "Sandbox and production tokens differ: a sandbox one answers 401 on live calls. Take the token that belongs to the production account."
        }
      ]
    },
    "seo": {
      "title": "Мегамаркет и ИИ-агент: сверка витрины с МойСкладом",
      "description": "Сверит цены и остатки витрины Мегамаркета с вашей учёткой, назовёт расходящиеся SKU и загрузит новый прайс пакетом. Работает по токену продавца через Seller API.",
      "headline": "Следите за заказами и отгрузками МегаМаркета в одном чате",
      "scenarios": [
        {
          "title": "Сводка заказов и отгрузок",
          "desc": "Агент соберёт заказы МегаМаркета по статусам, найдёт зависшие отгрузки и посчитает выручку за период по схемам FBO и DBS."
        },
        {
          "title": "Сверка цен и остатков с учёткой",
          "desc": "Агент сверит цены и остатки на витрине с 1С или МойСклад и покажет расхождения до того, как они превратятся в отмены."
        },
        {
          "title": "Отчёт по продажам для планёрки",
          "desc": "Агент подготовит недельный отчёт: динамика заказов, топ-товары, отмены и причины, и пришлёт его в Telegram по расписанию."
        },
        {
          "title": "Проверка карточек по категориям",
          "desc": "Агент пройдёт по каталогу, сверит характеристики карточек с требованиями их категорий и покажет, где не хватает обязательных полей для витрины."
        },
        {
          "title": "Товары на грани нуля",
          "desc": "Агент сопоставит остатки со скоростью заказов за последние недели и назовёт товары, которых хватит на пару дней, пока поставку ещё можно успеть."
        },
        {
          "title": "Обновление цен пакетом",
          "desc": "Агент возьмёт новый прайс, покажет, что уедет на витрину, отправит цены пакетом после подтверждения и перечитает результат по каждой позиции."
        }
      ],
      "how_it_works": [
        "Агент обращается к Seller API МегаМаркета и держит в поле зрения весь контур кабинета: товары и категории, цены и остатки, заказы по схемам FBO и DBS, поставки, отгрузки и отчёты. Он считает выручку за период, разбирает заказы по статусам, находит зависшие отгрузки и называет причины отмен: не выгрузкой на скачивание, а разбором, из которого понятно, где именно магазин теряет деньги.",
        "Каталог МегаМаркета держится на дереве категорий: набор характеристик у карточки задаётся её категорией, поэтому агент начинает с чтения категорий и только потом трогает товары. Цены и остатки при этом живут отдельными разделами: отправленная цена не двигает остаток, а обновлённый остаток не меняет цену. Расхождения витрины с учётной системой агент показывает до того, как они превращаются в отмены.",
        "Уведомлений МегаМаркет не присылает, поэтому новые заказы и застрявшие отгрузки агент забирает опросом: по вашему вопросу или по расписанию, если нужна регулярная сводка. Изменения цен и остатков он отправляет пакетами и перечитывает результат вместо того, чтобы поверить успешному коду ответа, а перед массовой правкой цен останавливается и показывает, что именно уедет на витрину.",
        "Работа идёт одним токеном продавца, который уходит отдельным заголовком: входа под вашей учётной записью не происходит, а удаление токена в кабинете закрывает доступ сразу, и агент об этом скажет, а не вернёт молча ноль. Заказы и отчёты Seller API отдаёт окнами по датам, поэтому длинный период агент режет на отрезки и склеивает результат сам. Частоту запросов он выдерживает сам, а про недоступный раздел скажет прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права администратора в кабинете продавца МегаМаркета.",
        "Включённый доступ к Seller API, иначе раздел скрыт.",
        "Подключённая схема работы FBO или DBS."
      ],
      "faq": [
        {
          "q": "Как подключить МегаМаркет?",
          "a": "API-токеном из кабинета продавца МегаМаркета. Токен вставляется один раз при подключении и хранится в зашифрованном виде."
        },
        {
          "q": "Какие данные доступны агенту?",
          "a": "Товары, заказы, остатки, цены, категории, поставки FBO, доставка DBS и отчёты: весь контур Seller API МегаМаркета."
        },
        {
          "q": "Можно ли автоматизировать регулярные отчёты?",
          "a": "Да. Задачи по расписанию входят в продукт: агент сам соберёт данные к назначенному времени и пришлёт сводку в Telegram или на почту."
        }
      ]
    },
    "seo_en": {
      "title": "Megamarket AI agent: storefront check against your stock",
      "description": "Reconciles Megamarket storefront prices and stock with your records, names the SKUs that differ and uploads a new price list in batches via a Seller API token.",
      "headline": "Follow MegaMarket orders and shipments from a single chat",
      "scenarios": [
        {
          "title": "Orders and shipments at a glance",
          "desc": "The agent collects MegaMarket orders by status, finds shipments that are stuck and totals revenue for the period across the FBO and DBS schemes."
        },
        {
          "title": "Reconcile prices and stock with your books",
          "desc": "The agent reconciles storefront prices and stock against 1C or MoySklad and shows discrepancies before they turn into cancellations."
        },
        {
          "title": "Sales report for the weekly stand-up",
          "desc": "The agent prepares a weekly report with order dynamics, top products, cancellations and their reasons, and sends it to Telegram on schedule."
        },
        {
          "title": "Listings checked against their categories",
          "desc": "The agent walks the catalogue, checks listing attributes against what each category requires and shows where the storefront is missing mandatory fields."
        },
        {
          "title": "Products about to run out",
          "desc": "The agent matches stock against the order pace of the past few weeks and names the products with a couple of days left, while a supply can still make it."
        },
        {
          "title": "A price list pushed in one go",
          "desc": "The agent takes the new price list, shows what is about to reach the storefront, sends the prices in batches once you confirm and re-reads every position."
        }
      ],
      "how_it_works": [
        "The agent calls the MegaMarket Seller API and keeps the whole scope of the account in view: products and categories, prices and stock, orders under the FBO and DBS schemes, supplies, shipments and reports. It totals revenue for a period, breaks orders down by status, finds shipments that are stuck and names the reasons for cancellations, not as a download, but as an analysis that makes it clear where exactly the shop loses money.",
        "The MegaMarket catalogue rests on a category tree: the set of attributes a listing has is defined by its category, so the agent starts by reading the categories and only then touches the products. Prices and stock meanwhile live in sections of their own: a price you send moves no stock, and an updated stock figure changes no price. Discrepancies between the storefront and your books are shown before they turn into cancellations.",
        "MegaMarket sends no notifications, so new orders and stalled shipments are picked up by polling: on your question, or on a schedule when a regular digest is needed. Price and stock changes are sent in batches and the result is re-read rather than taken on trust from a successful response code, and before a bulk price edit the agent stops and shows exactly what is about to reach the storefront.",
        "The work runs on a single seller token passed in a header of its own: there is no sign-in under your account, and deleting the token in the cabinet closes access at once, and the agent then says so instead of quietly returning zero. Orders and reports come out of the Seller API in date windows, so a long period is cut into slices and stitched back together by the agent. It holds the request rate itself, and about an unavailable section it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Cabinet administrator rights in the MegaMarket seller account.",
        "Seller API access enabled, otherwise the section stays hidden.",
        "The FBO or DBS scheme enabled in the account."
      ],
      "faq": [
        {
          "q": "How do I connect MegaMarket?",
          "a": "With an API token from your MegaMarket seller account. The token is entered once at connection time and stored encrypted."
        },
        {
          "q": "What data is available to the agent?",
          "a": "Products, orders, stock, prices, categories, FBO supply, DBS delivery and reports, the whole scope of the MegaMarket Seller API."
        },
        {
          "q": "Can regular reports be automated?",
          "a": "Yes. Scheduled tasks are part of the product: the agent gathers the data by the appointed time and sends the digest to Telegram or by email."
        }
      ]
    }
  },
  {
    "key": "megaplan",
    "name": "Мегаплан",
    "name_en": "Megaplan",
    "description": "Сделки, задачи, проекты, контакты, события",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "never",
    "has_own_page": false,
    "integration_slug": "megaplan-app",
    "description_en": "Deals, tasks, projects, contacts and events",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://megaplan.ru",
      "steps": [
        {
          "title": "Скопируйте адрес Мегаплана из адресной строки",
          "desc": "Адрес аккаунта виден в адресной строке: company.megaplan.ru или m123456789.megaplan.ru. Нужен весь адрес вместе с https://.",
          "title_en": "Copy your Megaplan address from the URL bar",
          "desc_en": "Your account address is in the address bar: company.megaplan.ru or m123456789.megaplan.ru. Keep the whole address, https:// included."
        },
        {
          "title": "Выберите учётную запись для агента",
          "desc": "Агент видит ровно то, что видит сотрудник. У ролей «Директор» и «Администратор» права максимальные, у рядового только его сделки и задачи.",
          "title_en": "Choose the account the agent will use",
          "desc_en": "The agent sees exactly what the employee sees. «Директор» and «Администратор» hold the widest rights; a regular employee only their own deals."
        },
        {
          "title": "Заведите сотрудника в «Сотрудники»",
          "desc": "Если отдельной учётной записи для агента ещё нет, добавьте сотрудника с рабочим e-mail: на него придёт приглашение с первым входом.",
          "title_en": "Add the account in «Сотрудники» (Employees)",
          "desc_en": "If the agent has no account yet, add an employee with a working e-mail. The invitation arrives there, and the first sign-in sets the password."
        },
        {
          "title": "Откройте /api/v3/docs под этой записью",
          "desc": "Под этой записью откройте адрес аккаунта с путём /api/v3/docs: список методов виден только авторизованному. Дальше нужны адрес, e-mail и пароль.",
          "title_en": "Open /api/v3/docs as that employee",
          "desc_en": "As that employee, open your account address with /api/v3/docs. The method list opens only for an authorized user."
        }
      ]
    }
  },
  {
    "key": "megaplan_app",
    "name": "Мегаплан",
    "name_en": "Megaplan",
    "description": "Сделки, задачи, проекты, контакты, события",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "megaplan-app",
    "description_en": "Deals, tasks, projects, contacts and events",
    "variant_of": "megaplan",
    "far_end_rule": "by_host",
    "guide": {
      "url": "https://megaplan.ru",
      "steps": [
        {
          "title": "Скопируйте из браузера адрес аккаунта",
          "desc": "Скопируйте из браузера полный адрес, например https://company.megaplan.ru.",
          "title_en": "Copy the account address from the browser",
          "desc_en": "Copy the complete address from the browser, for example https://company.megaplan.ru."
        },
        {
          "title": "В настройках интеграций создайте токен",
          "desc": "В настройках интеграций Мегаплана создайте токен с теми правами, которые нужны агенту.",
          "title_en": "In integration settings, create a token",
          "desc_en": "In Megaplan's integration settings, create a token for the account and permissions the agent should use."
        },
        {
          "title": "Вставьте адрес и токен",
          "desc": "Укажите адрес аккаунта и токен приложения. Пароль сотрудника сохранять не нужно.",
          "title_en": "Paste the address and token",
          "desc_en": "Enter the account address and application token; no employee password is stored."
        }
      ]
    },
    "seo": {
      "title": "Мегаплан с ИИ: сводка по сделкам к планёрке",
      "description": "Сделки, задачи и события 9 менеджеров за месяц сведены в одну сводку к планёрке. Агент читает API Мегаплана и находит контрагентов, выпавших из сделок.",
      "headline": "Собирайте сводку по сделкам Мегаплана к утренней планёрке",
      "scenarios": [
        {
          "title": "Сводка по сделкам в воронке",
          "desc": "Агент соберёт сделки Мегаплана по этапам и менеджерам, найдёт зависшие и посчитает суммы в работе за период."
        },
        {
          "title": "Контроль просроченных задач",
          "desc": "Агент проверит задачи и проекты, выделит просроченные и подходящие к дедлайну и пришлёт список ответственным."
        },
        {
          "title": "Отчёт по активности менеджеров",
          "desc": "Агент сведёт сделки, задачи и события по сотрудникам и покажет, кто тянет план, а у кого копятся зависшие сделки."
        },
        {
          "title": "Заявки и обращения в задачи",
          "desc": "Агент разберёт входящие обращения, заведёт по ним задачи или сделки в Мегаплане и назначит ответственных по вашим правилам."
        },
        {
          "title": "Клиенты без движения",
          "desc": "Агент пройдёт по контрагентам и их сделкам и покажет, кто не появлялся в новых сделках дольше квартала и на какую сумму покупал раньше."
        }
      ],
      "how_it_works": [
        "Агент обращается к API Мегаплана третьей версии на адресе вашего аккаунта: сделки, задачи, проекты и контрагенты, то есть четыре раздела, из которых собирается почти любой отчёт. По ним считаются суммы в работе по этапам и менеджерам, зависшие сделки, просроченные и подходящие к дедлайну задачи, активность сотрудников за период. Карточку конкретной сделки или задачи он дочитывает отдельным запросом, когда нужны детали, а не тянет всё подряд.",
        "У Мегаплана свой стиль запросов: фильтры, поля и сортировка передаются JSON-структурой прямо в адресе, а связанные сущности приходят ссылками: контрагент в сделке это идентификатор, а не название. Поэтому агент перечисляет нужные поля и подтягивает связи адресно, иначе ответ распухает, а в отчёте вместо клиента остаётся номер. Мегаплан совмещает CRM и трекер, и ответственный за задачу далеко не всегда менеджер сделки, и агент их не путает.",
        "На запись агент создаёт сделки и задачи, меняет статусы и назначает ответственных: например, разбирает входящие обращения и заводит по ним карточки по вашим правилам. Смену статуса сделки он подтверждает отдельно: в Мегаплане это событие, на которое навешаны уведомления и переходы.",
        "Подключение идёт по адресу аккаунта и токену приложения, созданному в настройках интеграций Мегаплана: агент работает с теми правами, которые выданы токену, а пароль сотрудника не хранится. Длинные списки Мегаплан отдаёт страницами с ограничением на размер выборки, поэтому период агент проходит постранично и складывает итог сам, а не обрывает отчёт на первой сотне. Запросы к сделкам, задачам, контрагентам и проектам идут в щадящем темпе, групповые операции ещё реже. Если записей за период нет, агент скажет это прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Аккаунт Мегаплана на собственном поддомене",
        "Токен приложения с правами на сделки, задачи и проекты",
        "Права на запись, если агент создаёт задачи и меняет статусы"
      ],
      "faq": [
        {
          "q": "Как подключить Мегаплан?",
          "a": "Адресом аккаунта и токеном приложения: токен создаётся в настройках интеграций Мегаплана, и агент видит сделки, задачи и проекты, на которые у токена есть права."
        },
        {
          "q": "Какие данные видит агент?",
          "a": "Сделки, задачи, проекты, контакты и события в рамках прав токена. Права можно ограничить при создании токена."
        },
        {
          "q": "Может ли агент менять данные в Мегаплане?",
          "a": "Да, если у токена есть права: агент может создавать задачи и сделки, менять их статусы и назначать ответственных. С доступом только на чтение агент лишь анализирует."
        },
        {
          "q": "Как быстро появляются данные после подключения?",
          "a": "Сразу: агент обращается к API Мегаплана напрямую по вашему запросу, без промежуточных выгрузок."
        }
      ]
    },
    "seo_en": {
      "title": "Megaplan with AI: a deal summary ready for the stand-up",
      "description": "Deals, tasks and events of 9 managers for the month in one stand-up summary. The agent reads the Megaplan API and finds accounts that dropped out of deals.",
      "headline": "Get the Megaplan deal summary ready before the stand-up",
      "scenarios": [
        {
          "title": "Deal pipeline at a glance",
          "desc": "The agent collects Megaplan deals by stage and manager, finds the ones that are stuck and totals the value in play for the period."
        },
        {
          "title": "Keep overdue tasks in check",
          "desc": "The agent reviews tasks and projects, singles out the ones overdue or nearing a deadline and sends the list to the people responsible."
        },
        {
          "title": "Manager activity report",
          "desc": "The agent combines deals, tasks and events per employee and shows who is carrying the plan and who is piling up stalled deals."
        },
        {
          "title": "Turn inbound requests into tasks",
          "desc": "The agent sorts incoming requests, creates tasks or deals for them in Megaplan and assigns owners by your rules."
        },
        {
          "title": "Clients gone quiet",
          "desc": "The agent walks the contractors and their deals and shows who has not turned up in a new deal for over a quarter and how much they used to buy."
        }
      ],
      "how_it_works": [
        "The agent calls the third version of the Megaplan API at your account address: deals, tasks, projects and contractors, the four sections that almost any report is assembled from. On them it totals the value in play by stage and manager, stalled deals, tasks overdue or nearing a deadline, and employee activity for the period. The card of a particular deal or task is read with a separate request when the details are needed, rather than pulled in wholesale.",
        "Megaplan has its own request style: filters, fields and sorting are passed as a JSON structure right inside the address, and related entities arrive as references: the contractor on a deal is an identifier, not a name. So the agent lists the fields it needs and pulls relations deliberately, otherwise the response swells and the report shows a number where the client should be. Megaplan combines a CRM and a tracker, and the owner of a task is far from always the manager of the deal, and the agent does not confuse the two.",
        "As writes the agent creates deals and tasks, changes statuses and assigns owners: it can sort incoming requests and open cards for them by your rules. A deal status change is confirmed separately: in Megaplan that is an event with notifications and transitions hanging off it.",
        "The connection runs on the account address and an application token created in Megaplan's integration settings: the agent works within the rights granted to the token, and no employee password is stored. Megaplan hands out long lists in pages with a cap on the selection size, so the agent walks the period page by page and adds the total up itself instead of cutting the report off at the first hundred. Requests to deals, tasks, contractors and projects go at a gentle pace, and bulk operations rarer still. If there are no records for the period, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A Megaplan account on its own subdomain",
        "An application token with access to deals, tasks and projects",
        "Write permissions if the agent creates tasks and changes statuses"
      ],
      "faq": [
        {
          "q": "How do I connect Megaplan?",
          "a": "With the account address and an application token: the token is created in Megaplan's integration settings, and the agent sees the deals, tasks and projects the token has rights to."
        },
        {
          "q": "What data does the agent see?",
          "a": "Deals, tasks, projects, contacts and events, within the token's permissions. You can restrict them when creating the token."
        },
        {
          "q": "Can the agent change data in Megaplan?",
          "a": "Yes, if the token has the rights: the agent can create tasks and deals, change their statuses and assign owners. With read-only access the agent only analyses."
        },
        {
          "q": "How soon does data appear after connecting?",
          "a": "Right away: the agent calls the Megaplan API directly on your request, with no intermediate exports."
        }
      ]
    }
  },
  {
    "key": "modbus_tcp",
    "name": "Modbus TCP / RTU over TCP",
    "name_en": "Modbus TCP / RTU over TCP",
    "description": "Регистры Modbus TCP или RTU поверх TCP через программу сбора данных по карте тегов, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "modbus-tcp",
    "short_name": "Modbus TCP",
    "short_name_en": "Modbus TCP",
    "description_en": "Read-only Modbus TCP or RTU over TCP registers by tag map through a data collection program",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Выберите режим передачи устройства",
          "desc": "tcp сопоставляет запрос и ответ по ID транзакции. RTU не различает одинаковые поздние ответы; если устройство или преобразователь умеет Modbus TCP, выберите tcp.",
          "title_en": "Choose the device's transmission mode",
          "desc_en": "tcp matches each reply by transaction ID. RTU cannot distinguish identical late replies; choose tcp if the device or the serial converter supports Modbus TCP."
        },
        {
          "title": "Для RTU оставьте одного мастера линии",
          "desc": "rtu_over_tcp требует прозрачного режима преобразователя интерфейсов. Отключите других мастеров и клиентов TCP, получающих копии того же потока.",
          "title_en": "Keep one master on the RTU line",
          "desc_en": "rtu_over_tcp requires a serial converter in transparent mode. Disconnect other masters and TCP clients that receive copies of the same stream."
        }
      ]
    },
    "seo": {
      "title": "Modbus TCP и ИИ-агент: расход по счётчику",
      "description": "Расход воды за месяц по дням из пары регистров накопительного счётчика. Регистры Modbus TCP или RTU поверх TCP опрашивает программа сбора по карте тегов, без записи.",
      "headline": "Регистры устройств Modbus прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по пути, например line1/tank, и покажет текущие значения регистров и катушек со временем отсчёта и пометкой, свежие ли они."
        },
        {
          "title": "Сводка за сутки",
          "desc": "Агент возьмёт историю температуры, давления или мощности за сутки и по часам покажет минимум, максимум, среднее и последнее значение."
        },
        {
          "title": "Расход по счётчику",
          "desc": "Агент заберёт показания накопительного счётчика из пары регистров за месяц и посчитает расход по дням."
        },
        {
          "title": "Задача на выход за порог",
          "desc": "Агент заведёт задачу, которая запустится, когда значение тега выйдет за порог и продержится заданное время, а не на каждый отсчёт за порогом."
        },
        {
          "title": "Теги с исключением",
          "desc": "Агент назовёт теги, на которые устройство ответило исключением, и его код, например 0x02 (нет такого адреса) или 0x0B (устройство за преобразователем не ответило)."
        },
        {
          "title": "Пропуски в данных",
          "desc": "Агент покажет промежутки истории без отсчётов и скажет, на связи ли сервер сбора сейчас."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и ходит к устройству по Modbus TCP, порт 502, или к преобразователю интерфейсов RS-485 в TCP в режиме RTU поверх TCP. В подключении указываются адрес, номер устройства (по умолчанию 1) и карта регистров: по строке на тег путь, адрес и тип, например holding.100 float32. Наружу программа отправляет данные только исходящим соединением.",
        "Адрес пишется от нуля, как в запросе: регистр 40001 из руководства это holding.0, а 30010 это input.9. Значения в 2 и 4 регистрах читаются в порядке байт из руководства устройства (ABCD, CDAB, BADC, DCBA), и тег может задать свой. Соседние теги одной области и одного устройства читаются одним запросом, до 125 регистров или 2000 битов; пропуск между тегами по умолчанию 0, потому что регистр без карты даёт исключение всему запросу.",
        "Драйвер только читает: из функций Modbus он посылает чтение катушек, дискретных входов, holding и input регистров (коды 1 до 4). Записи и комбинированных функций в нём нет. Исключение устройства помечает плохими теги этого запроса со своим кодом, а ответ «занято» пропускает один опрос; остальные устройства за тем же преобразователем читаются дальше.",
        "В режиме RTU поверх TCP у кадра нет номера транзакции, поэтому программа сбора держит один запрос за раз и после нового соединения выжидает одно время ответа, чтобы поздний ответ прошлого запроса не попал в тег. Для медленного устройства есть паузы после соединения и между запросами. Если связь с облаком рвётся, данные копятся на диске сервера сбора и приходят после восстановления."
      ],
      "requirements": [
        "Устройство Modbus TCP или преобразователь интерфейсов в прозрачном режиме",
        "Доступ с сервера сбора к порту 502 или к порту преобразователя интерфейсов",
        "Карта регистров из руководства устройства: адреса, типы, порядок байт",
        "Номер устройства (unit id), если он не 1",
        "Сервер сбора в сети объекта: Windows или Linux с Docker"
      ],
      "faq": [
        {
          "q": "Как подключить Modbus TCP?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Modbus TCP и укажите адрес устройства, например tcp://10.0.12.5:502, номер устройства, порядок байт и карту регистров: по строке путь, адрес и тип, например line1/tank/level holding.100 float32 unit=°C. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Modbus TCP?",
          "a": "Теги из карты регистров: катушки, дискретные входы, holding и input регистры, целые и дробные значения до 64 бит, отдельные биты регистра и строки. Для каждого тега агент читает текущее значение со временем отсчёта, историю интервалами и сырые отсчёты."
        },
        {
          "q": "Меняет ли агент значения в ПЛК?",
          "a": "Нет. Драйвер посылает только функции чтения 1 до 4, функций записи в нём нет. Агент ничего не пишет в устройство."
        },
        {
          "q": "Как перевести номер регистра из руководства?",
          "a": "Номер вида 40001 считается от единицы, а первая цифра называет область: 4 это holding, 3 это input. Номер пишется от нуля без этой цифры: 40001 это holding.0, 30010 это input.9. Бит регистра пишется через точку, например holding.100.3."
        }
      ]
    },
    "seo_en": {
      "title": "Modbus TCP and an AI agent: meter usage by day",
      "description": "A month of water usage per day from a totalizing meter held in a register pair. A collection program polls Modbus TCP or RTU over TCP by a tag map, read only.",
      "headline": "Modbus device registers right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by path, such as line1/tank, and shows current values of registers and coils with their timestamp and whether they are fresh."
        },
        {
          "title": "Daily summary",
          "desc": "The agent takes the temperature, pressure or power history for a day and shows the minimum, maximum, average and last value per hour."
        },
        {
          "title": "Usage from a meter",
          "desc": "The agent takes a month of readings of a totalizing meter held in a register pair and works out the usage per day."
        },
        {
          "title": "A task on a threshold",
          "desc": "The agent sets up a task that fires when a tag goes past a threshold and stays there for a set time, not on every sample past it."
        },
        {
          "title": "Tags with an exception",
          "desc": "The agent names tags the device answered with an exception and its code, such as 0x02 (no such address) or 0x0B (the device behind a converter did not answer)."
        },
        {
          "title": "Gaps in the data",
          "desc": "The agent shows history intervals without samples and says whether the collection server is online right now."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network and reaches the device over Modbus TCP, port 502, or an RS-485 to TCP converter in RTU over TCP mode. The connection takes the address, the unit id (1 by default) and a register map: one line per tag with a path, an address and a type, such as holding.100 float32. The program sends data out over outbound connections only.",
        "Addresses count from zero, as in the request: register 40001 of a manual is holding.0, and 30010 is input.9. Values in 2 and 4 registers are read in the byte order of the device manual (ABCD, CDAB, BADC, DCBA), and a tag may set its own. Neighbouring tags of one area and one unit are read in one request, up to 125 registers or 2000 bits; the gap between tags is 0 by default, because an unmapped register gives the whole request an exception.",
        "The driver only reads: of the Modbus functions it sends read coils, discrete inputs, holding and input registers (codes 1 to 4). It has no write or combined functions. A device exception marks the tags of that request bad with its code, and a busy answer skips one scan; other units behind the same converter keep reading.",
        "In RTU over TCP mode a frame has no transaction id, so the collection program keeps one request at a time and after a new connection waits one answer timeout so that a late answer to an earlier request does not reach a tag. A slow device gets pauses after connecting and between requests. If the link to the cloud drops, data piles up on the collection server's disk and arrives once it is back."
      ],
      "requirements": [
        "A Modbus TCP device or a serial converter in transparent mode",
        "Access from the collection server to port 502 or the serial converter's port",
        "A register map from the device manual: addresses, types, byte order",
        "The unit id, if it is not 1",
        "A collection server on the site network: Windows or Linux with Docker"
      ],
      "faq": [
        {
          "q": "How do I connect Modbus TCP?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick Modbus TCP and enter the device address, such as tcp://10.0.12.5:502, the unit id, the byte order and a register map: one line per tag with a path, an address and a type, such as line1/tank/level holding.100 float32 unit=°C. The collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in Modbus TCP?",
          "a": "The tags of the register map: coils, discrete inputs, holding and input registers, integer and floating values up to 64 bits, single bits of a register and strings. For each tag the agent reads the current value with its timestamp, the history in intervals and raw samples."
        },
        {
          "q": "Does the agent change values in the PLC?",
          "a": "No. The driver sends only the read functions 1 to 4 and has no write functions. The agent writes nothing to the device."
        },
        {
          "q": "How do I convert a register number from the manual?",
          "a": "A number like 40001 counts from one, and its first digit names the area: 4 is holding, 3 is input. The address drops that digit and counts from zero: 40001 is holding.0, 30010 is input.9. A bit of a register follows a dot, such as holding.100.3."
        }
      ]
    }
  },
  {
    "key": "modulbank",
    "name": "Модульбанк",
    "name_en": "Modulbank",
    "description": "Счета, баланс, история операций, платёжные поручения",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "modulbank",
    "description_en": "Accounts, balance, transaction history and payment orders",
    "guide": {
      "url": "https://my.modulbank.ru",
      "steps": [
        {
          "title": "Войдите под учётной записью со счетами",
          "desc": "Токен привязан к учётной записи, под которой сгенерирован, и видит только её компании и счета; чужие в списке не появятся.",
          "title_en": "Sign in with the login holding the accounts",
          "desc_en": "The token is bound to the login it was generated under and only sees that login's companies and accounts. No others show up."
        },
        {
          "title": "В меню «+» выберите «Интеграция с банком»",
          "desc": "Короткий путь из кабинета банка к экрану генерации токена: меню «+» → «Интеграция с банком» → сгенерируйте токен.",
          "title_en": "In the “+” menu pick «Интеграция с банком»",
          "desc_en": "The short route from the bank dashboard to the token screen: the “+” menu → «Интеграция с банком» (Integration with the bank) → generate the token."
        },
        {
          "title": "Либо «API Банка» в разделе «Услуги»",
          "desc": "Тот же экран длинным путём: «Настройки» → «Услуги» → «API Банка» → «Генерация токена авторизации». Туда же ведёт пункт «Подключиться к API» в меню действий.",
          "title_en": "Or open «API Банка» under «Услуги»",
          "desc_en": "The same screen the long way: «Настройки» → «Услуги» → «API Банка» → «Генерация токена авторизации» (Settings → Services → Bank API → token generation)."
        },
        {
          "title": "Отметьте account-info и operation-history",
          "desc": "На экране генерации отметьте account-info и operation-history: первый отдаёт компании и счета, второй историю операций.",
          "title_en": "Tick account-info and operation-history",
          "desc_en": "On the generation screen tick account-info and operation-history: the first returns companies and accounts, the second the history."
        },
        {
          "title": "Скопируйте токен и сохраните отдельно",
          "desc": "Токен выдаётся на 3 года, по истечении срока аннулируется автоматически, отозвать раньше можно по API. Он равен доступу в кабинет.",
          "title_en": "Copy the token and store it separately",
          "desc_en": "The token is issued for 3 years, stays the same and is annulled automatically afterwards; it can be revoked earlier via the API. It equals account access."
        }
      ]
    },
    "seo": {
      "title": "Модульбанк API и ИИ: сделки без оплаты и расходы",
      "description": "Выигранные сделки в CRM, по которым деньги так и не пришли, агент найдёт по счетам Модульбанка, а списания месяца разложит по контрагентам.",
      "headline": "Держите остатки и операции Модульбанка под контролем в чате",
      "scenarios": [
        {
          "title": "Ежедневный отчёт по счетам",
          "desc": "Агент проверит балансы и операции по счетам Модульбанка и пришлёт сводку с ключевыми движениями за день."
        },
        {
          "title": "Сверка оплат с CRM",
          "desc": "Агент сопоставит поступления в банке со сделками в CRM и покажет выигранные сделки без оплаты."
        },
        {
          "title": "Разбор расходов по категориям",
          "desc": "Агент разложит списания за месяц по категориям и контрагентам и покажет, куда утекают деньги."
        },
        {
          "title": "Платёжка на подпись",
          "desc": "Агент соберёт платёжное поручение, проверит реквизиты, сумму и назначение и покажет черновик, а подпись и отправка остаются в интернет-банке Модульбанка."
        },
        {
          "title": "Все юрлица одним отчётом",
          "desc": "Агент возьмёт из справки все компании и счета, доступные токену, и сведёт остатки в один отчёт, считая валютные и рублёвые счета раздельно."
        },
        {
          "title": "Что дописалось задним числом",
          "desc": "Агент перечитает уже показанный период и найдёт проводки, которые банк добавил задним числом, вместе с тем, как из-за них изменился остаток."
        }
      ],
      "how_it_works": [
        "Работа начинается со справки о компаниях и счетах: агент запрашивает account-info, получает список юрлиц и расчётных счетов, доступных токену, и уже от него идёт в историю операций. Дальше он считает остатки на дату, движения за день или месяц, раскладывает списания по контрагентам и категориям и сопоставляет поступления со сделками CRM, чтобы показать выигранные сделки, за которые деньги так и не пришли.",
        "Историю операций Модульбанк отдаёт постранично и по датам, а не одним куском, поэтому месяц агент собирает частями и держит порядок по дате проводки. Валютные и рублёвые счета он считает раздельно, не складывая суммы в одну цифру, а приход и расход различает по направлению платежа, а не по знаку суммы в выписке.",
        "На запись агент доходит только до черновика: платёжное поручение он собирает, проверяет реквизиты, сумму и назначение и показывает вам, но подпись и отправка остаются в интернет-банке Модульбанка. Это не ограничение коннектора, а устройство банка: деньги уходят только после вашего подтверждения на его стороне. Всё остальное, от ежедневной сводки до месячного разбора расходов, агент делает на чтение.",
        "Частоту запросов агент выдерживает сам и длинную выписку растягивает во времени вместо параллельных вызовов. Уже показанный период он перечитывает при следующем заходе, потому что банк дописывает проводки задним числом и вчерашний остаток к утру меняется. Если за период операций нет или токену не хватает доступа, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Учётная запись с доступом к нужным компаниям и счетам",
        "Подключение к API бесплатно на всех тарифах, заявка не нужна",
        "Подпись и отправка платежей остаются в банке, агент только читает"
      ],
      "faq": [
        {
          "q": "Как подключить Модульбанк?",
          "a": "API-токеном из интернет-банка Модульбанка. Токен вводится один раз при подключении и хранится в зашифрованном виде."
        },
        {
          "q": "Что агент может делать со счетами?",
          "a": "Читать счета, балансы и историю операций, готовить черновики платёжных поручений. Подпись и отправка платежей остаются в банке."
        },
        {
          "q": "Подходит ли для нескольких счетов?",
          "a": "Да, агент видит все счета, доступные токену, и умеет сводить их в один отчёт."
        }
      ]
    },
    "seo_en": {
      "title": "Modulbank API and AI: unpaid deals and spending",
      "description": "The agent finds won CRM deals with no matching payment in the bank and breaks the month's debits down by counterparty. Connects with one API token.",
      "headline": "Keep Modulbank balances and transactions under control in chat",
      "scenarios": [
        {
          "title": "Daily report across your accounts",
          "desc": "The agent checks balances and transactions on your Modulbank accounts and sends a digest of the key movements for the day."
        },
        {
          "title": "Match payments against CRM",
          "desc": "The agent matches incoming bank payments with CRM deals and shows won deals that have not been paid."
        },
        {
          "title": "Spend broken down by category",
          "desc": "The agent splits the outgoing payments of the month by category and counterparty and shows where the money is leaking."
        },
        {
          "title": "A payment order to sign",
          "desc": "The agent assembles a payment order, checks the details, the amount and the purpose and shows you the draft, while signing and sending stay in the Modulbank online bank."
        },
        {
          "title": "Every entity in one report",
          "desc": "The agent takes every company and account the token can reach and rolls their balances into one report, counting currency and rouble accounts apart."
        },
        {
          "title": "Entries posted after the fact",
          "desc": "The agent re-reads a period it has already shown and finds the entries the bank added with a back date, along with how they moved the balance."
        }
      ],
      "how_it_works": [
        "The work starts from the reference on companies and accounts: the agent requests account-info, gets the list of legal entities and settlement accounts the token can reach, and moves on to the transaction history from there. Then it calculates balances as of a date, movements for a day or a month, splits outgoing payments by counterparty and category and matches incoming funds against CRM deals to show the won deals the money never arrived for.",
        "Modulbank returns the transaction history page by page and by date rather than in one lump, so a month is collected in parts and kept in the order of the posting date. Foreign-currency and rouble accounts are counted separately instead of being added into a single figure, and money in and money out are told apart by the direction of the payment, not by the sign of the amount in the statement.",
        "On the write side the agent goes only as far as a draft: it assembles a payment order, checks the details, the amount and the purpose and shows it to you, but signing and sending stay in the Modulbank online bank. That is not a connector limitation but how the bank is built: money leaves only after your confirmation on its side. Everything else, from the daily digest to the monthly spend breakdown, the agent does read-only.",
        "The agent holds the request rate itself and spreads a long statement over time instead of firing parallel calls. A period it has already shown is re-read on the next run, because the bank posts entries with a back date and yesterday's balance changes by morning. If there are no transactions for the period or the token lacks access, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A login with access to the companies and accounts you need",
        "API access is free on every plan, with nothing to apply for",
        "Signing and sending payments stays in the bank; the agent reads"
      ],
      "faq": [
        {
          "q": "How do I connect Modulbank?",
          "a": "With an API token from the Modulbank online bank. The token is entered once at connection time and stored encrypted."
        },
        {
          "q": "What can the agent do with accounts?",
          "a": "Read accounts, balances and transaction history and prepare draft payment orders. Signing and sending payments stays in the bank."
        },
        {
          "q": "Does it work with several accounts?",
          "a": "Yes, the agent sees every account the token has access to and can roll them up into a single report."
        }
      ]
    }
  },
  {
    "key": "moysklad",
    "name": "МойСклад",
    "name_en": "MoySklad",
    "description": "Торговля и склад: товары, контрагенты, заказы, остатки, отчёты",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "moysklad",
    "description_en": "Trade and inventory: products, counterparties, orders, stock and reports",
    "search_terms": [
      "мс"
    ],
    "signup_url": "https://www.moysklad.ru/register/",
    "guide": {
      "url": "https://online.moysklad.ru",
      "steps": [
        {
          "title": "Откройте настройки токенов",
          "desc": "В МойСкладе перейдите в «Меню пользователя → Настройки → Токены».",
          "title_en": "Open token settings",
          "desc_en": "In MoySklad, go to User menu → Settings → Tokens («Меню пользователя → Настройки → Токены»)."
        },
        {
          "title": "Создайте токен",
          "desc": "Нажмите «+Токен», чтобы создать токен доступа к JSON API. Дополнительного сотрудника создавать не нужно.",
          "title_en": "Create a token",
          "desc_en": "Click +Token («+Токен») to create a JSON API access token. No additional employee is required."
        },
        {
          "title": "Скопируйте токен",
          "desc": "Скопируйте токен в открывшемся окне и вставьте его в поле «API-токен» этой формы.",
          "title_en": "Copy the token",
          "desc_en": "Copy the token from the window that opens and paste it into the API token field of this form."
        },
        {
          "title": "Отзывайте токен в «Токенах»",
          "desc": "Токен работает с правами вашей учётной записи. Если удалить его в «Настройки → Токены», доступ к МойСкладу прекратится сразу.",
          "title_en": "Revoke the token under Tokens",
          "desc_en": "The token carries your account's rights. Delete it under Settings → Tokens («Настройки → Токены») and access to MoySklad stops at once."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для МойСклад: что ниже неснижаемого остатка",
      "description": "Покажет позиции ниже неснижаемого остатка с суммой дефицита по поставщикам: 38 позиций на 1,24 млн ₽. Права равны правам сотрудника, чей API-токен подключён.",
      "headline": "Считайте остатки, прибыль и закупки МойСклад прямо в чате",
      "scenarios": [
        {
          "title": "Остатки и точка заказа",
          "desc": "Агент проверит остатки по складам, сравнит со скоростью продаж и покажет, что пора дозаказывать у поставщика."
        },
        {
          "title": "Оборачиваемость и неликвиды",
          "desc": "Агент посчитает оборачиваемость по товарам, найдёт неликвиды, замороженные в складских остатках, и оценит замороженные деньги."
        },
        {
          "title": "Сверка продаж с маркетплейсами",
          "desc": "Агент сверит отгрузки МойСклад с заказами Ozon и WB, найдёт расхождения по количеству и не отражённые в учёте продажи."
        },
        {
          "title": "Отчёт по прибыльности заказов",
          "desc": "Агент соберёт отчёт по прибыли с учётом себестоимости из МойСклад в разрезе товаров, контрагентам и периодам."
        },
        {
          "title": "Заказ поставщику черновиком",
          "desc": "Агент соберёт дефицит, разложит его по поставщикам из карточек товара, посчитает потребность по скорости продаж и создаст черновики только после вашего «да»."
        },
        {
          "title": "Деньги, долги и обязательства",
          "desc": "Агент сведёт остатки на счетах с дебиторкой и кредиторкой и покажет одной картиной, сколько денег есть, кто должен вам и кому должны вы."
        }
      ],
      "how_it_works": [
        "Агент подключается к МойСклад по API-токену сотрудника и работает со всей учёткой: продажи и прибыль, остатки и склады, контрагенты, деньги на счетах, документы. Права агента равны правам сотрудника, чей токен подключён: роль решает, какие разделы JSON API 1.2 он вообще увидит. Связанные сущности он подтягивает параметром expand, одним запросом вместо десятка, поэтому разбор документов не превращается в перебор карточек. Само подключение проверяется запросом к списку организаций, так что неверный или отозванный токен виден сразу, а не всплывает посреди первого отчёта.",
        "Продажи агент считает по-настоящему: выручка за период складывается из оптовых отгрузок и розничных продаж, а прибыль и маржа по товарам считаются от себестоимости FIFO. Если прав на себестоимость нет, агент сам переключится на расчёт от закупочной цены и прямо скажет об этом. Динамика продаж по дням, деньги на счетах, дебиторка и кредиторка, покупатели конкретного товара с телефонами: всё из учётки, без ручных выгрузок. Валюту учёта агент определяет автоматически (рубли, тенге или другую) и не путает копейки с рублями: в МойСклад суммы приходят в копейках, и это учтено везде.",
        "Остатки агент показывает единым обзором: штуки и рубли, разбивка по складам, нулевые и минусовые позиции отдельными счётчиками. Самое полезное для закупок: позиции ниже неснижаемого остатка, и здесь есть ловушка, которой не видно в API с первого взгляда: пороги по складам МойСклад в обычных запросах не отдаёт, и наивная проверка решает, что «неснижаемый не настроен», хотя под минимумом десятки позиций. Агент использует правильный серверный фильтр и находит их все, включая случаи, когда остаток положительный, но ниже порога конкретного склада.",
        "По найденному дефициту агент готовит документы: черновик внутреннего заказа на пополнение склада или черновики заказов поставщикам, сгруппированные по поставщику из карточки товара, с прогнозом потребности по скорости продаж и сроку поставки. Документы в учётке создаются только после вашего явного «да»: агент показывает, что именно собирается создать, и ждёт подтверждения. Товары, у которых поставщик в карточке не указан, он выделит отдельной строкой, а не пропустит молча.",
        "Темп запросов агент держит сам: не больше шести обращений в секунду к API и не больше двух в секунду к тяжёлым отчётам по остаткам, поэтому учётка не упирается в лимиты, пока агент собирает данные. Если роли не хватает прав, агент прямо в чате назовёт недостающий раздел и попросит расширить роль сотрудника, а не выдаст загадочную ошибку 403 посреди отчёта. Данные при этом берутся напрямую из справочников, метаданных сущностей и срезов отчётов API, а не из заранее выгруженной копии, поэтому цифры в чате совпадают с тем, что в учётке прямо сейчас."
      ],
      "requirements": [
        "Роль с доступом к товарам, заказам, отгрузкам, остаткам и отчётам",
        "Право на себестоимость, если нужна маржа по FIFO",
        "Право на запись, если агент создаёт заказы и перемещения"
      ],
      "faq": [
        {
          "q": "Как подключить МойСклад?",
          "a": "В МойСкладе откройте «Меню пользователя → Настройки → Токены», нажмите «+Токен» и вставьте созданный токен в поле API-токена при подключении. Дополнительного сотрудника создавать не обязательно. При установке «Сам Решу» из маркетплейса МойСклад доступ выдаётся автоматически."
        },
        {
          "q": "Что агент видит в МойСклад?",
          "a": "Товары, контрагентов, заказы, отгрузки, остатки и отчёты JSON API 1.2 в рамках роли сотрудника, чей токен подключён."
        },
        {
          "q": "Пишет ли агент в МойСклад?",
          "a": "Может, например, создавать заказы поставщику или внутренние перемещения, если роль разрешает запись. По умолчанию агент работает на чтение и аналитику."
        },
        {
          "q": "Что делать, если у токена не хватает прав?",
          "a": "Агент прямо в чате скажет, какого раздела не хватает, и попросит расширить роль сотрудника, без загадочных ошибок 403."
        }
      ]
    },
    "seo_en": {
      "title": "AI agent for MoySklad: items below minimum stock",
      "description": "Lists items below minimum stock with the shortfall by supplier: 38 positions worth 1.24M RUB. The agent gets the rights of the employee whose API token is connected.",
      "headline": "Track stock, profit and purchasing in MoySklad right in the chat",
      "scenarios": [
        {
          "title": "Stock levels and reorder points",
          "desc": "The agent checks stock across warehouses, compares it with sales velocity and shows what it is time to reorder from your supplier."
        },
        {
          "title": "Turnover and dead stock",
          "desc": "The agent calculates turnover per product, finds the dead stock frozen in your warehouse balances and estimates the cash tied up in it."
        },
        {
          "title": "Reconcile sales with marketplaces",
          "desc": "The agent reconciles MoySklad shipments with Ozon and WB orders and finds quantity discrepancies and sales missing from the books."
        },
        {
          "title": "Order profitability report",
          "desc": "The agent builds a profit report using cost prices from MoySklad, broken down by product, counterparty and period."
        },
        {
          "title": "Purchase orders as drafts",
          "desc": "The agent gathers the shortages, groups them by the supplier from each product card, forecasts demand from sales velocity and creates the drafts only after your yes."
        },
        {
          "title": "Cash, receivables and payables",
          "desc": "The agent brings the money in your accounts together with receivables and payables and shows in one picture how much cash you hold, who owes you and whom you owe."
        }
      ],
      "how_it_works": [
        "The agent connects to MoySklad with an employee API token and works with the whole account: sales and profit, stock and warehouses, counterparties, money in the accounts, documents. The agent's permissions equal those of the employee whose token is connected: the role decides which sections of the JSON API 1.2 the agent sees at all. Related entities it pulls in with the expand parameter, one request instead of a dozen, so going through documents never turns into walking card by card. The connection itself is verified with a request for the list of organizations, so an invalid or revoked token shows up immediately instead of surfacing in the middle of the first report.",
        "The agent counts sales properly: revenue for a period adds up from wholesale shipments and retail sales, while profit and margin per product are calculated from the FIFO cost price. If there are no permissions for cost prices, the agent switches to the purchase price on its own and says so explicitly. Daily sales dynamics, money in the accounts, receivables and payables, the buyers of a specific product with their phone numbers: all straight from the account, with no manual exports. The agent detects the accounting currency automatically, be it rubles, tenge or another one, and never confuses kopecks with rubles: MoySklad returns amounts in kopecks, and that is accounted for everywhere.",
        "Stock comes as a single overview: units and money, a breakdown by warehouse, zero and negative positions as separate counters. The most useful part for purchasing is the positions below the minimum stock level, and there is a trap here that is not visible in the API at first glance: MoySklad does not return per-warehouse thresholds in ordinary requests, so a naive check decides that no minimum is configured while dozens of positions sit below it. The agent uses the proper server-side filter and finds them all, including cases where the balance is positive but still below the threshold of that particular warehouse.",
        "For the shortages it finds the agent prepares documents: a draft internal order to replenish a warehouse, or draft purchase orders grouped by the supplier from the product card, with demand forecast based on sales velocity and lead time. Documents are created in the account only after your explicit yes: the agent shows exactly what it is about to create and waits for confirmation. Products with no supplier in the card are listed as a separate line instead of being silently skipped.",
        "The agent paces its own requests: no more than seven calls per second to the API and no more than three per second to the heavy stock reports, so the account does not hit the limits while the agent collects data. If the role lacks permissions, the agent names the missing section right in the chat and asks you to extend the employee role instead of showing a cryptic 403 error in the middle of a report. The data itself comes straight from the API directories, entity metadata and report slices rather than from a pre-exported copy, so the numbers in the chat match what is in the account right now."
      ],
      "requirements": [
        "A role with access to products, orders, shipments, stock and reports",
        "Permission for cost prices if you need FIFO margin",
        "Write permission if the agent creates orders and transfers"
      ],
      "faq": [
        {
          "q": "How do I connect MoySklad?",
          "a": "In MoySklad, go to User menu → Settings → Tokens, click +Token and paste the token into the API token field when connecting. No additional employee is required. Installing Samreshuuu from the MoySklad marketplace grants access automatically."
        },
        {
          "q": "What does the agent see in MoySklad?",
          "a": "Products, counterparties, orders, shipments, stock and reports of the JSON API 1.2, within the role of the employee whose token is connected."
        },
        {
          "q": "Does the agent write to MoySklad?",
          "a": "It can, creating purchase orders or internal transfers for example, if the role allows writing. By default the agent works in read and analytics mode."
        },
        {
          "q": "What if the token lacks permissions?",
          "a": "The agent tells you right in the chat which section is missing and asks you to extend the employee role, with no cryptic 403 errors."
        }
      ]
    }
  },
  {
    "key": "mpstats",
    "name": "MPStats",
    "name_en": "MPStats",
    "description": "Аналитика маркетплейсов Wildberries/Ozon: категории, товары, продажи, тренды",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mpstats",
    "description_en": "Wildberries and Ozon marketplace analytics: categories, products, sales and trends",
    "search_terms": [
      "мпстатс"
    ],
    "signup_url": "https://mpstats.io/register",
    "guide": {
      "url": "https://mpstats.io/account",
      "steps": [
        {
          "title": "Войдите в личный кабинет MPStats",
          "desc": "Войдите под аккаунтом MPStats с оплаченным тарифом: лимит запросов считается по нему, и при исчерпании сервис отвечает 429.",
          "title_en": "Sign in to your MPStats account",
          "desc_en": "Sign in with the MPStats account that holds the paid plan: the request quota is counted on it, and the API answers 429 once it runs out."
        },
        {
          "title": "На странице «Аккаунт» найдите «API токен»",
          "desc": "На странице «Аккаунт» токен уже сформирован в блоке «API токен», отдельную заявку подавать не нужно.",
          "title_en": "Find «API токен» on the «Аккаунт» page",
          "desc_en": "On the «Аккаунт» (Account) page the token is already generated in the «API токен» (API token) block, with no request or acceptance needed."
        },
        {
          "title": "Скопируйте значение токена целиком",
          "desc": "Токен: две hex-строки через точку, вида 5a2a5f0e538dd5.6691914852255446e23a9bcac46ee5255625f5d5. Точка входит в значение, пробелов по краям быть не должно.",
          "title_en": "Copy the whole token value",
          "desc_en": "The token is two hex strings joined by a dot, e.g. 5a2a5f0e538dd5.6691914852255446e23a9bcac46ee5255625f5d5. The dot is part of it; no spaces around it."
        },
        {
          "title": "Не меняйте пароль после копирования",
          "desc": "Смена пароля и кнопка «Сменить API токен» пересоздают токен: старое значение сразу перестаёт работать, и его придётся скопировать заново.",
          "title_en": "Don't change your password afterwards",
          "desc_en": "A password change and the «Сменить API токен» (Change API token) button both regenerate the token; the old value stops working at once."
        }
      ]
    },
    "seo": {
      "title": "MPStats API: стоит ли заходить в нишу на Wildberries",
      "description": "Подключить MPStats к агенту можно по API-токену. Дальше он ответит, стоит ли заходить в нишу на WB: ёмкость категории, доля топ-брендов и свободный ценовой сегмент.",
      "headline": "Разбирайте нишу на Wildberries и Ozon прямо в чате",
      "scenarios": [
        {
          "title": "Разбор ниши на Wildberries",
          "desc": "Агент пройдёт по дереву категорий, соберёт топ товаров по выручке и покажет, где спрос растёт, а где деньги уходят к конкурентам."
        },
        {
          "title": "Сравнение с конкурентами",
          "desc": "Агент сопоставит ваши карточки с соседями по категории (цена, выручка, динамика продаж) и сравнит бренды за два периода."
        },
        {
          "title": "Семантика категории",
          "desc": "Агент выгрузит топ поисковых запросов по предмету Wildberries и покажет частотность фраз, по которым ищут товары вашей ниши."
        },
        {
          "title": "Сезонность перед закупкой",
          "desc": "Агент поднимет годовую сезонность категории и ценовую сегментацию, чтобы было видно, когда и в каком ценовом сегменте заходить в закупку."
        },
        {
          "title": "Та же ниша на Ozon",
          "desc": "Агент соберёт ту же категорию на Ozon и сведёт её с Wildberries по выручке, числу брендов и ценовым сегментам: видно, где ниша свободнее."
        },
        {
          "title": "Продажи карточки по дням",
          "desc": "Агент поднимет карточку товара с продажами по дням и покажет, как двигались выручка и цена: это рыночная оценка, а не выгрузка из вашего кабинета."
        }
      ],
      "how_it_works": [
        "Агент ходит в API MPStats по токену из личного кабинета: разбирает дерево категорий и предметов Wildberries и Ozon, поднимает карточки товаров с продажами по дням, ценовую сегментацию, бренды, поисковые запросы товара и категории и годовую сезонность. На этом он строит топ ниши по выручке, сравнение ваших карточек с соседями по категории за два периода и картину того, в каком ценовом сегменте сосредоточены деньги.",
        "Главное про MPStats: это аналитика поверх данных маркетплейсов, а не выгрузка из вашего кабинета продавца. Плюс в том, что видно весь рынок, включая конкурентов, к чьим кабинетам доступа нет. Минус в том, что цифры по вашим же товарам агент подаёт как рыночную оценку и, если речь о собственной выручке или остатках, отправляет сверяться с кабинетом Wildberries или Ozon, а не выдаёт их за учётные данные.",
        "Писать здесь некуда: агент только запрашивает отчёты и ничего в MPStats не создаёт и не меняет. Решения, к которым приводит разбор (поднять цену, зайти в сезон, добавить фразы в карточку), исполняются в кабинетах Wildberries и Ozon, и агент прямо говорит, где именно нужна правка. Там, где данных по категории мало для вывода, он называет это ограничением выборки, а не подаёт как тренд.",
        "Объём доступных отчётов ограничен тарифом: при исчерпании лимита сервис отвечает кодом 429 с заголовком Retry-After, и агент выжидает указанное время, а не долбит запросами. Поэтому широкий разбор (категория целиком, десятки брендов) он делит на части, собирает дольше, чем справку по одной карточке, и заранее говорит, сколько данных собирается взять. А если лимит выбран до конца, он назовёт это ограничением выборки, а не выдаст неполные цифры за полные."
      ],
      "requirements": [
        "Оплаченный тариф MPStats: на аккаунте без подписки данных нет",
        "Запас лимита запросов по тарифу: если он исчерпан, сервис отвечает отказом"
      ],
      "faq": [
        {
          "q": "Как подключить MPStats?",
          "a": "API-токеном из личного кабинета: на mpstats.io/account в блоке «API токен» скопируйте значение целиком: это две hex-строки через точку, и точка входит в токен. При смене пароля токен пересоздаётся, и подключение придётся обновить."
        },
        {
          "q": "Какие данные видит агент?",
          "a": "Категории и предметы Wildberries и Ozon, карточки товаров с продажами по дням, ценовую сегментацию, бренды, поисковые запросы товара и категории, годовую сезонность в объёме вашего тарифа."
        },
        {
          "q": "Пишет ли агент в MPStats?",
          "a": "Нет. Это аналитика поверх данных маркетплейсов, агент только запрашивает отчёты. Цены, остатки и карточки меняются в кабинетах Wildberries и Ozon, а не здесь."
        },
        {
          "q": "Что будет при исчерпании лимита?",
          "a": "Сервис ответит кодом 429 и заголовком Retry-After, и агент подождёт указанное время и повторит запрос. На аккаунте без активной подписки данные не отдаются вовсе."
        }
      ]
    },
    "seo_en": {
      "title": "MPStats API agent: should you enter a Wildberries niche",
      "description": "Tells you whether a niche is worth entering: Wildberries category revenue, top-brand share, the open price segment and when to stock up. Connects by API token.",
      "headline": "Break down a Wildberries or Ozon niche right in the chat",
      "scenarios": [
        {
          "title": "Break down a niche on Wildberries",
          "desc": "The agent walks the category tree, collects the top products by revenue and shows where demand is growing and where the money goes to competitors."
        },
        {
          "title": "Compare yourself with competitors",
          "desc": "The agent matches your product cards against neighbours in the category by price, revenue and sales dynamics and compares brands across two periods."
        },
        {
          "title": "Category semantics",
          "desc": "The agent pulls the top search queries for a Wildberries subject and shows the frequency of the phrases people use to find products in your niche."
        },
        {
          "title": "Seasonality before you buy stock",
          "desc": "The agent brings up annual category seasonality and price segmentation so you can see when and in which price segment to enter with a purchase."
        },
        {
          "title": "The same niche on Ozon",
          "desc": "The agent collects the same category on Ozon and lines it up against Wildberries by revenue, brand count and price segments, so you see where the niche is freer."
        },
        {
          "title": "Daily sales of one card",
          "desc": "The agent brings up a product card with daily sales and shows how revenue and price moved, as a market estimate, not an export from your seller account."
        }
      ],
      "how_it_works": [
        "The agent calls the MPStats API with the token from your personal account: it walks the tree of Wildberries and Ozon categories and subjects, brings up product cards with daily sales, price segmentation, brands, product and category search queries and annual seasonality. On top of that it builds the niche top by revenue, a comparison of your cards against neighbours in the category across two periods and a picture of which price segment the money sits in.",
        "The main thing about MPStats: it is analytics on top of marketplace data, not an export from your own seller account. The upside is that the whole market is visible, competitors whose accounts you have no access to included. The downside is that figures for your own products are presented as a market estimate, and when it comes to your revenue or stock the agent sends you to reconcile with the Wildberries or Ozon account instead of passing them off as accounting data.",
        "There is nothing to write to here: the agent only requests reports and creates or changes nothing in MPStats. The decisions the analysis leads to (raise the price, enter the season, add phrases to the card) are carried out in the Wildberries and Ozon accounts, and the agent states plainly where the edit belongs. Where there is too little category data for a conclusion, it calls that a limitation of the sample rather than presenting it as a trend.",
        "The set of available reports is capped by your plan: once the limit runs out the service answers with code 429 and a Retry-After header, and the agent waits the stated time instead of hammering with requests. A wide analysis (a whole category, dozens of brands) is therefore split into parts, takes longer to assemble than a note on a single card, and the agent says up front how much data it intends to pull. And if the quota is spent, it calls that a limit of the sample instead of passing partial figures off as complete."
      ],
      "requirements": [
        "A paid MPStats plan: an account without one gets no data",
        "Request quota left on the plan: once it is spent, the service refuses"
      ],
      "faq": [
        {
          "q": "How do I connect MPStats?",
          "a": "With an API token from your personal account: at mpstats.io/account, in the API token block, copy the value in full, it is two hex strings separated by a dot and the dot is part of the token. Changing your password regenerates the token, so the connection has to be updated."
        },
        {
          "q": "What data does the agent see?",
          "a": "Wildberries and Ozon categories and subjects, product cards with daily sales, price segmentation, brands, product and category search queries and annual seasonality, within the scope of your plan."
        },
        {
          "q": "Does the agent write to MPStats?",
          "a": "No. This is analytics on top of marketplace data, the agent only requests reports. Prices, stock and product cards are changed in the Wildberries and Ozon accounts, not here."
        },
        {
          "q": "What happens when the limit runs out?",
          "a": "The service answers with code 429 and a Retry-After header, and the agent waits the stated time and repeats the request. An account without an active subscription gets no data at all."
        }
      ]
    }
  },
  {
    "key": "mqtt",
    "name": "MQTT",
    "name_en": "MQTT",
    "description": "Топики брокера MQTT (UNS) через программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mqtt",
    "description_en": "Read-only MQTT broker topics, a UNS included, through a data collection program",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Создайте пользователя брокера",
          "desc": "Программа сбора данных только подписывается и ничего не публикует. Дайте её учётной записи в ACL брокера право подписки на нужные топики, публикация ей не нужна.",
          "title_en": "Create a broker user",
          "desc_en": "The data collection program only subscribes and publishes nothing. Give its account subscribe rights to the needed topics in the broker's ACL; it needs no publish rights."
        },
        {
          "title": "Задайте Client ID, если брокер их проверяет",
          "desc": "Если ACL брокера пускает только известные ID клиента, впишите такой ID в дополнительных настройках подключения. Пусто: программа сбора назовётся сама.",
          "title_en": "Set a Client ID if the broker checks them",
          "desc_en": "If the broker's ACL admits only known client IDs, enter one in the connection's advanced settings. Left empty, the collection program names itself."
        },
        {
          "title": "Подпишитесь узкими фильтрами",
          "desc": "Перечислите фильтры через запятую, например линия/+/температура, а не #. Для Zigbee2MQTT подпишитесь на zigbee2mqtt/+, а не на zigbee2mqtt/#.",
          "title_en": "Subscribe with narrow filters",
          "desc_en": "List filters separated by commas, such as line/+/temperature, not #. For Zigbee2MQTT subscribe to zigbee2mqtt/+, not zigbee2mqtt/#."
        },
        {
          "title": "Для TLS положите сертификаты на сервер сбора",
          "desc": "Адрес mqtts:// проверяется по корням системы и PEM из папки pki/mqtt/trusted/ в папке данных программы сбора. Для mTLS: pki/mqtt/own/cert.pem и key.pem.",
          "title_en": "For TLS, put certificates on the server",
          "desc_en": "An mqtts:// address is verified against the system roots and the PEM files in pki/mqtt/trusted/ of the program's data folder. For mTLS: pki/mqtt/own/cert.pem and key.pem."
        }
      ]
    },
    "seo": {
      "title": "Брокер MQTT и ИИ-агент: какие датчики замолчали",
      "description": "Какие датчики на складе замолчали: агент проверит топики UNS, Zigbee2MQTT и ChirpStack в брокере MQTT. Подписку держит программа сбора на объекте, только чтение.",
      "headline": "Топики брокера MQTT как данные оборудования прямо в чате",
      "scenarios": [
        {
          "title": "Текущие значения",
          "desc": "Агент найдёт теги по топику или имени и покажет последние значения со временем источника, а устаревшее значение назовёт устаревшим, а не текущим."
        },
        {
          "title": "Тренд за смену",
          "desc": "Агент соберёт историю тега за период интервалами: минимум, максимум, среднее и последнее значение, с пропусками там, где данных не было."
        },
        {
          "title": "Датчики через мосты",
          "desc": "Агент читает JSON-сообщения Zigbee2MQTT, ChirpStack, Node-RED и HighByte: каждое поле объекта становится своим тегом со своей историей."
        },
        {
          "title": "Сравнение линий",
          "desc": "Агент сопоставит один показатель по разным топикам, например температуру на нескольких линиях, и сравнит средние и пики за один период."
        },
        {
          "title": "Задача по условию",
          "desc": "Агент заведёт задачу «По событию»: она запустится, когда значение тега перейдёт порог и продержится заданное время."
        },
        {
          "title": "Связь сервера сбора",
          "desc": "Агент скажет, на связи ли сервер сбора и подключение к брокеру, а задача по событию узнает, когда сервер пропал и когда вернулся."
        }
      ],
      "how_it_works": [
        "Брокер MQTT обычно стоит в сети объекта, поэтому к нему ходит программа сбора данных: она работает службой на сервере в той же сети и отправляет данные наружу только исходящим соединением. В подключении указываются адрес брокера (mqtt:// или mqtts://), при необходимости логин и пароль и фильтры топиков. Пока связи наружу нет, программа копит данные на диске и отправляет их, когда она вернётся.",
        "Программа сбора подписывается только на названные фильтры, а не на весь брокер, и каждый топик становится тегом. Сообщение читается как JSON или как текст; указатели JSON задают, где в нём значения и где время источника, а объект с несколькими полями даёт несколько тегов. Retained-сообщение без времени она помечает как значение неизвестного возраста. Сессия чистая: то, что брокер копил, пока программы не было на связи, не переигрывается.",
        "Программа сбора не публикует ни одного сообщения: у неё нет ни публикации, ни завещания (will), ни retained-сообщений от своего имени. Поэтому её учётной записи в ACL брокера достаточно права подписки, и только чтение держит сам брокер. Агент читает текущие значения, историю и свежесть, но ничего не отправляет в топики и не управляет оборудованием.",
        "Каталог тегов растёт по мере прихода сообщений и ограничен настройкой «Не больше тегов» (по умолчанию 10000), чтобы слишком широкий фильтр не превратил загруженный брокер в сотни тысяч тегов. Тип тега берётся по первому значению и меняется, только если два значения подряд пришли другого типа. История копится с момента подключения: прошлых значений брокер не хранит."
      ],
      "requirements": [
        "Брокер MQTT 5 или 3.1.1, доступный с сервера сбора",
        "Учётная запись брокера с правом подписки на нужные топики",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Для mqtts:// сертификат брокера, которому доверяет программа сбора"
      ],
      "faq": [
        {
          "q": "Как подключить MQTT?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите MQTT и укажите адрес брокера, например mqtt://10.0.12.5:1883, логин и пароль, если брокер их требует, и фильтры топиков через запятую; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в MQTT?",
          "a": "Топики под вашими фильтрами как теги: значения из JSON или текста, время источника, если оно есть в сообщении, историю с момента подключения и свежесть каждого значения. Поля объекта JSON становятся отдельными тегами."
        },
        {
          "q": "Отправляет ли агент сообщения в брокер?",
          "a": "Нет. Программа сбора только подписывается: публикации, завещания и retained-сообщений от её имени нет. Её учётной записи достаточно права подписки."
        },
        {
          "q": "Подключение отвечает отказом доступа. Что проверить?",
          "a": "Брокер принял логин, но отказал в подписке на один из фильтров. Проверьте ACL учётной записи программы сбора для каждого фильтра, а если брокер пускает только известные ID клиента, впишите Client ID в дополнительных настройках."
        }
      ]
    },
    "seo_en": {
      "title": "MQTT AI agent: find the sensors that went quiet",
      "description": "Which warehouse sensors went quiet: the agent checks UNS, Zigbee2MQTT and ChirpStack topics on your MQTT broker. An on-site collection program subscribes, read-only.",
      "headline": "MQTT broker topics as equipment data right in the chat",
      "scenarios": [
        {
          "title": "Current values",
          "desc": "The agent finds tags by topic or name and shows the latest values with the source time, and calls a stale value stale rather than current."
        },
        {
          "title": "Trend over a shift",
          "desc": "The agent collects a tag's history for a period in intervals: minimum, maximum, average and last value, with gaps where there was no data."
        },
        {
          "title": "Sensors behind bridges",
          "desc": "The agent reads JSON messages from Zigbee2MQTT, ChirpStack, Node-RED and HighByte: each field of an object becomes its own tag with its own history."
        },
        {
          "title": "Comparing lines",
          "desc": "The agent lines up one measurement across topics, such as temperature on several lines, and compares averages and peaks over one period."
        },
        {
          "title": "A task on a condition",
          "desc": "The agent sets up an On event task that starts when a tag's value crosses a threshold and holds there for the time you set."
        },
        {
          "title": "Collection server connectivity",
          "desc": "The agent tells whether the collection server and its broker connection are online, and an On event task learns when the server drops and when it is back."
        }
      ],
      "how_it_works": [
        "An MQTT broker usually sits on the site's network, so the data collection program reaches it: it runs as a service on a server on the same network and sends data out only over an outbound connection. The connection takes the broker address (mqtt:// or mqtts://), a login and password if needed, and topic filters. While there is no link outside, the program keeps the data on disk and sends it once the link is back.",
        "The collection program subscribes only to the filters you name, never the whole broker, and every topic becomes a tag. A message is read as JSON or as text; JSON Pointers say where its values and its source time are, and an object with several fields gives several tags. A retained message without a time is marked as a value of unknown age. The session is clean: what the broker queued while the program was offline is not replayed.",
        "The collection program publishes no message at all: it has no publish, no will and no retained message of its own. So subscribe rights in the broker's ACL are enough for its account, and the broker itself holds the read only. The agent reads current values, history and freshness, but sends nothing to topics and does not control any equipment.",
        "The tag catalog grows as messages arrive and is capped by the Max tags setting (10000 by default), so an overly wide filter does not turn a busy broker into hundreds of thousands of tags. A tag's type comes from its first value and changes only when two values in a row arrive in another type. History builds up from the moment of connection: the broker keeps no past values."
      ],
      "requirements": [
        "An MQTT 5 or 3.1.1 broker reachable from the collection server",
        "A broker account with subscribe rights to the needed topics",
        "A collection server on the site network: Windows or Linux with Docker",
        "For mqtts://, a broker certificate the collection program trusts"
      ],
      "faq": [
        {
          "q": "How do I connect MQTT?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick MQTT and enter the broker address, for example mqtt://10.0.12.5:1883, a login and password if the broker requires them, and topic filters separated by commas; the collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in MQTT?",
          "a": "The topics under your filters as tags: values from JSON or text, the source time when the message carries one, history from the moment of connection and the freshness of each value. Fields of a JSON object become separate tags."
        },
        {
          "q": "Does the agent send messages to the broker?",
          "a": "No. The collection program only subscribes: it has no publish, no will and no retained message of its own. Subscribe rights are enough for its account."
        },
        {
          "q": "The connection reports access denied. What should I check?",
          "a": "The broker accepted the login but refused a subscription to one of the filters. Check the ACL of the collection program's account for each filter, and if the broker admits only known client IDs, enter a Client ID in the advanced settings."
        }
      ]
    }
  },
  {
    "key": "msteams",
    "name": "Microsoft Teams",
    "name_en": "Microsoft Teams",
    "description": "Корпоративный мессенджер: агент отвечает в личке, чатах и каналах Teams от имени вашего бота",
    "category": "messengers",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "msteams",
    "short_name": "Teams",
    "short_name_en": "Teams",
    "description_en": "Company messenger: the agent replies in DMs, chats and Teams channels as your bot",
    "search_terms": [
      "тимс",
      "майкрософт тимс"
    ],
    "signup_url": "https://portal.azure.com/#create/Microsoft.AzureBot",
    "guide": {
      "url": "https://portal.azure.com/#create/Microsoft.AzureBot",
      "steps": [
        {
          "title": "Создайте Azure Bot в своём тенанте",
          "desc": "В портале Azure создайте ресурс Azure Bot: тип «Single Tenant», новое приложение Microsoft. Мультитенантных ботов Microsoft с 31.07.2025 не создаёт.",
          "title_en": "Create an Azure Bot in your tenant",
          "desc_en": "In the Azure portal create an Azure Bot resource: type «Single Tenant», a new Microsoft app. Microsoft stopped creating multi-tenant bots on 31.07.2025."
        },
        {
          "title": "Включите канал Microsoft Teams",
          "desc": "В ресурсе бота откройте «Каналы» и добавьте Microsoft Teams. Без канала Teams не доставит боту ни одного сообщения.",
          "title_en": "Turn on the Microsoft Teams channel",
          "desc_en": "In the bot resource open «Channels» and add Microsoft Teams. Without the channel Teams delivers the bot no messages at all."
        },
        {
          "title": "Скопируйте тенант, app id и секрет",
          "desc": "В «Конфигурации» бота возьмите App ID и App Tenant ID. В «Управлении паролем» создайте секрет клиента и сразу скопируйте его Value: позже Azure его не покажет.",
          "title_en": "Copy the tenant, app id and secret",
          "desc_en": "Take the App ID and App Tenant ID from the bot's «Configuration». Under «Manage password» create a client secret and copy its Value now: Azure hides it later."
        },
        {
          "title": "Вставьте адрес и установите приложение",
          "desc": "Адрес из карточки подключения вставьте в «Messaging endpoint» бота, пакет приложения из карточки загрузите в центре администрирования Teams.",
          "title_en": "Paste the address and install the app",
          "desc_en": "Paste the address from the connection card into the bot's «Messaging endpoint» and upload the card's app package in the Teams admin center."
        }
      ]
    },
    "seo": {
      "title": "Teams и ИИ-агент: ваш бот отвечает в канале поддержки",
      "description": "Ответит в ветке канала «Поддержка», когда бота упомянули, и по понедельникам пришлёт итоги продаж в канал. Нужен свой Azure Bot: Tenant ID, App ID и секрет.",
      "headline": "Отвечайте в Microsoft Teams от имени своего бота",
      "scenarios": [
        {
          "title": "Ответы в личке и каналах",
          "desc": "Агент получит сообщение из лички, группового чата или канала Teams, где бота упомянули, и ответит в той же ветке от имени вашего бота."
        },
        {
          "title": "Кнопки и согласия",
          "desc": "Агент задаст вопрос или попросит согласие карточкой с кнопками и обновит её, когда решение принято."
        },
        {
          "title": "Отчёты задач в канал",
          "desc": "Агент отправит результат задачи по расписанию в канал команды, куда добавлен бот, без напоминаний."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "Подписка Azure и права администратора в тенанте Microsoft 365",
        "Ресурс Azure Bot типа Single Tenant с включённым каналом Microsoft Teams",
        "Право загружать приложения в центре администрирования Teams"
      ],
      "faq": [
        {
          "q": "Как подключить Microsoft Teams?",
          "a": "Создайте в портале Azure ресурс Azure Bot типа Single Tenant и включите в нём канал Microsoft Teams. Вставьте при подключении App Tenant ID, App ID и секрет клиента, затем адрес из карточки подключения пропишите в «Messaging endpoint» бота, а пакет приложения загрузите в центре администрирования Teams."
        },
        {
          "q": "Почему бот только Single Tenant?",
          "a": "С 31.07.2025 Microsoft не создаёт мультитенантных ботов. Бот живёт в вашем тенанте Microsoft 365 и работает с вашей организацией."
        },
        {
          "q": "Где агент отвечает в Teams?",
          "a": "В личке с ботом, в групповых чатах и в каналах команд, куда бот добавлен. В канале агент получает сообщение, когда бота упомянули, и отвечает в той же ветке от имени вашего бота."
        },
        {
          "q": "Может ли агент спросить согласие прямо в Teams?",
          "a": "Да: вопрос или просьба о согласии приходит карточкой с кнопками, и после решения агент обновляет эту же карточку."
        },
        {
          "q": "Что делать, если бот не получает сообщений?",
          "a": "Проверьте, что в ресурсе бота включён канал Microsoft Teams и что в «Messaging endpoint» стоит адрес из карточки подключения: без канала Teams не доставит боту ни одного сообщения."
        }
      ]
    },
    "seo_en": {
      "title": "Teams AI agent: your bot answers in a support channel",
      "description": "Answers mentions in your support channel thread and posts weekly sales results to a channel every Monday. Needs your own Azure Bot: tenant ID, app ID and secret.",
      "headline": "Answer in Microsoft Teams as your own bot",
      "scenarios": [
        {
          "title": "Replies in chats and channels",
          "desc": "The agent receives a message from a personal chat, a group chat or a Teams channel where the bot was mentioned and answers in the same thread as your bot."
        },
        {
          "title": "Buttons and approvals",
          "desc": "The agent asks a question or an approval with a card of buttons and updates the card once the decision is made."
        },
        {
          "title": "Task reports in a channel",
          "desc": "The agent posts a scheduled task's result into the team channel the bot was added to, without reminders."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "An Azure subscription and admin rights in the Microsoft 365 tenant",
        "An Azure Bot resource of type Single Tenant with the Microsoft Teams channel on",
        "The right to upload apps in the Teams admin center"
      ],
      "faq": [
        {
          "q": "How do I connect Microsoft Teams?",
          "a": "In the Azure portal create an Azure Bot resource of type Single Tenant and turn on its Microsoft Teams channel. Paste the App Tenant ID, the App ID and the client secret when connecting, then put the address from the connection card into the bot's «Messaging endpoint» and upload the app package in the Teams admin center."
        },
        {
          "q": "Why is the bot Single Tenant only?",
          "a": "Microsoft stopped creating multi-tenant bots on 31.07.2025. The bot lives in your Microsoft 365 tenant and works with your organization."
        },
        {
          "q": "Where does the agent answer in Teams?",
          "a": "In a personal chat with the bot, in group chats and in team channels the bot was added to. In a channel the agent receives a message when the bot is mentioned and answers in the same thread as your bot."
        },
        {
          "q": "Can the agent ask for an approval right in Teams?",
          "a": "Yes: a question or an approval request arrives as a card with buttons, and once the decision is made the agent updates that same card."
        },
        {
          "q": "What if the bot receives no messages?",
          "a": "Check that the Microsoft Teams channel is on in the bot resource and that the «Messaging endpoint» holds the address from the connection card: without the channel Teams delivers the bot no messages at all."
        }
      ]
    }
  },
  {
    "key": "mtconnect",
    "name": "MTConnect",
    "name_en": "MTConnect",
    "description": "Модель и значения агента MTConnect через программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "mtconnect",
    "description_en": "Read-only device model and values of an MTConnect agent through a data collection program",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Проверьте ответ агента",
          "desc": "С сервера сбора откройте адрес агента с /probe и /current: агент должен отдать XML. Программа сбора ходит к агенту без прокси и не следует перенаправлениям.",
          "title_en": "Check that the agent answers",
          "desc_en": "From the collection server open the agent address with /probe and /current: the agent must return XML. The program reaches it without a proxy, no redirects."
        },
        {
          "title": "Выберите устройство агента",
          "desc": "Если агент обслуживает несколько машин, а нужна одна, впишите имя или UUID устройства из /probe. Пусто: программа сбора читает все устройства агента.",
          "title_en": "Choose the agent's device",
          "desc_en": "If the agent serves several machines and you need one, enter the device name or UUID from /probe. Left empty, the collection program reads every device of the agent."
        },
        {
          "title": "Для https добавьте сертификат агента",
          "desc": "Если адрес агента https:// с самоподписанным сертификатом, положите сертификат на сервер сбора в папку pki/mtconnect/trusted/ в папке данных программы.",
          "title_en": "For https, trust the agent's certificate",
          "desc_en": "If the agent's address is https:// with a self-signed certificate, put the certificate into pki/mtconnect/trusted/ in the collection program's data folder."
        }
      ]
    },
    "seo": {
      "title": "Интеграция MTConnect с ИИ: аварии машин за смену",
      "description": "Предупреждения и аварии CONDITION с машин за смену со временем, выпуск по счётчику деталей за период. Агента MTConnect читает программа сбора в сети цеха.",
      "headline": "Состояние машин и аварии из агента MTConnect прямо в чате",
      "scenarios": [
        {
          "title": "Что с машинами сейчас",
          "desc": "Агент покажет каждую машину агента MTConnect со словом состояния (работает, прерван, остановлен, готов) и числом активных аварий."
        },
        {
          "title": "Аварии и предупреждения",
          "desc": "Агент соберёт Warning и Fault из элементов CONDITION за смену с кодами, текстами и временем появления и снятия."
        },
        {
          "title": "Программа и детали",
          "desc": "Агент прочитает активную программу, режим стойки и счётчик деталей и покажет, сколько деталей прибавилось за период."
        },
        {
          "title": "Работа и простои",
          "desc": "Агент возьмёт отсчёты EXECUTION за период и посчитает, сколько времени машина работала, стояла с остановленной подачей или ждал."
        },
        {
          "title": "Шпиндель и коррекции",
          "desc": "Агент соберёт историю оборотов шпинделя и коррекций подачи и шпинделя интервалами: минимум, максимум и среднее."
        },
        {
          "title": "Паспорт машины",
          "desc": "Агент назовёт производителя, модель и серийный номер каждого устройства из описания агента."
        }
      ],
      "how_it_works": [
        "Агент MTConnect обычно стоит в сети объекта рядом с машинами, поэтому к нему ходит программа сбора данных: она работает службой на сервере в той же сети и отправляет данные наружу только исходящим соединением. В подключении указывается адрес агента, например http://10.0.12.5:5000, и при необходимости имя устройства. Пока связи наружу нет, программа копит данные на диске.",
        "Программа сбора читает агента так, как его читают клиенты стандарта: /probe даёт модель устройств, и каждый DataItem становится тегом, /current даёт настоящее, дальше /sample страницами от nextSequence. Каждое наблюдение читается ровно один раз и с временем агента. Если отсчёты ушли из кольцевого буфера агента, программа берёт /current заново: промежуточные значения теряются, текущие нет. Перезапуск агента с новым instanceId перечитывает модель.",
        "Программа сбора задаёт агенту только три GET-запроса: probe, current и sample. PUT и POST, которыми адаптер пишет в агента, в драйвере не используются, поэтому агент ничего не получает от программы и машина через него не управляется. Элементы CONDITION становятся авариями с уровнем Warning или Fault; квитирования в MTConnect нет, и программа его не изображает.",
        "Опрос идёт с паузой «Опрос, мс» (по умолчанию 1000), а пока у агента есть непрочитанные отсчёты, без паузы. Запрос, не уложившийся в «Ожидание ответа», обрывает раунд, и программа начинает заново с запомненной позиции, в том числе после своего перезапуска. Слово состояния машины программа выводит из EXECUTION по тем же правилам, что для стоек FANUC по FOCAS, так что одна стойка читается одинаково обоими путями."
      ],
      "requirements": [
        "Агент MTConnect с доступными /probe, /current и /sample",
        "Сетевой доступ к агенту с сервера сбора без прокси",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Для https:// сертификат агента, которому доверяет программа сбора"
      ],
      "faq": [
        {
          "q": "Как подключить MTConnect?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите MTConnect и укажите адрес агента, например http://10.0.12.5:5000, и при необходимости имя или UUID устройства (пусто значит все устройства агента); сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в MTConnect?",
          "a": "Модель устройств агента как теги: значения SAMPLE и EVENT с историей, аварии из CONDITION, производителя, модель и серийный номер, а также выведенное слово состояния каждой машины, программу и счётчик деталей, если агент их объявляет."
        },
        {
          "q": "Отправляет ли агент команды машине?",
          "a": "Нет. Программа сбора делает только GET-запросы probe, current и sample. Запросов PUT и POST к агенту в драйвере нет, и машиной через MTConnect управлять нельзя."
        },
        {
          "q": "Агент отвечает JSON. Это проблема?",
          "a": "Нет. Программа сбора в каждом запросе просит XML (Accept: application/xml), и агенты 2.x отдают его, даже если по умолчанию настроены на JSON. Драйвер читает XML-документы всех версий."
        }
      ]
    },
    "seo_en": {
      "title": "MTConnect integration: machine alarms per shift",
      "description": "A shift's Warning and Fault items from CONDITION with their times, and output from the part count. A shop-floor collection program reads the MTConnect agent.",
      "headline": "Machine state and alarms from an MTConnect agent right in the chat",
      "scenarios": [
        {
          "title": "How the machines are now",
          "desc": "The agent shows each machine of the MTConnect agent with its state word (running, interrupted, stopped, idle) and its number of active alarms."
        },
        {
          "title": "Alarms and warnings",
          "desc": "The agent collects Warning and Fault from CONDITION items over a shift with codes, texts and the time each was raised and cleared."
        },
        {
          "title": "Program and parts",
          "desc": "The agent reads the active program, the controller mode and the part count and shows how many parts were added over a period."
        },
        {
          "title": "Running and downtime",
          "desc": "The agent takes EXECUTION observations for a period and works out how long the machine ran, sat in feed hold or waited."
        },
        {
          "title": "Spindle and overrides",
          "desc": "The agent collects the history of spindle speed and feed and spindle overrides in intervals: minimum, maximum and average."
        },
        {
          "title": "Machine identity",
          "desc": "The agent names the manufacturer, model and serial number of each device from the agent's description."
        }
      ],
      "how_it_works": [
        "An MTConnect agent usually sits on the site's network next to the machines, so the data collection program reaches it: it runs as a service on a server on the same network and sends data out only over an outbound connection. The connection takes the agent address, for example http://10.0.12.5:5000, and a device name if needed. While there is no link outside, the program keeps the data on disk.",
        "The collection program reads the agent the way the standard's clients do: /probe gives the device model and every DataItem becomes a tag, /current gives the present, then /sample page by page from nextSequence. Each observation is read exactly once, with the agent's time. If observations have left the agent's ring buffer, the program reads /current again: intermediate values are lost, the present is not. An agent restart with a new instanceId reads the model again.",
        "The collection program sends the agent only three GET requests: probe, current and sample. PUT and POST, an adapter's way of writing to the agent, are not used by the driver, so the agent receives nothing from the program and the machine is not controlled through it. CONDITION items become alarms at the Warning or Fault level; MTConnect has no acknowledgement, and the program does not pretend otherwise.",
        "Polling waits the Scan interval (1000 ms by default) between requests, and none while the agent still has unread observations. A request that does not finish within the Timeout ends the round, and the program starts again from the position it remembered, also after its own restart. The machine state word comes from EXECUTION by the same rules as for FANUC controls over FOCAS, so one control reads the same by either path."
      ],
      "requirements": [
        "An MTConnect agent serving /probe, /current and /sample",
        "Network access to the agent from the collection server without a proxy",
        "A collection server on the site network: Windows or Linux with Docker",
        "For https://, an agent certificate the collection program trusts"
      ],
      "faq": [
        {
          "q": "How do I connect MTConnect?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick MTConnect and enter the agent address, for example http://10.0.12.5:5000, and a device name or UUID if needed (empty means every device of the agent); the collection server is assigned automatically, and if there are several, pick one in the form."
        },
        {
          "q": "What does the agent see in MTConnect?",
          "a": "The agent's device model as tags: SAMPLE and EVENT values with history, alarms from CONDITION, the manufacturer, model and serial number, and the derived state word of each machine, its program and part count when the agent declares them."
        },
        {
          "q": "Does the agent send commands to the machine?",
          "a": "No. The collection program makes only the GET requests probe, current and sample. The driver has no PUT or POST to the agent, and a machine cannot be controlled through MTConnect."
        },
        {
          "q": "The agent answers in JSON. Is that a problem?",
          "a": "No. The collection program asks for XML in every request (Accept: application/xml), and 2.x agents return it even when set to JSON by default. The driver reads the XML documents of every version."
        }
      ]
    }
  },
  {
    "key": "onec",
    "name": "1С:Предприятие",
    "name_en": "1C:Enterprise",
    "description": "Справочники, документы и регистры 1С; печатные формы и события через расширение конфигурации",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "onec",
    "description_en": "1C catalogs, documents and registers; print forms and events via a configuration extension",
    "search_terms": [
      "одинэс",
      "бухгалтерия",
      "унф",
      "зуп"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://v8.1c.ru/platforma/rest-interfeys/",
      "steps": [
        {
          "title": "Опубликуйте базу в IIS/Apache с OData",
          "desc": "Опубликуйте базу 1С через IIS/Apache со стандартным OData. Для прямого облачного доступа публикация должна открываться по HTTPS из интернета.",
          "title_en": "Publish the infobase in IIS/Apache with OData",
          "desc_en": "Publish the infobase through IIS/Apache with the standard OData interface. For direct cloud access, use a public HTTPS address."
        },
        {
          "title": "Включите объекты в состав OData",
          "desc": "В базе: «Настройки стандартного интерфейса OData», вкладка «Состав». Отметьте объекты и запишите. Агент сделает это в вашем браузере, если вы вошли администратором.",
          "title_en": "Add the objects to the OData composition",
          "desc_en": "In the infobase: Standard OData interface settings, Composition tab. Tick the objects and save. The agent can do it in your browser if you are signed in as admin."
        },
        {
          "title": "Создайте отдельного пользователя 1С",
          "desc": "Дайте ему право удалённого доступа OData и только те права чтения или записи, которых требует работа.",
          "title_en": "Create a dedicated 1C user",
          "desc_en": "Give the user OData remote-access rights and only the read or write permissions the work requires."
        },
        {
          "title": "Укажите адрес публикации и учётные данные",
          "desc": "Введите адрес публикации, логин и пароль 1С. Если сервер доступен только в офисной сети, укажите его внутренний адрес и откройте приложение на компьютере в этой сети.",
          "title_en": "Enter the publication address and credentials",
          "desc_en": "Enter the publication address, 1C username and password. For a server reachable only inside the office, use its internal address and open the app on a computer there."
        },
        {
          "title": "Необязательно: расширение конфигурации",
          "desc": "Печатные формы, отчёты файлом и события отдаёт расширение конфигурации: скачайте его в карточке подключения и добавьте в «Расширения» с режимом совместимости базы.",
          "title_en": "Optional: configuration extension",
          "desc_en": "Print forms, report files and events come from the configuration extension: get it from the connection card and add it to Extensions with your base's compatibility mode."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для 1С:Предприятие: вопросы к базе через OData",
      "description": "Прочитает /$metadata вашей конфигурации и перечислит, что отдаёт публикация OData: 47 справочников, 39 документов, 32 регистра. Нужны адрес, логин и пароль.",
      "headline": "Спрашивайте свою базу 1С без новых обработок от программиста",
      "scenarios": [
        {
          "title": "Разбор состава OData",
          "desc": "Агент прочитает схему /$metadata вашей базы и перечислит, какие справочники, документы и регистры реально отдаются через OData."
        },
        {
          "title": "Обороты и сальдо по счетам",
          "desc": "Агент снимет обороты и остатки по счетам бухучёта за период, раскроет их по субконто и назовёт счета с нетипичным движением."
        },
        {
          "title": "Готовность к закрытию месяца",
          "desc": "Агент проверит, все ли документы месяца проведены, покажет незакрытые авансы и остатки на технических счетах перед закрытием."
        },
        {
          "title": "Остатки и потребность в закупках",
          "desc": "Агент проверит остатки по складам, сопоставит их со скоростью продаж и покажет, какие позиции пора дозаказывать, чтобы не уйти в минус."
        },
        {
          "title": "Контроль дебиторки и просроченных оплат",
          "desc": "Агент соберёт взаиморасчёты, найдёт просроченную дебиторскую задолженность по контрагентам и подготовит список на обзвон."
        },
        {
          "title": "Обеспечение заказов клиентов",
          "desc": "Агент сопоставит заказы клиентов со свободными остатками и заказами поставщикам и покажет, по каким позициям обеспечение не закрыто."
        },
        {
          "title": "Фонд оплаты труда по подразделениям",
          "desc": "Агент посчитает начисления за месяц в разрезе подразделений и видов расчёта и покажет, где выплаты выросли сильнее всего."
        },
        {
          "title": "Неоплаченные счета и зависшие деньги",
          "desc": "Агент соберёт заказы покупателей и счета за период и покажет, какие не оплачены и сколько денег зависло у клиентов."
        },
        {
          "title": "Просроченные согласования",
          "desc": "Агент найдёт документы, которые висят на согласовании дольше регламентного срока, и назовёт сотрудников, у которых остановился маршрут."
        },
        {
          "title": "Регулярная сводка из вашей базы",
          "desc": "Агент по расписанию соберёт показатели вашей конфигурации и пришлёт их в чат, даже если типового отчёта под такую задачу нет."
        },
        {
          "title": "Почему объекта нет в ответе",
          "desc": "Агент сверит состав OData с правами роли и скажет, объект не входит в состав или закрыт правами, а не покажет непонятную ошибки OData."
        }
      ],
      "how_it_works": [
        "Подойдёт любая конфигурация на платформе 1С:Предприятие 8, в которой можно опубликовать стандартный интерфейс OData: отраслевая, дописанная под себя или полностью самописная. Агент ходит в неё обычными HTTP-запросами к опубликованному адресу, авторизуясь на каждом обращении, и пользуется только тем, что OData умеет сам: отбором, сортировкой, разворотом ссылок и постраничной выборкой. Никакого кода в базе для этого не появляется.",
        "Прикладные имена объектов агент не угадывает: он читает схему /$metadata и перечисляет, какие справочники, документы, журналы и регистры сведений, накопления, бухгалтерии и расчёта реально отдаются наружу. Для нетиповой базы это первый полезный шаг сам по себе: видно, что публикация действительно отдаёт, ещё до того, как задавать содержательные вопросы по данным.",
        "Дальше агент работает с вашей структурой напрямую: отбирает документы по периоду, контрагенту или произвольному реквизиту и отвечает в чате, не требуя новой обработки от программиста; берёт виртуальные таблицы регистров накопления и возвращает остатки и обороты на дату в разрезе нужных измерений; по расписанию собирает показатели вашей конфигурации в регулярную сводку, даже если типового отчёта под такую задачу в базе нет.",
        "Видимость ограничена дважды: составом OData и правами роли пользователя, чьи логин и пароль подключены. Эти два ограничения агент различает: пустой /$metadata или отсутствие объекта означает, что он не входит в состав OData, а не отказ по правам; агент назовёт, что включить, и может отметить это в вашем браузере. Запись через OData доступна только при соответствующих правах роли, поэтому подключение на чтение в базе ничего не изменит."
      ],
      "requirements": [
        "Конфигурация на платформе 1С:Предприятие 8.",
        "Веб-сервер IIS или Apache с модулем веб-сервера 1С.",
        "Права администратора базы.",
        "Конфигуратор нужен только для первой публикации на веб-сервере.",
        "В 1С:Фреш и в облаке база уже опубликована."
      ],
      "faq": [
        {
          "q": "Как подключить базу 1С?",
          "a": "Адресом публикации, логином и паролем пользователя базы. Базу публикуют на веб-сервере с включённым стандартным интерфейсом OData, в настройке состава отмечают нужные объекты и заводят отдельного пользователя с ролью удалённого доступа OData."
        },
        {
          "q": "Подойдёт ли моя конфигурация?",
          "a": "Подойдёт любая конфигурация на платформе 1С:Предприятие 8, где можно опубликовать стандартный интерфейс OData: 1С:Бухгалтерия, Управление торговлей, ERP, Зарплата и управление персоналом, Управление нашей фирмой, Документооборот, отраслевые решения и дописанные под себя базы. Коннектор один на все: OData-поверхность у платформы общая, а прикладные имена объектов агент берёт из /$metadata, а не угадывает."
        },
        {
          "q": "Что видит агент в такой базе?",
          "a": "Ровно то, что отмечено на вкладке «Состав» настройки OData и разрешено ролью пользователя: справочники, документы, журналы, регистры сведений, накопления, бухгалтерии и расчёта."
        },
        {
          "q": "Что делать, если объекта нет в ответе?",
          "a": "Пустой /$metadata или отсутствие нужного объекта означает, что он не входит в состав OData, а не отказ по правам. Агент различает эти случаи, назовёт, что включить, и может отметить это в вашем браузере."
        }
      ]
    },
    "seo_en": {
      "title": "AI agent for 1C:Enterprise: ask your database over OData",
      "description": "Reads your configuration's /$metadata, lists what the OData publication exposes and answers from live data. Connects with the address, login and password.",
      "headline": "Query your own 1C database without new custom data processors",
      "scenarios": [
        {
          "title": "See what the OData composition exposes",
          "desc": "The agent reads the /$metadata schema of your database and lists which catalogues, documents and registers are really served over OData."
        },
        {
          "title": "Turnovers and balances by account",
          "desc": "The agent pulls turnovers and balances for accounting accounts over a period, breaks them down by subconto and names the accounts with unusual movement."
        },
        {
          "title": "Month-end close readiness",
          "desc": "The agent checks that every document of the month is posted and shows open advances and balances on technical accounts before the close."
        },
        {
          "title": "Stock levels and purchasing needs",
          "desc": "The agent checks stock across warehouses, compares it with the sales rate and shows which items to reorder before you run out."
        },
        {
          "title": "Receivables and overdue payments",
          "desc": "The agent collects settlements, finds overdue receivables by counterparty and prepares a call list."
        },
        {
          "title": "Covering customer orders",
          "desc": "The agent matches customer orders against free stock and purchase orders and shows which lines are still not covered."
        },
        {
          "title": "Wage fund by department",
          "desc": "The agent totals the accruals for the month by department and calculation type and shows where payments grew the most."
        },
        {
          "title": "Unpaid invoices and cash stuck with clients",
          "desc": "The agent collects customer orders and invoices for the period and shows which ones are unpaid and how much money is stuck with clients."
        },
        {
          "title": "Overdue approvals",
          "desc": "The agent finds documents that have been sitting in approval longer than the regulated deadline and names the employees where the route stalled."
        },
        {
          "title": "A regular digest from your database",
          "desc": "The agent gathers the metrics of your configuration on schedule and sends them to the chat, even when no standard report covers the task."
        },
        {
          "title": "Why an object is missing",
          "desc": "The agent checks the OData composition against the role permissions and says whether an object is simply outside the composition or closed off by rights, instead of a cryptic OData error."
        }
      ],
      "how_it_works": [
        "Any configuration on the 1C:Enterprise 8 platform that can publish the standard OData interface will do: industry-specific, customised in-house or written from scratch. The agent reaches it with ordinary HTTP requests to the published address, authenticating on every call, and uses only what OData offers by itself: filtering, ordering, expanding references and paging through results. No code is added inside the database for this.",
        "The agent does not guess applied object names: it reads the /$metadata schema and lists which catalogues, documents, journals and information, accumulation, accounting and calculation registers are actually served outward. For a non-standard database that is a useful step in itself: you see what the publication really exposes before asking any substantive question about the data.",
        "From there the agent works with your structure directly: it selects documents by period, counterparty or an arbitrary attribute and answers in the chat, with no new data processor needed from a developer; it takes the virtual tables of accumulation registers and returns balances and turnovers as of a date across the dimensions you need; and on a schedule it gathers the metrics of your configuration into a regular digest, even when the database has no standard report for the task.",
        "Visibility is limited twice over: by the OData composition and by the permissions of the role of the user whose login and password are connected. The agent tells those two limits apart: an empty /$metadata or a missing object means it is outside the OData composition rather than a permissions refusal; the agent names what to add and can tick it in your browser. Writing over OData is available only with the matching role permissions, so a read-only connection changes nothing in the database."
      ],
      "requirements": [
        "A configuration on the 1C:Enterprise 8 platform.",
        "An IIS or Apache web server with the 1C web server module.",
        "Infobase admin rights.",
        "The Configurator is needed only for the first web-server publication.",
        "In 1C:Fresh and in the cloud the infobase is already published."
      ],
      "faq": [
        {
          "q": "How do I connect a 1C database?",
          "a": "With the publication address plus the login and password of a database user. The database is published on a web server with the standard OData interface enabled, the objects you need are ticked in the composition settings, and a separate user with the OData remote access role is created."
        },
        {
          "q": "Will my configuration work?",
          "a": "Any configuration on the 1C:Enterprise 8 platform that can publish the standard OData interface will work: 1C:Accounting, Trade Management, ERP, Payroll and HR, Small Firm Management, Document Management, industry-specific solutions and heavily customised databases. One connector covers them all (the platform's OData surface is shared), and the agent takes applied object names from /$metadata rather than guessing them."
        },
        {
          "q": "What does the agent see in such a database?",
          "a": "Exactly what is ticked on the Composition tab of the OData settings and allowed by the user role: catalogues, documents, journals, information registers, accumulation registers, accounting registers and calculation registers."
        },
        {
          "q": "What if an object is missing from the response?",
          "a": "An empty /$metadata or a missing object means it is outside the OData composition, not that permissions were denied. The agent tells these cases apart, names what to add and can tick it in your browser."
        }
      ]
    }
  },
  {
    "key": "onvif",
    "name": "ONVIF",
    "name_en": "ONVIF",
    "description": "Кадр по запросу и движение IP-камеры ONVIF через программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "onvif",
    "description_en": "Read-only on-demand frames and motion events of ONVIF IP cameras through the data collection program",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Включите ONVIF на камере",
          "desc": "Hikvision: Configuration → Network → Advanced Settings → Integration Protocol, отметьте Enable ONVIF и сохраните. Axis: System → ONVIF. На новых прошивках ONVIF выключен.",
          "title_en": "Turn ONVIF on in the camera",
          "desc_en": "Hikvision: Configuration → Network → Advanced Settings → Integration Protocol, tick Enable ONVIF and save. Axis: System → ONVIF. Recent firmware ships with ONVIF off."
        },
        {
          "title": "Заведите отдельного пользователя ONVIF",
          "desc": "У Hikvision и Axis список пользователей ONVIF отдельный от входа в веб-интерфейс. Добавьте пользователя там и впишите его имя и пароль в поля подключения.",
          "title_en": "Add a separate ONVIF user",
          "desc_en": "Hikvision and Axis keep ONVIF users apart from the web login. Add a user in the ONVIF list and enter its name and password in the connection fields."
        },
        {
          "title": "Настройте время по NTP",
          "desc": "События движения несут время камеры. Без NTP часы камеры уходят, а после отключения питания некоторые начинают с 1970 года.",
          "title_en": "Set the camera's time by NTP",
          "desc_en": "Motion events carry the camera's time. Without NTP its clock drifts, and some cameras restart at 1970 after a power cut."
        },
        {
          "title": "Для https добавьте сертификат камеры",
          "desc": "Если адрес камеры https:// с самоподписанным сертификатом, положите сертификат в папку pki/onvif/trusted/ в папке данных программы сбора на сервере сбора.",
          "title_en": "For https, trust the camera's certificate",
          "desc_en": "If the camera's address is https:// with a self-signed certificate, put the certificate into pki/onvif/trusted/ in the program's data folder on the collection server."
        }
      ]
    },
    "seo": {
      "title": "Камеры ONVIF и ИИ-агент: кадр и движение ночью",
      "description": "Было ли ночью движение на складе и сколько оно длилось, кадр с ворот по запросу. IP-камеры ONVIF опрашивает программа сбора в сети объекта, агент ничего не меняет.",
      "headline": "Кадр с IP-камеры и движение по ONVIF прямо в чате",
      "scenarios": [
        {
          "title": "Кадр по просьбе",
          "desc": "Агент снимет один кадр с выбранной камеры и посмотрит, что сейчас у ворот, на складе или в серверной, а кадр пришлёт в чат."
        },
        {
          "title": "Обход камер",
          "desc": "Агент снимет по кадру с нескольких камер подряд и коротко опишет, что видно на каждой."
        },
        {
          "title": "Было ли движение",
          "desc": "Агент прочитает историю датчика движения камеры и назовёт, когда за ночь или выходные она фиксировала движение и сколько оно длилось."
        },
        {
          "title": "Где движение сейчас",
          "desc": "Агент проверит текущее состояние движения по каждому видеоисточнику подключённых камер и назовёт те, где оно есть."
        },
        {
          "title": "Кадр и последнее движение",
          "desc": "Агент снимет кадр и рядом назовёт, когда на этой камере последний раз было движение."
        },
        {
          "title": "Профили камеры",
          "desc": "Агент перечислит профили камеры: имя, кодек, разрешение и есть ли у профиля снимок, чтобы выбрать, с какого брать кадр."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и отправляет данные наружу только исходящим соединением. В подключении указывается адрес камеры вида http://192.168.1.64 или полный адрес службы …/onvif/device_service, имя и пароль пользователя ONVIF.",
        "Программа сбора читает камеру так же, как клиенты стандарта: сначала часы камеры, потом адреса её служб, профили и адрес снимка каждого профиля (Media 1 или Media 2). Каждый вход подписывается по часам самой камеры, поэтому камера с ушедшими часами вход не отклоняет. Движение программа получает подпиской pull-point, которая живёт около минуты и продлевается, чтобы не занимать у камеры место подписки.",
        "Подключение только читает. Программа сбора отправляет камере только запросы из закрытого списка: часы, службы, профили, события и снимок. Поворотом и зумом, настройками, записью и пользователями камеры он не управляет. Подписка на события ничего не меняет в том, что камера снимает, пишет или показывает, и заканчивается сама.",
        "Кадр снимается по адресу снимка камеры (JPEG), а не из видеопотока: камеру без такого адреса программа прямо называет. Видеоролики и поток RTSP программа не забирает, камеры в сети сама не ищет, адрес вводится вручную. Если камера отказывает в подписке на события, программа продолжает работать с профилями и кадрами без движения."
      ],
      "requirements": [
        "IP-камера с ONVIF (Profile S) и включённой службой ONVIF",
        "Пользователь ONVIF камеры с паролем",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к камере по HTTP или HTTPS"
      ],
      "faq": [
        {
          "q": "Как подключить камеру ONVIF?",
          "a": "Включите ONVIF на камере и заведите там пользователя ONVIF. В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите ONVIF и укажите адрес камеры, например http://192.168.1.64, имя и пароль пользователя ONVIF; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в камере ONVIF?",
          "a": "Профили камеры с кодеком и разрешением, состояние движения по каждому видеоисточнику и его историю, если события камеры несут движение, и один кадр по запросу, снятый по адресу снимка камеры."
        },
        {
          "q": "Может ли агент повернуть камеру или изменить её настройки?",
          "a": "Нет. Программа сбора не отправляет команд поворота и зума, не меняет настройки, запись и пользователей камеры. Он только читает часы, профили и события и снимает кадр."
        },
        {
          "q": "Камера отклоняет вход, хотя пароль верный. Что проверить?",
          "a": "У многих камер пользователи ONVIF заводятся отдельно от входа в веб-интерфейс: проверьте, что пользователь есть именно в списке ONVIF. Ещё проверьте, что ONVIF на камере включён: на новых прошивках он выключен."
        }
      ]
    },
    "seo_en": {
      "title": "ONVIF cameras and an AI agent: snapshots and night motion",
      "description": "Whether the warehouse saw motion overnight and for how long, plus a gate snapshot on request. A collection program on site polls ONVIF cameras, read-only.",
      "headline": "IP camera frames and motion over ONVIF right in the chat",
      "scenarios": [
        {
          "title": "A frame on request",
          "desc": "The agent takes one frame from the chosen camera, looks at what is happening at the gate, in the warehouse or in the server room now, and sends the frame to the chat."
        },
        {
          "title": "Camera round",
          "desc": "The agent takes a frame from several cameras in a row and briefly describes what each one shows."
        },
        {
          "title": "Was there motion",
          "desc": "The agent reads the camera's motion history and names when it saw motion overnight or over the weekend and how long it lasted."
        },
        {
          "title": "Where motion is now",
          "desc": "The agent checks the current motion state of every video source of the connected cameras and names the ones where there is motion."
        },
        {
          "title": "Frame and last motion",
          "desc": "The agent takes a frame and names beside it when this camera last saw motion."
        },
        {
          "title": "Camera profiles",
          "desc": "The agent lists the camera's profiles: name, codec, resolution and whether the profile has a snapshot, so you can choose which one to take frames from."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server in the site network and sends data out over an outgoing connection only. The connection takes the camera address, such as http://192.168.1.64 or the full …/onvif/device_service address, and the ONVIF user's name and password.",
        "The data collection program reads the camera the way the standard's clients do: first the camera's clock, then its service addresses, the profiles and each profile's snapshot address (Media 1 or Media 2). Every login is stamped by the camera's own clock, so a camera whose clock has drifted does not refuse it. Motion arrives through a pull-point subscription that lives about a minute and is renewed, so it does not hold one of the camera's subscription slots.",
        "The connection only reads. The program sends the camera only requests from a closed list: clock, services, profiles, events and snapshot. It does not control pan and zoom, settings, recording or the camera's users. The event subscription changes nothing the camera captures, records or shows, and ends by itself.",
        "A frame is taken from the camera's snapshot address (JPEG), not from the video stream: a camera without such an address is named as such. The program does not take clips or the RTSP stream and does not search the network for cameras; the address is entered by hand. If the camera refuses the event subscription, the program goes on with profiles and frames without motion."
      ],
      "requirements": [
        "An IP camera with ONVIF (Profile S) and the ONVIF service turned on",
        "A camera ONVIF user with a password",
        "A collection server in the site network: Windows, or Linux with Docker",
        "Access from the collection server to the camera over HTTP or HTTPS"
      ],
      "faq": [
        {
          "q": "How do I connect an ONVIF camera?",
          "a": "Turn ONVIF on in the camera and add an ONVIF user there. In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick ONVIF and enter the camera address, for example http://192.168.1.64, and the ONVIF user's name and password; the collection server is assigned automatically, or you pick it in the form if there are several."
        },
        {
          "q": "What does the agent see in an ONVIF camera?",
          "a": "The camera's profiles with codec and resolution, the motion state of each video source and its history when the camera's events carry motion, and one frame on request taken from the camera's snapshot address."
        },
        {
          "q": "Can the agent turn the camera or change its settings?",
          "a": "No. The program sends no pan or zoom commands and does not change the camera's settings, recording or users. It only reads the clock, profiles and events and takes a frame."
        },
        {
          "q": "The camera refuses the login though the password is right. What should I check?",
          "a": "Many cameras keep ONVIF users apart from the web login: check that the user exists in the ONVIF list itself. Also check that ONVIF is turned on in the camera: recent firmware ships with it off."
        }
      ]
    }
  },
  {
    "key": "opc_da",
    "name": "OPC DA",
    "name_en": "OPC DA",
    "description": "Теги сервера OPC DA (Classic) старых SCADA через программу сбора данных на Windows, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "opc-da",
    "description_en": "Read-only OPC DA (Classic) server tags of legacy SCADA through a data collection program on Windows",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Поставьте сервер сбора рядом с OPC DA",
          "desc": "Для OPC DA программа сбора работает на Windows. На компьютере самого сервера COM вызывается локально: DCOM и брандмауэр не нужны, хватает учётки службы программы.",
          "title_en": "Put the collection server next to OPC DA",
          "desc_en": "For OPC DA the collection program runs on Windows. On the server's own computer COM is called locally: no DCOM or firewall rules, the service account is usually enough."
        },
        {
          "title": "Установите OPC Core Components",
          "desc": "Прокси интерфейсов OPC ставятся пакетом OPC Core Components от OPC Foundation. Без него на сервере сбора вызовы к серверу OPC DA не проходят.",
          "title_en": "Install the OPC Core Components",
          "desc_en": "The OPC interface proxies come with the OPC Foundation's Core Components package. Without it on the collection server calls to the OPC DA server fail."
        },
        {
          "title": "Для удалённого сервера откройте DCOM",
          "desc": "Откройте TCP 135 и динамический диапазон портов DCOM, дайте учётке права запуска и доступа к серверу. ProgID удалённо разрешает служба OpcEnum.",
          "title_en": "For a remote server, open DCOM",
          "desc_en": "Open TCP 135 and the DCOM dynamic port range, and give the account launch and access rights to the server. The OpcEnum service resolves the ProgID remotely."
        },
        {
          "title": "Укажите учётку Windows",
          "desc": "В поле пользователя впишите ДОМЕН\\пользователь, которому сервер разрешает чтение. Пустое поле: программа сбора ходит от учётки своей службы.",
          "title_en": "Enter the Windows account",
          "desc_en": "Put the DOMAIN\\user the server allows to read into the user field. An empty field means the collection program uses its own service account."
        }
      ]
    },
    "seo": {
      "title": "Сервер OPC DA и ИИ: среднее давление за смену",
      "description": "Минимум, максимум и среднее давления за смену из тегов старой SCADA на OPC DA (Classic). Сервер опрашивает программа сбора на Windows, с качеством и временем.",
      "headline": "Теги серверов OPC DA старых SCADA прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по ветке или ItemID и покажет текущие значения со временем сервера и качеством."
        },
        {
          "title": "История за смену",
          "desc": "Агент прочитает накопленную историю тега за смену или сутки и посчитает минимум, максимум и среднее."
        },
        {
          "title": "Теги с плохим качеством",
          "desc": "Агент найдёт теги, которые сервер отдаёт с качеством bad или uncertain, и покажет, с какого момента."
        },
        {
          "title": "Сравнение линий",
          "desc": "Агент сравнит одинаковые теги разных линий или станций за период и покажет, где значения расходятся."
        },
        {
          "title": "Сообщение о пороге",
          "desc": "В задаче «По событию» агент сообщит, когда значение тега выйдет за порог и продержится заданное время, и когда вернётся в норму."
        },
        {
          "title": "Связь с объектом",
          "desc": "Агент скажет, когда сервер сбора пропал со связи и когда вернулся, чтобы пропуск в истории был виден сразу."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере сбора с Windows и отправляет данные наружу только исходящим соединением. Лучше всего поставить её на тот же компьютер, где работает сервер OPC DA: локальному COM не нужны права DCOM и правила брандмауэра. В подключении указывается адрес вида opcda://localhost/Kepware.KEPServerEX.V6, где после хоста стоит ProgID или CLSID сервера.",
        "OPC DA работает поверх COM, у которого нет таймаута вызова, поэтому программа сбора держит COM в отдельном вспомогательном процессе и снимает его, если сервер не ответил вовремя. Она создаёт одну активную группу и читает кэш сервера, а не устройство: ПЛК не получает лишних запросов, как бы часто ни шёл опрос. Перед каждым чтением программа спрашивает статус сервера.",
        "Теги берутся из обзора адресного пространства сервера (DA 3, а если сервер его не поддерживает, DA 2) или из вашего списка строк «путь, ItemID, тип». Служебные ветки вроде _System у Kepware пропускаются, если вы их не назвали. Подписку с обратным вызовом программа не использует: она требует входящего канала DCOM к серверу сбора.",
        "Программа сбора только читает: записи в OPC DA в коде драйвера нет. У самого OPC DA истории нет, поэтому история тега копится из её опросов с учётом мёртвой зоны и повтора молчащего тега. Пока облако недоступно, значения ждут на диске сервера сбора и приходят после восстановления связи."
      ],
      "requirements": [
        "Сервер сбора на Windows, лучше компьютер самого сервера OPC DA",
        "Пакет OPC Core Components от OPC Foundation на сервере сбора",
        "Для удалённого сервера: открытые TCP 135 и динамические порты DCOM",
        "Учётка Windows с правами запуска и доступа к серверу"
      ],
      "faq": [
        {
          "q": "Как подключить OPC DA?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных для Windows одной командой из окна, лучше на компьютер сервера OPC DA. Затем выберите OPC DA и укажите адрес opcda://localhost/ с ProgID сервера, например Kepware.KEPServerEX.V6; если серверов сбора несколько, выберите нужный в форме. Логин можно не указывать: локальному серверу обычно хватает учётки службы программы."
        },
        {
          "q": "Что агент видит в OPC DA?",
          "a": "Теги, которые показывает обзор сервера, или те, что вы перечислили строками, с текущим значением, временем сервера и качеством, и историю, которую программа сбора накопила опросами. Ветка, под которой найден тег, служит подписью, а сам тег определяется своим ItemID."
        },
        {
          "q": "Меняет ли агент значения?",
          "a": "Нет. Программа сбора читает только кэш своей активной группы на сервере, записи в коде драйвера нет. Обратных вызовов от сервера к ней тоже нет, поэтому входящий канал DCOM на сервер сбора не открывается."
        },
        {
          "q": "Ошибка REGDB_E_IIDNOTREG или E_NOINTERFACE. Что это?",
          "a": "На сервере сбора нет прокси интерфейсов OPC, без которых вызов между процессами не проходит. Установите пакет OPC Core Components от OPC Foundation на компьютер, где работает программа сбора."
        }
      ]
    },
    "seo_en": {
      "title": "OPC DA server and AI: shift averages from legacy SCADA",
      "description": "Minimum, maximum and average pressure over a shift from legacy SCADA tags on OPC DA (Classic). A Windows collection program reads them with quality and server time.",
      "headline": "Legacy SCADA tags from OPC DA servers right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by branch or ItemID and shows current values with the server time and quality."
        },
        {
          "title": "A shift history",
          "desc": "The agent reads a tag's collected history for a shift or a day and works out the minimum, maximum and average."
        },
        {
          "title": "Tags with bad quality",
          "desc": "The agent finds tags the server returns with bad or uncertain quality and shows since when."
        },
        {
          "title": "Comparing lines",
          "desc": "The agent compares the same tags of different lines or stations over a period and shows where the values part."
        },
        {
          "title": "A threshold message",
          "desc": "In an event task the agent tells you when a tag's value crosses a threshold and holds for the set time, and when it is back to normal."
        },
        {
          "title": "Link to the site",
          "desc": "The agent tells you when the collection server went offline and came back, so a gap in the history is visible at once."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a Windows collection server and sends data out only over an outbound connection. It is best put on the same computer as the OPC DA server: local COM needs no DCOM rights and no firewall rules. The connection takes an address such as opcda://localhost/Kepware.KEPServerEX.V6, with the server ProgID or CLSID after the host.",
        "OPC DA runs on COM, whose calls have no timeout, so the collection program holds COM in a separate helper process and stops it if the server does not answer in time. It creates one active group and reads the server cache, not the device: the PLC gets no extra requests however often the poll runs. Before every read the program asks the server status.",
        "Tags come from browsing the server address space (DA 3, or DA 2 if the server does not support it) or from your list of lines of path, ItemID and type. Server branches such as Kepware's _System are skipped unless you name them. The program uses no callback subscription: it would need an inbound DCOM channel to the collection server.",
        "The collection program only reads: the driver has no OPC DA write in its code. OPC DA itself keeps no history, so a tag's history builds up from the program's polls, with the deadband and the repeat of a silent tag. While the cloud is unreachable, values wait on the collection server's disk and arrive once the link is back."
      ],
      "requirements": [
        "A collection server on Windows, best the OPC DA server's own computer",
        "The OPC Foundation's Core Components package on the collection server",
        "For a remote server: TCP 135 and the DCOM dynamic ports open",
        "A Windows account with launch and access rights to the server"
      ],
      "faq": [
        {
          "q": "How do I connect OPC DA?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program for Windows with the one command from the window, best on the OPC DA server's computer. Then pick OPC DA and enter opcda://localhost/ with the server ProgID, for example Kepware.KEPServerEX.V6; if there are several collection servers, pick one in the form. The login can stay empty: for a local server the program's service account is usually enough."
        },
        {
          "q": "What does the agent see in OPC DA?",
          "a": "The tags the server browse shows, or those you listed as lines, with the current value, server time and quality, plus the history the collection program gathered by polling. The branch a tag was found under is its caption, while the tag itself is identified by its ItemID."
        },
        {
          "q": "Does the agent change values?",
          "a": "No. The collection program only reads the cache of its active group on the server, and the driver has no write in its code. There are no callbacks from the server to the program either, so no inbound DCOM channel is opened to the collection server."
        },
        {
          "q": "REGDB_E_IIDNOTREG or E_NOINTERFACE. What is it?",
          "a": "The collection server lacks the OPC interface proxies, and without them a call between processes fails. Install the OPC Foundation's Core Components package on the computer where the collection program runs."
        }
      ]
    }
  },
  {
    "key": "opcua",
    "name": "OPC UA",
    "name_en": "OPC UA",
    "description": "Теги сервера OPC UA (Kepware, Ignition, SCADA, ПЛК) через программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "opcua",
    "description_en": "Read-only OPC UA server tags from Kepware, Ignition, SCADA and PLCs via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Узнайте адрес эндпоинта сервера",
          "desc": "Адрес вида opc.tcp://хост:порт есть в настройках сервера OPC UA (стандартный порт 4840). Откройте этот порт с сервера сбора до сервера OPC UA.",
          "title_en": "Find the server's endpoint address",
          "desc_en": "The opc.tcp://host:port address is in the OPC UA server settings (the standard port is 4840). Open that port from the collection server to the OPC UA server."
        },
        {
          "title": "Заведите пользователя с правом чтения",
          "desc": "Создайте на сервере пользователя, которому разрешено читать теги и их историю. Без логина и пароля программа сбора входит анонимно, если сервер это разрешает.",
          "title_en": "Add a user with read rights",
          "desc_en": "Create a server user allowed to read tags and their history. Without a login and password the collection program signs in anonymously, if the server allows it."
        },
        {
          "title": "Доверьте сертификат программы на сервере",
          "desc": "Программа сбора данных предъявляет серверу свой сертификат приложения. Если сервер отклонил его при первой попытке, переведите этот сертификат в доверенные на сервере.",
          "title_en": "Trust the program's certificate on the server",
          "desc_en": "The collection program presents its own application certificate. If the server rejected it on the first attempt, trust that certificate on the server."
        },
        {
          "title": "Доверьте сертификат сервера в программе",
          "desc": "Незнакомый сертификат сервера программа сбора кладёт в pki/opcua/rejected/certs/ своей папки данных. Перенесите его в pki/opcua/trusted/certs/ той же папки.",
          "title_en": "Trust the server certificate in the program",
          "desc_en": "The collection program puts an unknown server certificate into pki/opcua/rejected/certs/ in its data folder. Move it to pki/opcua/trusted/certs/ in the same folder."
        }
      ]
    },
    "seo": {
      "title": "Подключение OPC UA к ИИ-агенту: активные аварии",
      "description": "Какие аварии Alarms & Conditions активны и какая не квитирована, тренд тега за смену из Kepware, Ignition или ПЛК. Сервер OPC UA читает программа сбора, без записи.",
      "headline": "Теги, история и аварии сервера OPC UA прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по имени или описанию и покажет текущие значения с единицами, временем источника и качеством."
        },
        {
          "title": "Тренд за смену",
          "desc": "Агент прочитает историю тега за смену или неделю и назовёт минимум, максимум, среднее и моменты, когда значение выходило за диапазон."
        },
        {
          "title": "Активные аварии",
          "desc": "Агент соберёт аварии сервера из Alarms & Conditions: какие стоят сейчас, какие квитированы и когда поднялись."
        },
        {
          "title": "Состояние машин",
          "desc": "На сервере с моделью umati агент покажет каждую машину, её состояние, режим работы, состояние каналов, коррекцию подачи и активную программу."
        },
        {
          "title": "Сообщение о пороге",
          "desc": "В задаче «По событию» агент сообщит, когда значение тега выйдет за порог и продержится заданное время, и когда вернётся в норму."
        },
        {
          "title": "Связь с объектом",
          "desc": "Агент скажет, когда сервер сбора пропал со связи и когда вернулся, и покажет пропуск в истории тега, если сервер не смог его заполнить."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и отправляет данные наружу только исходящим соединением. К серверу OPC UA она подключается сама по адресу opc.tcp, который вы укажете, с логином и паролем или анонимно.",
        "Программа сбора обходит адресное пространство от Objects или от корня, который вы назовёте, берёт у числовых переменных единицы и диапазон и подписывается на изменения, а не опрашивает теги. Мёртвая зона уходит серверу фильтром изменений. Аварии читаются по Alarms & Conditions, а на сервере с моделью umati программа узнаёт машины, их состояние и активную программу.",
        "По умолчанию программа сбора выбирает самую сильную защищённую политику сервера и сам на None не переходит: открытый канал выбирает только владелец. Устаревшие Basic128Rsa15 и Basic256 не поддерживаются, незнакомому сертификату сервера она не доверяет. Её сессия умеет только читать: записи значений и вызова методов в ней нет, кроме запроса текущих аварий (ConditionRefresh).",
        "Если связь с сервером пропала, после переподключения программа сбора дочитывает пропущенное из истории сервера (HistoryRead), но не дальше недели назад. Kepware и Ignition как серверы OPC UA историю обычно не хранят, и тогда разрыв остаётся пропуском. Пока облако недоступно, значения копятся на диске сервера сбора и приходят после восстановления связи."
      ],
      "requirements": [
        "Сервер OPC UA, доступный по opc.tcp с сервера сбора",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Пользователь сервера с правом чтения либо разрешённый анонимный вход",
        "Взаимное доверие сертификатов программы сбора и сервера в защищённом режиме"
      ],
      "faq": [
        {
          "q": "Как подключить OPC UA?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите OPC UA и укажите адрес вида opc.tcp://10.0.12.5:4840, а также пользователя и пароль, если сервер их требует; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Затем доверьте сертификат программы на сервере OPC UA и сертификат сервера в программе."
        },
        {
          "q": "Что агент видит в OPC UA?",
          "a": "Переменные дерева сервера с типом, единицами, диапазоном и описанием, их текущие значения и историю, аварии Alarms & Conditions, а на серверах с моделью umati ещё машины с их состоянием и программой. Обход можно сузить корнем или перечнем NodeId."
        },
        {
          "q": "Меняет ли агент значения?",
          "a": "Нет. Сессия программы сбора не умеет писать значения и вызывать методы. Единственный вызов в ней, ConditionRefresh, только просит сервер прислать текущие аварии заново. Квитировать аварии агент тоже не может."
        },
        {
          "q": "Подключение отклонено из-за сертификата. Что делать?",
          "a": "Незнакомый сертификат сервера программа сбора кладёт в pki/opcua/rejected/certs/ своей папки данных. Перенесите файл в pki/opcua/trusted/certs/ той же папки или положите в pki/opcua/issuer/certs/ сертификат центра, который его выпустил. Сервер, в свою очередь, должен доверять сертификату программы сбора."
        }
      ]
    },
    "seo_en": {
      "title": "OPC UA server and an AI agent: active alarms and acks",
      "description": "Which Alarms & Conditions are active and unacknowledged, plus a shift trend from Kepware, Ignition or a PLC. A collection program on site reads the OPC UA server.",
      "headline": "OPC UA server tags, history and alarms right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by name or description and shows current values with units, source time and quality."
        },
        {
          "title": "A shift trend",
          "desc": "The agent reads a tag's history for a shift or a week and names the minimum, maximum, average and the moments the value left its range."
        },
        {
          "title": "Active alarms",
          "desc": "The agent collects the server's Alarms & Conditions: which stand now, which are acknowledged and when they were raised."
        },
        {
          "title": "Machine state",
          "desc": "On a server with the umati model the agent shows each machine, its state, operation mode, channel state, feed override and active program."
        },
        {
          "title": "A threshold message",
          "desc": "In an event task the agent tells you when a tag's value crosses a threshold and holds for the set time, and when it is back to normal."
        },
        {
          "title": "Link to the site",
          "desc": "The agent tells you when the collection server went offline and came back, and shows a gap in a tag's history if the server could not fill it."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network and sends data out only over an outbound connection. It connects to the OPC UA server itself at the opc.tcp address you give, with a login and password or anonymously.",
        "The collection program browses the address space from Objects or from the root you name, takes units and range for numeric variables and subscribes to changes instead of polling tags. The deadband goes to the server as a data change filter. Alarms are read through Alarms & Conditions, and on a server with the umati model the program recognises machines, their state and active program.",
        "By default the collection program picks the server's strongest secured policy and never falls back to None on its own: an open channel is the owner's choice only. The deprecated Basic128Rsa15 and Basic256 are not supported, and an unknown server certificate is not trusted. Its session can only read: it has no value writes and no method calls, except asking for current alarms (ConditionRefresh).",
        "If the link to the server drops, after reconnecting the collection program reads what it missed from the server history (HistoryRead), but no further back than a week. Kepware and Ignition as OPC UA servers usually keep no history, and then the break stays a gap. While the cloud is unreachable, values pile up on the collection server's disk and arrive once the link is back."
      ],
      "requirements": [
        "An OPC UA server reachable over opc.tcp from the collection server",
        "A collection server on the site network: Windows or Linux with Docker",
        "A server user with read rights, or anonymous sign-in allowed",
        "Mutual trust of the collection program and server certificates in secured mode"
      ],
      "faq": [
        {
          "q": "How do I connect OPC UA?",
          "a": "In Integrations → \"Equipment\", click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command from the window. Then pick OPC UA and enter an address such as opc.tcp://10.0.12.5:4840, plus a user and password if the server asks for them; the collection server is assigned automatically, and if there are several, pick one in the form. Then trust the program's certificate on the OPC UA server and the server certificate in the program."
        },
        {
          "q": "What does the agent see in OPC UA?",
          "a": "The server tree's variables with type, units, range and description, their current values and history, Alarms & Conditions, and on servers with the umati model also machines with their state and program. The browse can be narrowed by a root or a list of NodeIds."
        },
        {
          "q": "Does the agent change values?",
          "a": "No. The collection program's session cannot write values or call methods. Its one call, ConditionRefresh, only asks the server to send current alarms again. The agent cannot acknowledge alarms either."
        },
        {
          "q": "The connection is refused over a certificate. What now?",
          "a": "The collection program puts an unknown server certificate into pki/opcua/rejected/certs/ in its data folder. Move the file to pki/opcua/trusted/certs/ in the same folder, or put the certificate of the issuing authority into pki/opcua/issuer/certs/. The server in turn has to trust the collection program's certificate."
        }
      ]
    }
  },
  {
    "key": "ord",
    "name": "1ОРД (Билайн)",
    "name_en": "1ORD (Beeline)",
    "description": "Реестр рекламных данных: креативы, контракты, площадки, участники, акты, отчётность",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ord",
    "description_en": "Ad data registry: creatives, contracts, platforms, participants, acts and reporting",
    "guide": {
      "url": "https://ord.beeline.ru",
      "steps": [
        {
          "title": "На ord.beeline.ru пройдите «Регистрацию»",
          "desc": "На ord.beeline.ru откройте «Регистрация», заполните данные организации и нажмите «Отправить заявку». Логин и пароль придут письмом после активации кабинета.",
          "title_en": "Fill in «Регистрация» at ord.beeline.ru",
          "desc_en": "At ord.beeline.ru open «Регистрация», fill in the company details and press «Отправить заявку». Credentials arrive by email after activation."
        },
        {
          "title": "При первом входе примите оферту",
          "desc": "При первом входе кабинет предлагает принять оферту ООО «Первый ОРД». Принять её может только администратор организации.",
          "title_en": "Accept the offer on first sign-in",
          "desc_en": "On first sign-in the account asks you to accept the offer of ООО «Первый ОРД». Only the organization administrator can accept it."
        },
        {
          "title": "В «Пользователях» добавьте «Пользователя API»",
          "desc": "«Пользователи» → «Добавить пользователя»: укажите почту и роль «Пользователь API». Если такой роли в форме нет, напишите на support@1ord.ru.",
          "title_en": "In «Пользователи», add a «Пользователь API»",
          "desc_en": "«Пользователи» → «Добавить пользователя»: enter the email and pick the «Пользователь API» role. If the form lacks it, ask support@1ord.ru."
        },
        {
          "title": "Войдите на ord.beeline.ru новой парой",
          "desc": "Войдите с полученной парой на ord.beeline.ru: логин из письма может отличаться от почты. Не подошёл? «Восстановление пароля».",
          "title_en": "Sign in at ord.beeline.ru with that pair",
          "desc_en": "Sign in with that pair at ord.beeline.ru: the login from the email may differ from the mailbox. If it fails, use «Восстановление пароля»."
        }
      ]
    },
    "seo": {
      "title": "1ОРД (Билайн) и ИИ-агент: регистрация креатива и erid",
      "description": "Первый ОРД Билайн (1ОРД): агент заведёт креатив баннера и вернёт erid, а к месячной отчётности найдёт записи, которые не принял ЕРИР. Вход по логину кабинета.",
      "headline": "Регистрируйте креативы и получайте erid без ручной формы",
      "scenarios": [
        {
          "title": "Регистрация креатива и erid",
          "desc": "Агент заведёт креатив вместе с медиаданными и вернёт erid, который нужно поставить в ссылку до старта размещения."
        },
        {
          "title": "Проверка выгрузки в ЕРИР",
          "desc": "Агент покажет, какие договоры, креативы и акты не ушли в ЕРИР, и назовёт поле, из-за которого запись не прошла."
        },
        {
          "title": "Акты и статистика показов",
          "desc": "Агент соберёт статистику показов по площадкам и акты к сроку месячной отчётности и пришлёт сводку по тому, что ещё не сдано."
        },
        {
          "title": "Договоры и цепочка участников",
          "desc": "Агент найдёт изначальный договор по ИНН сторон, проверит дубликаты и покажет, где в цепочке контрагентов не хватает звена."
        },
        {
          "title": "Площадки под размещение",
          "desc": "Агент заведёт площадку размещения по вашим данным, привяжет её к креативу и обновит статистику показов, когда открутка пойдёт."
        },
        {
          "title": "Ревизия перед стартом кампании",
          "desc": "Агент выгрузит креативы пачкой, найдёт те, у которых нет erid или не хватает медиаданных, и назовёт, какого блока не хватает каждому."
        }
      ],
      "how_it_works": [
        "Агент работает с 1ОРД по API второй версии на адресе https://ord.beeline.ru/ordapi и читает весь реестр рекламных данных: изначальные договоры и договоры между участниками цепочки, креативы вместе с медиаданными, площадки размещения, самих участников, акты и статистику показов. Из этого он собирает картину того, что уже зарегистрировано, что ушло в ЕРИР и что осталось висеть без отчётности к концу месяца.",
        "Порядок регистрации в 1ОРД неочевиден, и агент его учитывает: erid присваивается креативу не в момент создания, а только после того, как к нему добавлены медиаданные, поэтому свежая запись какое-то время живёт без идентификатора. Выгрузка в ЕРИР это отдельный шаг со своим флагом, и запись, принятая реестром, ещё не значит сданную отчётность: агент сверяет, что именно ушло, и называет поле, из-за которого запись не прошла.",
        "На запись агент заводит и обновляет креативы и медиаданные, площадки, акты и статистику показов, ставит флаг выгрузки в ЕРИР. Реквизиты для регистрации (ИНН сторон, номера и даты договоров, тексты и ссылки креативов) он берёт у вас, а не придумывает. Перед созданием договора агент ищет уже существующий по ИНН сторон, чтобы не плодить дубликаты, а при неполных данных останавливается и спрашивает недостающее.",
        "Логин и пароль обмениваются на токен, который агент продлевает сам, поэтому вводить их заново не приходится, а смена пароля в кабинете обрывает доступ сразу. Объём видимого и изменяемого задают права того пользователя, чьим доступом идёт работа, и расширяются они в кабинете, а не в чате. Частоту запросов агент держит в пределах десяти в секунду, чтобы массовая выгрузка креативов не упёрлась в ограничение. Если данных нет или прав не хватает, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Юрлицо или ИП, отчитывающиеся о рекламе в ЕРИР.",
        "Данные организации для заявки: ИНН, тип и контактная почта.",
        "Права администратора организации в 1ОРД.",
        "Адрес API по умолчанию: https://ord.beeline.ru/ordapi."
      ],
      "faq": [
        {
          "q": "Как подключить 1ОРД (Билайн)?",
          "a": "Логином и паролем пользователя: в кабинете 1ОРД откройте «Пользователи» → «Добавить пользователя» с ролью «Пользователь API», логин и пароль придут на указанную почту. Адрес API можно оставить по умолчанию. Оферту до этого принимает администратор организации."
        },
        {
          "q": "Что агент видит в 1ОРД?",
          "a": "Договоры и изначальные договоры, креативы с медиаданными, площадки, участников, акты и статистику показов в объёме прав того пользователя, чьи логин и пароль подключены."
        },
        {
          "q": "Пишет ли агент в 1ОРД?",
          "a": "Может: заводит и обновляет креативы, медиаданные, площадки, акты и статистику показов, ставит флаг выгрузки в ЕРИР. Реквизиты для регистрации агент берёт у вас, а не придумывает."
        },
        {
          "q": "Почему креатив без erid?",
          "a": "Идентификатор присваивается только после того, как к креативу добавлены медиаданные. Агент покажет, какого блока не хватает, и добавит его тем же вызовом."
        }
      ]
    },
    "seo_en": {
      "title": "1ORD (Beeline) AI agent: creative registration and erid",
      "description": "Registers a creative for a new banner and returns its erid, and before monthly reporting finds the records ERIR rejected. Connects with your 1ORD login and password.",
      "headline": "Register creatives and get an erid without the manual form",
      "scenarios": [
        {
          "title": "Registering a creative and getting erid",
          "desc": "The agent creates the creative together with its media data and returns the erid that has to go into the link before the placement starts."
        },
        {
          "title": "Checking the upload to ERIR",
          "desc": "The agent shows which contracts, creatives and acts have not reached ERIR and names the field that stopped the record."
        },
        {
          "title": "Acts and impression stats",
          "desc": "The agent collects impression stats by platform and the acts due for the monthly reporting deadline and sends a summary of what is still outstanding."
        },
        {
          "title": "Contracts and the chain of participants",
          "desc": "The agent finds the initial contract by the tax IDs of the parties, checks for duplicates and shows where a link is missing in the counterparty chain."
        },
        {
          "title": "Platforms for a placement",
          "desc": "The agent registers a placement platform from the details you give, links it to the creative and updates the impression stats once the campaign starts running."
        },
        {
          "title": "An audit before launch",
          "desc": "The agent exports creatives in bulk, finds the ones with no erid or with media data missing and names exactly which block each of them is short of."
        }
      ],
      "how_it_works": [
        "The agent works with 1ORD over the second version of the API at https://ord.beeline.ru/ordapi and reads the whole registry of advertising data: initial contracts and contracts between the participants of the chain, creatives together with their media data, placement platforms, the participants themselves, acts and impression stats. Out of that it assembles the picture of what is already registered, what has reached ERIR and what is still hanging without reporting by the end of the month.",
        "The registration order in 1ORD is not obvious, and the agent takes it into account: an erid is assigned to a creative not at the moment of creation but only after media data has been added to it, so a fresh record lives for a while without an identifier. The upload to ERIR is a separate step with its own flag, and a record accepted by the registry does not yet mean submitted reporting: the agent checks what exactly went through and names the field that stopped the record.",
        "On the write side the agent creates and updates creatives and media data, platforms, acts and impression stats, and sets the flag for the upload to ERIR. The details needed for registration (the tax IDs of the parties, contract numbers and dates, creative texts and links) come from you; the agent does not invent them. Before creating a contract it looks for an existing one by the tax IDs of the parties so as not to breed duplicates, and with incomplete data it stops and asks for what is missing.",
        "The login and password are exchanged for a token that the agent renews itself, so they never have to be entered again, while changing the password in the account cuts access off at once. The scope of what is visible and changeable is set by the permissions of the user it works under, and they are extended in the account, not in chat. The agent holds the request rate within ten per second so that a bulk export of creatives does not run into the limit. If data is missing or permissions fall short, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A company or sole trader reporting advertising data to ERIR.",
        "Company details for the request: INN, type and contact email.",
        "Organisation administrator rights in 1ORD.",
        "The default API address, https://ord.beeline.ru/ordapi."
      ],
      "faq": [
        {
          "q": "How do I connect 1ORD (Beeline)?",
          "a": "With a user login and password: in the 1ORD account open Users, then Add user with the API User role, and the login and password will arrive at the email you specify. The API address can be left at its default. The offer agreement is accepted before that by the organisation administrator."
        },
        {
          "q": "What does the agent see in 1ORD?",
          "a": "Contracts and initial contracts, creatives with their media data, platforms, participants, acts and impression stats, within the permissions of the user whose login and password are connected."
        },
        {
          "q": "Does the agent write to 1ORD?",
          "a": "It can: it creates and updates creatives, media data, platforms, acts and impression stats, and sets the flag for upload to ERIR. The details needed for registration come from you, the agent does not invent them."
        },
        {
          "q": "Why does a creative have no erid?",
          "a": "The identifier is assigned only after media data has been added to the creative. The agent shows which block is missing and adds it in the same call."
        }
      ]
    }
  },
  {
    "key": "outlook_calendar",
    "name": "Outlook Календарь",
    "name_en": "Outlook Calendar",
    "description": "Календари Microsoft 365 и Outlook.com: события, участники, занятость",
    "category": "calendar",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "outlook-calendar",
    "description_en": "Microsoft 365 and Outlook.com calendars: events, attendees and availability",
    "search_terms": [
      "аутлук",
      "microsoft",
      "майкрософт",
      "office 365",
      "exchange"
    ],
    "guide": {
      "url": "https://outlook.office.com/calendar/",
      "steps": [
        {
          "title": "Войдите в аккаунт, где ведёте встречи",
          "desc": "В окне входа Microsoft укажите аккаунт Microsoft 365 или Outlook.com. Видны календари этого аккаунта, общие календари коллег не читаются.",
          "title_en": "Sign in to the account you run meetings from",
          "desc_en": "In the Microsoft sign-in window pick the Microsoft 365 or Outlook.com account. Its own calendars are visible; colleagues' shared ones are not."
        },
        {
          "title": "Нажмите «Принять» на экране разрешений",
          "desc": "Microsoft перечислит права к календарю: чтение событий и занятости, создание и перенос встреч. Проверьте аккаунт сверху и примите.",
          "title_en": "Click “Accept” on the permissions screen",
          "desc_en": "Microsoft lists the calendar permissions: events and free/busy, creating and moving meetings. Check the account at the top, then accept."
        },
        {
          "title": "Админ Microsoft 365: разрешите приложение",
          "desc": "Если вход отвечает «Требуется утверждение администратора», админ открывает Microsoft Entra → «Корпоративные приложения» → приложение → «Разрешения» и даёт согласие.",
          "title_en": "Microsoft 365 admin: approve the app",
          "desc_en": "If sign-in says “Need admin approval”, the admin opens Microsoft Entra → “Enterprise applications” → the app → “Permissions” and grants admin consent."
        }
      ]
    }
  },
  {
    "key": "outlook_mail",
    "name": "Outlook Почта",
    "name_en": "Outlook Mail",
    "description": "Почта Microsoft 365 и Outlook.com: письма, папки, вложения, ответы и отправка",
    "category": "mail",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "outlook-mail",
    "description_en": "Microsoft 365 and Outlook.com email: messages, folders, attachments, replies and sending",
    "search_terms": [
      "аутлук",
      "microsoft",
      "майкрософт",
      "office 365",
      "exchange",
      "hotmail"
    ],
    "guide": {
      "url": "https://outlook.office.com/mail/",
      "steps": [
        {
          "title": "Войдите в аккаунт Microsoft с нужной почтой",
          "desc": "В окне входа Microsoft укажите рабочий адрес Microsoft 365 или личный Outlook.com. Доступ выдаётся ровно этому ящику, второй подключается отдельно.",
          "title_en": "Sign in with the mailbox account",
          "desc_en": "In the Microsoft sign-in window enter the Microsoft 365 work address or your Outlook.com one. Access covers exactly that mailbox; add another separately."
        },
        {
          "title": "Нажмите «Принять» на экране разрешений",
          "desc": "Microsoft перечислит права к почте: чтение, черновики и отправку писем. Проверьте, что сверху указан нужный ящик, и примите.",
          "title_en": "Click “Accept” on the permissions screen",
          "desc_en": "Microsoft lists the mail permissions: reading, drafts and sending. Check the mailbox named at the top is the right one, then accept."
        },
        {
          "title": "Админ Microsoft 365: разрешите приложение",
          "desc": "Если вход отвечает «Требуется утверждение администратора», админ открывает Microsoft Entra → «Корпоративные приложения» → приложение → «Разрешения» и даёт согласие.",
          "title_en": "Microsoft 365 admin: approve the app",
          "desc_en": "If sign-in says “Need admin approval”, the admin opens Microsoft Entra → “Enterprise applications” → the app → “Permissions” and grants admin consent."
        }
      ]
    }
  },
  {
    "key": "ozon",
    "name": "Ozon Seller API",
    "name_en": "Ozon Seller API",
    "description": "Товары, заказы, остатки и аналитика продавца",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "ozon",
    "short_name": "Ozon",
    "short_name_en": "Ozon",
    "description_en": "Seller products, orders, stock and analytics",
    "search_terms": [
      "озон"
    ],
    "guide": {
      "url": "https://seller.ozon.ru",
      "steps": [
        {
          "title": "Войдите в seller.ozon.ru под нужной ролью",
          "desc": "Доступ приложению выдаёт только «Администратор» или «Управляющий». Курьеру, оператору склада и урезанным ролям окно подтверждения не покажут.",
          "title_en": "Sign in to seller.ozon.ru with the right role",
          "desc_en": "Only an Administrator or a Manager can grant access to an app. Courier, warehouse operator and other limited roles never see the consent screen."
        },
        {
          "title": "Выберите компанию, если магазинов несколько",
          "desc": "Если на аккаунт заведено несколько магазинов, Ozon сначала попросит выбрать компанию: доступ выдаётся одному кабинету. Второй магазин подключается отдельно.",
          "title_en": "Pick the company if you have several shops",
          "desc_en": "If your account holds several shops, Ozon asks you to pick a company first: access goes to one seller account. A second shop is connected separately."
        },
        {
          "title": "Перед «Разрешить» проверьте права",
          "desc": "Перед «Разрешить» Ozon перечислит права: агент получит полный доступ, включая чаты, скидки и поставки. Только чтение оставляют в карточке подключения, строка «Изменения».",
          "title_en": "Check the permissions before “Allow”",
          "desc_en": "Ozon lists the permissions above “Allow”: the agent gets full access, chats, discounts and supplies included. Keep it read-only on the connection card, under Changes."
        },
        {
          "title": "Проверьте доступ к performance.ozon.ru",
          "desc": "Статистика кампаний и ДРР идут из Performance API на performance.ozon.ru. Без доступа к рекламному кабинету отчётов по рекламе не будет.",
          "title_en": "Check your access to performance.ozon.ru",
          "desc_en": "Campaign stats and ACoS come from the Performance API at performance.ozon.ru. Without access to the ads account there are no ad reports."
        },
        {
          "title": "Отзывайте доступ: «Приложения и разрешения»",
          "desc": "Выданные приложениям права лежат в кабинете: Настройки → «Приложения и разрешения». Доступ отзывается там в один клик.",
          "title_en": "Revoke access: Applications and permissions",
          "desc_en": "Granted app permissions live in the seller account under Settings → “Applications and permissions”. Access is revoked there in one click."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для Ozon: ДРР рекламы и SKU в минус",
      "description": "Разберёт ДРР рекламных кампаний Ozon, найдёт SKU, которые работают в минус, и ответит на отзывы. Подключение входом в Ozon Seller, без копирования API-ключей.",
      "headline": "Считайте юнит-экономику Ozon и отвечайте покупателям в чате",
      "scenarios": [
        {
          "title": "Разобрать падение продаж по SKU",
          "desc": "Агент сведёт заказы и воронку показов Ozon за период, найдёт категории и карточки, где просела выручка, и покажет причину: цена, остатки или показы."
        },
        {
          "title": "Ответить на отзывы и вопросы покупателей",
          "desc": "Агент разберёт новые отзывы и вопросы, подготовит ответы в тоне бренда и поднимет наверх негатив, который бьёт по рейтингу карточки."
        },
        {
          "title": "Поставка FBO по кластерам",
          "desc": "Агент посчитает, на сколько хватит остатков в каждом кластере, отберёт SKU с рекомендацией к отгрузке и соберёт заявку на поставку FBO: черновик, таймслот, заявка."
        },
        {
          "title": "Сводка по рекламе без кабинета",
          "desc": "Агент подтянет статистику Performance API, посчитает ДРР по кампаниям и скажет, где реклама окупается, а где сливает бюджет."
        },
        {
          "title": "Прибыль по каждому SKU",
          "desc": "Агент соберёт помесячный P&L из финансовых транзакций и разложит по SKU выручку, комиссию, логистику, возвраты и налог вплоть до чистой прибыли."
        },
        {
          "title": "Дежурство по срокам отправлений",
          "desc": "Агент ловит уведомления Ozon об отменах, переносе даты доставки и смене дедлайна сборки и сразу говорит, по каким отправлениям горит срок."
        }
      ],
      "how_it_works": [
        "Агент ходит в Ozon Seller API напрямую: финансы, аналитика, товары, заказы FBS и FBO, отзывы и вопросы, поставки. Финансы здесь сильная сторона: помесячный P&L собирается одним запросом к финансовым транзакциям, а сумма строк сверяется с итогами Ozon, и расхождение агент покажет, а не спрячет. Юнит-экономика считается по каждому SKU: выручка, комиссия, логистика, возвраты, налог, прибыль, с аллокацией сервисных списаний пропорционально отправлениям. Поверх ложатся ABC×XYZ-классификация портфеля, прогноз прибыли план/факт и сверка компенсаций по возвратам и потерям: агент прогоняет все классы претензий и честно помечает, что посчитать не удалось, вместо того чтобы молча занизить сумму.",
        "С отзывами и вопросами агент работает так, как Ozon устроен на самом деле: признак неотвеченного вопроса это счётчик ответов, а не статус, потому что статус в Ozon это ручная пометка продавца. Негативные отзывы фильтруются по оценке, рядом считается скорость вашей реакции, а ответы агент готовит в тоне бренда и поднимает наверх то, что бьёт по рейтингу карточки. Вопросы к карточкам и чаты с покупателями он ведёт одной лентой неотвеченного, чтобы ничего не терялось между разделами кабинета.",
        "В отгрузке FBS агент знает главную ловушку: HTTP 200 от Ozon не означает, что отгрузка прошла. После каждой отгрузки он проверяет фактический статус отправления и при сбое повторяет сборку, а маркировку «Честный ЗНАК» валидирует до отгрузки. Заявки на поставку FBO создаются по актуальному v2-процессу: черновик, таймслот, заявка и только затем подтверждённый номер заказа. Новые отправления, отмены, смену дедлайна сборки, перенос даты доставки и дефицит остатков Ozon присылает уведомлениями, так что агент узнаёт о них, не опрашивая кабинет по кругу.",
        "Про цены и карточки агент осторожен, потому что API Ozon перезаписывает, а не дополняет. Массовое обновление цен идёт с обязательной минимальной ценой, чтобы промо-акция не увезла цену ниже себестоимости. Импорт карточки означает полную замену: агент собирает её целиком, проверяет статус модерации до правки и перечитывает карточку после. Фото заливаются только полным списком (старые плюс новые, иначе Ozon их сотрёт), а лимиты на создание товаров агент проверяет до массовой загрузки, а не узнаёт из ошибки после половины.",
        "Частоту запросов агент держит по каждой ручке Seller API отдельно: отчёты по размещению Ozon отдаёт считанные разы в сутки, аналитику и поисковые запросы заметно чаще, и лимит не сжигается на повторных выгрузках. Тяжёлые отчёты приходят асинхронно: агент ставит задачу, дожидается готового файла и разбирает его сам. Даты он приводит к московскому времени, в котором Ozon считает свои сутки, чтобы граница периода не сдвигала выручку в соседний месяц. Если данных за период нет, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Роль «Администратор» или «Управляющий» в кабинете Ozon Seller",
        "Продажи, заказы и остатки читаются на любом тарифе",
        "Позаказный отчёт о реализации: только по API-ключу Seller API",
        "Премиум-тариф нужен только для воронки показов, возвратов и разрезов",
        "Отзывы по API: подписка «Управление отзывами» или Premium Pro",
        "На части кабинетов раздел отзывов закрыт даже с подпиской"
      ],
      "faq": [
        {
          "q": "Нужен ли API-ключ, чтобы подключить Ozon?",
          "a": "Для товаров, заказов, отзывов и аналитики нет: подключение идёт входом в аккаунт Ozon Seller (OAuth), вы подтверждаете доступ в кабинете продавца, копировать ключи не нужно. Доступ выдаётся под ролью «Администратор» или «Управляющий»: под остальными ролями окно подтверждения не появится. Начисления и финансовые отчёты открываются тем же входом. Ключ Seller API нужен только для позаказного отчёта о реализации, он подключается в том же окне ссылкой «Другой способ подключения»."
        },
        {
          "q": "Какие данные Ozon видит агент?",
          "a": "Товары, заказы, остатки, возвраты, отзывы и вопросы, аналитику продаж и статистику рекламы Performance API: ровно те разделы, на которые выданы права при входе."
        },
        {
          "q": "Может ли агент менять что-то в кабинете?",
          "a": "Да: при подключении Ozon выдаёт полный доступ, и агент может отвечать в чатах и на вопросы, работать с заявками на скидку и поставками. Оставить агенту только чтение можно в карточке подключения, строка «Изменения». Подключения, созданные раньше с правами только на чтение, по-прежнему не дают агенту ничего менять."
        },
        {
          "q": "Как быстро появляются данные после подключения?",
          "a": "Сразу: агент ходит в Seller API напрямую по вашему запросу, без промежуточных выгрузок. Ограничения по частоте запросов Ozon соблюдаются автоматически."
        }
      ]
    },
    "seo_en": {
      "title": "Ozon seller AI agent: ad spend ratio and loss-making SKUs",
      "description": "Breaks down the ad spend ratio of Ozon campaigns, finds SKUs that lose money and answers buyer reviews. Connects by signing in to Ozon Seller, no API keys to copy.",
      "headline": "Calculate Ozon unit economics and answer buyers in chat",
      "scenarios": [
        {
          "title": "Break down a sales drop by SKU",
          "desc": "The agent brings Ozon orders and the impression funnel for the period together, finds the categories and listings where revenue fell and shows the reason: price, stock or impressions."
        },
        {
          "title": "Answer customer reviews and questions",
          "desc": "The agent goes through new reviews and questions, drafts replies in the brand tone of voice and surfaces the negative ones that hit the listing rating."
        },
        {
          "title": "FBO supply by cluster",
          "desc": "The agent works out how long stock lasts in each cluster, picks the SKUs recommended for shipment and assembles the FBO supply request: draft, timeslot, request."
        },
        {
          "title": "Ad summary without opening the account",
          "desc": "The agent pulls Performance API stats, calculates the ad cost share by campaign and tells you where advertising pays off and where it burns budget."
        },
        {
          "title": "Profit for every SKU",
          "desc": "The agent assembles a monthly P&L from financial transactions and splits revenue, commission, logistics, returns and tax down to net profit for each SKU."
        },
        {
          "title": "Watch over shipping deadlines",
          "desc": "The agent catches Ozon notifications about cancellations, moved delivery dates and changed assembly cutoffs and says right away which postings are running out of time."
        }
      ],
      "how_it_works": [
        "The agent calls the Ozon Seller API directly: finance, analytics, products, FBS and FBO orders, reviews and questions, supplies. Finance is the strong side here: a monthly P&L is assembled with a single request to financial transactions, and the sum of the rows is reconciled against Ozon's own totals, so a discrepancy gets shown, not hidden. Unit economics is calculated per SKU: revenue, commission, logistics, returns, tax, profit, with service charges allocated proportionally to postings. On top of that sit an ABC×XYZ classification of the portfolio, a plan/fact profit forecast and a reconciliation of compensations for returns and losses: the agent runs through every class of claim and honestly flags what could not be calculated instead of quietly understating the amount.",
        "With reviews and questions the agent works the way Ozon is actually built: an unanswered question is identified by the answer counter, not by the status, because status in Ozon is a manual seller flag. Negative reviews are filtered by rating, your reaction speed is measured alongside, and the agent drafts replies in the brand tone of voice and surfaces whatever hits the listing rating. Listing questions and buyer chats are kept in a single unanswered feed so nothing gets lost between sections of the account.",
        "In FBS shipping the agent knows the main trap: an HTTP 200 from Ozon does not mean the shipment went through. After every shipment it checks the actual posting status and repeats the assembly on failure, and it validates Chestny ZNAK marking codes before shipping. FBO supply requests are created through the current v2 process: draft, timeslot, request and only then a confirmed order number. New postings, cancellations, a changed assembly cutoff, a moved delivery date and a stock deficit arrive from Ozon as notifications, so the agent learns about them without polling the account in circles.",
        "The agent is careful with prices and listings, because the Ozon API overwrites rather than merges. Bulk price updates always carry a minimum price so a promo cannot drag the price below cost. A listing import is a full replacement: the agent assembles the whole card, checks the moderation status before editing and re-reads the card afterwards. Photos are uploaded only as a complete list (the old ones plus the new ones, otherwise Ozon wipes them), and product creation limits are checked before a bulk upload rather than discovered from an error halfway through.",
        "The agent holds the request rate for each Seller API endpoint separately: placement reports are handed out by Ozon only a few times a day, analytics and search queries far more often, and the quota is not burned on repeat exports. Heavy reports arrive asynchronously: the agent queues the job, waits for the finished file and parses it itself. Dates are converted to Moscow time, the day Ozon counts by, so the edge of a period does not push revenue into the neighbouring month. If there is no data for the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "The Administrator or Manager role in the Ozon Seller account",
        "Sales, orders and stock read on any plan",
        "The per-posting realization report reads only through a Seller API key",
        "A premium plan is needed only for the impression funnel, returns and breakdowns",
        "Review API access comes with the review management subscription or Premium Pro",
        "On some accounts the review section stays closed even with the subscription"
      ],
      "faq": [
        {
          "q": "Do I need an API key to connect Ozon?",
          "a": "For products, orders, reviews and analytics, no: the connection runs through a sign-in to the Ozon Seller account (OAuth), you approve access in the seller account and copy no keys. Access is granted under the Administrator or Manager role: other roles never see the confirmation window. Accruals and financial reports open through the same sign-in. A Seller API key is needed only for the per-posting realization report, and it is connected in the same window through the “Another way to connect” link."
        },
        {
          "q": "What Ozon data does the agent see?",
          "a": "Products, orders, stock, returns, reviews and questions, sales analytics and Performance API ad stats: exactly the sections you granted rights to at sign-in."
        },
        {
          "q": "Can the agent change anything in the account?",
          "a": "Yes: on connect Ozon grants full access, and the agent can reply in chats and to questions, handle discount requests and work with supplies. You can keep the agent read-only on the connection card, under Changes. Connections made earlier with read-only permissions still do not let the agent change anything."
        },
        {
          "q": "How soon does data appear after connecting?",
          "a": "Straight away: the agent calls the Seller API directly on your request, with no intermediate exports. Ozon rate limits are respected automatically."
        }
      ]
    }
  },
  {
    "key": "ozon_api_key",
    "name": "Ozon Seller API (API-ключ)",
    "name_en": "Ozon Seller API (API key)",
    "description": "Подключение по Client-Id и API-ключу из кабинета продавца, если вход через аккаунт Ozon не подошёл",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "inside_primary",
    "has_own_page": false,
    "integration_slug": "ozon",
    "short_name": "Ozon API",
    "short_name_en": "Ozon Seller API (API key)",
    "description_en": "Connect with a Client-Id and API key from the seller account when Ozon sign-in did not work",
    "variant_of": "ozon",
    "guide": {
      "url": "https://seller.ozon.ru",
      "steps": [
        {
          "title": "На seller.ozon.ru откройте «API-ключи»",
          "desc": "На seller.ozon.ru откройте «Настройки» → «API-ключи» под Администратором или Управляющим.",
          "title_en": "On seller.ozon.ru, open API keys",
          "desc_en": "In seller.ozon.ru, open Settings → API keys as an Administrator or Manager."
        },
        {
          "title": "Создайте ключ с нужными ролями",
          "desc": "Отметьте роли под задачу: подключение примет ключ с любой ролью. Для начислений и финансовых отчётов нужна роль «Финансы».",
          "title_en": "Create a key with the roles you need",
          "desc_en": "Select the roles for your task. The connection accepts a key with any role. Accruals and financial reports need a “Finance” role."
        },
        {
          "title": "Сразу скопируйте Client-Id и Api-Key",
          "desc": "Ozon показывает ключ один раз: вставьте оба значения в форму, прежде чем закрыть окно. Этот ключ не открывает отдельный Performance API.",
          "title_en": "Copy Client-Id and Api-Key right away",
          "desc_en": "Ozon shows the key only once: paste both values into the form before closing that window. This key does not open the separate Performance API."
        }
      ]
    }
  },
  {
    "key": "ozon_performance",
    "name": "Ozon Performance API (рекламный кабинет)",
    "name_en": "Ozon Performance API (advertising account)",
    "description": "Кампании, статистика, ставки и продвижение",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": false,
    "integration_slug": "ozon",
    "short_name": "Ozon Реклама",
    "short_name_en": "Ozon Performance API",
    "description_en": "Campaigns, statistics, bids and promotion",
    "search_terms": [
      "озон реклама",
      "озон перформанс"
    ],
    "guide": {
      "url": "https://seller.ozon.ru/app/settings/performance-api",
      "steps": [
        {
          "title": "Откройте раздел Performance API",
          "desc": "В кабинете Ozon Seller откройте «Настройки → Performance API».",
          "title_en": "Open Performance API settings",
          "desc_en": "In Ozon Seller, open Settings → Performance API."
        },
        {
          "title": "Выберите или создайте сервисный аккаунт",
          "desc": "Откройте нужный сервисный аккаунт или нажмите «Создать аккаунт». Для разграничения доступа приложений создайте отдельные аккаунты.",
          "title_en": "Select or create a service account",
          "desc_en": "Open the service account you need or click “Create account”. Use separate accounts to separate access for different applications."
        },
        {
          "title": "Добавьте ключ",
          "desc": "В сервисном аккаунте нажмите «Добавить ключ». Роли ключа здесь не выбираются.",
          "title_en": "Add a key",
          "desc_en": "In the service account, click “Add key”. There is no key-role selection here."
        },
        {
          "title": "Скопируйте ID клиента и секрет клиента",
          "desc": "Вставьте значения рекламного кабинета в поля «ID клиента рекламного кабинета» и «Секрет клиента». Ключи Seller API здесь не работают.",
          "title_en": "Copy the Client ID and secret",
          "desc_en": "Paste the advertising-account values into the “Advertising account Client ID” and “Client Secret” fields. Seller API keys do not work here."
        }
      ]
    }
  },
  {
    "key": "pachca",
    "name": "Пачка",
    "name_en": "Pachca",
    "description": "Корпоративный мессенджер: агент отвечает в беседах и тредах от имени вашего бота",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "pachca",
    "short_name": "Пачка",
    "short_name_en": "Pachca",
    "description_en": "Company messenger: the agent replies in conversations and threads as your bot",
    "signup_url": "https://app.pachca.com/signup",
    "guide": {
      "url": "https://app.pachca.com",
      "steps": [
        {
          "title": "Войдите администратором пространства",
          "desc": "Нужны права администратора: чат-бота заводит только администратор пространства. У обычного участника раздела с интеграциями в настройках не будет.",
          "title_en": "Sign in as a workspace administrator",
          "desc_en": "Administrator rights are required: only a workspace administrator can create a chatbot. A regular member has no integrations section in the settings at all."
        },
        {
          "title": "Создайте бота в разделе «Чат-боты»",
          "desc": "В настройках откройте «Интеграции» → «Чат-боты» и создайте бота: имя и аватар, под которыми он будет отвечать в беседах.",
          "title_en": "Create a bot in the «Чат-боты» section",
          "desc_en": "In the settings open «Интеграции» → «Чат-боты» and create a bot: the name and avatar it will answer under in conversations."
        },
        {
          "title": "Скопируйте токен из карточки бота",
          "desc": "Токен появляется в карточке бота сразу после создания, скопируйте строку целиком. Именно он даёт право писать в беседы от имени этого бота.",
          "title_en": "Copy the token from the bot card",
          "desc_en": "The token shows up in the bot card as soon as it is created, so copy the whole string. It is what grants the right to post in conversations as this bot."
        },
        {
          "title": "В «Исходящем webhook» скопируйте секрет",
          "desc": "Во вкладке «Исходящий webhook» включите срабатывание на все сообщения, а не только на команды, поставьте «Игнорировать сообщения бота» и скопируйте Signing Secret.",
          "title_en": "On «Исходящий webhook», copy Signing Secret",
          "desc_en": "On the «Исходящий webhook» tab set it to fire on all messages rather than commands only, switch on ignoring the bot's own messages, and copy the Signing Secret."
        }
      ]
    },
    "seo": {
      "title": "Пачка API: ИИ-агент отвечает в беседах от имени бота",
      "description": "Интеграция Пачки через API: агент отвечает в беседе «Заявки» от имени вашего бота и каждое утро присылает туда сводку. Подключение токеном бота, файлы читает сам.",
      "headline": "Отвечайте в беседах Пачки от имени своего бота",
      "scenarios": [
        {
          "title": "Ответы в рабочей беседе",
          "desc": "Агент получит сообщение из беседы Пачки через исходящий вебхук, разберёт вопрос и ответит от имени бота, не дожидаясь, пока вы освободитесь."
        },
        {
          "title": "Разбор присланных файлов",
          "desc": "Агент дочитает вложения сообщения по его идентификатору (накладную, выгрузку, скриншот отчёта) и ответит по их содержимому прямо в переписке."
        },
        {
          "title": "Сводка по расписанию",
          "desc": "Агент отправит утреннюю сводку в нужную беседу Пачки в согласованное время, чтобы цифры приходили сами, без напоминаний."
        },
        {
          "title": "Кнопки и уточнения",
          "desc": "Агент задаст вопрос кнопками, обработает нажатие по trigger_id и отредактирует своё сообщение, когда ответ уже не актуален."
        },
        {
          "title": "Видно, что бот работает",
          "desc": "Пока агент готовит ответ, он ставит реакцию на исходное сообщение и снимает её по завершении: в Пачке нет индикатора набора, и реакция заменяет его."
        },
        {
          "title": "Файл прямо в беседу",
          "desc": "Агент загрузит готовый отчёт или выгрузку в Пачку и назовёт, в какую беседу положил файл, вместо ссылки на сторонний диск."
        }
      ],
      "how_it_works": [
        "Агент работает через Bot API Пачки на api.pachca.com, а токен бота передаёт в заголовке Authorization как Bearer. Первым запросом он вызывает GET /profile: так проверяется, что токен живой, и видно, от чьего имени будут уходить сообщения. Дальше в работе только те беседы, куда бот добавлен: их переписка, вложения и нажатия кнопок.",
        "Бот в Пачке является участником беседы, а не наблюдатель со стороны: пока его не добавили в разговор, ни одного сообщения оттуда агент не получит, и никакие права это не обойдут. Входящие приходят не опросом, а исходящим вебхуком: адрес регистрируется при подключении, Пачка присылает новые сообщения и нажатия кнопок сама, а каждый запрос подписывает HMAC-подписью в заголовке Pachca-Signature.",
        "На запись это основной режим коннектора. Агент отвечает в переписке, загружает файлы, задаёт уточняющие вопросы кнопками и обрабатывает нажатие по trigger_id. Пока он думает, на исходном сообщении висит реакция: в Пачке нет индикатора набора, и она честно показывает, что запрос взят в работу. Редактировать и удалять он может только собственные сообщения.",
        "Токен даёт права ровно этого бота и ничего сверх: личная переписка владельца профиля через него недоступна. Вложения и признак пересылки агент получает, дочитывая сообщение по его идентификатору: вебхук их не несёт. Частоту запросов он выдерживает сам: на чтение у Пачки свой лимит, поэтому болтовня беседы, не обращённая к боту, запроса не тратит. Файл он отправляет загрузкой в Пачку, а не ссылкой на сторонний диск, и называет, в какую беседу его положил."
      ],
      "requirements": [
        "Рабочее пространство Пачки с правами администратора",
        "Чат-бот, созданный в разделе интеграций, и его токен доступа",
        "Бот добавлен в те беседы, где он должен отвечать"
      ],
      "faq": [
        {
          "q": "Как подключить Пачку?",
          "a": "Токеном бота. В настройках рабочего пространства откройте раздел интеграций, создайте чат-бота и скопируйте его токен доступа целиком. Подпись исходящих вебхуков включается там же, а её секрет можно указать вторым полем."
        },
        {
          "q": "Что агент видит в Пачке?",
          "a": "Сообщения и вложения тех бесед, куда добавлен бот, и данные самого бота. Переписку, в которой бота нет, он не читает."
        },
        {
          "q": "Пишет ли агент в Пачку?",
          "a": "Да, это основной сценарий: отправляет и редактирует сообщения, удаляет свои, загружает файлы, ставит реакции и отвечает на нажатия кнопок."
        },
        {
          "q": "Почему бот ставит реакцию вместо «печатает…»?",
          "a": "В Пачке нет индикатора набора для ботов. Реакция на исходном сообщении служит ближайшим честным эквивалентом: она появляется, когда запрос взят в работу, и снимается, когда ответ отправлен."
        }
      ]
    },
    "seo_en": {
      "title": "Pachca API: an AI agent that replies as your bot",
      "description": "Replies in your requests conversation as your Pachca bot and posts a morning digest of requests there. Connects with a bot token over the Bot API, reads files too.",
      "headline": "Answer in Pachca conversations as your own bot",
      "scenarios": [
        {
          "title": "Replies in a work conversation",
          "desc": "The agent receives a message from a Pachca conversation over an outgoing webhook, works out the question and answers as the bot without waiting for you to free up."
        },
        {
          "title": "Reading the files people send",
          "desc": "The agent fetches the message's attachments by its id (a delivery note, an export, a screenshot of a report) and answers on their content right in the thread."
        },
        {
          "title": "Scheduled digest",
          "desc": "The agent posts the morning digest to the right Pachca conversation at the agreed time, so the numbers arrive on their own, without reminders."
        },
        {
          "title": "Buttons and follow-up questions",
          "desc": "The agent asks a question with buttons, handles the tap by its trigger_id and edits its own message once the answer is no longer relevant."
        },
        {
          "title": "Visible proof the bot is working",
          "desc": "While the agent prepares an answer it puts a reaction on the original message and removes it when done: Pachca has no typing indicator for bots, and the reaction stands in for one."
        },
        {
          "title": "A file straight into the conversation",
          "desc": "The agent uploads a finished report or export into Pachca and names the conversation it put the file in, instead of passing around a link to an outside drive."
        }
      ],
      "how_it_works": [
        "The agent works through the Pachca Bot API at api.pachca.com and passes the bot token in the Authorization header as a Bearer token. Its first request is GET /profile: that checks the token is alive and shows whose name the messages will go out under. From there only the conversations the bot has been added to are in play: their threads, attachments and button taps.",
        "A bot in Pachca is a conversation participant, not an observer on the side: until it is added to a conversation the agent receives not a single message from there, and no permission gets around that. Incoming messages arrive not by polling but over an outgoing webhook: the address is registered at connection time, Pachca pushes new messages and button taps itself, and signs every request with an HMAC in the Pachca-Signature header.",
        "Writing is the main mode for this connector. The agent answers in the thread, uploads files, asks follow-up questions with buttons and handles the tap by its trigger_id. While it thinks, a reaction sits on the original message: Pachca has no typing indicator, and the reaction honestly shows the request was picked up. It can edit and delete only its own messages.",
        "The token carries exactly this bot's rights and nothing beyond: the profile owner's personal correspondence is out of reach through it. Attachments and the forward mark come from re-reading the message by its id, since the webhook carries neither. The agent holds the request rate itself: Pachca meters reads separately, so conversation chatter not addressed to the bot spends no call. A file goes out as an upload to Pachca rather than a link to an outside drive, and the agent names the conversation it landed in."
      ],
      "requirements": [
        "A Pachca workspace with administrator rights",
        "A chatbot created in the integrations section, and its access token",
        "The bot added to the conversations where it should answer"
      ],
      "faq": [
        {
          "q": "How do I connect Pachca?",
          "a": "With a bot token. In the workspace settings open the integrations section, create a chatbot and copy its access token in full. Outgoing-webhook signing is switched on in the same place, and its secret goes into the second field."
        },
        {
          "q": "What does the agent see in Pachca?",
          "a": "Messages and attachments in the conversations the bot has been added to, and the data of the bot itself. It does not read conversations where the bot is absent."
        },
        {
          "q": "Does the agent write to Pachca?",
          "a": "Yes, that is the main scenario: it sends and edits messages, deletes its own, uploads files, sets reactions and responds to button taps."
        },
        {
          "q": "Why does the bot set a reaction instead of «typing…»?",
          "a": "Pachca has no typing indicator for bots. A reaction on the original message is the closest honest equivalent: it appears when the request is picked up and comes off when the answer has been sent."
        }
      ]
    }
  },
  {
    "key": "parsec",
    "name": "Parsec (ParsecNET 3)",
    "name_en": "Parsec (ParsecNET 3)",
    "description": "Табель по проходам, пропуска и группы доступа",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "parsec",
    "short_name": "Parsec",
    "short_name_en": "Parsec",
    "description_en": "Timesheets from entries, passes and access groups",
    "search_terms": [
      "парсек",
      "parsecnet",
      "pnsoft",
      "pnoffice",
      "скуд",
      "контроль доступа",
      "проходная",
      "турникет",
      "пропуск"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://www.parsec.ru/support/integration/",
      "steps": [
        {
          "title": "Проверьте службу интеграции Parsec",
          "desc": "Служба интеграции ставится с сервером ParsecNET 3 на порт 10101 и отдельной лицензии не требует. В PNOffice нет подписки на события и команд оборудованию.",
          "title_en": "Check the Parsec integration service",
          "desc_en": "The integration service comes with the ParsecNET 3 server on port 10101 and needs no separate licence. PNOffice lacks event subscriptions and hardware commands."
        },
        {
          "title": "Заведите оператора для интеграции",
          "desc": "В ParsecNET создайте оператора с правами на чтение персонала, идентификаторов и событий. Запись дайте, только если агент будет выдавать пропуска.",
          "title_en": "Create an operator for the integration",
          "desc_en": "In ParsecNET create an operator that can read personnel, identifiers and events. Grant writes only if the agent will issue passes."
        },
        {
          "title": "Проверьте адрес сервера",
          "desc": "На компьютере с приложением откройте http://адрес-сервера:10101/IntegrationService/IntegrationService.asmx. Открылась страница сервиса: агент дойдёт до сервера.",
          "title_en": "Check the server address",
          "desc_en": "On the computer running the app open http://server-address:10101/IntegrationService/IntegrationService.asmx: if the service page opens, the agent reaches the server."
        },
        {
          "title": "Вставьте адрес, организацию, логин и пароль",
          "desc": "Организацию укажите, если оператор заведён не в системной организации. Права оператора ограничивают то, что агент видит в Parsec.",
          "title_en": "Paste address, organisation, login, password",
          "desc_en": "Enter the organisation if the operator does not belong to the system organisation. The operator's rights limit what the agent sees in Parsec."
        }
      ]
    },
    "seo": {
      "title": "СКУД Parsec и ИИ-агент: отработанные часы против графика",
      "description": "Отработано 1 874 часа из 2 016 по графику: так агент сводит табель отдела по журналу Parsec. Работает через сервис интеграции ParsecNET 3 с правами оператора.",
      "headline": "Табель, опоздания и пропуска из СКУД Parsec прямо в чате",
      "scenarios": [
        {
          "title": "Табель по журналу проходов",
          "desc": "Агент выгрузит проходы за месяц, найдёт по каждому сотруднику первый вход и последний выход за день и сведёт часы в таблицу."
        },
        {
          "title": "Опоздания против графика",
          "desc": "Агент сравнит первый вход с началом смены по графику рабочего времени и назовёт, кто и на сколько опоздал или ушёл раньше."
        },
        {
          "title": "Чья это карта",
          "desc": "Агент найдёт владельца карты по коду, покажет его подразделение, группу доступа и последние проходы."
        },
        {
          "title": "Пропуск новому сотруднику",
          "desc": "Агент заведёт сотрудника в нужном подразделении, выдаст карту с группой доступа и покажет каждый шаг до записи."
        },
        {
          "title": "Заявки бюро пропусков",
          "desc": "Агент соберёт заявки на посетителей за период, покажет их статусы и поможет оформить новую."
        },
        {
          "title": "Состояние дверей и охраны",
          "desc": "Агент прочитает состояние замков, дверных контактов и охранных областей и скажет, где что открыто или снято с охраны."
        }
      ],
      "how_it_works": [
        "Агент работает с сервисом интеграции ParsecNET 3, который ставится на сервер СКУД вместе с системой. В подключении указывается адрес сервера (по умолчанию порт 10101), организация и оператор ParsecNET. Сервис отвечает с правами этого оператора: что не видно ему в программе Parsec, то не увидит и агент. Сервер обычно стоит в локальной сети, поэтому запросы идут через ваш компьютер с запущенным приложением.",
        "Табель и опоздания агент считает по архиву событий: открывает отчёт за период с отбором по типам проходов, читает его порциями и закрывает. По каждому сотруднику и дню он берёт первый вход и последний выход и сравнивает их с интервалами графика рабочего времени. Отчёт без явного предела режется сервером на пяти тысячах событий, поэтому агент ставит предел сам и сверяет число событий с итогом.",
        "Выдача пропуска идёт так же, как в программе: сотрудник создаётся в подразделении, затем открывается сессия редактирования его карточки, и в ней выдаётся карта с группой доступа. Каждую запись агент показывает заранее и выполняет после вашего подтверждения.",
        "Открытие двери, снятие с охраны и другие команды оборудованию меняют физический доступ на объекте, поэтому агент выполняет их только по отдельной явной просьбе для конкретной двери. Подписку на события сервер Parsec умеет отправлять только на адрес в своей сети, поэтому свежие события агент читает опросом архива."
      ],
      "requirements": [
        "ParsecNET 3 (PNSoft) или ParsecNET Office с установленным сервисом интеграции",
        "Оператор ParsecNET с нужными правами и областью видимости",
        "Сетевой доступ к серверу Parsec с компьютера, где запущено приложение"
      ],
      "faq": [
        {
          "q": "Как подключить Parsec?",
          "a": "Укажите адрес сервера ParsecNET с портом сервиса интеграции (обычно http://адрес-сервера:10101), организацию (для системной можно оставить пустой) и имя и пароль оператора. Отдельной лицензии на сервис интеграции не нужно, достаточно базовой."
        },
        {
          "q": "Какие права нужны оператору?",
          "a": "Для чтения персонала и табеля: права на сведения о персонале, расписаниях и событиях. Для выдачи карт и правки сотрудников нужны права на изменение персонала и групп доступа, для команд оборудованию отдельное право на управление оборудованием."
        },
        {
          "q": "Работает ли с ParsecNET Office?",
          "a": "Да, но с меньшим набором функций: в Office нет бюро пропусков, чёрного списка, правки расписаний, оперативных событий и команд оборудованию. Табель по архиву событий и выдача карт доступны."
        },
        {
          "q": "Откроет ли агент дверь сам?",
          "a": "Нет. Команды оборудованию агент отправляет только по вашей явной просьбе с указанием двери или охранной области и после подтверждения."
        }
      ]
    },
    "seo_en": {
      "title": "Parsec and AI agent: hours worked against the schedule",
      "description": "1,874 of 2,016 scheduled hours worked: the agent builds a department timesheet from the Parsec log via the ParsecNET 3 integration service, as your operator.",
      "headline": "Parsec timesheets, lateness and passes right in the chat",
      "scenarios": [
        {
          "title": "A timesheet from the pass log",
          "desc": "The agent pulls the month's passes, finds each employee's first entry and last exit of every day and puts the hours into a table."
        },
        {
          "title": "Lateness against the schedule",
          "desc": "The agent compares the first entry with the shift start of the worktime schedule and names who came late or left early and by how much."
        },
        {
          "title": "Whose card is this",
          "desc": "The agent finds the card holder by the card code and shows their department, access group and latest passes."
        },
        {
          "title": "A pass for a new hire",
          "desc": "The agent creates the employee in the right department, issues a card with an access group and shows every step before it writes."
        },
        {
          "title": "Visitor bureau requests",
          "desc": "The agent collects visitor requests for a period, shows their statuses and helps file a new one."
        },
        {
          "title": "Doors and alarm state",
          "desc": "The agent reads the state of locks, door contacts and alarm areas and tells you what is open or disarmed."
        }
      ],
      "how_it_works": [
        "The agent works with the ParsecNET 3 integration service, which is installed on the access control server with the system. The connection takes the server address (port 10101 by default), the organisation and a ParsecNET operator. The service answers with that operator's rights: whatever the operator cannot see in Parsec, the agent cannot see either. The server usually sits on a local network, so requests go through your computer with the app running.",
        "Timesheets and lateness are computed from the event archive: the agent opens a report for the period filtered by pass types, reads it in portions and closes it. For each employee and day it takes the first entry and the last exit and compares them with the intervals of the worktime schedule. A report without an explicit limit is cut by the server at five thousand events, so the agent sets the limit itself and checks the event count against the total.",
        "Issuing a pass follows the same path as the Parsec application: the employee is created in a department, an editing session of their card is opened, and a card with an access group is issued in it. The agent shows every write in advance and performs it after your confirmation.",
        "Opening a door, disarming and other hardware commands change physical access on site, so the agent sends them only on a separate explicit request for a specific door. The Parsec server can deliver event subscriptions only to an address on its own network, so the agent reads fresh events by polling the archive."
      ],
      "requirements": [
        "ParsecNET 3 (PNSoft) or ParsecNET Office with the integration service installed",
        "A ParsecNET operator with the required rights and visibility scope",
        "Network access to the Parsec server from the computer running the app"
      ],
      "faq": [
        {
          "q": "How do I connect Parsec?",
          "a": "Enter the ParsecNET server address with the integration service port (usually http://server-address:10101), the organisation (it may stay empty for the system one) and the operator's name and password. The integration service needs no separate licence, the base one is enough."
        },
        {
          "q": "What rights does the operator need?",
          "a": "Reading staff and timesheets needs rights on staff data, schedules and events. Issuing cards and editing employees needs rights to change staff and access groups, and hardware commands need a separate hardware control right."
        },
        {
          "q": "Does it work with ParsecNET Office?",
          "a": "Yes, with a smaller set of functions: Office has no visitor bureau, blacklist, schedule editing, live events or hardware commands. Timesheets from the event archive and card issuing are available."
        },
        {
          "q": "Will the agent open a door on its own?",
          "a": "No. The agent sends hardware commands only on your explicit request naming the door or alarm area, and after confirmation."
        }
      ]
    }
  },
  {
    "key": "parus_exchange",
    "name": "ПАРУС 8 (Сервис интеграции)",
    "name_en": "Parus 8 Integration Service",
    "description": "Обмен с ПАРУС 8 через сервер приложений «Сервис интеграции с WEB API»",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "parus-exchange",
    "short_name": "ПАРУС 8",
    "short_name_en": "Parus 8",
    "description_en": "Data exchange with PARUS 8 through its Web API integration service",
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://git.citpb.ru/CITKParus/P8-ExchangeService",
      "steps": [
        {
          "title": "Поставьте сервис WEB API рядом с базой ПАРУС",
          "desc": "Сервер приложений «Сервис интеграции с WEB API» ставится рядом с базой ПАРУС 8 и держит весь обмен: без него запрос до базы не дойдёт вовсе.",
          "title_en": "Install the WEB API service next to PARUS 8",
          "desc_en": "The WEB API integration service application server is installed next to the PARUS 8 database and carries the exchange: without it no request reaches the database."
        },
        {
          "title": "В «Сервисах обмена» задайте сервис и корень",
          "desc": "В справочнике «Сервисы обмена» создайте сервис и задайте его корень URL: этот корень вы укажете вторым полем при подключении.",
          "title_en": "In Exchange services, add a service and root",
          "desc_en": "In the Exchange services directory create a service and set its URL root. That root is what you enter in the second field when connecting."
        },
        {
          "title": "В «Функциях сервиса» объявите адреса операций",
          "desc": "В справочнике «Функции сервиса» задайте для каждой операции адрес, HTTP-метод и обработчик в базе. Не объявленного адреса для сервера не существует, он ответит 404.",
          "title_en": "In Service functions, declare each operation",
          "desc_en": "In the Service functions directory set the address, method and database handler per operation. An undeclared address does not exist for the server: it answers 404."
        },
        {
          "title": "Проверьте корень сервиса в браузере",
          "desc": "Откройте адрес сервера приложений вместе с корнем сервиса: живой обмен отвечает страницей с версией сервера приложений и именем сервиса.",
          "title_en": "Open the service root in a browser",
          "desc_en": "Open the application server address together with the service root: a live exchange answers with a page carrying the application server version and the service name."
        }
      ]
    },
    "seo": {
      "title": "ПАРУС 8 и ИИ: функции сервиса обмена по WEB API",
      "description": "Разберёт выгрузку «Функции сервиса» и запомнит, что доступно: 24 функции, 17 читающих и 7 пишущих. Отказы ERR_ разложит по причинам, логин и пароль не нужны.",
      "headline": "Данные ПАРУС 8 в чате через сервис интеграции с WEB API",
      "scenarios": [
        {
          "title": "Выборка по объявленной функции",
          "desc": "Агент вызовет функцию сервиса обмена (остатки, контрагентов, лицевые счета) и разложит ответ в таблицу, не заставляя администратора выгружать её руками."
        },
        {
          "title": "Опись функций сервиса обмена",
          "desc": "Агент соберёт с ваших слов перечень функций (код, адрес, метод) и будет держать его в диалоге, чтобы не подбирать пути наугад и не ловить 404."
        },
        {
          "title": "Проверка живости сервера приложений",
          "desc": "Агент дёрнет корень сервиса обмена и по ответу скажет, жив ли сервер приложений и его ли это 404, до того, как вы начнёте искать ошибку в правах."
        },
        {
          "title": "Разбор отказов PL/SQL-обработчика",
          "desc": "Агент прочитает код ERR_ из тела ответа и назовёт причину: отказ в правах, ошибка обработчика в базе или неверная форма запроса."
        },
        {
          "title": "Регистрация документа из чата",
          "desc": "Если у сервиса объявлена пишущая функция, агент покажет тело будущего запроса и отправит его только после вашего подтверждения."
        },
        {
          "title": "Связка Паруса с остальными системами",
          "desc": "Агент сведёт выборку из Паруса с данными банка, маркетплейса или почты и покажет расхождения одной картиной, без промежуточных выгрузок."
        }
      ],
      "how_it_works": [
        "Агент ходит в ПАРУС 8 через сервер приложений «Сервис интеграции с WEB API», тот самый Node-сервис, который ставится рядом с базой. В подключении два поля: адрес сервера приложений и корень сервиса обмена, и путь функции агент считает уже относительно корня. Живость проверяется запросом к самому корню: он отвечает HTML с версией сервера приложений и именем сервиса на любой метод, поэтому доработок на стороне заказчика для подключения не требуется.",
        "Состав функций у каждой инсталляции свой, и это главное отличие от облачных сервисов. Маршрутов у сервера приложений нет собственных: при старте он читает справочники самой базы: «Сервисы обмена» задают корень URL, «Функции сервиса» задают адрес, HTTP-метод и обработчики «до» и «после». Наружу этот перечень не публикуется, поэтому агент не подбирает пути наугад, а просит у вас выгрузку из настроек Паруса и работает по ней.",
        "Отказы сервер приложений отдаёт одинаковым способом: HTTP 500 и текст вида ERR_КОД с сообщением, то есть статус не несёт смысла вообще. Агент разбирает префикс и различает то, что различить обязан: ERR_UNAUTH означает отказ PL/SQL-обработчика в правах, который не лечится сменой логина, ERR_DB_SERVER ошибку обработчика в базе, ERR_APP_SERVER_BEFORE и ERR_OBJECT_BAD_INTERFACE неверную форму запроса. Повтор после них бессмысленен, и агент его не делает.",
        "Форму ответа задаёт обработчик на стороне заказчика, а не вендор: одна функция вернёт JSON, соседняя XML или произвольный текст, и агент не считает ответ JSON'ом заранее. Свои потолки он тоже держит: пул подключений сервера приложений к базе по умолчанию десять, входящее сообщение до десяти мегабайт, поэтому тяжёлые обработчики упираются в базу, а не в HTTP. Функции, чей адрес начинается с собаки, раздают статику, и в перечне они пропускаются."
      ],
      "requirements": [
        "Развёрнутый сервер приложений «Сервис интеграции с WEB API»",
        "Заведённый сервис обмена с корнем URL в справочниках Паруса",
        "Объявленные функции сервиса: адрес, метод, обработчик в базе",
        "Сетевой доступ до сервера приложений с нашей стороны"
      ],
      "faq": [
        {
          "q": "Как подключить ПАРУС 8?",
          "a": "Двумя полями: адресом сервера приложений «Сервис интеграции с WEB API» и корнем сервиса обмена из справочника «Сервисы обмена». Логин и пароль здесь не нужны: входящие запросы сервер приложений не аутентифицирует."
        },
        {
          "q": "Почему агент спрашивает список функций?",
          "a": "Потому что взять его больше неоткуда: перечень лежит в самой базе Паруса и наружу не отдаётся. Ответ 404 означает «такой функции не объявлено», а не опечатку в пути, поэтому угадывание здесь бесполезно."
        },
        {
          "q": "Пишет ли агент в Парус?",
          "a": "Только через те функции сервиса обмена, которые ваш администратор объявил на запись. Тело будущего запроса агент показывает заранее и отправляет его после явного подтверждения."
        },
        {
          "q": "Что делать при ошибке ERR_UNAUTH?",
          "a": "Обратиться к администратору Паруса: права проверяет PL/SQL-обработчик конкретной функции обмена, а не сервер приложений. Смена логина и пароля в карточке подключения на этот отказ не влияет."
        }
      ]
    },
    "seo_en": {
      "title": "Parus 8 and an AI agent: exchange functions over WEB API",
      "description": "Reads your “Service functions” export and keeps what is available: 24 functions, 17 reading and 7 writing. Sorts ERR_ refusals by cause, no login needed.",
      "headline": "PARUS 8 data in chat through its WEB API integration service",
      "scenarios": [
        {
          "title": "A query through a declared function",
          "desc": "The agent calls a function of the exchange service (stock, counterparties, accounts) and lays the answer out as a table instead of asking the admin for a manual export."
        },
        {
          "title": "An inventory of exchange functions",
          "desc": "The agent collects the list of functions from you (code, address, method) and keeps it for the conversation, so paths are never guessed and 404s stop happening."
        },
        {
          "title": "A liveness check of the application server",
          "desc": "The agent pings the root of the exchange service and tells you whether the application server is alive and whether the 404 is its own, before you start looking for a permission problem."
        },
        {
          "title": "Reading refusals from the PL/SQL handler",
          "desc": "The agent reads the ERR_ code out of the response body and names the cause: denied permissions, a handler error in the database or a malformed request."
        },
        {
          "title": "Registering a document from the chat",
          "desc": "If the service has a writing function declared, the agent shows the body of the request it is about to send and sends it only after your confirmation."
        },
        {
          "title": "PARUS next to your other systems",
          "desc": "The agent puts a PARUS query next to bank, marketplace or mail data and shows the discrepancies in one picture, with no intermediate exports."
        }
      ],
      "how_it_works": [
        "The agent reaches PARUS 8 through the application server called the WEB API integration service, the Node service installed next to the database. The connection takes two fields: the address of the application server and the root of the exchange service, and every function path is resolved relative to that root. Liveness is checked against the root itself: it answers with an HTML page carrying the application server version and the service name for any method, so connecting needs no development work on your side.",
        "The set of functions differs per installation, and this is the main difference from a cloud service. The application server has no routes of its own: at startup it reads the directories of the database itself: Exchange services define the URL root, Service functions define the address, the HTTP method and the before and after handlers. That list is never published outwards, so the agent does not guess paths: it asks you for the export from the PARUS settings and works from it.",
        "Refusals always arrive the same way: HTTP 500 with a text body of the form ERR_CODE plus a message, which means the status code carries no meaning at all. The agent parses the prefix and separates what has to be separated: ERR_UNAUTH is the PL/SQL handler denying permissions, which no change of login will fix, ERR_DB_SERVER is a handler error inside the database, ERR_APP_SERVER_BEFORE and ERR_OBJECT_BAD_INTERFACE mean a malformed request. Retrying after those is pointless, and the agent does not retry.",
        "The shape of a successful response is defined by your own handler rather than by the vendor: one function returns JSON, the next one XML or arbitrary text, and the agent never assumes JSON in advance. It also respects the real ceilings: the application server keeps ten database connections by default and accepts messages up to ten megabytes, so heavy handlers hit the database rather than HTTP. Functions whose address starts with an at sign serve static files and are skipped in the list."
      ],
      "requirements": [
        "A deployed WEB API integration service application server",
        "An exchange service with a URL root in the PARUS directories",
        "Declared service functions: address, method, handler in the database",
        "Network access to the application server from our side"
      ],
      "faq": [
        {
          "q": "How do I connect PARUS 8?",
          "a": "With two fields: the address of the WEB API integration service application server and the root of the exchange service from the Exchange services directory. No login or password is needed here: the application server does not authenticate incoming requests."
        },
        {
          "q": "Why does the agent ask for the list of functions?",
          "a": "Because there is nowhere else to take it from: the list lives in the PARUS database and is never exposed. A 404 means that no such function is declared rather than a typo in the path, so guessing is useless."
        },
        {
          "q": "Does the agent write to PARUS?",
          "a": "Only through the exchange functions your administrator declared for writing. The agent shows the body of the request in advance and sends it after an explicit confirmation."
        },
        {
          "q": "What should I do about ERR_UNAUTH?",
          "a": "Talk to your PARUS administrator: permissions are checked by the PL/SQL handler of that specific exchange function, not by the application server. Changing the login and password in the connection card has no effect on this refusal."
        }
      ]
    }
  },
  {
    "key": "pek",
    "name": "ПЭК",
    "name_en": "PEC",
    "description": "Грузоперевозки: расчёт стоимости и сроков, отделения и зоны, статусы грузов, заявки на перевозку",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "pek",
    "description_en": "Freight: cost and time quotes, branches and zones, cargo status and shipping orders",
    "search_terms": [
      "пек"
    ],
    "guide": {
      "url": "https://kabinet.pecom.ru",
      "steps": [
        {
          "title": "Войдите в kabinet.pecom.ru",
          "desc": "Нужна учётная запись личного кабинета клиента ПЭК: её логин и есть логин подключения.",
          "title_en": "Sign in to kabinet.pecom.ru",
          "desc_en": "You need a PEK customer account: its login is the connection login."
        },
        {
          "title": "В «Регистрационных данных» выпустите ключ API",
          "desc": "В блоке «Ключи API» выпустите новый ключ. Для агента лучше завести отдельный, чтобы отзывать его независимо.",
          "title_en": "In Registration data, issue an API key",
          "desc_en": "Issue a new key in the API keys block. A separate key for the agent can be revoked on its own."
        },
        {
          "title": "Скопируйте логин и ключ",
          "desc": "Ключ служит паролем. Грузы контрагентов и документы видны только с расширенным личным кабинетом.",
          "title_en": "Copy the login and the key",
          "desc_en": "The key acts as the password. Counterparty cargo and documents need the extended account."
        }
      ]
    },
    "seo": {
      "title": "ПЭК API и ИИ-агент: расчёт сборного груза по адресу",
      "description": "Интеграция с ПЭК по API: агент найдёт филиал по адресу и посчитает груз, два места и 46 кг до Новосибирска за 3 870 ₽ и 5 дней. Нужны логин кабинета и ключ API.",
      "headline": "Считайте перевозку ПЭК и следите за грузами прямо в чате",
      "scenarios": [
        {
          "title": "Расчёт перевозки по адресам",
          "desc": "Агент найдёт филиал и склад ПЭК для адресов отправителя и получателя, посчитает стоимость и сроки сборного груза и авиа и покажет, из чего сложилась цена."
        },
        {
          "title": "Склад под габариты груза",
          "desc": "Агент подберёт ближайшие к клиенту отделения, которые примут груз с вашим весом и габаритами, и отсеет склады, где такой груз не выдают."
        },
        {
          "title": "Статусы грузов в пути",
          "desc": "Агент соберёт статусы по списку кодов грузов и историю их смены и пришлёт сводку: что едет, что прибыло и что стоит на складе дольше обычного."
        },
        {
          "title": "Заявка на перевозку",
          "desc": "Агент соберёт заявку с забором или самопривозом, покажет её целиком (адреса, места, вес, плательщика) и подаст в ПЭК только после вашего подтверждения."
        },
        {
          "title": "Грузы за период",
          "desc": "Агент поднимет все грузы ваших контрагентов за нужные даты и сведёт их в таблицу с номерами заказов, статусами и складами."
        },
        {
          "title": "Этикетки и заявки в PDF",
          "desc": "Агент заберёт печатную форму заявки или этикетки мест по коду груза, так что искать их в личном кабинете вручную не придётся."
        }
      ],
      "how_it_works": [
        "Агент ходит в API личного кабинета ПЭК на kabinet.pecom.ru: находит филиал и тарифную зону по адресу, подбирает отделения под вес и габариты груза, считает стоимость и сроки по нужным продуктам (сборный груз, EasyWay, авиа), читает статусы грузов и их историю, а также справочники получателей, наименований груза и упаковок.",
        "Расчёт у ПЭК начинается не с города, а с адреса: сначала агент определяет, какой филиал обслуживает адрес и какой у него основной склад, и только потом зовёт калькулятор. Габариты передаются в метрах, вес в килограммах, по каждому месту отдельно, и агент их не выдумывает: берёт из карточек товаров МоегоСклада или маркетплейса либо спрашивает у вас.",
        "На запись агент умеет подать заявку на перевозку, аннулировать заявку по коду груза и вести справочник получателей. Каждое такое действие он сначала показывает целиком и отправляет только после вашего подтверждения, потому что ошибка в заявке стоит реального рейса машины и денег, а повторная подача создаёт второй груз.",
        "Ключ API вводится один раз вместе с логином кабинета и подписывает каждый запрос. ПЭК пускает не больше 100 запросов в минуту на логин, поэтому агент держит темп около полутора запросов в секунду, а статусы спрашивает пачками по коду груза. Логическую ошибку ПЭК возвращает телом ответа, и агент показывает её текст, а не пустую таблицу."
      ],
      "requirements": [
        "Логин личного кабинета ПЭК и ключ API из раздела «Регистрационные данные»",
        "Подтверждение с вашей стороны перед подачей и аннулированием заявки"
      ],
      "faq": [
        {
          "q": "Как подключить ПЭК?",
          "a": "Логином от личного кабинета kabinet.pecom.ru и ключом API. Ключ выпускается в разделе «Регистрационные данные», блок «Ключи API»; для агента лучше завести отдельный ключ, чтобы его можно было отозвать, не трогая другие интеграции."
        },
        {
          "q": "Что агент видит в ПЭК?",
          "a": "Филиалы, склады и тарифные зоны, расчёт стоимости и сроков, статусы и историю грузов, грузы контрагентов за период, печатные формы заявок и этикеток, справочники получателей, наименований груза и упаковок."
        },
        {
          "q": "Пишет ли агент в ПЭК?",
          "a": "Да: агент может подать заявку на перевозку, аннулировать её по коду груза и изменить справочник получателей. Все такие действия он согласует с вами перед отправкой, остальное сводится к расчётам и чтению статусов."
        },
        {
          "q": "Какие лимиты у API?",
          "a": "Не больше 100 запросов в минуту на логин. Статусы грузов агент запрашивает пачками (до 15 кодов в одном запросе полного статуса), поэтому даже большой список укладывается в лимит."
        }
      ]
    },
    "seo_en": {
      "title": "PEC API and an AI agent: groupage quotes by address",
      "description": "Finds the branch that serves the address, then quotes: two pieces, 46 kg to Novosibirsk, 3,870 RUB in 5 days. Connects with your cabinet login and API key.",
      "headline": "Quote PEK freight and track your cargo right in chat",
      "scenarios": [
        {
          "title": "Freight quote by address",
          "desc": "The agent finds the PEK branch and warehouse for the sender and recipient addresses, calculates the cost and transit time for groupage and air, and shows what the price is made of."
        },
        {
          "title": "A warehouse that fits the cargo",
          "desc": "The agent picks the branches nearest to your customer that accept cargo of your weight and dimensions and drops the ones that do not hand such cargo out."
        },
        {
          "title": "Cargo statuses in transit",
          "desc": "The agent collects statuses for a list of cargo codes along with their history and sends a summary: what is moving, what has arrived and what has sat in a warehouse too long."
        },
        {
          "title": "A shipping order",
          "desc": "The agent assembles an order with pickup or drop-off, shows it in full (addresses, places, weight, payer) and files it with PEK only after you confirm it."
        },
        {
          "title": "Cargo for a period",
          "desc": "The agent pulls every cargo of your counterparties for the dates you need and puts them in one table with order numbers, statuses and warehouses."
        },
        {
          "title": "Orders and labels as PDF",
          "desc": "The agent fetches the printed order form or the place labels by cargo code, so there is no hunting for them in the account by hand."
        }
      ],
      "how_it_works": [
        "The agent calls the PEK customer account API at kabinet.pecom.ru: it finds the branch and tariff zone for an address, picks branches that fit the cargo weight and dimensions, calculates cost and transit time for the products you need (groupage, EasyWay, air), reads cargo statuses and their history, and the directories of recipients, cargo names and packaging.",
        "A PEK quote starts from an address rather than a city: the agent first works out which branch serves the address and which main warehouse it has, and only then calls the calculator. Dimensions go in metres and weight in kilograms, per place, and the agent does not invent them: it takes them from MoySklad or marketplace product cards or asks you.",
        "On the write side the agent can file a shipping order, cancel an order by cargo code and maintain the recipient directory. It shows every such action in full first and sends it only after your confirmation, because a mistake in an order costs a real truck run and real money, and filing it twice creates a second cargo.",
        "The API key is entered once together with the account login and signs every request. PEK allows no more than 100 requests a minute per login, so the agent keeps a pace of about one and a half requests a second and asks for statuses in batches of cargo codes. PEK returns a logical error inside the response body, and the agent shows its text instead of an empty table."
      ],
      "requirements": [
        "A PEK account login and an API key from the Registration data section",
        "Your confirmation before an order is filed or cancelled"
      ],
      "faq": [
        {
          "q": "How do I connect PEK?",
          "a": "With the login of your kabinet.pecom.ru account and an API key. The key is issued under Registration data, in the API keys block; a separate key for the agent is better, so it can be revoked without touching other integrations."
        },
        {
          "q": "What can the agent see in PEK?",
          "a": "Branches, warehouses and tariff zones, cost and transit time quotes, cargo statuses and history, counterparties' cargo for a period, printed order forms and labels, and the directories of recipients, cargo names and packaging."
        },
        {
          "q": "Does the agent write to PEK?",
          "a": "Yes: the agent can file a shipping order, cancel it by cargo code and change the recipient directory. It agrees every such action with you before sending, and everything else is quotes and status reads."
        },
        {
          "q": "What are the API limits?",
          "a": "No more than 100 requests a minute per login. The agent requests cargo statuses in batches (up to 15 codes per full status request), so even a long list stays within the limit."
        }
      ]
    }
  },
  {
    "key": "perco_web",
    "name": "PERCo-Web",
    "name_en": "PERCo-Web",
    "description": "Журнал проходов, пропуска и учёт рабочего времени",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "perco-web",
    "short_name": "PERCo",
    "short_name_en": "PERCo",
    "description_en": "Entry log, passes and working time tracking",
    "search_terms": [
      "перко",
      "скуд",
      "проходная",
      "турникет",
      "пропуска",
      "учёт рабочего времени",
      "урв"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://www.perco.ru/products/perco-wm-04-integratsiya-s-vneshnimi-sistemami.php",
      "steps": [
        {
          "title": "Включите лицензию PERCo-WM04",
          "desc": "В PERCo-Web откройте «Администрирование» → «Лицензии» и активируйте модуль PERCo-WM04 «Интеграция с внешними системами»: без него API не отвечает.",
          "title_en": "Enable the PERCo-WM04 licence",
          "desc_en": "In PERCo-Web open Administration → Licences and activate the PERCo-WM04 «Integration with external systems» module: without it the API does not answer."
        },
        {
          "title": "Заведите роль для интеграции",
          "desc": "В «Администрирование» → «Роли» создайте роль с правами на чтение сотрудников, подразделений, карт и отчётов. Запись дайте, только если агент будет заводить пропуска.",
          "title_en": "Create a role for the integration",
          "desc_en": "Under Administration → Roles create a role that can read employees, departments, cards and reports. Grant writes only if the agent will issue passes."
        },
        {
          "title": "Создайте отдельного оператора",
          "desc": "Создайте оператора с этой ролью, латинским логином и без двухфакторного входа. Его логин и пароль вы укажете при подключении.",
          "title_en": "Create a dedicated operator",
          "desc_en": "Create an operator with that role, a Latin login and no two-factor sign-in. You will enter its login and password when connecting."
        },
        {
          "title": "Проверьте адрес сервера",
          "desc": "Откройте адрес PERCo-Web в браузере на компьютере, где запущено приложение: если вход в веб-интерфейс открывается, агент дойдёт до сервера тем же путём.",
          "title_en": "Check the server address",
          "desc_en": "Open the PERCo-Web address in a browser on the computer running the app: if the web interface sign-in opens, the agent reaches the server the same way."
        }
      ]
    },
    "seo": {
      "title": "СКУД PERCo и ИИ-агент: опоздания без ручных выгрузок",
      "description": "9 опозданий у 6 сотрудников и пропуск новичку с шаблоном «Склад» из чата. Агент работает с PERCo-Web через модуль интеграции, сервер остаётся во внутренней сети.",
      "headline": "Журнал проходов PERCo, табель и пропуска новичкам без ручных выгрузок",
      "scenarios": [
        {
          "title": "Опоздания и ранние уходы",
          "desc": "Агент возьмёт журнал проходов за период, найдёт первый вход и последний выход каждого сотрудника по дням и сравнит их с графиком работы."
        },
        {
          "title": "Табель из проходных",
          "desc": "Агент соберёт отработанные часы по подразделению за месяц: из отчётов учёта рабочего времени PERCo, а без этой лицензии посчитает их по журналу проходов."
        },
        {
          "title": "Пропуск новому сотруднику",
          "desc": "Агент заведёт сотрудника в нужное подразделение и должность, выдаст свободную карту и назначит шаблон доступа, предварительно показав, что именно запишет."
        },
        {
          "title": "Кто сейчас на объекте",
          "desc": "Агент покажет, кто находится в помещениях прямо сейчас и сколько людей внутри, по данным местонахождения PERCo."
        },
        {
          "title": "Карты и доступы уволенных",
          "desc": "Агент сверит уволенных сотрудников с выданными картами и шаблонами доступа и соберёт список пропусков, которые пора отозвать."
        },
        {
          "title": "Состояние оборудования",
          "desc": "Агент проверит связь с контроллерами, найдёт устройства с непереданными изменениями и перечислит события оборудования за сутки."
        }
      ],
      "how_it_works": [
        "Агент работает с сервером PERCo-Web через модуль PERCo-WM04 «Интеграция с внешними системами»: это HTTP API на 337 методов, описанное самим вендором. Из него читаются сотрудники, посетители, подразделения и должности, карты доступа, шаблоны доступа и помещения, журнал проходов, события системы, графики работы и отчёты учёта рабочего времени.",
        "Сервер PERCo-Web обычно стоит в локальной сети. Тогда запросы идут через приложение на компьютере, который видит этот сервер, как у 1С: адрес из подключения остаётся внутренним и наружу не публикуется. Если сервер опубликован по https, агент обращается к нему напрямую.",
        "Табель и опоздания агент берёт из отчётов учёта рабочего времени PERCo, если активна лицензия TimeTracking. Без неё он считает первый вход и последний выход по журналу проходов и сверяет их с графиком, а ночные смены относит к дню начала смены.",
        "По умолчанию агент только читает. Завести сотрудника, выдать карту, назначить шаблон доступа он может по вашей просьбе и после подтверждения. Открыть дверь или пропустить человека через турникет агент сам не предлагает: это физический доступ на объект, и такую команду он выполняет только по прямому поручению с названием устройства."
      ],
      "requirements": [
        "Сервер PERCo-Web с активной лицензией PERCo-WM04 (входит в пакет Standard)",
        "Отдельный оператор PERCo-Web для интеграции, без двухфакторного входа",
        "Для отчётов учёта рабочего времени: лицензия TimeTracking"
      ],
      "faq": [
        {
          "q": "Как подключить PERCo-Web?",
          "a": "Тремя полями: адрес веб-интерфейса PERCo-Web, как его открывают в браузере, логин и пароль отдельного оператора. Права агенту задаёт роль этого оператора в разделе «Администрирование»."
        },
        {
          "q": "Сервер стоит во внутренней сети. Это сработает?",
          "a": "Да. Запросы пойдут через приложение на компьютере, который видит сервер PERCo-Web, наружу его публиковать не нужно."
        },
        {
          "q": "Может ли агент открыть дверь?",
          "a": "Только по вашему прямому поручению с названием двери и команды. В сценариях по умолчанию таких действий нет."
        },
        {
          "q": "Нужна ли лицензия учёта рабочего времени?",
          "a": "Для готовых отчётов PERCo да. Без неё агент считает табель и опоздания сам, по журналу проходов из базового пакета."
        }
      ]
    },
    "seo_en": {
      "title": "PERCo and AI agent: late arrivals without manual exports",
      "description": "Nine late arrivals by six people and a new hire's pass with the Warehouse template, from chat. The agent uses the PERCo-Web integration module on your network.",
      "headline": "PERCo pass logs, timesheets and new-hire passes without manual exports",
      "scenarios": [
        {
          "title": "Late arrivals and early leaves",
          "desc": "The agent takes the pass log for a period, finds each employee's first entry and last exit per day and compares them with the work schedule."
        },
        {
          "title": "Timesheet from the turnstiles",
          "desc": "The agent totals worked hours per department for a month: from PERCo time tracking reports, or from the pass log when that licence is absent."
        },
        {
          "title": "A pass for a new hire",
          "desc": "The agent creates the employee in the right department and position, issues a free card and assigns an access template, showing what it will write first."
        },
        {
          "title": "Who is on site now",
          "desc": "The agent shows who is inside the premises right now and how many people are in, from PERCo whereabouts data."
        },
        {
          "title": "Cards and access of dismissed staff",
          "desc": "The agent matches dismissed employees against issued cards and access templates and lists the passes that should be revoked."
        },
        {
          "title": "Hardware health",
          "desc": "The agent checks controller connectivity, finds devices with pending changes and lists hardware events for the day."
        }
      ],
      "how_it_works": [
        "The agent works with the PERCo-Web server through the PERCo-WM04 «Integration with external systems» module: an HTTP API of 337 methods documented by the vendor. It reads employees, visitors, departments and positions, access cards, access templates and rooms, the pass log, system events, work schedules and time tracking reports.",
        "A PERCo-Web server usually sits on a local network. Requests then go through the app on a computer that can see the server, the same way as with 1C: the address stays internal and is never published. If the server is published over https, the agent reaches it directly.",
        "Timesheets and late arrivals come from PERCo time tracking reports when the TimeTracking licence is active. Without it the agent computes first entry and last exit from the pass log and checks them against the schedule, assigning night shifts to the day the shift started.",
        "By default the agent only reads. It can create an employee, issue a card or assign an access template on your request and after confirmation. It never offers to open a door or let a person through a turnstile on its own: that is physical access to the site, and such a command runs only on a direct instruction naming the device."
      ],
      "requirements": [
        "A PERCo-Web server with an active PERCo-WM04 licence (Standard package)",
        "A dedicated PERCo-Web operator for the integration, without two-factor sign-in",
        "For time tracking reports: the TimeTracking licence"
      ],
      "faq": [
        {
          "q": "How do I connect PERCo-Web?",
          "a": "With three fields: the PERCo-Web web interface address as it is opened in a browser, plus the login and password of a dedicated operator. The agent's rights are those of that operator's role under Administration."
        },
        {
          "q": "The server is on an internal network. Will it work?",
          "a": "Yes. Requests go through the app on a computer that can see the PERCo-Web server, so it does not need to be published."
        },
        {
          "q": "Can the agent open a door?",
          "a": "Only on your direct instruction naming the door and the command. Default scenarios contain no such actions."
        },
        {
          "q": "Is the time tracking licence required?",
          "a": "For PERCo's ready-made reports, yes. Without it the agent computes timesheets and late arrivals itself from the pass log in the base package."
        }
      ]
    }
  },
  {
    "key": "pi_web_api",
    "name": "PI Web API",
    "name_en": "PI Web API",
    "description": "Историан AVEVA PI и FactoryTalk Historian SE через PI Web API, архив и текущие значения, чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "pi-web-api",
    "description_en": "Read-only archive and current values of AVEVA PI and FactoryTalk Historian SE via PI Web API",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Откройте доступ к PI Web API",
          "desc": "Серверу сбора нужен доступ к адресу PI Web API вида https://хост/piwebapi. Прокси программа сбора не использует, укажите адрес, по которому сервер отвечает напрямую.",
          "title_en": "Open access to PI Web API",
          "desc_en": "The collection server needs access to the PI Web API address such as https://host/piwebapi. The program uses no proxy, so give the address the server answers on directly."
        },
        {
          "title": "Выберите способ входа",
          "desc": "Для Basic включите его в AuthenticationMethods PI Web API. Для Windows сервер сбора в домене, а для адреса сервера зарегистрирован SPN HTTP/хост.",
          "title_en": "Choose the sign-in method",
          "desc_en": "For Basic, enable it in the PI Web API AuthenticationMethods. For Windows, the collection server is in the domain and an HTTP/host SPN is registered."
        },
        {
          "title": "Дайте учётке право чтения",
          "desc": "Учётке подключения нужен доступ на чтение точек PI Data Archive и их данных. Права записи не нужны.",
          "title_en": "Give the account read access",
          "desc_en": "The connection account needs read access to the PI Data Archive points and their data. No write rights are needed."
        },
        {
          "title": "Доверьте сертификат сервера",
          "desc": "Самоподписанный сертификат PI Web API положите файлом .pem или .crt в pki/pi_web_api/trusted/ в папке данных программы сбора на сервере сбора.",
          "title_en": "Trust the server certificate",
          "desc_en": "Put a self-signed PI Web API certificate, as a .pem or .crt file, into pki/pi_web_api/trusted/ in the program's data folder on the collection server."
        }
      ]
    },
    "seo": {
      "title": "PI Web API и ИИ-агент: дыры в архиве AVEVA PI",
      "description": "Какие точки AVEVA PI или FactoryTalk Historian отдают No Data и с какого часа дыра в архиве. Снимок значений и архив агент берёт через PI Web API, только чтение.",
      "headline": "Архив AVEVA PI и FactoryTalk Historian прямо в чате",
      "scenarios": [
        {
          "title": "Текущие значения точек",
          "desc": "Агент найдёт точки PI по имени или описанию и покажет снимок значений с единицами, временем и качеством."
        },
        {
          "title": "Тренд за период",
          "desc": "Агент прочитает архив точки за смену, сутки или неделю и назовёт минимум, максимум, среднее и выходы за диапазон."
        },
        {
          "title": "Пропуски в архиве",
          "desc": "Агент найдёт точки, которые отдают системные состояния вроде No Data, и покажет, с какого момента данных нет."
        },
        {
          "title": "Сравнение линий",
          "desc": "Агент сравнит одинаковые точки разных линий или установок за период и покажет, где значения расходятся."
        },
        {
          "title": "Сообщение о пороге",
          "desc": "В задаче «По событию» агент сообщит, когда значение точки выйдет за порог и продержится заданное время, и когда вернётся в норму."
        },
        {
          "title": "Связь с объектом",
          "desc": "Агент скажет, когда сервер сбора пропал со связи и когда вернулся. Пропущенное за перерыв программа дочитает из архива PI."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и обращается к PI Web API по адресу вида https://pi.local/piwebapi. Он читает точки одного PI Data Archive, если вы назовёте сервер, или всех архивов за этим PI Web API, с фильтром по маскам имён. FactoryTalk Historian SE устроен как PI Data Archive и читается так же.",
        "Программа сбора читает архив каждой точки вперёд от места, где остановился, через streamsets/recorded: по 50 точек за запрос и до 1000 значений на точку за страницу, с запасом в минуту, чтобы не потерять событие, которое PI Buffer Subsystem дописал позже. В чтение входит снимок, самое новое событие точки, поэтому значение не пропадает до сжатия архива. После простоя пропущенное дочитывается, но не дальше недели назад.",
        "Все запросы программы сбора идут методом GET: пакетный контроллер, каналы и подписки на обновления не используются, потому что требуют POST или WebSocket. Программа не ходит через прокси и не следует переадресациям, чтобы не унести учётку на другой хост. Элементы и атрибуты PI AF программа не читает: агент находит точку по её имени и описанию.",
        "Вход двумя способами: Basic с логином и паролем, если он включён в AuthenticationMethods, или Windows, то есть Kerberos от служебной учётки программы сбора в домене с SPN HTTP/хост. Откат на NTLM программа отклоняет. Точки типа Blob не объявляются, значение с флагом Questionable приходит как uncertain, а цифровое состояние читается своим именем."
      ],
      "requirements": [
        "PI Web API перед PI Data Archive или FactoryTalk Historian SE",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к адресу PI Web API",
        "Учётка с правом чтения точек и их данных",
        "Для входа Windows: сервер сбора на Windows в домене и SPN HTTP/хост"
      ],
      "faq": [
        {
          "q": "Как подключить PI Web API?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите PI Web API и укажите адрес вида https://pi.local/piwebapi и логин с паролем учётки с правом чтения; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Если нужен только один PI Data Archive, назовите его; маски имён сузят набор точек."
        },
        {
          "q": "Что агент видит в PI Web API?",
          "a": "Точки PI Data Archive с путём \\\\СЕРВЕР\\ТЕГ, единицами и диапазоном, их текущий снимок и архив значений. Плохое значение приходит с кодом системного состояния, например No Data, а значение цифровой точки читается именем состояния."
        },
        {
          "q": "Меняет ли агент данные в PI?",
          "a": "Нет. Программа сбора отправляет в PI Web API только запросы GET, а пакетный контроллер и прочие пути, через которые доступна запись, не использует. Учётке подключения права записи не нужны."
        },
        {
          "q": "Вход Windows не работает. Что проверить?",
          "a": "Программа сбора должна работать службой на сервере сбора с Windows в домене, а для адреса PI Web API должен быть зарегистрирован SPN HTTP/хост. Указывайте адрес по имени хоста, которое знает контроллер домена: иначе Kerberos не выдаст билет, а откат на NTLM программа отклоняет."
        }
      ]
    },
    "seo_en": {
      "title": "PI Web API and an AI agent: gaps in the AVEVA PI archive",
      "description": "Which AVEVA PI or FactoryTalk Historian points return No Data and since when there is a gap. The agent reads snapshots and archives through PI Web API, read-only.",
      "headline": "AVEVA PI and FactoryTalk Historian archive right in the chat",
      "scenarios": [
        {
          "title": "Current point values",
          "desc": "The agent finds PI points by name or description and shows a snapshot of values with units, time and quality."
        },
        {
          "title": "A period trend",
          "desc": "The agent reads a point's archive for a shift, a day or a week and names the minimum, maximum, average and range breaches."
        },
        {
          "title": "Gaps in the archive",
          "desc": "The agent finds points returning system states such as No Data and shows since when there is no data."
        },
        {
          "title": "Comparing lines",
          "desc": "The agent compares the same points of different lines or units over a period and shows where the values part."
        },
        {
          "title": "A threshold message",
          "desc": "In an event task the agent tells you when a point's value crosses a threshold and holds for the set time, and when it is back to normal."
        },
        {
          "title": "Link to the site",
          "desc": "The agent tells you when the collection server went offline and came back. The program reads what it missed during the break from the PI archive."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network and reaches PI Web API at an address such as https://pi.local/piwebapi. It reads the points of one PI Data Archive, if you name the server, or of every archive behind that PI Web API, filtered by name masks. FactoryTalk Historian SE is a PI Data Archive and is read the same way.",
        "The program reads each point's archive forward from where it stopped through streamsets/recorded: 50 points a request and up to 1000 values a point a page, with a one minute overlap so an event the PI Buffer Subsystem wrote late is not lost. The read includes the snapshot, the point's newest event, so a value is not lost before the archive compresses it. After downtime the gap is read, but no further back than a week.",
        "Every request of the program uses GET: the batch controller, channels and stream updates are not used, since they need POST or a WebSocket. The program uses no proxy and follows no redirects, so the account is never carried to another host. PI AF elements and attributes are not read: the agent finds a point by its name and descriptor.",
        "Sign-in is one of two: Basic with a login and password, if it is enabled in AuthenticationMethods, or Windows, meaning Kerberos as the program's domain service account with an HTTP/host SPN. A fallback to NTLM is refused. Blob points are not declared, a value flagged Questionable arrives as uncertain, and a digital state is read by its name."
      ],
      "requirements": [
        "PI Web API in front of PI Data Archive or FactoryTalk Historian SE",
        "A collection server on the site network: Windows, or Linux with Docker",
        "Access from the collection server to the PI Web API address",
        "An account with read access to the points and their data",
        "For Windows sign-in: a Windows collection server in the domain, HTTP/host SPN"
      ],
      "faq": [
        {
          "q": "How do I connect PI Web API?",
          "a": "In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick PI Web API and enter an address such as https://pi.local/piwebapi and the login and password of an account with read access; the collection server is assigned automatically, or you pick it in the form if there are several. If you need just one PI Data Archive, name it; name masks narrow the set of points."
        },
        {
          "q": "What does the agent see in PI Web API?",
          "a": "PI Data Archive points with their \\\\SERVER\\TAG path, units and range, their current snapshot and value archive. A bad value comes with its system state code, such as No Data, and a digital point's value is read as the state name."
        },
        {
          "q": "Does the agent change data in PI?",
          "a": "No. The program sends PI Web API GET requests only and does not use the batch controller or other routes through which writes are reachable. The connection account needs no write rights."
        },
        {
          "q": "Windows sign-in does not work. What should I check?",
          "a": "The data collection program has to run as a service on a Windows collection server in the domain, and an HTTP/host SPN has to be registered for the PI Web API address. Use an address by the host name the domain controller knows: otherwise Kerberos issues no ticket, and the program refuses a fallback to NTLM."
        }
      ]
    }
  },
  {
    "key": "pochta_russia",
    "name": "Почта России",
    "name_en": "Russian Post",
    "description": "Почтовые отправления: заказы, тарифы, трекинг, нормализация адресов, поиск ОПС",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "pochta-russia",
    "description_en": "Postal shipments: orders, rates, tracking, address normalization and post office search",
    "guide": {
      "url": "https://otpravka.pochta.ru",
      "steps": [
        {
          "title": "Заведите кабинет на otpravka.pochta.ru",
          "desc": "Регистрация отправляет заявку на доступ и договор на подпись; она обрабатывается до 3 рабочих дней. Пока заявка не подтверждена, ключей в кабинете не будет.",
          "title_en": "Create an account at otpravka.pochta.ru",
          "desc_en": "Signing up submits an access request and a contract to sign; it takes up to 3 business days. Until it is approved, the account has no keys to copy."
        },
        {
          "title": "В разделе «API» скопируйте «API токен»",
          "desc": "Адрес экрана: otpravka.pochta.ru/settings#/api-settings. Поле «API токен» и есть токен приложения, соседняя кнопка выдаёт новый.",
          "title_en": "In the API section, copy the API token",
          "desc_en": "The screen lives at otpravka.pochta.ru/settings#/api-settings. The «API токен» field is the app token; the button next to it reissues one."
        },
        {
          "title": "Запишите логин-телефон и пароль кабинета",
          "desc": "Кроме токена нужны логин и пароль учётной записи otpravka.pochta.ru. Логин надёжнее указывать телефоном в формате +7XXXXXXXXXX.",
          "title_en": "Note the phone login and account password",
          "desc_en": "Besides the token you need the otpravka.pochta.ru login and password. A phone in +7XXXXXXXXXX format authenticates more reliably than an e-mail address."
        }
      ]
    },
    "seo": {
      "title": "Почта России и ИИ-агент: нормализация адресов партии",
      "description": "Прогонит адреса партии через нормализацию Почты до сдачи: из 340 не распознаны 27. Посчитает тариф по индексу и найдёт ОПС, нужны токен и логин кабинета.",
      "headline": "Считайте тарифы и сроки Почты России до оформления отправки",
      "scenarios": [
        {
          "title": "Тариф до оформления",
          "desc": "Агент посчитает стоимость и срок доставки по индексу, весу и габаритам ещё до того, как отправление будет оформлено."
        },
        {
          "title": "Нормализация адресов",
          "desc": "Агент приведёт адреса из заказов к почтовому формату, разложит их на индекс и элементы и покажет строки, которые Почта не распознала."
        },
        {
          "title": "Отправления в пути",
          "desc": "Агент соберёт трекинг по отправлениям и пришлёт сводку: что в пути, что вручено и что застряло на сортировке."
        },
        {
          "title": "Куда сдавать партию",
          "desc": "Агент найдёт отделения по индексу или адресу и подскажет ОПС, куда удобнее сдавать очередную партию отправлений."
        },
        {
          "title": "Партия к сдаче",
          "desc": "Агент соберёт отправления в партию, покажет её целиком (состав, вес, тариф) и отправит в кабинет только после вашего подтверждения."
        },
        {
          "title": "Настройки отправителя",
          "desc": "Агент поднимет настройки кабинета otpravka.pochta.ru и покажет, с какими параметрами отправителя пойдёт расчёт и чего не хватает для оформления."
        }
      ],
      "how_it_works": [
        "Агент работает с кабинетом otpravka.pochta.ru через его API: считает стоимость и срок по индексу, весу и габаритам, читает заказы и отправления, поднимает статусы трекинга, прогоняет адреса через нормализацию и ищет отделения связи по индексу или адресу. Начинает он с настроек кабинета: так проверяется само подключение и становится видно, с какими параметрами отправителя предстоит считать.",
        "Почта отличается от курьерских служб тем, что адрес здесь не строка, а разложенный на элементы почтовый объект: пока адрес не нормализован, отправление не оформить. Поэтому агент прогоняет адреса из заказов через нормализацию и отдельно показывает строки, которые Почта не распознала. Это не ошибка агента, а адрес, который придётся править руками. Статусы трекинга приходят с задержкой сортировки, и агент читает их как историю, а не как факт текущей минуты.",
        "По умолчанию агент считает, ищет и отчитывается в чате: собирает сводку по отправлениям в пути, отделяет вручённые от застрявших на сортировке и подсказывает ОПС для очередной партии. Всё, что меняет данные кабинета (заказ, партия), он сначала показывает целиком и отправляет только после вашего подтверждения, а на отказ не отвечает повторным запросом.",
        "Почта требует два заголовка одновременно (токен приложения и данные учётной записи), поэтому агент подписывает ими каждый вызов, а не открывает сессию. Частота держится в пределах пяти запросов в секунду, крупные выгрузки идут частями, а стоимость считается по каждой посылке отдельно: тариф зависит от индекса, веса и габаритов. Про закрытый раздел агент говорит прямо, вместо пустой таблицы."
      ],
      "requirements": [
        "Подтверждённые заявка на доступ и договор (до 3 рабочих дней)",
        "Права агента равны правам вашей учётной записи в кабинете"
      ],
      "faq": [
        {
          "q": "Как подключить Почта России?",
          "a": "Тремя значениями из кабинета otpravka.pochta.ru: токен приложения из «Настройки» → «API», а также логин и пароль самой учётной записи. Логин надёжнее указывать телефоном в формате +7XXXXXXXXXX. Ключи появляются после подтверждения заявки и договора."
        },
        {
          "q": "Что агент видит в кабинете?",
          "a": "Заказы и отправления кабинета otpravka.pochta.ru, расчёт тарифов, статусы трекинга, результаты нормализации адресов и справочник отделений связи."
        },
        {
          "q": "Пишет ли агент в Почту России?",
          "a": "По умолчанию агент считает, ищет и отчитывается в чате. Действия, меняющие данные кабинета, он согласует с вами и делает только в пределах прав вашей учётной записи."
        },
        {
          "q": "Что с правами и лимитами?",
          "a": "Токен и логин дают ровно те права, что есть у учётной записи otpravka.pochta.ru. Запросы идут не чаще 5 в секунду, поэтому крупные выгрузки агент собирает частями."
        }
      ]
    },
    "seo_en": {
      "title": "Russian Post and an AI agent: address checks for a batch",
      "description": "Runs a batch's addresses through Russian Post normalisation before hand-over: 27 of 340 were not recognised. Prices by postcode and finds the post office.",
      "headline": "Quote Russian Post prices and times before you ship anything",
      "scenarios": [
        {
          "title": "A price quote before you ship",
          "desc": "The agent calculates the delivery cost and time from the postcode, weight and dimensions before the shipment has even been created."
        },
        {
          "title": "Address normalisation",
          "desc": "The agent brings addresses from your orders into postal format, splits them into a postcode and components and shows the lines Russian Post did not recognise."
        },
        {
          "title": "Shipments in transit",
          "desc": "The agent collects tracking for your shipments and sends a summary: what is on the way, what has been delivered and what is stuck in sorting."
        },
        {
          "title": "Where to hand over the batch",
          "desc": "The agent finds branches by postcode or address and suggests the post office most convenient for handing over the next batch of shipments."
        },
        {
          "title": "A batch ready to hand over",
          "desc": "The agent gathers shipments into a batch, shows it in full (contents, weight, price) and sends it to the account only after you have confirmed it."
        },
        {
          "title": "Sender settings check",
          "desc": "The agent pulls the otpravka.pochta.ru account settings and shows which sender parameters the calculations run on and what is still missing to create a shipment."
        }
      ],
      "how_it_works": [
        "The agent works with the otpravka.pochta.ru account through its API: it calculates cost and time from the postcode, weight and dimensions, reads orders and shipments, pulls tracking statuses, runs addresses through normalisation and searches post offices by postcode or address. It starts from the account settings: that is how the connection itself is checked and how it becomes clear which sender parameters the calculations will run on.",
        "Russian Post differs from courier services in that an address here is not a string but a postal object split into components: until an address is normalised, no shipment can be created. So the agent runs the addresses from your orders through normalisation and separately shows the lines Russian Post did not recognise. That is not an agent error but an address that will have to be fixed by hand. Tracking statuses arrive with the delay of sorting, and the agent reads them as a history, not as a fact of the current minute.",
        "By default the agent calculates, searches and reports in chat: it builds a summary of shipments in transit, separates the delivered ones from those stuck in sorting and suggests a post office for the next batch. Anything that changes account data (an order, a batch) it first shows in full and sends only after your confirmation, and it does not answer a refusal with a repeat request.",
        "Russian Post requires two headers at once (the application token and the account credentials), so the agent signs every call with them instead of opening a session. The rate stays within five requests per second, large exports go in parts, and the cost is calculated per parcel, because the tariff depends on the postcode, the weight and the dimensions. About a closed section the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "An approved access request and contract (up to 3 business days)",
        "The agent gets exactly your account's rights in the cabinet"
      ],
      "faq": [
        {
          "q": "How do I connect Russian Post?",
          "a": "With three values from the otpravka.pochta.ru account: the application token from Settings and then API, plus the login and password of the account itself. The login is more reliable as a phone number in the +7XXXXXXXXXX format. The keys appear once the application and the contract are approved."
        },
        {
          "q": "What does the agent see in the account?",
          "a": "Orders and shipments of the otpravka.pochta.ru account, tariff calculations, tracking statuses, address normalisation results and the directory of post offices."
        },
        {
          "q": "Does the agent write to Russian Post?",
          "a": "By default the agent calculates, searches and reports in chat. Anything that changes account data is agreed with you and stays within the permissions of your account."
        },
        {
          "q": "What about permissions and limits?",
          "a": "The token and login give exactly the permissions the otpravka.pochta.ru account has. Requests go out no faster than 5 per second, so the agent collects large exports in parts."
        }
      ]
    }
  },
  {
    "key": "polymarket",
    "name": "Polymarket",
    "name_en": "Polymarket",
    "description": "Рынки предсказаний: события, цены, ордербуки и позиции кошелька, только чтение",
    "category": "other",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "never",
    "has_own_page": false,
    "integration_slug": null,
    "description_en": "Prediction markets: events, prices, order books and wallet positions, read-only",
    "search_terms": [
      "полимаркет"
    ],
    "guide": {
      "url": "https://polymarket.com",
      "steps": [
        {
          "title": "Войдите на polymarket.com своим аккаунтом",
          "desc": "Нужен тот аккаунт, чьи позиции и активность вы хотите видеть: сам адрес и служит фильтром. Ни API-ключа, ни приватного ключа для чтения не требуется.",
          "title_en": "Sign in to polymarket.com with your account",
          "desc_en": "Use the account whose positions and activity you want to see: the address itself is the filter. No API key and no private key are needed for reading."
        },
        {
          "title": "Скопируйте адрес кошелька в меню профиля",
          "desc": "Меню профиля показывает адрес кошелька аккаунта, на компьютере и в телефоне одинаково. Именно за этим адресом числятся позиции и балансы.",
          "title_en": "Copy the wallet address in the profile menu",
          "desc_en": "The profile menu shows your account wallet address, on desktop and mobile alike. This is the address your positions and balances are held under."
        },
        {
          "title": "Не перепутайте с адресом подписанта",
          "desc": "При входе через Google или почту Polymarket заводит смарт-кошелёк, и адрес подписанта в MetaMask будет другим. По адресу подписанта ответ придёт пустым.",
          "title_en": "Do not take the signer address",
          "desc_en": "Signing up with Google or email gives you a proxy smart wallet, and your MetaMask signer address is a different one; the signer address returns nothing."
        },
        {
          "title": "Проверьте формат: 0x и 40 символов",
          "desc": "Адрес состоит из 0x и 40 шестнадцатеричных символов, 42 знака целиком. Если скопировалась короткая запись вида 0x1a2b…f9, скопируйте адрес полностью.",
          "title_en": "Check the format: 0x plus 40 characters",
          "desc_en": "The address is 0x plus 40 hexadecimal characters, 42 in total. If you copied a nickname or a shortened 0x1a2b…f9 form, copy the full value instead."
        }
      ]
    },
    "seo": {
      "title": "Polymarket и ИИ: позиции кошелька и живые рынки",
      "description": "Позиции по адресу кошелька и рынки по теме, где реально идут торги: агент читает Gamma, CLOB и Data API. Нужен только адрес, торговать агент не может.",
      "headline": "Следите за ценами и стаканом рынков Polymarket в чате",
      "scenarios": [
        {
          "title": "Цены и глубина по событию",
          "desc": "Агент соберёт по интересующим событиям текущие цены, спред и стакан и покажет, где рынок сдвинулся, а где сдвиг нарисовала одна сделка."
        },
        {
          "title": "Разбор своих позиций",
          "desc": "Агент разложит открытые позиции по сохранённому адресу кошелька: на каких рынках вы стоите, по какой цене входили и сколько стоит портфель."
        },
        {
          "title": "История цены рынка",
          "desc": "Агент выгрузит историю котировок рынка с нужным интервалом и покажет, на каком событии цена развернулась."
        },
        {
          "title": "Сводка по закрывающимся рынкам",
          "desc": "Агент по расписанию пришлёт, какие из ваших рынков заметно ушли по цене за ночь и какие события закрываются на этой неделе."
        },
        {
          "title": "Рынки по интересной теме",
          "desc": "Агент найдёт в Gamma активные рынки по теме или тегу, отсортирует их по объёму и дате закрытия и покажет, где сейчас идёт настоящая торговля."
        },
        {
          "title": "История своих сделок",
          "desc": "Агент поднимет активность по сохранённому адресу (что покупали и продавали за период и по каким ценам), сведёт сделки по рынкам и покажет место адреса в лидерборде."
        }
      ],
      "how_it_works": [
        "У Polymarket не один API, а несколько, и агент ходит в каждый за своим: в Gamma за событиями, рынками, поиском и тегами, в CLOB за стаканом, спредом и историей котировок, в Data API за позициями, активностью и лидербордами по сохранённому адресу. Отсюда и складывается картина: что за событие, по какой цене торгуется, насколько глубок рынок и как в нём стоите вы.",
        "Цена рынка предсказаний выражает оценку вероятности, и агент читает её вместе со стаканом, а не отдельно. На тонком рынке одна сделка уводит последнюю цену далеко от того, по чему реально можно войти, поэтому рядом с котировкой агент показывает спред и глубину и разделяет настоящий сдвиг рынка и движение, нарисованное единственным ордером. История котировок берётся с тем интервалом, на котором событие видно, а не сглажено.",
        "Торговать агент не может по устройству коннектора: создание и отмена ордеров требуют приватного ключа, которого он не хранит и не принимает. Всё, что он делает, сводится к чтению публичных данных и разбор ваших позиций: на каких рынках вы стоите, по какой цене входили, сколько стоит портфель сейчас. Регулярную сводку по закрывающимся рынкам и ночным сдвигам цены можно поставить на расписание: это тоже чтение.",
        "Для подключения нужно одно поле с адресом кошелька: ни API-ключа, ни приватного ключа Polymarket для чтения не выдаёт и не требует, поэтому и отзывать нечего, достаточно убрать адрес. Позиции агент читает по этому адресу и сводит их с текущими котировками рынков, так что стоимость портфеля считается на момент вопроса, а не на момент входа. Данных, закрытых за логином, у него нет вовсе: всё, что он видит, видно и любому другому. Частоту запросов коннектор держит низкой, около одного в секунду с небольшим запасом на всплеск, и разносит обращения по трём API, чтобы не упереться в лимит одного из них."
      ],
      "requirements": [
        "Аккаунт Polymarket, чьи позиции и активность нужно видеть",
        "Ни API-ключа, ни приватного ключа: читаются только публичные данные"
      ],
      "faq": [
        {
          "q": "Как подключить Polymarket?",
          "a": "Одним полем, адресом кошелька: polymarket.com → меню профиля → адрес кошелька аккаунта, это 0x плюс 40 шестнадцатеричных символов. Ни API-ключа, ни приватного ключа Polymarket для чтения не выдаёт и не требует."
        },
        {
          "q": "Что агент видит в Polymarket?",
          "a": "Публичные данные Gamma, CLOB и Data API: события, рынки, поиск и теги, стаканы, спреды и историю цен, лидерборды, а также позиции и активность по сохранённому адресу."
        },
        {
          "q": "Может ли агент торговать?",
          "a": "Нет. Создание и отмена ордеров требуют приватного ключа, который коннектор не хранит и не принимает, поэтому доступно только чтение публичных данных."
        },
        {
          "q": "Какой адрес указывать при входе через Google?",
          "a": "Адрес аккаунта, а не адрес подписанта в MetaMask: при входе через почту или Google Polymarket заводит смарт-кошелёк, и позиции числятся за ним. По адресу подписанта ответ придёт пустым."
        }
      ]
    },
    "seo_en": {
      "title": "Polymarket AI agent: wallet positions and live markets",
      "description": "The agent breaks down positions for your wallet address and finds markets on a topic that actually trade. Only the wallet address is needed; it can't trade.",
      "headline": "Watch Polymarket prices and order books from the chat",
      "scenarios": [
        {
          "title": "Prices and depth on an event",
          "desc": "The agent collects the current prices, spread and order book for the events you care about and shows where the market really moved and where one trade drew the move."
        },
        {
          "title": "Reviewing your own positions",
          "desc": "The agent breaks down open positions for the saved wallet address: which markets you are in, at what price you entered and what the portfolio is worth."
        },
        {
          "title": "Market price history",
          "desc": "The agent pulls the quote history of a market at the interval you need and shows which event turned the price around."
        },
        {
          "title": "Digest of markets about to close",
          "desc": "On a schedule the agent sends which of your markets moved notably in price overnight and which events close this week."
        },
        {
          "title": "Markets on a topic you follow",
          "desc": "Through Gamma the agent finds active markets by topic or tag, sorts them by volume and closing date and shows where the real trading is going on right now."
        },
        {
          "title": "Your own trading history",
          "desc": "The agent pulls activity for the saved address (what was bought and sold over the period and at what prices), groups the trades by market and finds the address on the leaderboard."
        }
      ],
      "how_it_works": [
        "Polymarket has not one API but several, and the agent calls each for its own part: Gamma for events, markets, search and tags, CLOB for the order book, the spread and the quote history, Data API for positions, activity and leaderboards on the saved address. That is how the picture comes together: what the event is, at what price it trades, how deep the market is and how you are positioned in it.",
        "A prediction market price is an estimate of probability, and the agent reads it together with the order book rather than on its own. In a thin market a single trade drags the last price far from anything you could actually enter at, so alongside the quote the agent shows the spread and the depth and separates a real market move from one drawn by a single order. Quote history is taken at the interval where the event is visible rather than smoothed away.",
        "The agent cannot trade, by the way the connector is built: placing and cancelling orders requires a private key, which it neither stores nor accepts. All it does is read public data and break down your positions: which markets you are in, at what price you entered, what the portfolio is worth now. A recurring digest of markets about to close and of overnight price moves can be put on a schedule: that too is reading.",
        "The connection is a single field with a wallet address: Polymarket neither issues nor requires an API key or a private key for reading, so there is nothing to revoke either; removing the address is enough. Positions are read against that address and matched with current market quotes, so the portfolio is valued as of the question, not as of the entry. Nothing behind a login is available to the agent at all: everything it sees is equally visible to anyone else. The connector keeps the request rate low, around one per second with a small allowance for bursts, and spreads calls across the three APIs so none of them hits its own limit."
      ],
      "requirements": [
        "A Polymarket account whose positions and activity you want to see",
        "No API key and no private key: only public data is read"
      ],
      "faq": [
        {
          "q": "How do I connect Polymarket?",
          "a": "With a single field, the wallet address: polymarket.com, then the profile menu, then the account wallet address, which is 0x plus 40 hexadecimal characters. Polymarket neither issues nor requires an API key or a private key for reading."
        },
        {
          "q": "What does the agent see in Polymarket?",
          "a": "Public Gamma, CLOB and Data API data: events, markets, search and tags, order books, spreads and price history, leaderboards, plus positions and activity for the saved address."
        },
        {
          "q": "Can the agent trade?",
          "a": "No. Placing and cancelling orders requires a private key, which the connector neither stores nor accepts, so only reading public data is available."
        },
        {
          "q": "Which address do I give if I sign in with Google?",
          "a": "The account address, not the signer address in MetaMask: when you sign in with email or Google, Polymarket creates a smart wallet and the positions belong to it. The signer address returns an empty answer."
        }
      ]
    }
  },
  {
    "key": "postgres",
    "name": "PostgreSQL",
    "name_en": "PostgreSQL",
    "description": "Read-only SQL по Supabase, Neon, Yandex Managed PostgreSQL, RDS и своей базе",
    "category": "database",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "postgres",
    "description_en": "Read-only SQL on Supabase, Neon, Yandex Managed PostgreSQL, RDS or your own database",
    "search_terms": [
      "постгрес"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://www.postgresql.org/docs/current/sql-createrole.html",
      "steps": [
        {
          "title": "В SQL Editor или psql создайте роль LOGIN",
          "desc": "В «SQL Editor» Supabase или Neon, иначе в psql под владельцем: CREATE ROLE analytics_ro LOGIN PASSWORD '…'. Пароль роли станет паролем подключения.",
          "title_en": "In SQL Editor or psql, create a LOGIN role",
          "desc_en": "In the Supabase or Neon “SQL Editor”, otherwise in psql as owner: CREATE ROLE analytics_ro LOGIN PASSWORD '…'. That password connects the database."
        },
        {
          "title": "Выдайте роли GRANT pg_read_all_data",
          "desc": "GRANT pg_read_all_data TO analytics_ro (PostgreSQL 14+). Иначе для каждой схемы, не только public: GRANT USAGE ON SCHEMA и GRANT SELECT ON ALL TABLES IN SCHEMA.",
          "title_en": "Grant the role pg_read_all_data",
          "desc_en": "GRANT pg_read_all_data TO analytics_ro (PostgreSQL 14+). Otherwise, for every schema, not just public: GRANT USAGE ON SCHEMA and GRANT SELECT ON ALL TABLES IN SCHEMA."
        },
        {
          "title": "Проверьте row-level security",
          "desc": "pg_read_all_data не обходит row-level security, а в Supabase она включена почти везде: без политики SELECT такие таблицы вернут ноль строк.",
          "title_en": "Check row-level security",
          "desc_en": "pg_read_all_data does not bypass row-level security, and Supabase turns it on almost everywhere: without a SELECT policy such tables return zero rows."
        },
        {
          "title": "Разрешите доступ к порту базы по TLS",
          "desc": "На ВМ разрешите порт базы в брандмауэре и hostssl в pg_hba.conf для роли, базы и адресов из требований. У облачного провайдера настройте аналогичные правила.",
          "title_en": "Allow TLS connections to the database port",
          "desc_en": "On a VM allow the database port in its firewall and hostssl in pg_hba.conf for the role, database and listed addresses. Configure equivalent rules with a cloud provider."
        },
        {
          "title": "Укажите хост, порт и корневой сертификат",
          "desc": "Хост должен совпадать с именем в сертификате; для IP нужен IP SAN. Укажите порт базы и её имя. TLS всегда verify-full; для своего CA загрузите корневой сертификат PEM.",
          "title_en": "Enter the host, port and root certificate",
          "desc_en": "The host must match the certificate; an IP needs an IP SAN. Enter the database port and name. TLS always uses verify-full; upload a PEM root certificate for a private CA."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для PostgreSQL: метрики и медленные запросы",
      "description": "Средний чек считается запросом к вашей базе, а медленный отчёт агент разберёт через EXPLAIN. Только чтение: SELECT, WITH, SHOW и EXPLAIN от отдельной роли.",
      "headline": "Спрашивайте свою базу PostgreSQL словами, без SQL",
      "scenarios": [
        {
          "title": "Вопрос к базе без SQL",
          "desc": "Агент сам разберёт схему (таблицы, колонки и связи) и ответит на вопрос по данным, не требуя от вас ни строчки SQL."
        },
        {
          "title": "Метрики прямо в базе",
          "desc": "Агент посчитает выручку, средний чек и конверсию запросом к вашей базе и покажет, из каких таблиц и колонок взяты цифры."
        },
        {
          "title": "Регулярная сводка по данным",
          "desc": "Агент по расписанию прогонит один и тот же запрос (вчерашние продажи или всплеск отказов) и пришлёт результат."
        },
        {
          "title": "Сверка с внешними сервисами",
          "desc": "Агент сопоставит строки вашей базы с данными подключённых сервисов и покажет расхождения по заказам или платежам."
        },
        {
          "title": "Что вообще лежит в базе",
          "desc": "Агент перечислит таблицы, колонки и типы и объяснит, где какие данные лежат: первое, что нужно на входе в чужую или давно забытую базу."
        },
        {
          "title": "Разбор тяжёлого запроса",
          "desc": "Агент прогонит EXPLAIN по нужному запросу и покажет, где план уходит в полный перебор таблицы, до того, как отчёт снова упрётся в таймаут."
        }
      ],
      "how_it_works": [
        "Агент подключается к базе напрямую по параметрам (хост, порт, имя базы, пользователь, пароль и, если нужен, корневой сертификат) и начинает с обзора схемы: список таблиц, их колонки и типы. Дальше SQL он пишет сам: считает выручку, средний чек и конверсию, сопоставляет строки с данными других подключённых сервисов и показывает, из каких таблиц и колонок взята каждая цифра. Тот же запрос можно поставить на расписание и получать результат регулярно.",
        "Особенность именно PostgreSQL, которую агент учитывает: роль с pg_read_all_data не обходит row-level security. Таблица под RLS без политики SELECT вернёт ноль строк, и это не «данных нет», а «доступа нет», о чём агент говорит прямо. Так же он читает и пустой результат обычного запроса: сначала проверяет, есть ли строки вообще, и только потом называет цифру нулём. Схему агент перечитывает перед разбором, поэтому переименованная колонка или новая таблица подхватываются без переподключения.",
        "На запись агент в базу не ходит: коннектор пропускает только SELECT, WITH, SHOW и EXPLAIN, по одному запросу за вызов и с лимитом строк, а INSERT, UPDATE и любые DDL отклоняет до отправки в базу. Это устройство самого коннектора, а не настройка, которую можно снять из чата, поэтому подключение остаётся аналитическим по природе: агент читает, считает и объясняет, из чего сложился результат, но ничего в базе не меняет.",
        "Доступ агент получает не входом через сервис, а логином и паролем отдельной роли, поэтому его границы задаёте вы: агент видит ровно то, что видит эта роль, и расширить их из чата нельзя. Каждый запрос коннектор ограничивает по времени и по числу строк, а слишком тяжёлый обрывает по таймауту, вместо того чтобы висеть на рабочей базе. Если таблицы нет или права не дают её прочитать, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права владельца базы или суперпользователя для SQL-консоли",
        "PostgreSQL 14 или новее, иначе права выдаются вручную",
        "Публичный адрес базы и доступ к её TCP-порту с адресов из списка ниже",
        "Правила брандмауэра и hostssl в pg_hba.conf для выбранной базы и роли",
        "TLS 1.2 или новее с проверкой цепочки и имени сервера (verify-full)",
        "IP SAN для подключения по IP; корневой сертификат PEM для своего CA"
      ],
      "faq": [
        {
          "q": "Как подключить PostgreSQL?",
          "a": "Параметрами подключения, а не входом через сервис: хост, порт, имя базы, пользователь, пароль и, если провайдер подписывает базу своим CA, его корневой сертификат. Заведите роль только на чтение (CREATE ROLE analytics_ro LOGIN PASSWORD и GRANT pg_read_all_data), её логин и пароль и вводятся в форме."
        },
        {
          "q": "Что агент видит в базе?",
          "a": "Список таблиц, колонки и типы и результаты SELECT в пределах прав роли. Роль pg_read_all_data не обходит row-level security: таблицы под RLS без политики SELECT вернут ноль строк."
        },
        {
          "q": "Пишет ли агент в базу?",
          "a": "Нет. Разрешены только SELECT, WITH, SHOW и EXPLAIN, по одному запросу за вызов и с лимитом строк; INSERT, UPDATE и любые DDL коннектор отклоняет."
        },
        {
          "q": "Что нужно на стороне базы?",
          "a": "Поддерживается и PostgreSQL на своей ВМ с публичным адресом. Укажите настроенный TCP-порт базы, в том числе нестандартный. В брандмауэре ВМ разрешите этот порт с постоянных адресов Сам Решу из требований на этой странице, а в pg_hba.conf добавьте hostssl для этих адресов, выбранной базы и роли только на чтение. У облачного провайдера настройте аналогичные правила. Успешное чтение из DataLens или проверка с самой ВМ не подтверждают доступ с этих адресов."
        }
      ]
    },
    "seo_en": {
      "title": "PostgreSQL AI agent: metrics and slow query analysis",
      "description": "The agent computes metrics like average order value straight from your database and shows why a report hangs on a full table scan. Read-only, via its own role.",
      "headline": "Ask your PostgreSQL database in plain words, no SQL",
      "scenarios": [
        {
          "title": "A question to the database without SQL",
          "desc": "The agent works out the schema itself (tables, columns and relations) and answers your question about the data without a single line of SQL from you."
        },
        {
          "title": "Metrics straight inside the database",
          "desc": "The agent calculates revenue, average order value and conversion with a query to your database and shows which tables and columns the numbers came from."
        },
        {
          "title": "A recurring data digest",
          "desc": "On a schedule the agent runs the same query (yesterday sales or a spike in failures) and sends the result."
        },
        {
          "title": "Reconciliation with external services",
          "desc": "The agent matches the rows of your database against data from connected services and shows discrepancies in orders or payments."
        },
        {
          "title": "What is actually in the database",
          "desc": "The agent lists tables, columns and types and explains where each kind of data lives: the first thing you need in an inherited or long-forgotten database."
        },
        {
          "title": "Reading a slow query",
          "desc": "The agent runs EXPLAIN on the query you care about and shows where the plan drops into a full table scan, before the report hits a timeout again."
        }
      ],
      "how_it_works": [
        "The agent connects to the database directly with parameters (host, port, database name, user, password and, when needed, a root certificate) and starts with a look at the schema: the list of tables, their columns and types. From there it writes the SQL itself: it calculates revenue, average order value and conversion, matches rows against data from other connected services and shows which tables and columns every number came from. The same query can be put on a schedule and delivered regularly.",
        "The PostgreSQL specific the agent accounts for: a role with pg_read_all_data does not bypass row-level security. A table under RLS with no SELECT policy returns zero rows, and that is not «no data» but «no access», which the agent states directly. It reads an empty result from an ordinary query the same way: it first checks whether any rows exist at all and only then calls the number a zero. The schema is re-read before an analysis, so a renamed column or a new table is picked up without reconnecting.",
        "The agent never writes to the database: the connector passes through only SELECT, WITH, SHOW and EXPLAIN, one statement per call and with a row limit, and rejects INSERT, UPDATE and any DDL before they reach the database. That is how the connector itself is built, not a setting that can be lifted from chat, so the connection stays analytical by nature: the agent reads, calculates and explains what the result is made of, but changes nothing in the database.",
        "Access comes not from a sign-in through a service but from the login and password of a separate role, so you set its boundaries: the agent sees exactly what that role sees, and nothing said in chat can widen them. Every query is bounded by the connector in time and in rows, and one that grows too heavy is cut off by timeout instead of hanging on a production database. If a table is missing or permissions do not allow reading it, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Owner or superuser rights for the database SQL console",
        "PostgreSQL 14 or newer, otherwise grants are issued by hand",
        "A public database address and TCP port reachable from the addresses listed below",
        "Firewall and pg_hba.conf hostssl rules for the selected database and role",
        "TLS 1.2 or newer with chain and server name verification (verify-full)",
        "An IP SAN for an IP address; a PEM root certificate for a private CA"
      ],
      "faq": [
        {
          "q": "How do I connect PostgreSQL?",
          "a": "With connection parameters rather than a sign-in through the service: host, port, database name, user, password and, when the provider signs the database with its own CA, that root certificate. Create a read-only role (CREATE ROLE analytics_ro LOGIN PASSWORD and GRANT pg_read_all_data), and it is that login and password you enter in the form."
        },
        {
          "q": "What does the agent see in the database?",
          "a": "The list of tables, the columns and types and the results of SELECT within the permissions of the role. The pg_read_all_data role does not bypass row-level security: tables under RLS with no SELECT policy return zero rows."
        },
        {
          "q": "Does the agent write to the database?",
          "a": "No. Only SELECT, WITH, SHOW and EXPLAIN are allowed, one statement per call and with a row limit; INSERT, UPDATE and any DDL are rejected by the connector."
        },
        {
          "q": "What is needed on the database side?",
          "a": "PostgreSQL on your own VM with a public address is supported too. Enter the database's configured TCP port, including a nonstandard port. In the VM firewall allow that port from the fixed Samreshuuu addresses listed in the requirements on this page, and add hostssl in pg_hba.conf for those addresses, the selected database and a read-only role. Configure equivalent rules with a cloud provider. Reading through DataLens or checking from the VM itself does not confirm access from these addresses."
        }
      ]
    }
  },
  {
    "key": "rambler_mail",
    "name": "Рамблер Почта",
    "name_en": "Rambler Mail",
    "description": "Электронная почта Рамблера: письма, папки, отправка и пересылка",
    "category": "mail",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "rambler-mail",
    "description_en": "Rambler email: messages, folders, sending and forwarding",
    "guide": {
      "url": "https://id.rambler.ru",
      "steps": [
        {
          "title": "В профиле Рамблера откройте «Безопасность»",
          "desc": "Войдите в id.rambler.ru под адресом ящика, который подключаете, и откройте раздел «Безопасность».",
          "title_en": "Open «Безопасность» in your Rambler profile",
          "desc_en": "Sign in at id.rambler.ru with the mailbox you are connecting and open the «Безопасность» (Security) section."
        },
        {
          "title": "Включите доступ почтовых клиентов",
          "desc": "Переведите «Доступ к почтовому ящику с помощью почтовых клиентов» во «Вкл» и пройдите «Я не робот». Пока он выключен, ящик не пускает IMAP и SMTP.",
          "title_en": "Turn on mail-client access",
          "desc_en": "Switch «Доступ к почтовому ящику с помощью почтовых клиентов» to «Вкл» and confirm the «Я не робот» check. While it is off, the mailbox rejects IMAP and SMTP logins."
        },
        {
          "title": "Создайте специальный пароль",
          "desc": "Появится кнопка создания пароля для почтовых клиентов. Скопируйте его с полным адресом ящика. Новый пароль отменяет прежний: после пересоздания обновите подключение.",
          "title_en": "Create the special password",
          "desc_en": "A button to create a mail-client password appears. Copy it with the full mailbox address. A new password revokes the old one: update the connection after recreating it."
        }
      ]
    },
    "seo": {
      "title": "Рамблер Почта и ИИ-агент: кто забивает ящик",
      "description": "Из 1 240 писем за месяц 58% прислали пять отправителей: агент назовёт их и разберёт входящие. Подключается специальным паролем для почтовых клиентов по IMAP и SMTP.",
      "headline": "Разбирайте входящие Рамблера, не открывая почтовый ящик",
      "scenarios": [
        {
          "title": "Разбор входящих за утро",
          "desc": "Агент пройдёт по непрочитанным письмам и покажет, какие ждут ответа, с темой, отправителем и датой, без открытия почтового ящика."
        },
        {
          "title": "Счета и акты из вложений",
          "desc": "Агент найдёт письмо по отправителю или теме, достанет вложение (счёт, акт или договор) и разберёт его содержимое."
        },
        {
          "title": "Ответ и пересылка письма",
          "desc": "Агент напишет ответ в нужную переписку, перешлёт письмо коллеге или отправит новое письмо с вашего ящика через SMTP."
        },
        {
          "title": "Наведение порядка в папках",
          "desc": "Агент разложит письма по папкам, отметит разобранные как прочитанные и удалит то, что явно не нужно хранить дальше."
        },
        {
          "title": "Переписка по сделке",
          "desc": "Агент соберёт письма с нужным адресатом за период, выстроит их по датам и покажет, о чём договорились и что осталось без ответа."
        },
        {
          "title": "Кто пишет чаще всего",
          "desc": "Агент посчитает месяц почты по отправителям и папкам и покажет, кто наполняет ящик и какая часть этих писем так и осталась непрочитанной."
        }
      ],
      "how_it_works": [
        "Агент подключается к ящику по IMAP и SMTP: первым делом читает список папок, а дальше работает с самими письмами: темой, отправителем, датой, телом и вложениями. Он проходит по непрочитанным и показывает, какие ждут ответа, находит письмо по отправителю или теме и достаёт из него счёт, акт или договор, чтобы разобрать содержимое, а не пересказать имя файла.",
        "Подключается не пароль от аккаунта, а специальный пароль для почтовых клиентов, который Рамблер выдаёт после включения доступа по IMAP. Одна пара адреса и пароля обслуживает и IMAP, и SMTP, поэтому для разбора переписки и отправки ответов достаточно подключить один ящик. Пароль у ящика один: создание нового отменяет прежний, и подключение нужно обновить.",
        "IMAP это не копия почты, а сам ящик: отметка о прочтении, перенос в другую папку и удаление применяются на сервере и сразу видны во всех ваших почтовых клиентах. Поэтому агент разбирает входящие по шагам: сначала показывает, что нашёл, и только потом раскладывает, помечает прочитанным или удаляет. Ответ в переписку, пересылку и новое письмо через SMTP он отправляет с вашего адреса.",
        "Доступ ограничен одним ящиком: тем, чей адрес и пароль подключены; чужие ящики агенту не видны. Доступ отзывается в настройках Рамблера выключением почтовых клиентов или созданием нового пароля, без смены пароля от аккаунта. Если письма по запросу не нашлись или папка недоступна, агент скажет об этом прямо, а не покажет пустой список."
      ],
      "requirements": [
        "Полный адрес ящика Рамблера и доступ к его настройкам.",
        "Агент читает все папки ящика и отправляет письма от вашего имени."
      ],
      "faq": [
        {
          "q": "Как подключить Рамблер Почту?",
          "a": "Адресом ящика и специальным паролем для почтовых клиентов. В профиле Рамблера откройте «Безопасность», включите «Доступ к почтовому ящику с помощью почтовых клиентов», создайте пароль и скопируйте его."
        },
        {
          "q": "Что агент видит в почте?",
          "a": "Список папок, письма с темой, отправителем и датой, тела писем и вложения. Всё через IMAP, в объёме того ящика, чей пароль подключён."
        },
        {
          "q": "Пишет ли агент в почту?",
          "a": "Может: отправить письмо, ответить в переписку, переслать сообщение, переложить письмо в другую папку, отметить прочитанным или удалить."
        },
        {
          "q": "Что делать, если вход не проходит?",
          "a": "Проверьте, что доступ почтовых клиентов включён, а в подключении стоит последний созданный специальный пароль: новый пароль отменяет прежний. Основной пароль от аккаунта для IMAP не подходит."
        }
      ]
    },
    "seo_en": {
      "title": "Rambler Mail and AI agent: see who floods your inbox",
      "description": "Out of 1,240 emails a month, 58% came from five senders: the agent names them and sorts the inbox. Connects over IMAP and SMTP with a mail client password.",
      "headline": "Triage your Rambler inbox without opening the mailbox",
      "scenarios": [
        {
          "title": "Morning inbox triage",
          "desc": "The agent goes through unread messages and shows which ones are waiting for a reply, with subject, sender and date, without opening the mailbox."
        },
        {
          "title": "Invoices and acts out of attachments",
          "desc": "The agent finds a message by sender or subject, pulls out the attachment (an invoice, an act or a contract) and reads what is inside."
        },
        {
          "title": "Replying and forwarding",
          "desc": "The agent writes a reply in the right thread, forwards a message to a colleague or sends a new email from your mailbox over SMTP."
        },
        {
          "title": "Tidying up the folders",
          "desc": "The agent sorts messages into folders, marks the handled ones as read and deletes what clearly does not need keeping."
        },
        {
          "title": "The thread behind a deal",
          "desc": "The agent gathers the messages with one contact over a period, lines them up by date and shows what was agreed and what was left unanswered."
        },
        {
          "title": "Who writes the most",
          "desc": "The agent counts a month of mail by sender and folder and shows who fills the mailbox and how much of it was never even opened."
        }
      ],
      "how_it_works": [
        "The agent connects to the mailbox over IMAP and SMTP: the first thing it reads is the folder list, and from there it works with the messages themselves: subject, sender, date, body and attachments. It goes through the unread ones and shows which are waiting for a reply, finds a message by sender or subject and pulls the invoice, act or contract out of it to read what is inside rather than retell the file name.",
        "What gets connected is not the account password but a special mail-client password that Rambler issues once IMAP access is switched on. One pair of address and password serves both IMAP and SMTP, so connecting one mailbox is enough to read a thread and send the reply. A mailbox has one such password: creating a new one revokes the previous one, and the connection has to be updated.",
        "IMAP is not a copy of the mail but the mailbox itself: a read flag, a move to another folder and a deletion are applied on the server and show up immediately in all of your mail clients. So the agent triages the inbox step by step: first it shows what it found, and only then sorts, marks as read or deletes. A reply in a thread, a forward and a new email over SMTP are sent from your own address.",
        "Access is limited to a single mailbox, the one whose address and password are connected; other mailboxes stay invisible to the agent. Access is revoked in the Rambler settings by switching mail clients off or creating a new password, without changing the account password. If the messages you asked for were not found or a folder is unavailable, the agent says so directly instead of showing an empty list."
      ],
      "requirements": [
        "The full Rambler mailbox address and access to its settings.",
        "The agent reads every folder and sends mail on your behalf."
      ],
      "faq": [
        {
          "q": "How do I connect Rambler Mail?",
          "a": "With the mailbox address and a special mail-client password. In your Rambler profile open Security, switch on mailbox access for mail clients, create a password and copy it."
        },
        {
          "q": "What does the agent see in the mailbox?",
          "a": "The folder list, messages with subject, sender and date, message bodies and attachments, all over IMAP, limited to the mailbox whose password is connected."
        },
        {
          "q": "Does the agent write to the mailbox?",
          "a": "It can: send an email, reply in a thread, forward a message, move a message to another folder, mark it as read or delete it."
        },
        {
          "q": "What should I do if sign-in fails?",
          "a": "Check that mail-client access is switched on and that the connection holds the latest special password: a new one revokes the previous. The account password itself does not work over IMAP."
        }
      ]
    }
  },
  {
    "key": "retailcrm",
    "name": "RetailCRM",
    "name_en": "RetailCRM",
    "description": "Для интернет-магазинов: заказы, клиенты, товары, справочники, задачи, аналитика",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "retailcrm",
    "description_en": "For online stores: orders, customers, products, reference data, tasks and analytics",
    "search_terms": [
      "ритейл црм"
    ],
    "guide": {
      "url": "https://www.retailcrm.ru",
      "steps": [
        {
          "title": "Скопируйте поддомен из адреса кабинета",
          "desc": "В «https://myshop.retailcrm.ru» поддомен это myshop, до первой точки, а «Домен аккаунта» это retailcrm.ru после неё. Иногда это retailcrm.pro.",
          "title_en": "Copy the subdomain from your account address",
          "desc_en": "In “https://myshop.retailcrm.ru” the subdomain is myshop and “Account domain” is retailcrm.ru after the first dot. Some use retailcrm.pro."
        },
        {
          "title": "В «Интеграции» добавьте ключ доступа к API",
          "desc": "Шестерёнка настроек слева вверху → «Интеграция» → вкладка «Ключи доступа к API» → «Добавить». Значение ключа генерируется само, не короче 32 символов.",
          "title_en": "In Integration add an API key",
          "desc_en": "Open “Administration” → “Integration” and press “Add” in the API keys list. The token is generated automatically, at least 32 characters."
        },
        {
          "title": "В «Типе доступа» отметьте нужные магазины",
          "desc": "В «Тип доступа» выберите «Доступ ко всем магазинам» либо отметьте нужные в поле «Магазины». По магазинам вне списка ключа заказы и клиенты не придут.",
          "title_en": "In Access type pick the shops for the key",
          "desc_en": "In “Access type” pick “Access to all shops”, or tick the ones you need in the “Shops” field. Orders and customers of shops left out will not be returned."
        },
        {
          "title": "Отметьте разрешённые методы и скопируйте ключ",
          "desc": "В «Разрешённые методы API» включите заказы, клиентов, товары, справочники, задачи и пользователей, сохраните и скопируйте ключ.",
          "title_en": "Tick the allowed methods and copy the key",
          "desc_en": "In “Allowed API methods” enable orders, customers, products, reference books, tasks and users, then save and copy the key."
        }
      ]
    },
    "seo": {
      "title": "RetailCRM и ИИ: отвал постоянных клиентов и невыкупы",
      "description": "214 постоянных клиентов не покупают дольше 90 дней, отмены и невыкупы за месяц на 1,34 млн ₽. Агент считает это по заказам RetailCRM через API вашего кабинета.",
      "headline": "ИИ для интернет-магазина: заказы RetailCRM по статусам",
      "scenarios": [
        {
          "title": "Сводка заказов по статусам и магазинам",
          "desc": "Агент соберёт заказы RetailCRM по статусам, источникам и магазинам, найдёт зависшие и посчитает выручку за период."
        },
        {
          "title": "Анализ повторных покупок",
          "desc": "Агент сегментирует клиентов по частоте и давности покупок, найдёт уснувших постоянников и подготовит список для реактивации."
        },
        {
          "title": "Контроль просроченных задач",
          "desc": "Агент проверит задачи менеджеров, выделит просроченные по заказам в работе и пришлёт список ответственным."
        },
        {
          "title": "Отмены и невыкупы",
          "desc": "Агент разберёт отменённые и невыкупленные заказы за период, покажет их отдельно от выручки и назовёт магазины, где потери выше всего."
        },
        {
          "title": "Что на самом деле покупают",
          "desc": "Агент сведёт состав заказов со справочником товаров и покажет, что берут чаще всего, а что лежит в каталоге без единой продажи за период."
        },
        {
          "title": "Правка карточки заказа",
          "desc": "Агент перечитает карточку заказа и поставит новый статус или комментарий, если ключу разрешено изменение; иначе честно скажет, что остаётся читающим."
        }
      ],
      "how_it_works": [
        "Агент ходит в API RetailCRM пятой версии на адресе вашего кабинета (retailcrm.ru или retailcrm.pro) и читает заказы, клиентов, товары, справочники, задачи и аналитику. На них строится сводка заказов по статусам, источникам и магазинам с выручкой за период, сегментация клиентов по частоте и давности покупок вместе с уснувшими постоянниками и разбор задач менеджеров с просрочкой по заказам в работе.",
        "Начинает агент со справочника статусов, и это не формальность: статусы в RetailCRM настраиваются под магазин, названия у всех разные, а смысл несёт группа, к которой статус отнесён. Сравнивать заказы по подписи на кнопке бессмысленно, поэтому агент раскладывает их по группам и только потом считает. Так же он разделяет магазины и источники: общая цифра по аккаунту, где сложены несколько площадок, прячет ровно то, ради чего отчёт и заказывали.",
        "Отменённые и невыкупленные заказы агент в выручку не кладёт, а показывает отдельной строкой, иначе сводка выглядит бодрее кассы. Что он умеет помимо чтения, решает набор методов, отмеченных у ключа: если изменение заказов ключу не разрешено, агент останется читающим и скажет об этом, а не будет гадать. Перед правкой заказа он перечитывает карточку: её параллельно двигают менеджеры и обмен с магазином, и затирать чужое изменение нельзя.",
        "Доступ идёт API-ключом кабинета: он передаётся с каждым запросом, ограничен списком методов и списком магазинов и отзывается там же, где был создан. Сужение ключа до одного магазина агент читает как границу данных, а не как поломку, и так и объясняет цифру. Частоту запросов он выдерживает сам, длинные периоды забирает постранично, а если метод ключу не отмечен или заказов за период не было, говорит это прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Права администратора в кабинете RetailCRM.",
        "Магазины, заказы которых нужны агенту, подключены в кабинете."
      ],
      "faq": [
        {
          "q": "Что нужно для подключения RetailCRM?",
          "a": "Адрес аккаунта (поддомен и домен, на котором открывается кабинет: retailcrm.ru или retailcrm.pro) и API-ключ из «Настройки → Интеграция → Ключи доступа к API». Ключу можно выдать доступ только к нужным методам и магазинам."
        },
        {
          "q": "Какие данные агент читает?",
          "a": "Заказы, клиентов, товары, справочники, задачи и аналитику по тем магазинам, к которым у ключа есть доступ."
        },
        {
          "q": "Можно ли ограничить доступ одним магазином?",
          "a": "Да, это настраивается прямо в RetailCRM на уровне API-ключа: агент увидит только выбранные магазины."
        },
        {
          "q": "Чем ИИ помогает интернет-магазину?",
          "a": "Считает заказы по статусам, источникам и магазинам с выручкой за период, отделяет отмены и невыкупы от кассы, сегментирует клиентов по частоте и давности покупок и поднимает уснувших постоянников, а по составу заказов показывает, что берут чаще всего и что лежит в каталоге без единой продажи."
        }
      ]
    },
    "seo_en": {
      "title": "RetailCRM API and AI agent: lapsed repeat customers",
      "description": "214 repeat customers have not ordered in 90 days, and cancellations cost 1.34 million rubles this month. The agent counts it from RetailCRM orders via the API.",
      "headline": "Total RetailCRM orders by status and store right in chat",
      "scenarios": [
        {
          "title": "Orders by status and store",
          "desc": "The agent groups RetailCRM orders by status, source and store, spots the ones that have stalled and totals revenue for the period."
        },
        {
          "title": "Repeat purchase analysis",
          "desc": "The agent segments customers by purchase frequency and recency, finds loyal buyers who have gone quiet and prepares a list for reactivation."
        },
        {
          "title": "Overdue task control",
          "desc": "The agent reviews manager tasks, singles out the overdue ones on orders in progress and sends the list to whoever owns them."
        },
        {
          "title": "Cancellations and unredeemed orders",
          "desc": "The agent takes cancelled and unredeemed orders for the period apart, keeps them off the revenue line and names the stores losing the most."
        },
        {
          "title": "What people actually buy",
          "desc": "The agent matches order lines against the product reference book and shows what sells most often and what has sat in the catalogue without a single sale."
        },
        {
          "title": "Updating an order card",
          "desc": "The agent re-reads the order card and sets a new status or a comment, if the key is allowed to change orders; otherwise it says plainly that it stays a reader."
        }
      ],
      "how_it_works": [
        "The agent calls the fifth version of the RetailCRM API at your workspace address (retailcrm.ru or retailcrm.pro) and reads orders, customers, products, reference books, tasks and analytics. On top of those it builds the order summary by status, source and store with revenue for the period, the segmentation of customers by purchase frequency and recency together with loyal buyers who have gone quiet, and the review of manager tasks with overdue items on orders in progress.",
        "The agent starts from the status reference book, and that is not a formality: statuses in RetailCRM are configured per shop, everyone's names differ, and the meaning is carried by the group a status belongs to. Comparing orders by the label on a button is pointless, so the agent sorts them into groups first and counts afterwards. It separates stores and sources the same way: a single account-wide figure that stacks several sales channels hides exactly what the report was asked for.",
        "Cancelled and unredeemed orders are kept out of revenue and shown on a separate line, otherwise the summary looks livelier than the till. What the agent can do beyond reading is decided by the set of methods ticked for the key: if changing orders is not permitted, the agent stays a reader and says so rather than guessing. Before editing an order it re-reads the card: managers and the store exchange move it in parallel, and someone else's change must not be overwritten.",
        "Access runs on an API key of the workspace: it travels with every request, is limited to a list of methods and a list of stores, and is revoked where it was created. A key narrowed down to one store reads to the agent as a data boundary rather than a breakage, and it explains the figure that way. It holds the request rate itself and fetches long periods page by page, and if a method is not ticked for the key or there were no orders in the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Administrator rights in the RetailCRM workspace.",
        "The shops whose orders the agent needs are connected in the workspace."
      ],
      "faq": [
        {
          "q": "What is needed to connect RetailCRM?",
          "a": "The account address (the subdomain and the domain your workspace opens on: retailcrm.ru or retailcrm.pro) and an API key from Settings, Integration, API access keys. A key can be limited to only the methods and stores you need."
        },
        {
          "q": "What data does the agent read?",
          "a": "Orders, customers, products, reference books, tasks and analytics, for the stores the key has access to."
        },
        {
          "q": "Can access be limited to a single store?",
          "a": "Yes, it is set in RetailCRM itself at the API key level: the agent will see only the stores you pick."
        },
        {
          "q": "How does AI help an online store?",
          "a": "It counts orders by status, source and store with revenue for the period, keeps cancellations and non-redemptions out of the till figure, segments customers by purchase frequency and recency to surface lapsed regulars, and from the order contents shows what sells most and what sits in the catalogue without a single sale."
        }
      ]
    }
  },
  {
    "key": "robokassa",
    "name": "Robokassa",
    "name_en": "Robokassa",
    "description": "Приём платежей: ссылки и счета, статус, холд, повторные списания, возвраты, чеки 54-ФЗ",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "robokassa",
    "description_en": "Accept payments: links and invoices, status, holds, recurring charges, refunds, receipts",
    "search_terms": [
      "робокасса"
    ],
    "signup_url": "https://login.robokassa.ru/reg",
    "guide": {
      "url": "https://partner.robokassa.ru/Shops",
      "steps": [
        {
          "title": "Заведите магазин в кабинете Robokassa",
          "desc": "Зарегистрируйтесь на partner.robokassa.ru и создайте магазин: идентификатор и пароли существуют у магазина, а не у аккаунта.",
          "title_en": "Create a shop in your Robokassa account",
          "desc_en": "Register at partner.robokassa.ru and create a shop: the identifier and the passwords belong to the shop, not to the account."
        },
        {
          "title": "Скопируйте MerchantLogin в «Моих магазинах»",
          "desc": "Идентификатор магазина (MerchantLogin) лежит в карточке: «Мои магазины» → «Технические настройки». Это логин магазина, а не e-mail входа в кабинет.",
          "title_en": "Copy MerchantLogin under Technical settings",
          "desc_en": "The shop identifier (MerchantLogin) sits in the shop card under «Мои магазины» → «Технические настройки». It is the shop login, not your account e-mail."
        },
        {
          "title": "Проверьте алгоритм расчёта хеша: MD5",
          "desc": "Там же выбирается метод хэширования подписи. Нужен MD5, по умолчанию стоит он; если выбран SHA-256 или другой, верните MD5.",
          "title_en": "Make sure the hash algorithm is MD5",
          "desc_en": "The signature hash method sits in the same card. MD5 is the default and the only one that matches, so switch anything else back."
        },
        {
          "title": "Скопируйте рабочие Пароль #1 и Пароль #2",
          "desc": "В том же разделе два блока паролей: рабочий и тестовый. Пароль #1 подписывает платёж, а Пароль #2 уведомления и статус.",
          "title_en": "Copy the live Password #1 and Password #2",
          "desc_en": "Two password blocks sit there, live and test. Пароль #1 signs the payment, Пароль #2 notifications and status. Test ones give error 29."
        }
      ]
    },
    "seo": {
      "title": "Robokassa и ИИ-агент: ссылка на оплату с чеком 54-ФЗ",
      "description": "Ссылка на оплату с фискальным чеком по 54-ФЗ прямо из переписки и итог, сколько счетов оплачено за сутки. Нужны идентификатор магазина и его пароли.",
      "headline": "Выставляйте ссылки на оплату Robokassa прямо в переписке",
      "scenarios": [
        {
          "title": "Ссылка на оплату в переписке",
          "desc": "Агент соберёт ссылку на оплату с суммой, описанием и фискальным чеком по 54-ФЗ, и её сразу можно отправить клиенту."
        },
        {
          "title": "Статус выставленного счёта",
          "desc": "Агент скажет по номеру счёта, что с платежом: инициирован, в холде, оплачен или возвращён, без захода в кабинет."
        },
        {
          "title": "Напоминания по неоплаченным",
          "desc": "Агент по расписанию обойдёт выставленные им счета и напомнит о тех, что так и остались неоплаченными."
        },
        {
          "title": "Валюты и способы оплаты",
          "desc": "Агент покажет доступные магазину валюты и способы оплаты, чтобы ссылка выставлялась в том, чем клиенту удобно платить."
        },
        {
          "title": "Сколько собрали за день",
          "desc": "Агент обойдёт выставленные за сутки счета, посчитает оплаченные и покажет собранную сумму, отдельно назвав те, что ушли в возврат или зависли в холде."
        },
        {
          "title": "Почему платёж не прошёл",
          "desc": "Агент расшифрует числовой код ошибки (разошлась подпись, магазин ещё не прошёл модерацию или такого счёта нет) и скажет, что именно поправить."
        }
      ],
      "how_it_works": [
        "Агент работает с Robokassa через подписанные запросы к auth.robokassa.ru: собирает ссылку на оплату с суммой, описанием заказа и фискальным чеком по 54-ФЗ, читает статус выставленного счёта по его номеру и показывает валюты и способы оплаты, доступные конкретно вашему магазину. Проверочным запросом при подключении служит список валют магазина: он же сразу показывает, что подпись сходится и магазин отвечает.",
        "Токена в Robokassa нет: доступ держится на паролях магазина, и они не равнозначны. Пароль #1 подписывает платёж, счета, холд и повторные списания, пароль #2 уведомления и проверку статуса, пароль #3 только возвраты. Поэтому агенту нужны первые два, а третий, если возвраты должны идти через агента. Сама подпись собирается из идентификатора магазина, суммы, номера счёта и пароля и считается по MD5, поэтому сумма в подписи и сумма в ссылке обязаны совпадать до копейки, иначе платёж отклоняется на входе, ещё до страницы оплаты.",
        "Операции, которые двигают деньги (подтвердить или отменить холд, повторно списать по подписке, оформить возврат), агент выполняет только после вашего согласия на конкретный вызов, а итог проверяет статусом операции. Зачисление и вывод остаются на стороне Robokassa и вашего договора с ней. По расписанию он обходит выставленные им же счета и напоминает о неоплаченных. Выписки по расчётному счёту здесь нет и быть не может: Robokassa отвечает за приём платежей от клиентов, банк подключается отдельным коннектором.",
        "Ошибки Robokassa возвращает числовым кодом, и агент расшифровывает его, а не показывает «запрос не прошёл»: по коду видно, разошлась ли подпись, не активирован ли магазин или такого счёта попросту нет. Частоту запросов он выдерживает сам (до пяти в секунду с небольшим запасом на всплеск), так что серия проверок статуса не упирается в отказ. Если по счёту данных нет или магазин их не отдаёт, агент говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Личный кабинет Robokassa с правами владельца магазина",
        "Магазин прошёл модерацию: до неё работает только тестовый режим",
        "Сайт или страница, куда принимаются платежи"
      ],
      "faq": [
        {
          "q": "Как подключить Robokassa?",
          "a": "Значениями из «Мои магазины» → «Технические настройки»: идентификатор магазина (это логин магазина, а не e-mail входа), пароль #1 и пароль #2; пароль #3 нужен только для возвратов и появляется после подключения API возвратов. Проверьте, что выбран алгоритм хеша MD5, иначе подписи не сойдутся, а тестовые пароли дадут ошибку 29."
        },
        {
          "q": "Что агент делает с платежами?",
          "a": "Формирует ссылки на оплату с фискальным чеком по 54-ФЗ, проверяет статус счёта по его номеру и показывает валюты и способы оплаты, доступные магазину."
        },
        {
          "q": "Это же не расчётный счёт?",
          "a": "Нет. Robokassa отвечает за приём платежей от клиентов: агент видит выставленные счета и их статусы, а не выписку по расчётному счёту. Для операций по счёту банк подключается отдельным коннектором."
        },
        {
          "q": "Что с деньгами и правами?",
          "a": "Каждую операцию с деньгами (холд, повторное списание, возврат) агент выполняет только после вашего согласия на этот вызов. Зачисление и вывод остаются на стороне Robokassa и вашего договора с ней."
        }
      ]
    },
    "seo_en": {
      "title": "Robokassa AI agent: payment links with 54-FZ receipts",
      "description": "Ask for a payment link with a 54-FZ fiscal receipt and see how many invoices were paid yesterday. Connects with your shop ID and the shop passwords.",
      "headline": "Issue Robokassa payment links right inside the conversation",
      "scenarios": [
        {
          "title": "A payment link right in the chat",
          "desc": "The agent builds a payment link with the amount, the description and a 54-FZ fiscal receipt, ready to send to the customer straight away."
        },
        {
          "title": "Status of an issued invoice",
          "desc": "The agent tells you by invoice number where the payment stands: initiated, on hold, paid or refunded, without opening the merchant account."
        },
        {
          "title": "Reminders on unpaid invoices",
          "desc": "On a schedule the agent walks through the invoices it issued and reminds you about the ones that are still unpaid."
        },
        {
          "title": "Currencies and payment methods",
          "desc": "The agent shows the currencies and payment methods available to your shop, so a link is issued in whatever is convenient for the customer."
        },
        {
          "title": "How much came in today",
          "desc": "The agent walks the invoices issued over the day, counts the paid ones and shows the total collected, naming separately what went to a refund or stayed on hold."
        },
        {
          "title": "Why a payment failed",
          "desc": "The agent decodes the numeric error code (a signature mismatch, a shop not through moderation yet, an invoice number that does not exist) and says what to fix."
        }
      ],
      "how_it_works": [
        "The agent works with Robokassa through signed requests to auth.robokassa.ru: it assembles a payment link with the amount, the order description and a 54-FZ fiscal receipt, reads the status of an issued invoice by its number and shows the currencies and payment methods available to your particular shop. The check request on connection is the list of shop currencies: it immediately shows that the signature matches and the shop responds.",
        "There is no token in Robokassa: access rests on the shop passwords, and they are not interchangeable. Password #1 signs the payment, invoices, holds and repeat charges, password #2 signs notifications and the status check, password #3 only refunds. So the agent needs the first two, and the third if refunds should go through the agent. The signature itself is assembled from the shop identifier, the amount, the invoice number and the password and hashed with MD5, so the amount in the signature and the amount in the link have to match to the kopeck, otherwise the payment is rejected at the entrance, before the checkout page.",
        "Operations that move money (confirming or cancelling a hold, a repeat subscription charge, a refund) the agent runs only after your consent to that specific call, and it checks the outcome by the operation status. Crediting and withdrawal stay on the Robokassa side and under your contract with them. On a schedule it walks through the invoices it issued itself and reminds you about the unpaid ones. There is no bank account statement here and there cannot be: Robokassa is about accepting payments from customers, a bank is connected as a separate connector.",
        "Robokassa returns its errors as numeric codes, and the agent decodes them rather than showing a bare «the request failed»: the code tells a signature mismatch apart from a shop that is not live yet and from an invoice number that does not exist. It holds the request rate itself (up to five per second with a small allowance for a burst), so a series of status checks does not run into a refusal. If there is no data on an invoice or the shop does not return it, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A Robokassa account with owner rights on the shop",
        "The shop past moderation: before that only test mode works",
        "A website or page where the payments are accepted"
      ],
      "faq": [
        {
          "q": "How do I connect Robokassa?",
          "a": "With the values from My shops, Technical settings: the shop identifier (this is the shop login, not the sign-in e-mail), password #1 and password #2; password #3 is needed only for refunds and appears once the refund API is enabled. Check that the hash algorithm is MD5, otherwise signatures will not match, and test passwords will return error 29."
        },
        {
          "q": "What does the agent do with payments?",
          "a": "It builds payment links with a 54-FZ fiscal receipt, checks the status of an invoice by its number and shows the currencies and payment methods available to the shop."
        },
        {
          "q": "This is not a settlement account, is it?",
          "a": "No. Robokassa is about accepting payments from customers: the agent sees issued invoices and their statuses, not a bank account statement. For account operations a bank is connected as a separate connector."
        },
        {
          "q": "What about money and permissions?",
          "a": "Every money operation (a hold, a repeat charge, a refund) the agent runs only after your consent to that call. Crediting and withdrawal stay on the Robokassa side and under your contract with them."
        }
      ]
    }
  },
  {
    "key": "rusguard",
    "name": "RusGuard (RusGuard Soft)",
    "name_en": "RusGuard (RusGuard Soft)",
    "description": "Опоздания по графику, пропуска и уровни доступа",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "rusguard",
    "short_name": "RusGuard",
    "short_name_en": "RusGuard",
    "description_en": "Late arrivals against schedule, passes and access levels",
    "search_terms": [
      "русгард",
      "rgsec",
      "рус гард",
      "скуд",
      "контроль доступа",
      "проходная",
      "турникет",
      "пропуск"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://www.rgsec.ru/integration/corporate-systems/integration-corporate-systems-native-api",
      "steps": [
        {
          "title": "Проверьте сервис интеграции RusGuard",
          "desc": "Сервис интеграции входит в серверную часть RusGuard Soft и отвечает по адресу https://имя-сервера/LNetworkServer/LNetworkService.svc. Работает только по HTTPS.",
          "title_en": "Check the RusGuard integration service",
          "desc_en": "The integration service is part of the RusGuard Soft server and answers at https://server-name/LNetworkServer/LNetworkService.svc. It works over HTTPS only."
        },
        {
          "title": "Подтвердите сертификат сервера",
          "desc": "Если сертификат самоподписанный, приложение покажет отпечаток SHA-256. Сверьте его на сервере и подтвердите: дальше принимается только этот сертификат, и по IP тоже.",
          "title_en": "Confirm the server certificate",
          "desc_en": "If the certificate is self-signed, the app shows its SHA-256 fingerprint. Check it on the server and confirm: from then on only that certificate is accepted, by IP too."
        },
        {
          "title": "Заведите оператора для интеграции",
          "desc": "В RusGuard Soft создайте оператора с правами на чтение сотрудников, ключей и журнала событий. Запись дайте, только если агент будет выдавать пропуска.",
          "title_en": "Create an operator for the integration",
          "desc_en": "In RusGuard Soft create an operator that can read employees, keys and the event log. Grant writes only if the agent will issue passes."
        },
        {
          "title": "Вставьте адрес, логин и пароль",
          "desc": "Проверьте, что часы компьютера и сервера совпадают: при расхождении больше нескольких минут сервер отклоняет вход оператора.",
          "title_en": "Paste the address, login and password",
          "desc_en": "Make sure the computer and server clocks agree: if they differ by more than a few minutes the server rejects the operator sign-in."
        }
      ]
    },
    "seo": {
      "title": "СКУД RusGuard и ИИ-агент: опоздания и ранние уходы",
      "description": "15 нарушений графика у 8 сотрудников, из них 4 ранних ухода. Агент читает журнал RusGuard Soft под логином оператора, блокировку пропуска делает после подтверждения.",
      "headline": "Табель, опоздания и пропуска из СКУД RusGuard прямо в чате",
      "scenarios": [
        {
          "title": "Табель по журналу проходов",
          "desc": "Агент выгрузит проходы за месяц, найдёт по каждому сотруднику первый вход и последний выход за день и сведёт часы в таблицу."
        },
        {
          "title": "Опоздания против графика",
          "desc": "Агент сравнит первый вход с началом смены по рабочему расписанию сотрудника и назовёт, кто и на сколько опоздал или ушёл раньше."
        },
        {
          "title": "Чья это карта",
          "desc": "Агент найдёт владельца карты по номеру, покажет его группу, уровни доступа и последние проходы."
        },
        {
          "title": "Пропуск новому сотруднику",
          "desc": "Агент заведёт сотрудника в нужной группе, выдаст карту и назначит уровень доступа, показав каждый шаг до записи."
        },
        {
          "title": "Блокировка уволенных",
          "desc": "Агент найдёт сотрудников по списку табельных номеров и заблокирует им проход после вашего подтверждения."
        }
      ],
      "how_it_works": [
        "Агент работает с сетевым сервисом сервера RusGuard Soft (LNetworkService), тем же, через который подключаются рабочие места системы. В подключении указывается адрес сервера и логин и пароль оператора RusGuard. Сервис отвечает с правами этого оператора: что не видно ему в программе, то не увидит и агент. Сервер обычно стоит в локальной сети, поэтому запросы идут через ваш компьютер с запущенным приложением.",
        "Табель и опоздания агент считает по журналу событий: читает проходы по ключу за период по дням и страницами, по каждому сотруднику и дню берёт первый вход и последний выход и сравнивает их с началом и концом смены из рабочего расписания сотрудника.",
        "Выдача пропуска идёт так же, как в программе: сотрудник создаётся в группе, ему выдаётся карта и назначается уровень доступа. Каждую запись агент показывает заранее и выполняет после вашего подтверждения.",
        "Открытие двери, блокировка и постановка на охрану меняют физический доступ на объекте, поэтому агент отправляет такие команды только по отдельной явной просьбе для конкретной двери и только после вашего подтверждения."
      ],
      "requirements": [
        "RusGuard Soft с сетевым сервисом LNetworkServer, доступным по HTTPS",
        "Оператор RusGuard с нужными правами",
        "Сертификат сервера: доверенный или подтверждённый по отпечатку",
        "Сетевой доступ к серверу RusGuard с компьютера, где запущено приложение"
      ],
      "faq": [
        {
          "q": "Как подключить RusGuard?",
          "a": "Укажите адрес сервера RusGuard (например, https://rusguard.company.local, путь к сервису приложение добавит само) и логин и пароль оператора RusGuard."
        },
        {
          "q": "Почему подключение не проходит проверку сертификата?",
          "a": "Сервис RusGuard работает только по HTTPS, и приложение проверяет сертификат сервера. Если сертификат самоподписанный, при подключении приложение покажет его отпечаток SHA-256: сверьте его с отпечатком на сервере и подтвердите. Дальше подключение принимает только этот сертификат, по IP-адресу тоже. Если сертификат на сервере сменится, в чате появится карточка с новым отпечатком: сверьте его и подтвердите."
        },
        {
          "q": "Почему отказ проверки безопасности при верном пароле?",
          "a": "Сервер отвергает запрос, если его часы расходятся с настоящим временем больше чем на пять минут. Сверьте время на сервере RusGuard."
        },
        {
          "q": "Откроет ли агент дверь сам?",
          "a": "Нет. Команды устройствам агент отправляет только по вашей явной просьбе с указанием двери и после подтверждения."
        }
      ]
    },
    "seo_en": {
      "title": "RusGuard and AI agent: late arrivals and early departures",
      "description": "15 schedule violations by 8 people, 4 of them early departures. The agent reads the RusGuard Soft log as your operator and blocks a pass only after you confirm.",
      "headline": "RusGuard timesheets, lateness and passes right in the chat",
      "scenarios": [
        {
          "title": "A timesheet from the pass log",
          "desc": "The agent pulls the month's passes, finds each employee's first entry and last exit of every day and puts the hours into a table."
        },
        {
          "title": "Lateness against the schedule",
          "desc": "The agent compares the first entry with the shift start of the employee's work timetable and names who came late or left early and by how much."
        },
        {
          "title": "Whose card is this",
          "desc": "The agent finds the card holder by the card number and shows their group, access levels and latest passes."
        },
        {
          "title": "A pass for a new hire",
          "desc": "The agent creates the employee in the right group, issues a card and assigns an access level, showing every step before it writes."
        },
        {
          "title": "Locking out leavers",
          "desc": "The agent finds employees by a list of personnel numbers and blocks their passage after your confirmation."
        }
      ],
      "how_it_works": [
        "The agent works with the network service of the RusGuard Soft server (LNetworkService), the same one the system's workstations connect to. The connection takes the server address and a RusGuard operator's login and password. The service answers with that operator's rights: whatever the operator cannot see in RusGuard, the agent cannot see either. The server usually sits on a local network, so requests go through your computer running the app.",
        "Timesheets and lateness are computed from the event log: the agent reads key passes for the period day by day and page by page, takes each employee's first entry and last exit per day and compares them with the shift start and end of the employee's work timetable.",
        "Issuing a pass follows the same path as the RusGuard application: the employee is created in a group, a card is issued and an access level is assigned. The agent shows every write in advance and performs it after your confirmation.",
        "Opening a door, blocking and arming change physical access on site, so the agent sends such commands only on a separate explicit request for a specific door, and only after you confirm the command in the chat."
      ],
      "requirements": [
        "RusGuard Soft with the LNetworkServer network service reachable over HTTPS",
        "A RusGuard operator with the required rights",
        "A trusted server certificate, or one confirmed by its fingerprint",
        "Network access to the RusGuard server from the computer running the app"
      ],
      "faq": [
        {
          "q": "How do I connect RusGuard?",
          "a": "Enter the RusGuard server address (for example https://rusguard.company.local, the app adds the service path itself) and a RusGuard operator's login and password."
        },
        {
          "q": "Why does the connection fail the certificate check?",
          "a": "The RusGuard service works over HTTPS only, and the app verifies the server certificate. If the certificate is self-signed, the app shows its SHA-256 fingerprint when you connect: compare it with the fingerprint on the server and confirm. From then on the connection accepts only that certificate, by IP address too. If the certificate on the server changes, a card with the new fingerprint appears in the chat: compare it and confirm."
        },
        {
          "q": "Why is the security check refused with the right password?",
          "a": "The server rejects a request when its clock is more than five minutes off the real time. Check the time on the RusGuard server."
        },
        {
          "q": "Will the agent open a door on its own?",
          "a": "No. The agent sends device commands only on your explicit request naming the door, and after confirmation."
        }
      ]
    }
  },
  {
    "key": "s7",
    "name": "Siemens S7",
    "name_en": "Siemens S7",
    "description": "ПЛК S7-300/400 по адресам STEP 7 через сервер сбора, только чтение; S7-1200/1500 через OPC UA",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "s7",
    "description_en": "Read-only S7-300/400 PLC addresses through the data collection program; S7-1200/1500 through OPC UA",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Разрешите PUT/GET на S7-1200/1500",
          "desc": "В защите ЦП в TIA Portal включите «Permit access with PUT/GET». Без этого ПЛК отклоняет чтение целиком, и подключение получает отказ доступа.",
          "title_en": "Allow PUT/GET on S7-1200/1500",
          "desc_en": "Enable «Permit access with PUT/GET» in the CPU protection in TIA Portal. Without it the PLC refuses every read and the connection gets an access denial."
        },
        {
          "title": "Выключите оптимизированный доступ к DB",
          "desc": "На S7-1200/1500 у каждого читаемого блока данных снимите «Optimized block access». Оптимизированный блок ПЛК читать по абсолютному адресу не даёт.",
          "title_en": "Turn off optimized access to the DBs",
          "desc_en": "On S7-1200/1500 clear «Optimized block access» on every data block you read. The PLC refuses absolute address reads of an optimized block."
        },
        {
          "title": "Найдите стойку и слот ЦП",
          "desc": "S7-300 стоит в слоте 2, S7-1200/1500 в слоте 1, S7-400 в слоте из конфигурации оборудования. Для LOGO! и S7-200 вместо них задаются TSAP, у LOGO! 0BA7/0BA8 это 20.00.",
          "title_en": "Find the CPU's rack and slot",
          "desc_en": "An S7-300 sits in slot 2, an S7-1200/1500 in slot 1, an S7-400 in the slot of its hardware configuration. LOGO! and S7-200 take TSAPs instead, 20.00 on LOGO! 0BA7/0BA8."
        },
        {
          "title": "Пропустите порт 102 до сервера сбора",
          "desc": "Программа сбора ходит к ПЛК по ISO-on-TCP на порт 102. Сеть между сервером сбора и ПЛК должна пропускать это соединение.",
          "title_en": "Let port 102 through to the collection server",
          "desc_en": "The data collection program reaches the PLC over ISO-on-TCP on port 102. The network between the collection server and the PLC has to let this connection through."
        },
        {
          "title": "Выпишите абсолютные адреса тегов",
          "desc": "По строке на тег: путь, адрес STEP 7 и тип, например DB1.DBD8 real или M10.1 bool. Адрес пишется без пробела, который показывает TIA: DB1.DBX5.2.",
          "title_en": "List the tags' absolute addresses",
          "desc_en": "One line per tag: a path, the STEP 7 address and a type, such as DB1.DBD8 real or M10.1 bool. Write the address without the space TIA shows: DB1.DBX5.2."
        }
      ]
    },
    "seo": {
      "title": "Siemens S7 и ИИ-агент: моточасы и пуски насоса",
      "description": "Моточасы и число пусков насоса за неделю по флагу в блоке данных S7-300/400. Адреса STEP 7 опрашивает программа сбора на объекте, S7-1200/1500 идут через OPC UA.",
      "headline": "Данные ПЛК Siemens S7 прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по пути, например line1/tank, и покажет текущие значения из блоков данных и меркеров со временем отсчёта и пометкой, свежие ли они."
        },
        {
          "title": "Сводка за смену",
          "desc": "Агент возьмёт историю температуры, давления или расхода за смену и по часам покажет минимум, максимум, среднее и последнее значение."
        },
        {
          "title": "Время работы насоса",
          "desc": "Агент заберёт сырые отсчёты флага работы, например DB1.DBX0.3, за неделю и посчитает, сколько часов насос работал и сколько раз запускался."
        },
        {
          "title": "Задача на выход за порог",
          "desc": "Агент заведёт задачу, которая запустится, когда значение тега выйдет за порог и продержится заданное время, а не на каждый отсчёт за порогом."
        },
        {
          "title": "Теги, которые ПЛК не читает",
          "desc": "Агент назовёт теги с отказом ПЛК и его кодом: адрес вне диапазона, нет такого блока данных, нет доступа, и подскажет, что поправить в карте тегов."
        },
        {
          "title": "Пропуски в данных",
          "desc": "Агент покажет промежутки истории без отсчётов и скажет, на связи ли сервер сбора объекта сейчас."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта, ходит к ПЛК по ISO-on-TCP, порт 102, и отправляет данные наружу только исходящим соединением. В подключении указываются адрес ПЛК, стойка и слот ЦП (по умолчанию 0 и 2, как у S7-300) и карта тегов: по строке на тег путь, абсолютный адрес STEP 7 и тип.",
        "Размер PDU ПЛК называет сам при каждом подключении: 240 байт у S7-300, 480 или 960 у S7-400 и S7-1500. Драйвер упаковывает запросы под этот размер: теги одной области, стоящие не дальше 5 байт друг от друга, читаются одним диапазоном, в запросе до 20 элементов, а длинная строка режется на части. Числа S7 хранит в порядке big endian, поэтому порядок байт выбирать не нужно.",
        "Драйвер только читает: он устанавливает связь и посылает чтение переменных (Read Var), записи, загрузки блоков, остановки и запуска ЦП в нём нет. Тег, который ПЛК отказался читать (адрес вне диапазона, нет блока данных, оптимизированный блок), помечается плохим со своим кодом, остальные читаются дальше. Отказ всего запроса на S7-1200/1500 значит, что в защите ЦП не разрешён PUT/GET.",
        "Программа сбора отправляет изменения значений и раз в 1800 секунд повторяет тег, который не менялся; мёртвая зона задаётся числом или процентом диапазона. Если связь с облаком рвётся, данные копятся на диске сервера сбора и приходят после восстановления. Таймеры и счётчики S7-300/400 читаются как элементы T5 и C3, а у S7-1200/1500 таймеры живут в блоке данных."
      ],
      "requirements": [
        "ПЛК S7-300/400, S7-1200/1500, S7-200 или LOGO! с доступом по сети",
        "Порт 102 открыт между ПЛК и сервером сбора",
        "На S7-1200/1500: разрешён PUT/GET в защите ЦП",
        "На S7-1200/1500: выключен оптимизированный доступ у читаемых блоков данных",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Абсолютные адреса тегов из проекта STEP 7 или TIA Portal"
      ],
      "faq": [
        {
          "q": "Как подключить Siemens S7?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Siemens S7 и укажите адрес ПЛК, например tcp://10.0.12.5:102, стойку и слот ЦП и карту тегов: по строке путь, адрес STEP 7 и тип, например line1/tank/level DB1.DBD8 real. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Siemens S7?",
          "a": "Теги из карты: блоки данных, меркеры, входы и выходы образа процесса, периферийные входы, таймеры и счётчики S7-300/400, V-память S7-200 и LOGO!. Для каждого тега агент читает текущее значение со временем отсчёта, историю интервалами и сырые отсчёты."
        },
        {
          "q": "Меняет ли агент значения в ПЛК?",
          "a": "Нет. Драйвер посылает ПЛК только установку связи и чтение переменных. Записи, загрузки блоков и команд остановки или запуска ЦП в нём нет."
        },
        {
          "q": "S7-1200 отвечает отказом доступа. Что проверить?",
          "a": "Отказ всего запроса значит, что в защите ЦП не включён «Permit access with PUT/GET». Если отказывают отдельные теги, проверьте, что у их блока данных выключен оптимизированный доступ и адрес не выходит за его конец. Символьные теги S7-1200/1500 удобнее читать через их встроенный сервер OPC UA."
        }
      ]
    },
    "seo_en": {
      "title": "Siemens S7 and an AI agent: pump run hours and starts",
      "description": "Weekly pump run hours and starts from a flag in an S7-300/400 data block. An on-site collection program polls STEP 7 addresses, read-only; S7-1200/1500 via OPC UA.",
      "headline": "Siemens S7 PLC data right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by path, such as line1/tank, and shows current values from data blocks and markers with their timestamp and whether they are fresh."
        },
        {
          "title": "Shift summary",
          "desc": "The agent takes the temperature, pressure or flow history for a shift and shows the minimum, maximum, average and last value per hour."
        },
        {
          "title": "Pump running hours",
          "desc": "The agent takes a week of raw samples of a run flag, such as DB1.DBX0.3, and counts how many hours the pump ran and how many times it started."
        },
        {
          "title": "A task on a threshold",
          "desc": "The agent sets up a task that fires when a tag goes past a threshold and stays there for a set time, not on every sample past it."
        },
        {
          "title": "Tags the PLC refuses",
          "desc": "The agent names tags the PLC refused with its code, such as address out of range, no such data block or access denied, and suggests what to fix in the tag map."
        },
        {
          "title": "Gaps in the data",
          "desc": "The agent shows history intervals without samples and says whether the site's collection server is online right now."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network, reaches the PLC over ISO-on-TCP, port 102, and sends data out over outbound connections only. The connection takes the PLC address, the CPU rack and slot (0 and 2 by default, as on an S7-300) and a tag map: one line per tag with a path, the STEP 7 absolute address and a type.",
        "The PLC names its PDU size at every connect: 240 bytes on an S7-300, 480 or 960 on an S7-400 and S7-1500. The driver packs requests to that size: tags of one area standing at most 5 bytes apart are read as one range, a request holds up to 20 items, and a long string is cut into pieces. S7 stores numbers big endian, so there is no byte order to choose.",
        "The driver only reads: it sets up communication and sends Read Var, and has no write, block download, CPU stop or start. A tag the PLC refuses (address out of range, no data block, an optimized block) is marked bad with its code while the others keep reading. A whole request refused on an S7-1200/1500 means PUT/GET is not permitted in the CPU protection.",
        "The program sends value changes and repeats a tag that has not changed every 1800 seconds; a deadband is set as a number or a percent of range. If the link to the cloud drops, data piles up on the collection server's disk and arrives once it is back. S7-300/400 timers and counters are read as elements T5 and C3, while S7-1200/1500 keeps its timers in a data block."
      ],
      "requirements": [
        "An S7-300/400, S7-1200/1500, S7-200 or LOGO! PLC reachable over the network",
        "Port 102 open between the PLC and the collection server",
        "On S7-1200/1500: PUT/GET permitted in the CPU protection",
        "On S7-1200/1500: optimized access turned off on the data blocks you read",
        "A collection server on the site network: Windows, or Linux with Docker",
        "Absolute tag addresses from the STEP 7 or TIA Portal project"
      ],
      "faq": [
        {
          "q": "How do I connect Siemens S7?",
          "a": "In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick Siemens S7 and enter the PLC address, such as tcp://10.0.12.5:102, the CPU rack and slot and a tag map: one line per tag with a path, a STEP 7 address and a type, such as line1/tank/level DB1.DBD8 real. The collection server is assigned automatically, or you pick it in the form if there are several."
        },
        {
          "q": "What does the agent see in Siemens S7?",
          "a": "The tags of the map: data blocks, markers, process image inputs and outputs, peripheral inputs, S7-300/400 timers and counters, and V memory of S7-200 and LOGO!. For each tag the agent reads the current value with its timestamp, the history in intervals and raw samples."
        },
        {
          "q": "Does the agent change values in the PLC?",
          "a": "No. The driver sends the PLC only communication setup and variable reads. It has no write, no block download and no command to stop or start the CPU."
        },
        {
          "q": "An S7-1200 answers with access denied. What should I check?",
          "a": "A whole request refused means «Permit access with PUT/GET» is not enabled in the CPU protection. If single tags are refused, check that their data block has optimized access turned off and the address does not run past its end. Symbolic tags of S7-1200/1500 are easier to read through their built-in OPC UA server."
        }
      ]
    }
  },
  {
    "key": "sberbank",
    "name": "СберБизнес",
    "name_en": "Sberbank",
    "description": "Счета, выписки, платежи, контрагенты, корпоративные карты, зарплата",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sberbank",
    "description_en": "Accounts, statements, payments, counterparties, corporate cards and payroll",
    "search_terms": [
      "сбербанк"
    ],
    "guide": {
      "url": "https://sbi.sberbank.ru",
      "steps": [
        {
          "title": "Подключите Sber API в СберБизнесе",
          "desc": "«Все продукты и услуги» → «Сбербанк API» → «Sber API» → «Подключить». Выберите права; заявление подписывает ЕИО или пользователь с доверенностью.",
          "title_en": "Enable Sber API in SberBusiness",
          "desc_en": "«Все продукты и услуги» → «Сбербанк API» → “Sber API” → «Подключить». Select rights; the sole executive or an authorized representative signs the application."
        },
        {
          "title": "Скопируйте параметры активного сервиса",
          "desc": "Активируйте сервис. Из «Параметров промышленного сервиса» заполните в форме Client ID, Client Secret и Redirect URI; сохраните scope для авторизации.",
          "title_en": "Copy the activated service settings",
          "desc_en": "Activate the service. Copy Client ID, Client Secret and Redirect URI from «Параметры промышленного сервиса» into the form; keep scope for authorization."
        },
        {
          "title": "Подготовьте сертификат и ключ в PEM",
          "desc": "В «Сертификатах шифрования» выпустите TLS для своего Client ID. Загрузите PEM-сертификат и незашифрованный PEM-ключ; из .p12 их нужно экспортировать заранее.",
          "title_en": "Prepare the PEM certificate and key",
          "desc_en": "Issue TLS for your Client ID under «Сертификаты шифрования». Upload a PEM certificate and unencrypted PEM key; export both from .p12 beforehand if needed."
        },
        {
          "title": "Пройдите авторизацию СберБизнеса",
          "desc": "На sbi.sberbank.ru:9443 откройте /ic/sso/api/v2/oauth/authorize: response_type=code, client_id, redirect_uri, scope с openid, случайные state и nonce.",
          "title_en": "Authorize access in SberBusiness",
          "desc_en": "On sbi.sberbank.ru:9443, open /ic/sso/api/v2/oauth/authorize with response_type=code, client_id, redirect_uri, scope including openid, and random state and nonce."
        },
        {
          "title": "Вставьте свежий код и подключите",
          "desc": "После авторизации скопируйте значение code из адреса Redirect URI в форму и сразу нажмите «Подключить»: код одноразовый и быстро истекает.",
          "title_en": "Paste a fresh code and connect",
          "desc_en": "After authorization, copy the code value from the Redirect URI address into the form and immediately click Connect: the code is single-use and expires quickly."
        }
      ]
    },
    "seo": {
      "title": "СберБизнес API и ИИ: сверка зарплатного реестра с ЗУП",
      "description": "Расхождения зарплатного реестра с ведомостью 1С:ЗУП видны до отправки в банк, траты по корпоративным картам разложены по сотрудникам. Доступ по OAuth.",
      "headline": "Собирайте остатки и операции по счетам СберБизнеса в чате",
      "scenarios": [
        {
          "title": "Сводка по счетам СберБизнеса",
          "desc": "Агент соберёт остатки и операции по всем счетам компании и пришлёт утреннюю сводку с крупными движениями."
        },
        {
          "title": "Выписка в разрезе контрагентов",
          "desc": "Агент разложит поступления и списания по контрагентам за период и покажет, кто платит вовремя, а кто копит долг."
        },
        {
          "title": "Сверка зарплатного проекта",
          "desc": "Агент сверит зарплатные реестры с ведомостями из 1С:ЗУП и найдёт расхождения до отправки в банк."
        },
        {
          "title": "Платёжка на подпись",
          "desc": "Агент соберёт платёжное поручение по счёту, проверит реквизиты контрагента по справочнику и подготовит документ, а подписание остаётся в СберБизнесе."
        },
        {
          "title": "Траты по корпоративным картам",
          "desc": "Агент разложит операции по корпоративным картам за месяц по сотрудникам и покажет, где расходы выбились из привычного уровня."
        },
        {
          "title": "Сверка выписки с 1С",
          "desc": "Агент сопоставит поступления из выписки с оплатами счетов в 1С и покажет по каждому контрагенту платежи, которым не нашлось документа."
        }
      ],
      "how_it_works": [
        "Агент ходит в СберБизнес API и начинает со списка счетов компании, тем же запросом, которым проверяется подключение. Дальше в работу идут выписки, платежи, справочник контрагентов, корпоративные карты и зарплатные сервисы: остатки на дату, крупные движения за сутки, поступления и списания в разрезе контрагентов за период и сверка зарплатных реестров с ведомостями из 1С:ЗУП до того, как реестр ушёл в банк.",
        "Выписка в Сбере является самым тяжёлым разделом API, и лимит на неё жёстче, чем на остальные методы. Агент это учитывает: запрашивает период порциями и держит частоту по выписке отдельно от прочих запросов, чтобы длинный отчёт не упёрся в отказ на середине. Соединение здесь тоже нестандартное (взаимный TLS): сертификат предъявляется на каждом запросе, и обрыв такой сессии агент отличает от отказа в правах, а не сваливает в общую ошибку.",
        "Платёж агент готовит, но не отправляет. Он собирает документ, проверяет реквизиты, сумму и контрагента по справочнику, показывает расхождения, а подписание остаётся в СберБизнесе и идёт по вашим правилам подписи. Без подтверждения на стороне банка платёж не уйдёт, и то же касается зарплатных реестров: агент доводит их до состояния «сверено и готово», а решение об отправке принимаете вы.",
        "Доступ выдаётся по OAuth: приложение со scope, включающим openid, обменивает код авторизации на токен и дальше обновляет его по refresh_token, так что переподключаться каждый раз не нужно. Набор разделов, куда агент вообще может зайти, задан этим же scope: счета, выписки, платежи и зарплатные сервисы включаются по отдельности. Если данных за период нет или scope не покрывает раздел, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Расчётный счёт компании в СберБизнесе.",
        "Право подписи заявления у ЕИО или пользователя с доверенностью.",
        "Client ID и Client Secret приложения из кабинета Sber API.",
        "Клиентский TLS-сертификат и его приватный ключ в формате PEM.",
        "Зарегистрированный в Сбере Redirect URI и свежий одноразовый код авторизации."
      ],
      "faq": [
        {
          "q": "Как подключается СберБизнес?",
          "a": "В разделе Интеграции укажите Client ID и Client Secret из кабинета Sber API, загрузите TLS-сертификат и его приватный ключ в формате PEM. Затем пройдите авторизацию в СберБизнесе с зарегистрированным Redirect URI, вставьте полученный одноразовый код и сохраните подключение. Код обменивается на токены, которые интеграция дальше обновляет автоматически. Доступ отзывается в кабинете банка."
        },
        {
          "q": "Что доступно агенту?",
          "a": "Счета, выписки, платежи, справочник контрагентов, корпоративные карты и зарплатные сервисы в рамках scope, выданного приложению."
        },
        {
          "q": "Может ли агент провести платёж без меня?",
          "a": "Нет. Агент готовит документы, но подписание происходит в СберБизнес по вашим правилам подписи: без подтверждения платёж не уйдёт."
        }
      ]
    },
    "seo_en": {
      "title": "Sberbank API and AI: payroll register vs 1C:ZUP check",
      "description": "The agent checks the payroll register against 1C:ZUP before it goes to the bank and splits corporate card spending by employee. Connects via OAuth.",
      "headline": "Pull SberBusiness balances and operations together in chat",
      "scenarios": [
        {
          "title": "SberBusiness account summary",
          "desc": "The agent collects balances and operations across all company accounts and sends a morning summary with the large movements."
        },
        {
          "title": "Statement broken down by counterparty",
          "desc": "The agent splits incoming and outgoing payments by counterparty for the period and shows who pays on time and who is running up debt."
        },
        {
          "title": "Payroll project reconciliation",
          "desc": "The agent reconciles payroll registers against the statements from 1C:ZUP and finds discrepancies before anything goes to the bank."
        },
        {
          "title": "A payment ready for signing",
          "desc": "The agent assembles the payment order from the invoice and checks the counterparty details against the directory, while the signing itself stays in SberBusiness."
        },
        {
          "title": "Corporate card spending",
          "desc": "The agent breaks corporate card operations for the month down by employee and shows where the spending has stepped out of its usual range."
        },
        {
          "title": "Statement against the books",
          "desc": "The agent matches incoming payments from the statement with invoice payments in 1C and shows, counterparty by counterparty, which payments have no document behind them."
        }
      ],
      "how_it_works": [
        "The agent calls the SberBusiness API and starts from the list of company accounts, the same request that verifies the connection. From there it works with statements, payments, the counterparty directory, corporate cards and payroll services: balances as of a date, large movements for the day, incoming and outgoing payments by counterparty for a period and a reconciliation of payroll registers against 1C:ZUP statements before the register goes to the bank.",
        "The statement is the heaviest section of the Sber API, and its rate limit is tighter than that of the other methods. The agent accounts for that: it requests the period in portions and holds the statement rate separately from other calls, so a long report does not hit a refusal halfway through. The connection is unusual too (mutual TLS): the certificate is presented on every request, and the agent tells a dropped session apart from a rights refusal instead of lumping both into one error.",
        "The agent prepares payments but does not send them. It assembles the document, checks the details, the amount and the counterparty against the directory and shows any discrepancies, while signing stays in SberBusiness and follows your own signature rules. Without confirmation on the bank's side no payment leaves, and the same holds for payroll registers: the agent brings them to a reconciled, ready state, and the decision to send is yours.",
        "Access is granted over OAuth: an application whose scope includes openid exchanges the authorization code for a token and refreshes it afterwards, so there is no need to reconnect every time. That same scope defines which sections the agent can reach at all: accounts, statements, payments and payroll services are switched on separately. If there is no data for the period or the scope does not cover a section, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A company settlement account in SberBusiness.",
        "An executive officer or an authorized delegate to sign the application.",
        "The Client ID and Client Secret of the application in the Sber API workspace.",
        "A client TLS certificate and its private key in PEM format.",
        "A Redirect URI registered with Sber and a fresh, single-use authorization code."
      ],
      "faq": [
        {
          "q": "How is SberBusiness connected?",
          "a": "In Integrations, enter the Client ID and Client Secret from the Sber API workspace and upload the TLS certificate and its private key in PEM format. Then authorize in SberBusiness using the registered Redirect URI, paste the single-use code and save the connection. The code is exchanged for tokens that the integration refreshes automatically. Access is revoked in the bank's workspace."
        },
        {
          "q": "What is available to the agent?",
          "a": "Accounts, statements, payments, the counterparty directory, corporate cards and payroll services, within the scope granted to the application."
        },
        {
          "q": "Can the agent make a payment without me?",
          "a": "No. The agent prepares the documents, but signing happens in SberBusiness under your signature rules; without confirmation no payment leaves."
        }
      ]
    }
  },
  {
    "key": "sbis",
    "name": "СБИС (Saby)",
    "name_en": "Saby",
    "description": "ЭДО: отправка, получение и подписание документов",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sbis",
    "short_name": "СБИС",
    "short_name_en": "Saby",
    "description_en": "Send, receive and sign electronic documents",
    "search_terms": [
      "саби"
    ],
    "guide": {
      "url": "https://online.sbis.ru",
      "steps": [
        {
          "title": "Войдите в Saby под нужным сотрудником",
          "desc": "Войдите на online.sbis.ru логином и паролем сотрудника. Агент работает с его правами и видит ровно те разделы, что открыты ему в Saby.",
          "title_en": "Sign in to Saby as the right employee",
          "desc_en": "Sign in at online.sbis.ru with the employee's login and password. The agent works with their rights and sees exactly the sections open to them in Saby."
        },
        {
          "title": "Выберите организацию и подтвердите доступ",
          "desc": "Если в профиле Saby несколько организаций, войдите в ту, чьи документы нужны агенту. Затем Saby попросит согласие на доступ к данным: подтвердите его.",
          "title_en": "Pick the company and confirm access",
          "desc_en": "If your Saby profile holds several companies, sign in to the one whose documents the agent needs. Saby then asks consent to access your data: confirm it."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для СБИС: кто из клиентов ещё не в ЭДО",
      "description": "Сверит контрагентов с ЭДО: из 78 клиентов 12 ещё не подключены. Соберёт реестр отгрузочных и покажет документы, которые встали на одном этапе.",
      "headline": "Разбирайте документы СБИС, по которым ждут вашего решения",
      "scenarios": [
        {
          "title": "Документы, ждущие подписания",
          "desc": "Агент покажет входящие документы ЭДО, по которым нужно принять решение, с контрагентом, суммой и датой поступления."
        },
        {
          "title": "Реестр исходящих отгрузочных",
          "desc": "Агент соберёт исходящие отгрузочные документы за период и назовёт те, по которым контрагент так и не ответил."
        },
        {
          "title": "Готовность контрагентов к ЭДО",
          "desc": "Агент проверит по ИНН и КПП, подключён ли контрагент к электронному документообороту, и подготовит список приглашений."
        },
        {
          "title": "Контроль сертификатов подписи",
          "desc": "Агент сверит серверные сертификаты компании и покажет, какие из них перестанут действовать раньше ближайшей отчётной даты."
        },
        {
          "title": "Где встали документы",
          "desc": "Агент пройдёт по задачам и служебным этапам документооборота и покажет, на каком шаге и у кого документ стоит дольше остальных."
        },
        {
          "title": "Пакет к отправке",
          "desc": "Агент соберёт пакет к отправке, если приложению выданы права: сохранит документ, приложит вложения и доведёт до подписи, а её ставит сотрудник или серверный сертификат компании по вашей команде."
        }
      ],
      "how_it_works": [
        "Агент обращается к сервисным методам СБИС: запрашивает списки документов с фильтром по типу и постраничной навигацией, читает вложения и состояния документооборота, свои организации и подразделения, контрагентов и приглашения, задачи и служебные этапы, сертификаты и машиночитаемые доверенности. Из этого собираются реестр исходящих отгрузочных за период и список входящего, по которому ждут вашего решения, с контрагентом, суммой и датой поступления.",
        "Выборка в СБИС всегда идёт через фильтр и страницы, поэтому «все документы за период» означает обход, а не один запрос, и агент следит, что дошёл до конца, а не выдал первую страницу за итог. Вторая особенность предметной области: обмен двусторонний, и документ не уйдёт контрагенту, который к ЭДО не подключён. Поэтому готовность второй стороны агент проверяет по ИНН и КПП заранее и готовит список приглашений.",
        "На запись агент идёт ровно настолько, насколько приложению выданы права: сохранить документ, приложить вложения, собрать пакет к отправке. С подписью граница проходит по типу ключа: квалифицированную подпись с носителя ставит человек, и здесь агент доводит документ до подписи и останавливается, а серверный сертификат компании он активирует и подписывает им сам. Запускает он это только по прямой команде: подпись юридически значима и шагом конвейера не бывает. Сроки действия серверных сертификатов агент сверяет заранее и показывает, какие заканчиваются раньше ближайшей отчётной даты.",
        "Агент работает с токеном, который Saby выдаёт после вашего входа и подтверждения доступа; если Saby его отзовёт, агент попросит войти заново, а не будет молча ошибаться. Права аккаунта ограничивают выборку на стороне сервиса: закрытый раздел возвращает отказ, а не пустой список, и агент отличает одно от другого. Частоту запросов он выдерживает сам, а если документов за период действительно нет, говорит об этом прямо."
      ],
      "requirements": [
        "Аккаунт Saby сотрудника с доступом к нужным разделам",
        "Серверный сертификат с кодом активации, если подписывает агент",
        "Квалифицированную подпись с носителя ставит человек, не агент",
        "Права на запись у вошедшего сотрудника, если агент сохраняет документы"
      ],
      "faq": [
        {
          "q": "Как подключить СБИС?",
          "a": "Кнопкой «Подключить через Saby»: войдите в свой аккаунт Saby и подтвердите доступ для приложения «Сам Решу», ключи копировать не нужно. Если вход не подходит, можно подключиться сервисным ключом своего приложения из раздела «Настройки → Безопасность → Подключения к Saby»."
        },
        {
          "q": "Что агент видит в СБИС?",
          "a": "Документы электронного документооборота с вложениями и состояниями, свои организации и подразделения, контрагентов и приглашения, задачи и служебные этапы, сертификаты и машиночитаемые доверенности."
        },
        {
          "q": "Может ли агент создавать документы?",
          "a": "Может, если приложению выданы права на запись: СБИС позволяет сохранить документ и приложить вложения. Подписать он способен только серверным сертификатом компании и только по вашей команде; квалифицированную подпись с носителя ставит человек."
        },
        {
          "q": "Как ограничить права агента?",
          "a": "Агент действует с правами сотрудника, который вошёл в Saby при подключении, и видит ровно то же, что он. Чтобы оставить агенту только документооборот, подключите Saby под сотрудником, чья роль открывает лишь эти разделы."
        }
      ]
    },
    "seo_en": {
      "title": "AI agent for Saby: which clients are still off EDI",
      "description": "Checks counterparties against EDI: 12 of 78 clients are not yet connected in Saby. Builds the shipping document register and flags documents stuck at one stage.",
      "headline": "Work through the SBIS documents waiting on your decision",
      "scenarios": [
        {
          "title": "Documents waiting for a signature",
          "desc": "The agent shows the incoming EDI documents that need a decision, with the counterparty, the amount and the date received."
        },
        {
          "title": "Register of outgoing shipping documents",
          "desc": "The agent collects outgoing shipping documents for the period and names the ones the counterparty never responded to."
        },
        {
          "title": "Counterparty readiness for EDI",
          "desc": "The agent checks by INN and KPP whether a counterparty is connected to electronic document exchange and prepares a list of invitations."
        },
        {
          "title": "Signing certificate control",
          "desc": "The agent reviews the company server certificates and shows which of them stop being valid before the nearest reporting date."
        },
        {
          "title": "Where documents got stuck",
          "desc": "The agent walks the tasks and internal document flow stages and shows at which step and with whom a document has been sitting longer than the rest."
        },
        {
          "title": "A package ready to send",
          "desc": "The agent assembles a package for sending where the application has write rights: saves the document, attaches the files and takes it up to the signature, which is put on by an employee or by the company server certificate on your command."
        }
      ],
      "how_it_works": [
        "The agent calls the SBIS service methods: it requests document lists with a type filter and page-by-page navigation, reads attachments and document flow states, your own organizations and units, counterparties and invitations, tasks and service stages, certificates and machine-readable powers of attorney. Out of that come a register of outgoing shipping documents for the period and a list of the incoming ones waiting on your decision, with the counterparty, the amount and the date received.",
        "A selection in SBIS always runs through a filter and pages, so every document for a period is a traversal rather than a single request, and the agent makes sure it reached the end instead of passing off the first page as the total. The second feature of the domain: exchange is two-sided, and a document will not reach a counterparty who is not connected to EDI. So the agent checks the other side by INN and KPP in advance and prepares a list of invitations.",
        "The agent writes exactly as far as the application has permissions to: save a document, attach files, assemble a package for sending. With signing the line runs along the key type: a qualified signature held on a token is put on by a person, and there the agent takes the document up to the signature and stops, while a company server certificate it activates and signs with itself. It starts that only on a direct command: a signature is legally binding and never a pipeline step. It reviews server certificate validity ahead of time and shows which ones run out before the nearest reporting date.",
        "The agent works with the token Saby issues after you sign in and confirm access; if Saby revokes it, the agent asks you to sign in again instead of failing silently. The account permissions narrow the selection on the service side: a closed section returns a refusal rather than an empty list, and the agent tells the two apart. It holds the request rate itself, and when there really are no documents for the period it says so directly."
      ],
      "requirements": [
        "A Saby employee account with access to the sections you need",
        "A server certificate with its activation code if the agent signs",
        "A qualified signature held on a token is put on by a person",
        "Write rights for the signed-in employee if the agent saves documents"
      ],
      "faq": [
        {
          "q": "How do I connect SBIS?",
          "a": "With the Connect via Saby button: sign in to your Saby account and confirm access for the Sam Reshu application, no keys to copy. If signing in does not suit you, connect with the service key of your own application from Settings, Security, Connections to Saby."
        },
        {
          "q": "What does the agent see in SBIS?",
          "a": "Electronic document exchange documents with attachments and states, your own organizations and units, counterparties and invitations, tasks and service stages, certificates and machine-readable powers of attorney."
        },
        {
          "q": "Can the agent create documents?",
          "a": "It can, if the application has write permissions: SBIS allows saving a document and attaching files. It can sign only with a company server certificate and only on your command; a qualified signature held on a token is put on by a person."
        },
        {
          "q": "How do I limit the agent permissions?",
          "a": "The agent acts with the rights of the employee who signed in to Saby when connecting and sees exactly what that employee sees. To leave the agent only the document exchange, connect Saby as an employee whose role opens only those sections."
        }
      ]
    }
  },
  {
    "key": "sbis_service_key",
    "name": "СБИС (Saby, сервисный ключ)",
    "name_en": "Saby (service key)",
    "description": "Подключение по сервисному ключу своего приложения в Saby, если вход через аккаунт Saby не подошёл",
    "category": "docflow",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "inside_primary",
    "has_own_page": false,
    "integration_slug": "sbis",
    "short_name": "СБИС ключ",
    "short_name_en": "Saby (service key)",
    "description_en": "Connect with your Saby app's service key when Saby account sign-in did not work",
    "variant_of": "sbis",
    "guide": {
      "url": "https://online.sbis.ru",
      "steps": [
        {
          "title": "В «Настройках» откройте «Подключения к Saby»",
          "desc": "В кабинете online.sbis.ru: «Настройки» → блок «Система» → «Безопасность» → «Подключения к Saby». Здесь живут все внешние приложения компании.",
          "title_en": "In «Настройки» open «Подключения к Saby»",
          "desc_en": "In your account at online.sbis.ru: «Настройки» → «Система» → «Безопасность» → «Подключения к Saby». The account is Russian-only."
        },
        {
          "title": "Добавьте внешнее приложение",
          "desc": "Нажмите кнопку добавления, укажите название и описание приложения, выберите тип и адрес внешней системы или IP, с которого пойдут запросы.",
          "title_en": "Add an external application",
          "desc_en": "Click the add button, enter the application name and description, pick its type and the address or IP the requests will come from."
        },
        {
          "title": "Выдайте права и сервисный ключ",
          "desc": "Права: «Разрешен полностью» либо «С ограничением по правам» с доступом к документообороту. Тип авторизации: «по сервисному ключу».",
          "title_en": "Grant rights and the service key",
          "desc_en": "Rights: «Разрешен полностью» or «С ограничением по правам» covering document flow. Authorization type must be «по сервисному ключу»."
        },
        {
          "title": "Скопируйте три значения из карточки",
          "desc": "Скопируйте «ID подключения», раскройте «Защищенный ключ» глазом и сохраните сервисный ключ в строке «с авторизацией по сервисному ключу».",
          "title_en": "Copy the three values from the card",
          "desc_en": "Copy «ID подключения», reveal «Защищенный ключ» with the eye icon and save the service key from the «с авторизацией по сервисному ключу» row."
        }
      ]
    }
  },
  {
    "key": "scan_interfax",
    "name": "СКАН Интерфакс",
    "name_en": "SCAN Interfax",
    "description": "Поиск публикаций по компаниям, медиа-аналитика, риск-факторы, мониторинг СМИ",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "scan-interfax",
    "description_en": "Publication search by company, media analytics, risk factors and press monitoring",
    "guide": {
      "url": "https://scan-interfax.ru/api-for-business-reputation/",
      "steps": [
        {
          "title": "Нажмите «Обсудить внедрение» на сайте СКАН",
          "desc": "На scan-interfax.ru раздел «API для проверки деловой репутации» → «Обсудить внедрение», либо письмо на scan-sales@interfax.ru.",
          "title_en": "Click «Обсудить внедрение» on the SCAN site",
          "desc_en": "On scan-interfax.ru open «API для проверки деловой репутации» → «Обсудить внедрение», or email scan-sales@interfax.ru."
        },
        {
          "title": "Получите логин и пароль от Интерфакса",
          "desc": "Интерфакс заводит учётную запись под интеграцию и передаёт логин и пароль. В кабинете web.scan-interfax.ru её не создать: без заявки API-учётки просто нет.",
          "title_en": "Get the login and password from Interfax",
          "desc_en": "Interfax provisions an account for the integration and hands over the login and password. You cannot create it in the web.scan-interfax.ru workspace yourself."
        },
        {
          "title": "Уточните лимиты тарифа у менеджера",
          "desc": "Спросите у менеджера, безлимитный ли тариф или счёт в поисковых термах и какой лимит компаний на мониторингах. На исчерпанном балансе поиск перестаёт отвечать.",
          "title_en": "Ask the manager about the tariff limits",
          "desc_en": "Ask the manager whether the plan is unlimited or metered in search terms, and what the cap on monitored companies is. An empty balance stops search."
        },
        {
          "title": "Проверьте пару в публичном Swagger СКАН",
          "desc": "Откройте https://gateway.scan-interfax.ru/index.html и вызовите POST /api/v1/account/login: придёт accessToken, если доступ активирован, иначе 401.",
          "title_en": "Verify the pair in the public SCAN Swagger",
          "desc_en": "Open https://gateway.scan-interfax.ru/index.html and call POST /api/v1/account/login: accessToken in the response means access is live, a 401 means it is not."
        }
      ]
    },
    "seo": {
      "title": "СКАН Интерфакс и ИИ-агент: риски поставщиков по ИНН",
      "description": "СКАН-Интерфакс (SCAN Interfax) проверит поставщиков по ИНН и назовёт, кого брать нельзя: иски, уголовные дела, рейтинг рисков, публикации. Вход по API-логину.",
      "headline": "Собирайте публикации о компании и конкурентах в чате",
      "scenarios": [
        {
          "title": "Публикации о компании и конкурентах",
          "desc": "Агент соберёт публикации по компании за период, разложит их по месяцам и источникам и покажет тональность и заметность материалов."
        },
        {
          "title": "Риск-факторы контрагентов",
          "desc": "Агент проверит список компаний по ИНН и подсветит уголовные дела, иски, долги и корпоративные действия вместе с интегральным рейтингом рисков."
        },
        {
          "title": "Мониторинг репутации по расписанию",
          "desc": "Агент пройдёт по фильтрам мониторинга, соберёт новые критичные упоминания по портфелю компаний и пришлёт их в чат без ручных выгрузок."
        },
        {
          "title": "Аналитика информационного поля",
          "desc": "Агент разложит публикации по темам, персонам и компаниям и покажет, вокруг чего строится повестка отрасли за выбранный период."
        },
        {
          "title": "Досье перед переговорами",
          "desc": "Агент соберёт по ИНН карточку контрагента, свежие публикации и риск-факторы и оставит рядом с каждым фактором исходную публикацию и дату."
        },
        {
          "title": "Остаток по тарифу",
          "desc": "Агент посмотрит учётную запись СКАНа и скажет, сколько поисковых термов осталось по договору и сколько компаний ещё можно поставить на мониторинг."
        }
      ],
      "how_it_works": [
        "Агент работает со СКАНом через шлюз Интерфакса: находит карточки компаний по ИНН, собирает публикации о них за период, строит гистограммы по месяцам и источникам, раскладывает материалы по темам, персонам и тональности и снимает интегральный рейтинг рисков вместе с уголовными делами, исками, долгами и корпоративными действиями. Отдельно он читает события фильтров мониторинга, заведённых в кабинете.",
        "Компания в СКАНе опознаётся по ИНН, а не по названию, и это меняет качество выборки: агент сначала получает карточку по ИНН, а уже к ней подтягивает публикации, поэтому однофамильцы и тёзки бренда в отчёт не попадают. Сами фильтры мониторинга живут в кабинете и настраиваются там же: агент их не переписывает, а читает то, что они уже отобрали, и приносит новые критичные упоминания в чат.",
        "На запись агент здесь не выходит: он ищет компании и публикации и собирает риск-отчёты, не трогая мониторинги, фильтры и настройки учётной записи. Рейтинг рисков он подаёт как сигнал по информационному полю, а не как юридический вывод: рядом с каждым фактором остаются исходные публикации и даты, чтобы решение принималось по первоисточнику, а не по одной цифре.",
        "Bearer-токен агент получает и обновляет сам, частоту запросов держит в рамках, а длинные выдачи забирает страницами, а не одним вызовом. Объём выборки ограничен тарифом договора, и на исчерпанном балансе поиск перестаёт возвращать данные, и агент назовёт эту причину, а не выдаст пустой отчёт за отсутствие упоминаний. Глубина архива и состав источников тоже заданы договором, поэтому агент показывает, за какой период собрана выборка."
      ],
      "requirements": [
        "Юрлицо или ИП: API СКАН продаётся по договору",
        "Действующий договор с остатком по тарифу",
        "Контактное лицо, которое ведёт договор с Интерфаксом"
      ],
      "faq": [
        {
          "q": "Как подключить СКАН Интерфакс?",
          "a": "Логином и паролем API-учётной записи: её заводит Интерфакс по заявке через форму на scan-interfax.ru или письмом в отдел продаж. В веб-кабинете такую учётку не создать, а bearer-токен агент получает по этой паре сам."
        },
        {
          "q": "Что агент видит в СКАН?",
          "a": "Карточки компаний по ИНН, публикации о них за период, гистограммы по месяцам, аналитику по темам, персонам и тональности, интегральный рейтинг рисков и события фильтров мониторинга."
        },
        {
          "q": "Пишет ли агент в СКАН?",
          "a": "Нет. Доступ используется на чтение: агент ищет компании и публикации и собирает риск-отчёты, не меняя мониторинги, фильтры и настройки учётной записи."
        },
        {
          "q": "Есть ли ограничения по объёму?",
          "a": "Да, и они зависят от договора: тариф считается в поисковых термах либо бывает безлимитным, отдельно ограничено число компаний на мониторингах. На исчерпанном балансе поиск перестаёт возвращать данные."
        }
      ]
    },
    "seo_en": {
      "title": "SCAN Interfax AI agent: supplier risk check by INN",
      "description": "Screens a list of suppliers by INN and flags the ones to avoid: lawsuits, criminal cases, risk rating; charts press coverage by month. Signs in with an API login.",
      "headline": "Collect coverage of your company and rivals in the chat",
      "scenarios": [
        {
          "title": "Publications about your company and rivals",
          "desc": "The agent collects publications about a company for the period, breaks them down by month and source and shows the sentiment and prominence of the coverage."
        },
        {
          "title": "Counterparty risk factors",
          "desc": "The agent checks a list of companies by INN and highlights criminal cases, lawsuits, debts and corporate actions alongside an integral risk rating."
        },
        {
          "title": "Scheduled reputation monitoring",
          "desc": "The agent walks through the monitoring filters, gathers new critical mentions across your portfolio of companies and sends them to the chat with no manual exports."
        },
        {
          "title": "Analytics of the information field",
          "desc": "The agent breaks publications down by topic, person and company and shows what the industry agenda is built around over the period you pick."
        },
        {
          "title": "A dossier before a negotiation",
          "desc": "The agent pulls a counterparty card by INN, recent coverage and risk factors, keeping the source publication and its date next to every factor."
        },
        {
          "title": "What is left on the plan",
          "desc": "The agent looks into the SCAN account and tells you how many search terms the contract has left and how many more companies can go under monitoring."
        }
      ],
      "how_it_works": [
        "The agent works with SCAN through the Interfax gateway: it finds company cards by INN, collects publications about them for a period, builds histograms by month and source, breaks the material down by topic, person and sentiment and takes the integral risk rating along with criminal cases, lawsuits, debts and corporate actions. Separately it reads the events of the monitoring filters set up in the workspace.",
        "A company in SCAN is identified by INN rather than by name, and that changes the quality of the selection: the agent first gets the card by INN and only then pulls publications onto it, so namesakes and brand lookalikes never reach the report. The monitoring filters themselves live in the workspace and are configured there: the agent does not rewrite them, it reads what they have already selected and brings the new critical mentions into the chat.",
        "The agent never writes here: it searches companies and publications and assembles risk reports without touching monitorings, filters or account settings. It presents the risk rating as a signal from the information field, not as a legal conclusion: the source publications and dates stay next to every factor, so the decision is made on the primary source rather than on a single number.",
        "The agent obtains and refreshes the bearer token itself, keeps the request rate within bounds and collects long result sets page by page rather than in one call. The size of a selection is capped by the contract plan, and once the balance is spent search stops returning data, and the agent names that reason instead of passing an empty report off as an absence of mentions. Archive depth and the set of sources are set by the contract too, so the agent states the period a selection covers."
      ],
      "requirements": [
        "A company or sole trader: the SCAN API is sold under a contract",
        "A valid contract with balance left on the plan",
        "A contact person who handles the Interfax contract"
      ],
      "faq": [
        {
          "q": "How do I connect SCAN Interfax?",
          "a": "With the login and password of an API account: Interfax creates it on request through the form on scan-interfax.ru or by e-mail to the sales team. Such an account cannot be created in the web workspace, and the agent obtains the bearer token from that pair itself."
        },
        {
          "q": "What does the agent see in SCAN?",
          "a": "Company cards by INN, publications about them for a period, monthly histograms, analytics by topic, person and sentiment, the integral risk rating and events from monitoring filters."
        },
        {
          "q": "Does the agent write to SCAN?",
          "a": "No. Access is read-only: the agent searches companies and publications and assembles risk reports without changing monitorings, filters or account settings."
        },
        {
          "q": "Are there limits on volume?",
          "a": "Yes, and they depend on the contract: a plan is counted in search terms or can be unlimited, with a separate cap on the number of companies under monitoring. Once the balance is spent, search stops returning data."
        }
      ]
    }
  },
  {
    "key": "sendsay",
    "name": "Sendsay",
    "name_en": "Sendsay",
    "description": "Email-маркетинг: рассылки, подписчики, сегменты, шаблоны, триггеры, A/B-тесты",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sendsay",
    "description_en": "Email marketing: campaigns, subscribers, segments, templates, triggers and A/B tests",
    "search_terms": [
      "сендсей"
    ],
    "guide": {
      "url": "https://app.sendsay.ru",
      "steps": [
        {
          "title": "В «Пользователях» добавьте саблогин",
          "desc": "Меню аккаунта → «Настройки системы» → «Пользователи» → «Добавить пользователя»: имя, логин, email, пароль. Владельцу аккаунта API-ключ не выдаётся.",
          "title_en": "In «Пользователи» add a sublogin",
          "desc_en": "Account menu → «Настройки системы» → «Пользователи» → «Добавить пользователя»: name, login, email, password. The account owner cannot be issued an API key."
        },
        {
          "title": "Дайте роль «Менеджер» без 2FA",
          "desc": "Роль «Менеджер» покрывает подписчиков, рассылки и автоматизации. Двухфакторную авторизацию на этом саблогине не включайте: с ней запросы по ключу не идут.",
          "title_en": "Give the «Менеджер» role, leave 2FA off",
          "desc_en": "The «Менеджер» role covers subscribers, campaigns and automations. Never enable two-factor auth on this sublogin, or requests with the key stop working."
        },
        {
          "title": "В «Настройке пользователя» создайте API-ключ",
          "desc": "Карточка пользователя → вкладка «Настройка пользователя» → «API-ключ» → «Сгенерировать ключ». Ключ показывается один раз, скопируйте сразу.",
          "title_en": "In «Настройка пользователя» generate the key",
          "desc_en": "User card → «Настройка пользователя» tab → «API-ключ» → «Сгенерировать ключ». The key is shown once: copy it immediately, a lost key can only be replaced."
        },
        {
          "title": "Запишите основной логин из меню аккаунта",
          "desc": "Имя аккаунта это основной логин, под которым создавали саблогин; он виден в меню аккаунта и подставляется в адрес API. Логин саблогина сюда не подходит.",
          "title_en": "Note the main login from the account menu",
          "desc_en": "The account name is the main login shown in the account menu, not the sublogin's login. It is what goes into the API address."
        }
      ]
    },
    "seo": {
      "title": "Sendsay API: разбор вчерашней рассылки по открытиям",
      "description": "Расскажет, как прошла вчерашняя рассылка в Sendsay: доставки, открытия и клики, и какая часть базы подписчиков ещё активна. Нужны имя аккаунта и API-ключ саблогина.",
      "headline": "Разбирайте рассылки Sendsay по открытиям и кликам в чате",
      "scenarios": [
        {
          "title": "Разбор последней рассылки",
          "desc": "Агент разложит выпуск по доставкам, открытиям, кликам и отпискам и покажет, какие письма и ссылки сработали, а какие нет."
        },
        {
          "title": "Порядок в базе подписчиков",
          "desc": "Агент сверит группы и сегменты, найдёт отписавшихся и давно неактивных и обновит карточки подписчиков по вашим данным."
        },
        {
          "title": "Подготовка выпуска и A/B-теста",
          "desc": "Агент соберёт выпуск из шаблона, отправит тестовое письмо на проверку и покажет результаты сплит-теста после отправки."
        },
        {
          "title": "Еженедельная сводка по рассылкам",
          "desc": "Агент пришлёт по расписанию сводку: доставляемость, активность подписчиков и рост базы за неделю в сравнении с прошлой."
        },
        {
          "title": "Проверка триггерных сценариев",
          "desc": "Агент пройдёт по триггерным сценариям, покажет, сколько писем ушло по каждому и как их открывают, и выделит те, что давно не срабатывали."
        },
        {
          "title": "Сравнение выпусков за период",
          "desc": "Агент сведёт статистику всех выпусков за квартал в одну таблицу, сравнит открытия, клики и отписки и покажет, какие темы и дни отправки работают лучше."
        }
      ],
      "how_it_works": [
        "Агент обращается к Sendsay по единому JSON-адресу https://api.sendsay.ru/general/api/v100/json: имя действия и ключ уходят в теле запроса, отдельных ручек под каждый раздел здесь нет. Через него он читает подписчиков и их поля, группы и сегменты, выпуски и шаблоны, триггерные сценарии и статистику доставок, открытий, кликов, отписок и возвратов, а из этого собирает разбор выпуска и динамику базы за период.",
        "Статистика рассылки не окончательна в момент отправки: доставки, открытия и клики продолжают дописываться часами и днями после выпуска, поэтому агент называет период, за который снял цифры, и не выдаёт свежий выпуск за подведённый итог. Отписки и возвраты он смотрит отдельно от открытий: по ним видно не оформление письма, а состояние базы, и именно они объясняют, почему доставляемость падает от выпуска к выпуску.",
        "На запись агент обновляет карточки подписчиков и состав групп, собирает выпуск из шаблона и готовит A/B-тест. Порядок здесь один: сначала тестовое письмо на проверку, и только по вашему явному подтверждению идёт отправка на живую базу. Сам он рассылку не запускает. Перед отправкой агент называет сегмент, на который уходит выпуск, и число адресов в нём, потому что отозвать ушедшее письмо уже нельзя.",
        "Все вызовы идут одним JSON-адресом, поэтому границу задаёт не набор ручек, а имя действия в теле запроса: список подписчиков, выгрузка статистики и запуск выпуска отличаются только им. Тяжёлые выборки сервис отдаёт отложенной задачей: агент ставит её в очередь и забирает результат, когда он готов, а не ждёт всё одним ответом. Частоту он держит в пределах десяти запросов в секунду, а при нехватке данных или прав говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Аккаунт Sendsay и доступ владельца к настройкам системы",
        "Свободный слот пользователя в тарифе",
        "Отдельный почтовый ящик для приглашения саблогина"
      ],
      "faq": [
        {
          "q": "Как подключить Sendsay?",
          "a": "Именем аккаунта и API-ключом: заведите отдельный саблогин в «Настройки системы» → «Пользователи» (владельцу аккаунта ключ не выдаётся) и в его карточке на вкладке «Настройка пользователя» нажмите «Сгенерировать ключ». Имя аккаунта: основной логин."
        },
        {
          "q": "Что агент видит в Sendsay?",
          "a": "Подписчиков и их поля, группы и сегменты, выпуски и шаблоны, триггерные сценарии и статистику доставок, открытий, кликов, отписок и возвратов."
        },
        {
          "q": "Пишет ли агент в Sendsay?",
          "a": "Может: обновлять карточки подписчиков и состав групп, собирать выпуски, отправлять тестовые письма и запускать рассылку. Отправку агент делает по вашему явному подтверждению, а не сам."
        },
        {
          "q": "Почему ключ не работает?",
          "a": "Чаще всего на саблогине включена двухфакторная авторизация, а с ней запросы по ключу не выполняются. Второй случай: в поле аккаунта указан логин саблогина вместо основного логина."
        }
      ]
    },
    "seo_en": {
      "title": "Sendsay API agent: yesterday's campaign by opens and clicks",
      "description": "Reports how yesterday's Sendsay campaign did on deliveries, opens and clicks and how much of the subscriber base is still active. Needs a sublogin API key.",
      "headline": "Break down Sendsay campaigns by opens and clicks in chat",
      "scenarios": [
        {
          "title": "Breakdown of the latest campaign",
          "desc": "The agent splits an issue by deliveries, opens, clicks and unsubscribes and shows which emails and links worked and which did not."
        },
        {
          "title": "Order in the subscriber base",
          "desc": "The agent reviews groups and segments, finds unsubscribed and long-inactive contacts and updates subscriber records from your data."
        },
        {
          "title": "Preparing an issue and an A/B test",
          "desc": "The agent assembles an issue from a template, sends a test email for review and shows the split test results once it has gone out."
        },
        {
          "title": "Weekly campaign summary",
          "desc": "On a schedule the agent sends a summary: deliverability, subscriber activity and growth of the base for the week against the previous one."
        },
        {
          "title": "Check on trigger scenarios",
          "desc": "The agent walks through the trigger scenarios, shows how many emails each one sent and how they were opened, and flags the ones that have long gone quiet."
        },
        {
          "title": "Compare issues over a period",
          "desc": "The agent pulls the statistics of every issue in the quarter into one table, compares opens, clicks and unsubscribes and shows which subjects and send days work best."
        }
      ],
      "how_it_works": [
        "The agent calls Sendsay at a single JSON address, https://api.sendsay.ru/general/api/v100/json: the action name and the key travel in the request body, and there are no separate endpoints per section here. Through it the agent reads subscribers and their fields, groups and segments, issues and templates, trigger scenarios and statistics on deliveries, opens, clicks, unsubscribes and bounces, and out of that assembles the breakdown of an issue and the dynamics of the base over a period.",
        "Campaign statistics are not final at the moment of sending: deliveries, opens and clicks keep being written in for hours and days after an issue, so the agent states the period the figures were taken for and does not pass a fresh issue off as a settled result. Unsubscribes and bounces it looks at separately from opens: they show not the design of the email but the state of the base, and they are what explains why deliverability drops from issue to issue.",
        "On the write side the agent updates subscriber records and group membership, assembles an issue from a template and prepares an A/B test. The order here is always the same: first a test email for review, and only on your explicit confirmation a send to the live base; it never launches a campaign on its own. Before sending, the agent names the segment the issue goes to and the number of addresses in it, because an email that has gone out cannot be recalled.",
        "Every call goes to a single JSON address, so the boundary is set not by a set of endpoints but by the action name in the request body: listing subscribers, exporting statistics and launching an issue differ only by that. Heavy selections come back as a deferred task: the agent queues it and picks the result up when it is ready instead of waiting for everything in one response. It holds the rate within ten requests per second, and when data or permissions fall short it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A Sendsay account with owner access to system settings",
        "A free user slot on your plan",
        "A separate mailbox for the sublogin invite"
      ],
      "faq": [
        {
          "q": "How do I connect Sendsay?",
          "a": "With the account name and an API key: create a separate sublogin under System settings, Users (the account owner is not issued a key), and in its card, on the User setup tab, click Generate key. The account name is the main login."
        },
        {
          "q": "What does the agent see in Sendsay?",
          "a": "Subscribers and their fields, groups and segments, issues and templates, trigger scenarios and statistics on deliveries, opens, clicks, unsubscribes and bounces."
        },
        {
          "q": "Does the agent write to Sendsay?",
          "a": "It can: update subscriber records and group membership, assemble issues, send test emails and launch a campaign. The agent sends only on your explicit confirmation, never on its own."
        },
        {
          "q": "Why is the key not working?",
          "a": "Most often two-factor authorization is enabled on the sublogin, and requests by key do not run while it is on. The second case: the account field holds the sublogin instead of the main login."
        }
      ]
    }
  },
  {
    "key": "sigur",
    "name": "Sigur (СКУД)",
    "name_en": "Sigur Access Control",
    "description": "Кто на объекте, отказы в проходе, пропуска",
    "category": "hr",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sigur",
    "short_name": "Sigur",
    "short_name_en": "Sigur Access Control",
    "description_en": "Who is on site, denied entries and passes",
    "search_terms": [
      "сигур",
      "скуд",
      "контроль доступа",
      "проходная",
      "турникет",
      "пропуск",
      "журнал проходов",
      "табель"
    ],
    "far_end_rule": "user_host",
    "guide": {
      "url": "https://sigur.com/doc/Public_REST_API_Developers_Guide.pdf",
      "steps": [
        {
          "title": "Включите REST API на сервере Sigur",
          "desc": "«Управление сервером» → «Порты» → «Использовать REST API», порт 9500, затем «Применить» и перезапуск сервера. Нужна лицензия REST API: Pro, Enterprise или модуль Web.",
          "title_en": "Enable the REST API on the Sigur server",
          "desc_en": "Server management → Ports → Use REST API, port 9500, then Apply and restart the server module. A REST API licence is required: Pro, Enterprise or the Web module."
        },
        {
          "title": "Заведите оператора для интеграции",
          "desc": "В программе «Клиент» на вкладке «Персонал» дайте сотруднику права оператора, отметьте «Доступ по REST API (Интеграции)» и задайте логин и пароль.",
          "title_en": "Create an operator for the integration",
          "desc_en": "In the Client program on the Personnel tab give an employee operator rights, check REST API access (Integrations) and set a login and password."
        },
        {
          "title": "Проверьте адрес и HTTPS",
          "desc": "Адрес вида http://192.168.0.10:9500. С включённым «Использовать TLS» адрес начинается с https, а сертификат сервера должен проверяться на компьютере с приложением.",
          "title_en": "Check the address and HTTPS",
          "desc_en": "An address like http://192.168.0.10:9500. If Use TLS is enabled, the address starts with https and the server certificate has to validate on the computer running the app."
        },
        {
          "title": "Вставьте адрес, логин и пароль",
          "desc": "Запустите приложение на компьютере в сети сервера Sigur: запросы к серверу в локальной сети идут через него.",
          "title_en": "Paste the address, login and password",
          "desc_en": "Run the app on a computer on the Sigur server network: requests to a server on the local network go through it."
        }
      ]
    },
    "seo": {
      "title": "СКУД Sigur и ИИ-агент: отказы в проходе за вчера",
      "description": "Кто вчера не прошёл через турникет: 14 отказов у 6 карт. Агент разбирает журнал Sigur через Public REST API сервера, даже если сервер стоит в локальной сети.",
      "headline": "Журнал проходов и пропуска Sigur прямо в чате",
      "scenarios": [
        {
          "title": "Табель и опоздания",
          "desc": "Агент соберёт проходы за период, найдёт по каждому сотруднику первый вход и последний выход за день и сравнит их с началом смены."
        },
        {
          "title": "Кто сейчас на объекте",
          "desc": "Агент прочитает последнюю зону каждого сотрудника и покажет, кто внутри, по отделам и зонам."
        },
        {
          "title": "Отказы в проходе",
          "desc": "Агент разберёт отказы по причинам: истёкший ключ, нет доступа к двери, повторный проход, и назовёт сотрудников и точки, где они повторяются."
        },
        {
          "title": "Пропуск новому сотруднику",
          "desc": "Агент заведёт сотрудника в отделе, выдаст свободную карту и назначит режим доступа, показав перед записью, что именно изменится."
        },
        {
          "title": "Ревизия карт и режимов",
          "desc": "Агент найдёт заблокированных сотрудников с выданными картами, карты без владельца и сотрудников без режима доступа."
        },
        {
          "title": "Тревоги и состояние оборудования",
          "desc": "Агент соберёт вскрытия корпусов, потерю связи с точками доступа и переходы на батарею за период."
        }
      ],
      "how_it_works": [
        "Агент работает с Public REST API сервера Sigur: в подключении указывается адрес сервера с портом (по умолчанию 9500), логин и пароль оператора. Сервер обычно стоит в локальной сети, поэтому запросы идут через ваш компьютер с запущенным приложением. Сервер отвечает с правами этого оператора.",
        "Для табеля агент читает разобранный журнал событий: проходы с сотрудником, точкой, направлением и зоной. Время запрашивается с часовым поясом сервера, а журнал читается порциями до 3000 событий, поэтому период в несколько месяцев собирается целиком.",
        "Запись в Sigur меняет физический доступ людей: выдача карты, идентификатора, гостевого пропуска или режима открывает двери. Агент собирает такие изменения как черновик, показывает человека, карту и срок и выполняет их только после подтверждения. Открыть дверь или снять зону с охраны через этот API нельзя."
      ],
      "requirements": [
        "Лицензия REST API: пакет Pro или Enterprise либо модуль «Лицензии Web: REST API»",
        "Оператор с правом «Доступ по REST API (Интеграции)»",
        "Сетевой доступ к серверу Sigur с компьютера, где запущено приложение"
      ],
      "faq": [
        {
          "q": "Как подключить Sigur?",
          "a": "Включите «Использовать REST API» на вкладке «Порты» программы «Управление сервером», дайте сотруднику права оператора с галочкой «Доступ по REST API (Интеграции)» и задайте ему логин и пароль. В подключении укажите адрес сервера с портом, например http://192.168.0.10:9500, и эти логин с паролем."
        },
        {
          "q": "Что агент видит в Sigur?",
          "a": "Отделы, должности, сотрудников, карты и виртуальные идентификаторы, служебный транспорт, гостей и гостевые карты, режимы доступа, точки доступа и зоны, операторов и роли, а также журнал событий в кратком и разобранном виде."
        },
        {
          "q": "Меняет ли агент доступ?",
          "a": "Только по вашему подтверждению: заводит сотрудников, выдаёт и изымает карты и идентификаторы, назначает режимы. Перед каждой такой записью агент показывает, что изменится. Команд открытия дверей в API нет."
        },
        {
          "q": "Сервер работает по HTTPS. Что учесть?",
          "a": "Если на сервере включено шифрование TLS, указывайте адрес с https. Сертификат сервера должен проверяться на компьютере, через который идут запросы; при взаимной аутентификации нужен ещё и сертификат внешней системы."
        }
      ]
    },
    "seo_en": {
      "title": "Sigur Access Control and AI agent: denied entries",
      "description": "Who could not get through yesterday: 14 denied entries on 6 cards. The agent reads the Sigur log over the server's Public REST API, even on a local network.",
      "headline": "Sigur passage log and badges right in the chat",
      "scenarios": [
        {
          "title": "Timesheets and late arrivals",
          "desc": "The agent collects passages for a period, finds each employee's first entry and last exit per day and compares them with the start of the shift."
        },
        {
          "title": "Who is on site now",
          "desc": "The agent reads each employee's last zone and shows who is inside, by department and zone."
        },
        {
          "title": "Denied passages",
          "desc": "The agent breaks denials down by reason, such as an expired key, no access to the door or anti-passback, and names the employees and points where they repeat."
        },
        {
          "title": "A badge for a new hire",
          "desc": "The agent creates the employee in a department, issues a free card and assigns an access rule, showing what will change before writing."
        },
        {
          "title": "Card and access rule audit",
          "desc": "The agent finds blocked employees who still hold cards, cards without a holder and employees without an access rule."
        },
        {
          "title": "Alarms and equipment state",
          "desc": "The agent collects controller case openings, lost connections to access points and switches to battery power for a period."
        }
      ],
      "how_it_works": [
        "The agent works with the Sigur server Public REST API: the connection takes the server address with its port (9500 by default) and an operator login and password. The server usually sits on the local network, so requests go through your computer with the app running. The server answers with that operator's rights.",
        "For timesheets the agent reads the parsed event log: passages with the employee, access point, direction and zone. Time is requested with the server time zone, and the log is read in batches of up to 3000 events, so a period of several months is collected in full.",
        "Writing to Sigur changes people's physical access: issuing a card, an identifier, a guest badge or an access rule opens doors. The agent prepares such changes as a draft, shows the person, the card and the period, and applies them only after confirmation. Opening a door or disarming a zone is not possible through this API."
      ],
      "requirements": [
        "A REST API licence: Pro, Enterprise or the Web licences: REST API module",
        "An operator with the REST API access (Integrations) right",
        "Network access to the Sigur server from the computer running the app"
      ],
      "faq": [
        {
          "q": "How do I connect Sigur?",
          "a": "Enable Use REST API on the Ports tab of the Server management program, give an employee operator rights with REST API access (Integrations) checked and set their login and password. In the connection enter the server address with its port, for example http://192.168.0.10:9500, and that login and password."
        },
        {
          "q": "What does the agent see in Sigur?",
          "a": "Departments, positions, employees, cards and virtual identifiers, official vehicles, guests and guest cards, access rules, access points and zones, operators and roles, plus the event log in short and parsed form."
        },
        {
          "q": "Does the agent change access?",
          "a": "Only with your confirmation: it creates employees, issues and withdraws cards and identifiers and assigns access rules. Before each such write the agent shows what will change. The API has no door opening commands."
        },
        {
          "q": "The server runs over HTTPS. What should I know?",
          "a": "If TLS is enabled on the server, use an https address. The server certificate has to validate on the computer the requests go through; with mutual authentication the external system also needs its own certificate."
        }
      ]
    }
  },
  {
    "key": "sipuni",
    "name": "Sipuni",
    "name_en": "Sipuni",
    "description": "IP-телефония: история и пропущенные звонки, записи разговоров, статусы сотрудников",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sipuni",
    "description_en": "IP telephony: call history and missed calls, recordings and employee statuses",
    "search_terms": [
      "сипуни"
    ],
    "signup_url": "https://lk.sipuni.com/registration",
    "guide": {
      "url": "https://sipuni.com",
      "steps": [
        {
          "title": "Войдите в свой кабинет Sipuni",
          "desc": "Откройте кабинет компании, в котором подключали услугу API. Номер кабинета и ключ интеграции должны принадлежать одному аккаунту.",
          "title_en": "Sign in to your Sipuni account",
          "desc_en": "Open the company account where the API service was activated. The account number and integration key must belong to the same account."
        },
        {
          "title": "Подключите API статистики",
          "desc": "В старом кабинете: «Настройки» → «API» → «Статистика» → «Подключить услугу». В новом: «Интеграции» → «Интеграция по API» → «Статистика».",
          "title_en": "Activate the statistics API service",
          "desc_en": "Old cabinet: «Настройки» → «API» → «Статистика» → «Подключить услугу». New cabinet: «Интеграции» → «Интеграция по API» → «Статистика»."
        },
        {
          "title": "Скопируйте ключ интеграции",
          "desc": "Откройте «Настройки» → «Интеграция по API»; в старом кабинете: «Настройки» → «API». Если ключа нет, нажмите «Сгенерировать» и «Сохранить».",
          "title_en": "Copy the integration key",
          "desc_en": "Open «Настройки» → «Интеграция по API»; in the old cabinet: «Настройки» → «API». If no key exists, click «Сгенерировать», then «Сохранить»."
        },
        {
          "title": "Запишите номер кабинета с нулями",
          "desc": "Номер кабинета показан в правом верхнем углу. Переносите его целиком, вместе с начальными нулями: без них подпись запроса не сойдётся.",
          "title_en": "Note the account number with its zeroes",
          "desc_en": "The account number is shown in the top right corner. Copy it whole, leading zeroes included: without them the request signature does not match."
        }
      ]
    },
    "seo": {
      "title": "Сипуни (Sipuni) и ИИ: пропущенные без личного кабинета",
      "description": "Сипуни без входа в личный кабинет: агент покажет пропущенные входящие за вчера, историю звонков и разбор записи разговора. Ключ из раздела «Интеграция по API».",
      "headline": "Разбирайте звонки и записи разговоров Sipuni",
      "scenarios": [
        {
          "title": "Пропущенные за период",
          "desc": "Агент выгрузит входящие пропущенные звонки за выбранные даты и покажет список обращений."
        },
        {
          "title": "История по номеру",
          "desc": "Агент найдёт звонки по номеру клиента, добавочному сотрудника или схеме обработки."
        },
        {
          "title": "Разбор записи разговора",
          "desc": "Агент скачает запись по её ID из выгрузки и подготовит аудиофайл для расшифровки и анализа."
        },
        {
          "title": "Статусы сотрудников",
          "desc": "Агент получит список сотрудников и их текущие статусы присутствия."
        }
      ],
      "how_it_works": [
        "Подключение использует номер кабинета Sipuni и ключ интеграции. Запросы подписываются на сервере. Навык разбирает выгрузку CSV, сохраняя исходные названия колонок, номера телефонов и ID записей как текст.",
        "Историю можно ограничить датами, направлением и статусом звонка, номерами и схемой. Записи разговоров скачиваются отдельно по ID из выгрузки. Длинный период агент разбивает по дням, а список записей читает страницами. Если выгрузка остановлена до конца, он указывает, какая часть данных получена и откуда её продолжить."
      ],
      "requirements": [
        "Номер кабинета Sipuni и ключ из раздела «Интеграция по API»",
        "Услуга API статистики, подключённая в этом кабинете (подходит и старый кабинет)"
      ],
      "faq": [
        {
          "q": "Где получить ключ?",
          "a": "В кабинете Sipuni откройте «Настройки» → «Интеграция по API»; в старом кабинете: «Настройки» → «API». Скопируйте сохранённый ключ. Если его нет, нажмите «Сгенерировать» и «Сохранить». Также нужен номер того же кабинета, включая начальные нули."
        },
        {
          "q": "Что означает Service not connected?",
          "a": "Sipuni сообщает, что услуга не подключена для этого кабинета. В старом кабинете откройте «Настройки» → «API» → «Статистика» → «Подключить услугу». Если услуга уже подключена, попросите поддержку Sipuni проверить её привязку к вашему номеру кабинета. Этот ответ не подтверждает и не опровергает правильность ключа."
        },
        {
          "q": "Можно ли звонить или отправлять SMS?",
          "a": "Эта интеграция работает с историей, записями и статусами сотрудников. Управление звонками и отправка SMS в неё не входят."
        }
      ]
    },
    "seo_en": {
      "title": "Sipuni AI agent: missed calls without the dashboard",
      "description": "Shows who went unanswered yesterday: missed inbound calls by number, call history and a review of a call recording. The key is in the API integration settings.",
      "headline": "Review Sipuni calls and recordings",
      "scenarios": [
        {
          "title": "Missed calls over a period",
          "desc": "The agent exports missed incoming calls for the selected dates and shows the list of calls."
        },
        {
          "title": "History by phone number",
          "desc": "The agent finds calls by customer number, employee extension or call routing scheme."
        },
        {
          "title": "Review a conversation",
          "desc": "The agent downloads a recording using its ID from the export and prepares the audio for transcription and analysis."
        },
        {
          "title": "Employee presence",
          "desc": "The agent retrieves employees and their current presence statuses."
        }
      ],
      "how_it_works": [
        "The connection uses your Sipuni account number and integration key. Requests are signed on the server. The skill parses CSV exports and preserves the original column names. Phone numbers and recording IDs remain text so that leading zeroes and decimal-looking identifiers are preserved.",
        "Filter call history by dates, direction, status, phone numbers and routing scheme. Audio recordings are downloaded separately using IDs from the export. The agent splits long periods into individual days and reads recording lists in pages, reporting where to resume if an export stops before completion."
      ],
      "requirements": [
        "Sipuni account number and a key from the API integration section",
        "Statistics API service activated for this account (the old cabinet counts too)"
      ],
      "faq": [
        {
          "q": "Where do I get the key?",
          "a": "In Sipuni, open Settings → API integration; in the old cabinet: Settings → API. Copy the saved key. If no key exists, click Generate and Save. You also need the number of the same account, including any leading zeroes."
        },
        {
          "q": "What does Service not connected mean?",
          "a": "Sipuni says the service is not activated for this account. In the old cabinet, open Settings → API → Statistics → Connect service. If it is already activated, ask Sipuni support to check its assignment to your account number. This response neither confirms nor disproves that the key is correct."
        },
        {
          "q": "Can it place calls or send SMS?",
          "a": "This integration reads call history, recordings and employee statuses. Placing calls and sending SMS are not included."
        }
      ]
    }
  },
  {
    "key": "slack",
    "name": "Slack",
    "name_en": "Slack",
    "description": "Рабочий мессенджер: агент отвечает в личке с ботом и в каналах Slack, куда бота пригласили",
    "category": "messengers",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "slack",
    "short_name": "Slack",
    "short_name_en": "Slack",
    "description_en": "Work messenger: the agent replies in DMs and in the Slack channels its bot is invited to",
    "search_terms": [
      "слак"
    ],
    "guide": {
      "url": "https://slack.com/apps",
      "steps": [
        {
          "title": "Нажмите «Подключить»",
          "desc": "Откроется окно Slack. Выберите пространство, в котором должен работать агент, если их несколько.",
          "title_en": "Press «Connect»",
          "desc_en": "A Slack window opens. Pick the workspace the agent should work in, if you have several."
        },
        {
          "title": "Разрешите приложение в пространстве",
          "desc": "Slack покажет права приложения, нажмите «Разрешить». Если установку одобряет администратор, Slack отправит ему запрос, и подключение завершится после одобрения.",
          "title_en": "Allow the app in the workspace",
          "desc_en": "Slack shows the app's permissions, press «Allow». If an admin approves installs, Slack sends them a request, and the connection completes once approved."
        },
        {
          "title": "Напишите боту или пригласите его в канал",
          "desc": "Бот появится в разделе «Приложения» Slack: напишите ему в личку. Чтобы агент работал в канале, пригласите бота командой /invite @samreshu и упомяните его в сообщении.",
          "title_en": "Message the bot or invite it to a channel",
          "desc_en": "The bot appears under «Apps» in Slack: send it a direct message. For the agent to work in a channel, invite the bot with /invite @samreshu and mention it in a message."
        }
      ]
    },
    "seo": {
      "title": "Slack и ИИ-агент: ответы в ветке и отчёты в канал",
      "description": "Отвечает в ветке канала #support, когда бота упомянули, а по понедельникам присылает итоги продаж в #sales. Подключается кнопкой, без своего бота и ключей.",
      "headline": "Агент «Сам Решу» в вашем Slack",
      "scenarios": [
        {
          "title": "Ответы в личке и каналах",
          "desc": "Агент отвечает в личке с ботом, а в канале, куда бота пригласили, отвечает на сообщение с упоминанием бота в ветке этого сообщения."
        },
        {
          "title": "Кнопки и согласия",
          "desc": "Вопрос или просьба о согласии приходит сообщением с кнопками, и решение принимается одним нажатием прямо в Slack."
        },
        {
          "title": "Отчёты задач в канал",
          "desc": "Результат задачи по расписанию приходит в канал, куда приглашён бот, без напоминаний."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "Пространство Slack",
        "Право устанавливать приложения в пространство либо одобрение администратора"
      ],
      "faq": [
        {
          "q": "Как подключить Slack?",
          "a": "Нажмите «Подключить», выберите пространство в окне Slack и разрешите приложение «Сам Решу». Создавать своего бота и копировать ключи не нужно."
        },
        {
          "q": "Что делать, если установку приложений одобряет администратор?",
          "a": "Slack отправит администратору запрос на установку. Подключение завершится после одобрения."
        },
        {
          "q": "Где агент отвечает в Slack?",
          "a": "В личке с ботом и в каналах, куда бота пригласили командой /invite @samreshu. В канале агент получает сообщение, когда бота упомянули, и отвечает в ветке этого сообщения."
        },
        {
          "q": "Может ли агент спросить согласие прямо в Slack?",
          "a": "Да: вопрос или просьба о согласии приходит сообщением с кнопками, и решение принимается одним нажатием."
        },
        {
          "q": "Что будет, если удалить приложение из пространства?",
          "a": "Агент перестанет получать и отправлять сообщения в этом пространстве. Чтобы вернуть его, подключите Slack заново."
        }
      ]
    },
    "seo_en": {
      "title": "Slack AI agent: thread replies and weekly channel reports",
      "description": "Answers in the #support thread when the bot is mentioned and posts weekly sales results to #sales on Mondays. Connects in one click, no bot of your own or keys.",
      "headline": "The «Сам Решу» agent in your Slack",
      "scenarios": [
        {
          "title": "Replies in direct messages and channels",
          "desc": "The agent answers in direct messages with the bot, and in a channel the bot was invited to it answers a message that mentions the bot in that message's thread."
        },
        {
          "title": "Buttons and approvals",
          "desc": "A question or an approval request arrives as a message with buttons, and the decision is one press right in Slack."
        },
        {
          "title": "Task reports in a channel",
          "desc": "A scheduled task's result arrives in the channel the bot was invited to, without reminders."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "A Slack workspace",
        "The right to install apps in the workspace, or an admin's approval"
      ],
      "faq": [
        {
          "q": "How do I connect Slack?",
          "a": "Press «Connect», pick the workspace in the Slack window and allow the «Сам Решу» app. There is no bot to create and no keys to copy."
        },
        {
          "q": "What if an admin approves app installs?",
          "a": "Slack sends the admin an install request. The connection completes once it is approved."
        },
        {
          "q": "Where does the agent answer in Slack?",
          "a": "In direct messages with the bot and in channels the bot was invited to with /invite @samreshu. In a channel the agent receives a message when the bot is mentioned and answers in that message's thread."
        },
        {
          "q": "Can the agent ask for an approval right in Slack?",
          "a": "Yes: a question or an approval request arrives as a message with buttons, and the decision is one press."
        },
        {
          "q": "What happens if the app is removed from the workspace?",
          "a": "The agent stops receiving and sending messages in that workspace. To bring it back, connect Slack again."
        }
      ]
    }
  },
  {
    "key": "slmp",
    "name": "Mitsubishi SLMP",
    "name_en": "Mitsubishi SLMP",
    "description": "ПЛК Mitsubishi MELSEC Q, L, iQ-R, iQ-L и iQ-F по устройствам через сервер сбора, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "slmp",
    "description_en": "Read-only Mitsubishi MELSEC Q, L, iQ-R, iQ-L and iQ-F PLC devices via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Добавьте соединение SLMP в GX Works",
          "desc": "В настройках Ethernet-порта ПЛК добавьте соединение SLMP по TCP и задайте ему порт. Стандартного порта у SLMP нет: этот номер впишите в адрес подключения.",
          "title_en": "Add an SLMP connection in GX Works",
          "desc_en": "In the PLC's Ethernet port settings add an SLMP connection over TCP and give it a port. SLMP has no standard port: enter this number in the connection address."
        },
        {
          "title": "Выберите двоичный код данных",
          "desc": "Код данных соединения должен быть Binary. Программа сбора говорит кадром 3E в двоичном виде, а порт в режиме ASCII может не ответить вовсе.",
          "title_en": "Choose the Binary data code",
          "desc_en": "The connection's communication data code has to be Binary. The data collection program speaks frame 3E in binary, and a port set to ASCII may not answer at all."
        },
        {
          "title": "Оставьте порт одному клиенту",
          "desc": "Порт SLMP принимает одного клиента. Если его держит панель оператора или другая программа, программа сбора не подключится; удалённый пароль на порту даёт отказ доступа.",
          "title_en": "Keep the port for one client",
          "desc_en": "An SLMP port takes one client. If an operator panel or another program holds it, the collection program cannot connect; a remote password on the port gives access denied."
        },
        {
          "title": "Уточните серию ПЛК",
          "desc": "Серия задаёт адресацию: на iQ-F входы X и выходы Y восьмеричные, и неверная серия читает другие входы без ошибки. FX3U и серия A по кадру 3E не читаются.",
          "title_en": "Check the PLC series",
          "desc_en": "The series decides addressing: on iQ-F inputs X and outputs Y are octal, and a wrong series reads other inputs with no error. FX3U and the A series are not read in 3E."
        }
      ]
    },
    "seo": {
      "title": "Mitsubishi SLMP и ИИ: циклы пресса MELSEC по дням",
      "description": "Циклы пресса по дням и время между циклами по биту в ПЛК Mitsubishi MELSEC Q, L или iQ-R. Регистры D и реле M по SLMP читает программа сбора, без записи.",
      "headline": "Устройства ПЛК Mitsubishi MELSEC прямо в чате",
      "scenarios": [
        {
          "title": "Что сейчас на линии",
          "desc": "Агент найдёт теги по пути, например line1/press, и покажет текущие значения регистров D, реле M и входов X со временем отсчёта и пометкой, свежие ли они."
        },
        {
          "title": "Сводка за смену",
          "desc": "Агент возьмёт историю температуры, давления или скорости за смену и по часам покажет минимум, максимум, среднее и последнее значение."
        },
        {
          "title": "Счёт циклов",
          "desc": "Агент заберёт сырые отсчёты бита цикла, например M100, за неделю и посчитает число циклов по дням и время между ними."
        },
        {
          "title": "Задача на выход за порог",
          "desc": "Агент заведёт задачу, которая запустится, когда значение тега выйдет за порог и продержится заданное время, а не на каждый отсчёт за порогом."
        },
        {
          "title": "Теги, которые ПЛК не читает",
          "desc": "Агент назовёт теги с отказом ЦП и кодом завершения, например C056 (номер за концом устройства), и подскажет, что поправить в карте тегов."
        },
        {
          "title": "Пропуски в данных",
          "desc": "Агент покажет промежутки истории без отсчётов и скажет, на связи ли сервер сбора объекта сейчас."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта, ходит к ПЛК по SLMP, кадр 3E в двоичном виде по TCP, и отправляет данные наружу только исходящим соединением. В подключении указываются адрес ПЛК с портом из настройки соединения SLMP, серия ПЛК и карта тегов: по строке на тег путь, устройство GX Works и тип, например D100 real или M10 bool.",
        "У кадра 3E нет порядкового номера, который связал бы ответ с запросом, поэтому программа сбора держит один запрос за раз и проверяет, что в соединении тихо до запроса и после ответа; лишний байт обрывает связь, а не попадает в чужой тег. Теги одного устройства, стоящие не дальше 64 слов друг от друга, читаются одним запросом до 960 слов. Битовые устройства читаются словами по 16 точек, а двойные слова iQ-F и LZ читаются выборочным чтением до 96 точек.",
        "Драйвер только читает: из команд SLMP он посылает пакетное чтение 0401 и выборочное чтение 0403. Изменения устройств, удалённого управления ЦП и команд пароля в нём нет. Код завершения об устройстве помечает плохими теги этого запроса, остальные читаются дальше; удалённый пароль на порту даёт отказ доступа.",
        "Серия ПЛК обязательна: она задаёт форму запроса и то, какие устройства есть, а на iQ-F ещё и восьмеричные номера X и Y. Широкие значения MELSEC хранит младшим словом вперёд, а первый символ строки в младшем байте слова. FX3U и серия A говорят другим кадром, 1E, и этим драйвером не читаются. Если связь с облаком рвётся, данные копятся на диске сервера сбора и приходят после восстановления."
      ],
      "requirements": [
        "ПЛК MELSEC Q, L, iQ-R, iQ-L или iQ-F с портом Ethernet",
        "Соединение SLMP по TCP с кодом данных Binary в GX Works",
        "Свободный порт SLMP без удалённого пароля",
        "Сетевой доступ к этому порту с сервера сбора",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Устройства тегов из проекта GX Works"
      ],
      "faq": [
        {
          "q": "Как подключить Mitsubishi SLMP?",
          "a": "Добавьте в GX Works соединение SLMP по TCP с кодом данных Binary и запишите его порт. В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Mitsubishi SLMP и укажите адрес с этим портом, например tcp://10.0.12.5:1025, серию ПЛК и карту тегов. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Mitsubishi SLMP?",
          "a": "Теги из карты: регистры D и W, реле M, входы X и выходы Y, файловые регистры ZR, текущие значения таймеров и счётчиков и другие устройства серии. Для каждого тега агент читает текущее значение со временем отсчёта, историю интервалами и сырые отсчёты."
        },
        {
          "q": "Меняет ли агент значения в ПЛК?",
          "a": "Нет. Драйвер посылает только пакетное и выборочное чтение. Записи в устройства, удалённого запуска и остановки ЦП и команд пароля в нём нет."
        },
        {
          "q": "Подключение молчит. Что проверить?",
          "a": "Сначала код данных соединения: порт в режиме ASCII может не ответить вовсе. Затем, не занят ли порт: соединение SLMP принимает одного клиента, и его может держать панель оператора. Код C059 значит, что ПЛК не принимает команду, и чаще всего выбрана не та серия."
        }
      ]
    },
    "seo_en": {
      "title": "Mitsubishi SLMP and AI: MELSEC press cycles by day",
      "description": "Daily press cycles and the gap between them from a cycle bit in a Mitsubishi MELSEC Q, L or iQ-R PLC. A site program reads D registers and M relays over SLMP.",
      "headline": "Mitsubishi MELSEC PLC devices right in the chat",
      "scenarios": [
        {
          "title": "What is on the line now",
          "desc": "The agent finds tags by path, such as line1/press, and shows current values of D registers, M relays and X inputs with their timestamp and whether they are fresh."
        },
        {
          "title": "Shift summary",
          "desc": "The agent takes the temperature, pressure or speed history for a shift and shows the minimum, maximum, average and last value per hour."
        },
        {
          "title": "Cycle count",
          "desc": "The agent takes a week of raw samples of a cycle bit, such as M100, and counts cycles per day and the time between them."
        },
        {
          "title": "A task on a threshold",
          "desc": "The agent sets up a task that fires when a tag goes past a threshold and stays there for a set time, not on every sample past it."
        },
        {
          "title": "Tags the PLC refuses",
          "desc": "The agent names tags the CPU refused with the end code, such as C056 (a number past the end of the device), and suggests what to fix in the tag map."
        },
        {
          "title": "Gaps in the data",
          "desc": "The agent shows history intervals without samples and says whether the site's collection server is online right now."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server on the site network, reaches the PLC over SLMP, frame 3E binary over TCP, and sends data out over outbound connections only. The connection takes the PLC address with the port of its SLMP connection setting, the PLC series and a tag map: one line per tag with a path, a GX Works device and a type, such as D100 real or M10 bool.",
        "Frame 3E has no serial number to tie an answer to its request, so the program keeps one request at a time and checks that the connection is silent before the request and after the answer; a surplus byte drops the link instead of reaching another tag. Tags of one device standing at most 64 words apart are read in one request of up to 960 words. Bit devices are read as words of 16 points, and iQ-F double words and LZ go by random read of up to 96 points.",
        "The driver only reads: of the SLMP commands it sends batch read 0401 and random read 0403. It has no device change, no remote CPU control and no password commands. An end code about a device marks the tags of that request bad while the others keep reading; a remote password on the port gives access denied.",
        "The PLC series is required: it decides the request form and which devices exist, and on iQ-F also the octal numbers of X and Y. MELSEC keeps wide values low word first and a string's first character in a word's low byte. FX3U and the A series speak another frame, 1E, and are not read by this driver. If the link to the cloud drops, data piles up on the collection server's disk and arrives once it is back."
      ],
      "requirements": [
        "A MELSEC Q, L, iQ-R, iQ-L or iQ-F PLC with an Ethernet port",
        "An SLMP connection over TCP with the Binary data code in GX Works",
        "A free SLMP port with no remote password",
        "Network access to that port from the collection server",
        "A collection server on the site network: Windows, or Linux with Docker",
        "Tag devices from the GX Works project"
      ],
      "faq": [
        {
          "q": "How do I connect Mitsubishi SLMP?",
          "a": "Add an SLMP connection over TCP with the Binary data code in GX Works and note its port. In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick Mitsubishi SLMP and enter the address with that port, such as tcp://10.0.12.5:1025, the PLC series and a tag map. The collection server is assigned automatically, or you pick it in the form if there are several."
        },
        {
          "q": "What does the agent see in Mitsubishi SLMP?",
          "a": "The tags of the map: D and W registers, M relays, X inputs and Y outputs, ZR file registers, timer and counter current values and the other devices of the series. For each tag the agent reads the current value with its timestamp, the history in intervals and raw samples."
        },
        {
          "q": "Does the agent change values in the PLC?",
          "a": "No. The driver sends only batch and random reads. It has no device writes, no remote CPU run or stop and no password commands."
        },
        {
          "q": "The connection stays silent. What should I check?",
          "a": "First the connection's data code: a port set to ASCII may not answer at all. Then whether the port is taken: an SLMP connection takes one client, and an operator panel may hold it. Code C059 means the PLC does not take the command, most often because the series is wrong."
        }
      ]
    }
  },
  {
    "key": "smsaero",
    "name": "SMS Aero",
    "name_en": "SMS Aero",
    "description": "SMS, WhatsApp, Viber и коды в Telegram, контакты, статусы и баланс",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "smsaero",
    "description_en": "SMS, WhatsApp, Viber and Telegram codes, contacts, statuses and balance",
    "search_terms": [
      "смс аэро"
    ],
    "guide": {
      "url": "https://smsaero.ru/cabinet/",
      "steps": [
        {
          "title": "Войдите в кабинет SMS Aero",
          "desc": "Откройте smsaero.ru/cabinet и войдите под аккаунтом компании. Email этого аккаунта будет первым из двух нужных значений: он же логин при обращении к API.",
          "title_en": "Sign in to your SMS Aero account",
          "desc_en": "Open smsaero.ru/cabinet and sign in with the company account. That account's email is the first of the two values you need: it doubles as the API login."
        },
        {
          "title": "Скопируйте API-ключ в настройках",
          "desc": "Настройки → «API» (smsaero.ru/cabinet/settings/apikey). Ключ работает только в паре с email аккаунта, поэтому скопируйте оба значения.",
          "title_en": "Copy the API key from settings",
          "desc_en": "Settings → \"API\" (smsaero.ru/cabinet/settings/apikey). The key only works paired with the account email, so copy both values."
        },
        {
          "title": "Заведите имя отправителя",
          "desc": "Добавьте подпись (sign) в кабинете и дождитесь модерации: неодобренное имя сервис отклоняет. Поле необязательное.",
          "title_en": "Register a sender name",
          "desc_en": "Add a sender signature (sign) in the account and wait for acceptance: an unapproved name gets rejected. The field is optional."
        },
        {
          "title": "Пополните баланс перед отправкой",
          "desc": "SMS Aero работает по предоплате: при нехватке средств API отвечает ошибкой оплаты, а не отправляет сообщение. Остаток виден на главной кабинета.",
          "title_en": "Top up the balance before sending",
          "desc_en": "SMS Aero is prepaid: when funds run out the API returns a payment error instead of sending. The remaining balance is shown on the account home page."
        }
      ]
    },
    "seo": {
      "title": "Интеграция SMS Aero с ИИ: смета и недоставленные SMS",
      "description": "Посчитает смету SMS-рассылки по базе с учётом частей текста и сверит с балансом, а после отправки найдёт номера, куда сообщение не дошло. Нужны email и API-ключ.",
      "headline": "Рассылайте SMS, WhatsApp и Viber и проверяйте доставку в чате",
      "scenarios": [
        {
          "title": "Рассылка по списку номеров",
          "desc": "Агент отправит сообщения по вашему списку одним запросом с одобренной подписью и вернёт результат по каждому номеру отдельно."
        },
        {
          "title": "Цена до отправки",
          "desc": "Агент прогонит текст тестовым запросом, который не списывает деньги, покажет цену сообщения и итог по списку и уйдёт в рассылку только после подтверждения."
        },
        {
          "title": "Статусы доставки",
          "desc": "Агент проверит статус каждого сообщения (доставлено, передано, отклонено или ещё на модерации) и соберёт список номеров, до которых SMS не дошли."
        },
        {
          "title": "Отписки и чёрный список",
          "desc": "Агент занесёт отказавшихся в чёрный список сервиса и будет исключать их из следующих рассылок, а по запросу вернёт номер обратно."
        },
        {
          "title": "Группы и контакты",
          "desc": "Агент соберёт группу получателей, добавит контакты с именем и полем для подстановки и потом разошлёт по группе целиком, не перечисляя номера руками."
        },
        {
          "title": "Живые номера перед рассылкой",
          "desc": "Агент закажет HLR-проверку и покажет, какие номера доступны, а какие не существуют, чтобы не платить за отправку в пустоту."
        },
        {
          "title": "WhatsApp, Viber и коды в Telegram",
          "desc": "Агент отправит сообщение в WhatsApp или Viber, поднимет переписку по диалогу, а код подтверждения пошлёт в Telegram с откатом в SMS, если он не дошёл."
        },
        {
          "title": "Контроль баланса и тарифа",
          "desc": "Агент по расписанию сверит остаток с ценой по вашему тарифу и предупредит заранее, что средств не хватит на ближайшую рассылку."
        }
      ],
      "how_it_works": [
        "Агент ходит в шлюз SMS Aero по адресу https://gate.smsaero.ru/v2 и работает с тем, что этот API умеет: отправка по номеру или списку номеров сразу, история отправленного, статус каждого сообщения, группы и карточки контактов, чёрный список, проверка живости номера и оператора, остаток и тариф, а также отдельные каналы WhatsApp, Viber и кода в Telegram. Массовая рассылка уходит одним запросом со списком номеров, а не циклом по одному: так не бывает наполовину отправленной рассылки.",
        "Цена считается по частям: длинный текст разбивается на несколько сообщений, каждое оплачивается отдельно, кириллица укорачивает часть сильнее латиницы, а смешение кириллицы и латиницы внутри одного слова сервис вовсе не пропускает. Числа частей API в ответе не возвращает, поэтому агент считает его сам по длине текста, а цену берёт из тестовой отправки: она возвращает стоимость, но не списывает деньги и не идёт абоненту.",
        "Отправка тратит деньги и уходит на чужие телефоны, поэтому агент не запускает её сам. Сначала он показывает текст, подпись отправителя, размер списка и стоимость, и только после вашего подтверждения уходит в рассылку. Дальше он собирает результат по каждому номеру отдельно и отдельным списком выносит те, до которых сообщение не дошло, с причиной отказа, а не общей фразой об ошибке. Так же он ведёт себя и с необратимым: очистка всех групп или контактов и пополнение баланса с карты идут только по явному подтверждению.",
        "Статус приходит не сразу и не одним шагом: без договора каждое сообщение проходит ручную модерацию до десяти минут, и «на модерации» это штатное состояние, а не сбой. «Передано оператору» тоже не равно «доставлено», поэтому агент перечитывает статус позже, а не выдаёт одно за другое. Подпись отправителя может быть одобрена не у всех операторов сразу, поэтому агент смотрит на разбивку по операторам и предупреждает, если у части абонентов рассылка отобьётся.",
        "Отдельного токена шлюз не выдаёт: каждый запрос подписывается парой значений из кабинета, поэтому перевыпуск ключа обрывает доступ мгновенно, и агент сразу скажет, что подключение нужно обновить, вместо молчаливых повторов. Если в кабинете включён белый список адресов, сервис отвечает отказом, который легко принять за «данных нет», но агент называет причину прямо и не уходит в бесполезные повторы. Списки он дочитывает до конца постранично, а о нехватке данных или прав говорит прямо."
      ],
      "requirements": [
        "Аккаунт компании на smsaero.ru: его email служит логином к API.",
        "Пополненный баланс: сервис работает по предоплате.",
        "Имя отправителя, прошедшее модерацию: с неодобренным сервис отклонит отправку."
      ],
      "faq": [
        {
          "q": "Как подключить SMS Aero?",
          "a": "Email аккаунта и API-ключом из кабинета: Настройки → «API» на smsaero.ru. Ключ работает только в паре с email. Имя отправителя (sign) в подключении необязательно: его можно указывать при отправке, но подпись в любом случае должна пройти модерацию."
        },
        {
          "q": "Что агент видит в SMS Aero?",
          "a": "Историю отправленных сообщений и статус каждого, остаток и тариф, имена отправителя с их статусом модерации, группы и карточки контактов, чёрный список, результаты HLR-проверки и оператора номера, а также диалоги и сообщения WhatsApp."
        },
        {
          "q": "Отправляет ли агент сообщения сам?",
          "a": "Отправка тратит деньги, поэтому агент сначала показывает текст, подпись и стоимость и уходит в рассылку только после вашего подтверждения. То же и с необратимым: очисткой контактов или групп и пополнением баланса."
        },
        {
          "q": "Что если на счету не хватает денег?",
          "a": "Сервис работает по предоплате: при нехватке средств он отвечает ошибкой оплаты и не отправляет сообщение. Агент покажет остаток и назовёт сумму, которой не хватило."
        },
        {
          "q": "Почему сообщение долго висит в статусе «на модерации»?",
          "a": "Без заключённого договора сервис проверяет каждое сообщение вручную, это занимает до десяти минут. Агент не считает такой статус ошибкой и перечитывает его позже; чтобы модерации не было, договор заключается в разделе «Реквизиты и договоры»."
        }
      ]
    },
    "seo_en": {
      "title": "SMS Aero integration: cost estimate and undelivered SMS",
      "description": "Estimates an SMS campaign's cost across your base, counting message parts, checks it against the balance and lists numbers it never reached. Needs email and API key.",
      "headline": "Send SMS, WhatsApp and Viber and check delivery right in the chat",
      "scenarios": [
        {
          "title": "A campaign to a list of numbers",
          "desc": "The agent sends your list in a single request with an approved sender sign and returns the result for each number separately."
        },
        {
          "title": "The price before sending",
          "desc": "The agent runs the text as a test request that charges nothing, shows the price per message and the total for the list, and sends only after you confirm."
        },
        {
          "title": "Delivery statuses",
          "desc": "The agent checks the status of every message (delivered, handed to the operator, rejected or still in moderation) and collects the numbers the SMS never reached."
        },
        {
          "title": "Opt-outs and the blocklist",
          "desc": "The agent puts everyone who opted out on the service blocklist and keeps them out of later campaigns, and puts a number back when you ask."
        },
        {
          "title": "Groups and contacts",
          "desc": "The agent builds a group of recipients, adds contacts with a name and a field for substitution, and later sends to the whole group instead of listing numbers by hand."
        },
        {
          "title": "Live numbers before a campaign",
          "desc": "The agent orders an HLR check and shows which numbers are reachable and which do not exist, so you do not pay to send into the void."
        },
        {
          "title": "WhatsApp, Viber and Telegram codes",
          "desc": "The agent sends a message over WhatsApp or Viber, pulls up the conversation in a dialog, and delivers a confirmation code via Telegram with a fallback to SMS if it does not arrive."
        },
        {
          "title": "Balance and tariff control",
          "desc": "On a schedule the agent checks the balance against the price on your tariff and warns in advance when the funds will not cover the next campaign."
        }
      ],
      "how_it_works": [
        "The agent calls the SMS Aero gateway at https://gate.smsaero.ru/v2 and works with what that API can do: sending to a number or to a whole list at once, the history of what went out, the status of every message, groups and contact cards, the blocklist, checks on whether a number is live and which operator it belongs to, the balance and the tariff, plus the separate WhatsApp, Viber and Telegram-code channels. A bulk campaign goes out as one request carrying the list rather than a loop of single sends, so there is no such thing as a half-sent campaign.",
        "The price is counted in parts: a long text is split into several messages, each charged separately, Cyrillic shortens a part more than Latin does, and mixing Cyrillic and Latin inside a single word is refused outright. The API does not return the number of parts, so the agent works it out from the length of the text itself and takes the price from a test send, which returns the cost without charging you and without reaching the subscriber.",
        "Sending spends money and reaches other people's phones, so the agent never launches it on its own. First it shows the text, the sender sign, the size of the list and the price, and only after you confirm does it go ahead. Then it collects the result for each number separately and puts the numbers the message never reached into a list of their own, with the reason for the refusal, not a generic error phrase. It treats the irreversible the same way: wiping every group or contact and topping the balance up from a card happen only on an explicit confirmation.",
        "A status does not arrive at once or in a single step: without a contract every message goes through manual moderation for up to ten minutes, and «in moderation» is a normal state rather than a fault. «Handed to the operator» is not the same as «delivered» either, so the agent re-reads the status later instead of passing one off as the other. A sender sign may be approved by some operators and not others, so the agent reads the per-operator breakdown and warns when the campaign will bounce for part of your audience.",
        "The gateway issues no separate token: every request is signed with the pair of values from the cabinet, so reissuing the key cuts access off instantly, and the agent says straight away that the connection has to be refreshed instead of retrying in silence. When the cabinet has an IP allowlist switched on, the service answers with a refusal that reads a lot like «no data», but the agent names the real reason instead of retrying pointlessly. It reads lists to the end page by page and states any shortage of data or permissions directly."
      ],
      "requirements": [
        "A company account on smsaero.ru: its email is the API login.",
        "A topped-up balance: the service is prepaid.",
        "A sender name that has passed moderation, since unapproved names are rejected."
      ],
      "faq": [
        {
          "q": "How do I connect SMS Aero?",
          "a": "With the account email and an API key from the workspace: Settings, then API on smsaero.ru. The key works only paired with the email. A sender name (sign) in the connection is optional (it can be passed per send), but either way the sign has to pass moderation."
        },
        {
          "q": "What does the agent see in SMS Aero?",
          "a": "The history of sent messages and the status of each, the balance and the tariff, sender names with their moderation status, groups and contact cards, the blocklist, HLR results and the operator behind a number, plus WhatsApp dialogs and messages."
        },
        {
          "q": "Does the agent send messages on its own?",
          "a": "Sending spends money, so the agent first shows the text, the sign and the price, and goes ahead only after you confirm. The same holds for the irreversible: wiping contacts or groups and topping up the balance."
        },
        {
          "q": "What if there is not enough money on the account?",
          "a": "The service runs on prepayment: when funds are short it replies with a payment error and does not send the message. The agent will show the balance and name the amount that was missing."
        },
        {
          "q": "Why does a message sit in «moderation» for so long?",
          "a": "Without a signed contract the service reviews every message by hand, which takes up to ten minutes. The agent does not treat that status as an error and re-reads it later; to remove moderation entirely, sign the contract in the «Реквизиты и договоры» section."
        }
      ]
    }
  },
  {
    "key": "snmp",
    "name": "SNMP",
    "name_en": "SNMP",
    "description": "ИБП, сеть, серверная и датчики климата по SNMP через программу сбора данных, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "snmp",
    "description_en": "Read-only UPS, network, server room and climate sensor data over SNMP via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Включите SNMP на устройстве",
          "desc": "В веб-интерфейсе ИБП, коммутатора или датчика включите SNMP-агент. Выберите v3, если устройство его поддерживает: v1 и v2c передают всё открытым текстом.",
          "title_en": "Turn SNMP on in the device",
          "desc_en": "In the web interface of the UPS, switch or sensor, turn the SNMP agent on. Choose v3 if the device supports it: v1 and v2c send everything in plain text."
        },
        {
          "title": "Для v1 и v2c: сообщество на чтение",
          "desc": "Заведите строку сообщества только для чтения. Если устройство пускает менеджеров только с известных адресов, добавьте адрес сервера сбора.",
          "title_en": "For v1 and v2c: a read-only community",
          "desc_en": "Create a read-only community string. If the device accepts managers only from known addresses, add the collection server's address."
        },
        {
          "title": "Для v3: пользователь с паролями",
          "desc": "Заведите пользователя v3 с аутентификацией (SHA-256 или другой алгоритм из списка) и шифрованием AES. Без пароля шифрования значения подписаны, но не зашифрованы.",
          "title_en": "For v3: a user with passwords",
          "desc_en": "Create a v3 user with authentication (SHA-256 or another algorithm from the list) and AES privacy. Without a privacy password values are signed but not encrypted."
        },
        {
          "title": "Откройте UDP 161 до устройства",
          "desc": "Программа сбора опрашивает агент по UDP на порт 161 со своего свободного порта. Ловушки на порт 162 она не принимает, их настраивать не нужно.",
          "title_en": "Open UDP 161 to the device",
          "desc_en": "The data collection program polls the agent over UDP on port 161 from a free port of its own. It takes no traps on port 162, so they need no setup."
        }
      ]
    },
    "seo": {
      "title": "SNMP и ИИ-агент: сколько продержится ИБП серверной",
      "description": "ИБП серверной на батарее: агент назовёт заряд, нагрузку и сколько минут осталось, проверит порты коммутаторов и климат. Опрос SNMP идёт через программу сбора.",
      "headline": "ИБП, коммутаторы и серверная по SNMP прямо в чате",
      "scenarios": [
        {
          "title": "ИБП на батарее",
          "desc": "Агент прочитает, от чего питается выход ИБП, заряд и оставшееся время работы батареи, сколько ИБП уже работает от неё и нагрузку на выходе."
        },
        {
          "title": "Аварии ИБП",
          "desc": "Агент покажет активные аварии ИБП: низкий заряд, перегрузку выхода, замену батареи, перегрев, работу на байпасе, и их число."
        },
        {
          "title": "Порты коммутатора",
          "desc": "Агент найдёт порты, которые включены, но лежат, и покажет трафик по портам с именами вроде Gi1/0/1, а не по номерам."
        },
        {
          "title": "Климат серверной",
          "desc": "Агент прочитает температуры и обороты вентиляторов со встроенных датчиков устройств и покажет, как они менялись за сутки."
        },
        {
          "title": "Ресурсы сервера",
          "desc": "Агент покажет загрузку процессоров и заполнение дисков сервера по стандартной таблице ресурсов хоста."
        },
        {
          "title": "Задача по порогу",
          "desc": "Агент заведёт задачу по событию: например, заряд батареи ИБП ниже порога дольше пяти минут. Задача сработает на начале и на снятии условия."
        }
      ],
      "how_it_works": [
        "Данные с объекта забирает программа сбора данных: она работает службой на сервере в сети объекта и отправляет данные наружу только исходящим соединением. Одно подключение соответствует одному SNMP-агенту: указываются адрес вида udp://10.0.5.30:161, версия и строка сообщества для v1 и v2c или пользователь с паролями для v3.",
        "OID знать не нужно: без списка тегов программа сбора читает стандартные группы, на которые устройство отвечает: system, ИБП по RFC 1628 (или APC PowerNet с теми же именами тегов), датчики ENTITY-SENSOR-MIB, ресурсы хоста и интерфейсы IF-MIB. Порт называется по ifName, а не по номеру, и после рестарта агента, когда номера могут смениться, программа перечитывает таблицы, чтобы тег не съехал на другой порт.",
        "Подключение только читает. Программа сбора отправляет только GET и обход таблиц: SET он не посылает, ловушки не принимает и сам на портах 161 и 162 не слушает. Поэтому аварии ИБП приходят не ловушками, а тегами-флагами, которые читаются на каждом опросе, а настройки устройства агент изменить не может.",
        "Опрос идёт раз в 30 секунд: агенты на сетевых картах ИБП и датчиков медленные. Если устройство отказывает на пачке объектов, программа переспрашивает их по одному, и отказ ложится на свой тег, а соседние читаются дальше. Счётчики трафика отдаются как есть, 64-битные там, где агент их держит; история копится в хранилище и читается за любой период."
      ],
      "requirements": [
        "Устройство с SNMP v1, v2c или v3: ИБП, коммутатор, сервер, датчик",
        "Строка сообщества только для чтения или пользователь SNMPv3",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Доступ с сервера сбора к устройству по UDP, порт 161"
      ],
      "faq": [
        {
          "q": "Как подключить SNMP?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите SNMP и укажите адрес устройства, например udp://10.0.5.30:161, версию и строку сообщества или пользователя v3; сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме. Список тегов можно оставить пустым."
        },
        {
          "q": "Что агент видит по SNMP?",
          "a": "Имя, расположение и время работы устройства, состояние ИБП, батареи, входа и выхода и его аварии, показания датчиков температуры и вентиляторов, загрузку процессоров и дисков хоста, состояние и трафик портов. Остальное читается по OID, указанным в списке тегов."
        },
        {
          "q": "Может ли агент изменить настройки устройства?",
          "a": "Нет. Программа сбора не отправляет SET и не принимает ловушки: он только читает значения запросами GET и обходом таблиц, поэтому настройки ИБП, коммутатора и датчиков остаются как были."
        },
        {
          "q": "Устройство отвечает на часть объектов или молчит на таблицах. Что делать?",
          "a": "Маленькие сетевые карты бывают перегружены длинными запросами. В дополнительных полях уменьшите число объектов в запросе или число строк в запросе таблицы: программа сбора будет спрашивать устройство меньшими порциями."
        }
      ]
    },
    "seo_en": {
      "title": "SNMP and an AI agent: how long the server-room UPS lasts",
      "description": "Server-room UPS on battery: the agent reports charge, load and minutes left, and checks switch ports and climate. A site collection program polls SNMP, read-only.",
      "headline": "UPS, switches and the server room over SNMP right in the chat",
      "scenarios": [
        {
          "title": "UPS on battery",
          "desc": "The agent reads what feeds the UPS output, the battery charge and remaining runtime, how long the UPS has been on battery and the output load."
        },
        {
          "title": "UPS alarms",
          "desc": "The agent shows the UPS's active alarms: low battery, output overload, battery replacement, overheating, running on bypass, and how many there are."
        },
        {
          "title": "Switch ports",
          "desc": "The agent finds ports that are enabled but down, and shows traffic per port under names like Gi1/0/1 rather than numbers."
        },
        {
          "title": "Server room climate",
          "desc": "The agent reads temperatures and fan speeds from the devices' built-in sensors and shows how they changed over the day."
        },
        {
          "title": "Server resources",
          "desc": "The agent shows a server's processor load and disk usage from the standard host resources table."
        },
        {
          "title": "Threshold task",
          "desc": "The agent sets up an event task: for example, the UPS battery charge below a threshold for more than five minutes. The task fires when the condition starts and when it clears."
        }
      ],
      "how_it_works": [
        "Data is collected on site by the data collection program: it runs as a service on a server in the site network and sends data out over an outgoing connection only. One connection is one SNMP agent: it takes an address such as udp://10.0.5.30:161, the version and a community string for v1 and v2c or a user with passwords for v3.",
        "No OID knowledge is needed: without a tag list the program reads the standard groups the device answers: system, UPS per RFC 1628 (or APC PowerNet under the same tag names), ENTITY-SENSOR-MIB sensors, host resources and IF-MIB interfaces. A port is named by ifName rather than its number, and after an agent restart, when the numbers may change, the program reads the tables again so a tag does not slide onto another port.",
        "The connection only reads. The program sends only GET and table walks: it sends no SET, takes no traps and listens on neither port 161 nor 162. So UPS alarms arrive not as traps but as flag tags read on every poll, and the agent cannot change the device's settings.",
        "Polling runs every 30 seconds: agents on UPS and sensor network cards are slow. If a device refuses a batch of objects, the program asks for them one at a time, so the refusal lands on its own tag and the neighbours keep being read. Traffic counters go out as read, 64-bit where the agent has them; history is kept in the store and read for any period."
      ],
      "requirements": [
        "A device with SNMP v1, v2c or v3: a UPS, switch, server or sensor",
        "A read-only community string or an SNMPv3 user",
        "A collection server in the site network: Windows, or Linux with Docker",
        "Access from the collection server to the device over UDP, port 161"
      ],
      "faq": [
        {
          "q": "How do I connect SNMP?",
          "a": "In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick SNMP and enter the device address, for example udp://10.0.5.30:161, the version and a community string or a v3 user; the collection server is assigned automatically, or you pick it in the form if there are several. The tag list can stay empty."
        },
        {
          "q": "What does the agent see over SNMP?",
          "a": "The device's name, location and uptime, the state of the UPS, its battery, input and output and its alarms, temperature and fan sensor readings, host processor and disk load, and port state and traffic. Anything else is read by the OIDs given in the tag list."
        },
        {
          "q": "Can the agent change the device's settings?",
          "a": "No. The program sends no SET and takes no traps: it only reads values with GET requests and table walks, so the UPS, switch and sensor settings stay as they were."
        },
        {
          "q": "The device answers only some objects or goes silent on tables. What should I do?",
          "a": "Small network cards can choke on long requests. In the advanced fields lower the objects per request or the rows per table request: the program will ask the device in smaller portions."
        }
      ]
    }
  },
  {
    "key": "sparkplug",
    "name": "Sparkplug B",
    "name_en": "Sparkplug B",
    "description": "Метрики узлов Sparkplug B 3.0 (Ignition, HighByte, Litmus) через сервер сбора, только чтение",
    "category": "equipment",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "sparkplug",
    "description_en": "Read-only Sparkplug B 3.0 node metrics from Ignition, HighByte or Litmus via a collection server",
    "far_end_rule": "user_host",
    "guide": {
      "steps": [
        {
          "title": "Оставьте действующий Primary Host",
          "desc": "Программа сбора только наблюдает: не публикует STATE и не отправляет NCMD Rebirth. Если узлы ждут Primary Host, его должен предоставлять другой клиент брокера.",
          "title_en": "Keep the existing Primary Host",
          "desc_en": "The data collection program only observes: it publishes no STATE and sends no NCMD Rebirth. If nodes require a Primary Host, another broker client must provide it."
        },
        {
          "title": "Дождитесь BIRTH от узлов",
          "desc": "Имена псевдонимов приходят в NBIRTH/DBIRTH. При подключении посреди сессии нужны сохранённые BIRTH от Sparkplug Aware брокера или следующий BIRTH узла.",
          "title_en": "Wait for the nodes' BIRTH messages",
          "desc_en": "Aliases get their names from NBIRTH/DBIRTH. Joining mid-session needs kept BIRTH messages from a Sparkplug Aware broker or the node's next BIRTH."
        }
      ]
    },
    "seo": {
      "title": "Sparkplug B и ИИ-агент: узлы, которые не на связи",
      "description": "Какие узлы и устройства Sparkplug B погасли по NDEATH или DDEATH, история метрик Ignition, HighByte и Litmus с единицами из BIRTH. Данные читает программа сбора.",
      "headline": "Метрики узлов Sparkplug B как данные оборудования прямо в чате",
      "scenarios": [
        {
          "title": "Текущие метрики узла",
          "desc": "Агент найдёт метрики по группе, узлу, устройству или имени и покажет последние значения с единицами из BIRTH и свежестью."
        },
        {
          "title": "История за период",
          "desc": "Агент соберёт историю метрики интервалами: минимум, максимум, среднее и последнее значение, с пропусками там, где данных не было."
        },
        {
          "title": "Какие узлы отключились",
          "desc": "Агент увидит метрики, погашенные по NDEATH или DDEATH, и назовёт узлы и устройства, от которых нет данных."
        },
        {
          "title": "Сравнение устройств",
          "desc": "Агент сопоставит одну метрику у нескольких устройств группы, например давление на разных насосах, и сравнит средние и пики за период."
        },
        {
          "title": "Задача по условию",
          "desc": "Агент заведёт задачу «По событию»: она запустится, когда значение метрики перейдёт порог и продержится заданное время."
        },
        {
          "title": "Связь с объектом",
          "desc": "Агент скажет, на связи ли сервер сбора и подключение к брокеру, а задача по событию узнает, когда сервер пропал и когда вернулся."
        }
      ],
      "how_it_works": [
        "Брокер, через который узлы Sparkplug B публикуют метрики, обычно стоит в сети объекта, поэтому к нему ходит программа сбора данных: она работает службой на сервере в той же сети и отправляет данные наружу только исходящим соединением. В подключении указываются адрес брокера, при необходимости логин и пароль и группы Sparkplug; пусто значит все группы брокера.",
        "Программа сбора читает Sparkplug B 3.0 как наблюдающий хост. NBIRTH и DBIRTH объявляют метрики с типами и единицами и задают псевдонимы, NDATA и DDATA приходят по имени или псевдониму, NDEATH и DDEATH гасят метрики узла или устройства. Тег называется по имени метрики, а не по псевдониму. Разрыв последовательности не обрывает чтение: программа сбрасывает псевдонимы узла и запрашивает у брокера сохранённые BIRTH.",
        "Программа сбора не публикует STATE и не отправляет NCMD Rebirth, поэтому её нельзя принять за Primary Host, и узлы не отключатся из-за её ухода. Сообщений в брокер она не пишет вовсе, и её учётной записи достаточно права подписки. Агент читает значения, историю и свежесть, но не отправляет команд ни узлам, ни устройствам.",
        "Если программа подключилась посреди сессии узла, имена псевдонимов берутся из сохранённых BIRTH брокера с поддержкой Sparkplug Aware или из следующего BIRTH узла; метрики, пришедшие по имени, читаются сразу. Каталог ограничен настройкой «Не больше тегов» (по умолчанию 10000). История копится с момента подключения."
      ],
      "requirements": [
        "Брокер MQTT 5 или 3.1.1 с узлами Sparkplug B 3.0",
        "Право подписки на spBv1.0/… и $sparkplug/certificates/… брокера",
        "Сервер сбора в сети объекта: Windows или Linux с Docker",
        "Отдельный Primary Host, если узлы его ждут"
      ],
      "faq": [
        {
          "q": "Как подключить Sparkplug B?",
          "a": "В разделе Интеграции → «Оборудование» нажмите «Подключить оборудование». Если сервера сбора ещё нет, установите программу сбора данных одной командой из окна. Затем выберите Sparkplug B и укажите адрес брокера, например mqtt://10.0.12.5:1883, логин и пароль, если брокер их требует, и точные имена групп через запятую или оставьте поле пустым для всех групп. Сервер сбора назначится сам, а если серверов несколько, выберите нужный в форме."
        },
        {
          "q": "Что агент видит в Sparkplug B?",
          "a": "Метрики узлов и устройств выбранных групп как теги с типами, единицами и описаниями из BIRTH, их текущие значения, историю с момента подключения и то, какие узлы и устройства погашены по DEATH."
        },
        {
          "q": "Отправляет ли агент команды узлам?",
          "a": "Нет. Программа сбора не публикует ни STATE, ни NCMD, ни DCMD и вообще ничего не пишет в брокер. Ей достаточно права подписки."
        },
        {
          "q": "Метрики пришли без имён. Почему?",
          "a": "Узел шлёт данные по псевдонимам, а его BIRTH программа сбора не застала. Имена появятся из сохранённых BIRTH, если брокер поддерживает Sparkplug Aware, или из следующего BIRTH узла."
        }
      ]
    },
    "seo_en": {
      "title": "Sparkplug B and an AI agent: nodes that went offline",
      "description": "Which Sparkplug B nodes and devices went dark by NDEATH or DDEATH, plus Ignition, HighByte and Litmus metric history with BIRTH units, read by a site collector.",
      "headline": "Sparkplug B node metrics as equipment data right in the chat",
      "scenarios": [
        {
          "title": "A node's current metrics",
          "desc": "The agent finds metrics by group, node, device or name and shows the latest values with units from BIRTH and their freshness."
        },
        {
          "title": "History for a period",
          "desc": "The agent collects a metric's history in intervals: minimum, maximum, average and last value, with gaps where there was no data."
        },
        {
          "title": "Which nodes went offline",
          "desc": "The agent sees metrics darkened by NDEATH or DDEATH and names the nodes and devices that send no data."
        },
        {
          "title": "Comparing devices",
          "desc": "The agent lines up one metric across devices of a group, such as pressure on several pumps, and compares averages and peaks over a period."
        },
        {
          "title": "A task on a condition",
          "desc": "The agent sets up an On event task that starts when a metric's value crosses a threshold and holds there for the time you set."
        },
        {
          "title": "Site connectivity",
          "desc": "The agent tells whether the collection server and its broker connection are online, and an On event task learns when the server drops and when it is back."
        }
      ],
      "how_it_works": [
        "The broker your Sparkplug B nodes publish to usually sits on the site's network, so the data collection program reaches it: it runs as a service on a server on the same network and sends data out over an outgoing connection only. The connection takes the broker address, a login and password if needed, and the Sparkplug groups; empty means every group on the broker.",
        "The program reads Sparkplug B 3.0 as an observing host. NBIRTH and DBIRTH declare metrics with their types and units and assign aliases, NDATA and DDATA arrive by name or alias, NDEATH and DDEATH darken a node's or device's metrics. A tag is named by the metric's name, never its alias. A sequence gap does not stop reading: the program drops the node's aliases and asks the broker for its kept BIRTH messages.",
        "The program publishes no STATE and sends no NCMD Rebirth, so it cannot be mistaken for the Primary Host, and nodes do not disconnect when it goes away. It writes no messages to the broker at all, and subscribe rights are enough for its account. The agent reads values, history and freshness, but sends no commands to nodes or devices.",
        "If the program joins in the middle of a node's session, alias names come from the BIRTH messages kept by a Sparkplug Aware broker or from the node's next BIRTH; metrics sent by name are read at once. The catalog is capped by the Max tags setting (10000 by default). History builds up from the moment of connection."
      ],
      "requirements": [
        "An MQTT 5 or 3.1.1 broker with Sparkplug B 3.0 nodes",
        "Subscribe rights to spBv1.0/… and $sparkplug/certificates/… on the broker",
        "A collection server on the site's network: Windows, or Linux with Docker",
        "A separate Primary Host if the nodes require one"
      ],
      "faq": [
        {
          "q": "How do I connect Sparkplug B?",
          "a": "In Integrations → \"Equipment\" click \"Connect equipment\". If there is no collection server yet, install the data collection program with the one command shown in the window. Then pick Sparkplug B and enter the broker address, for example mqtt://10.0.12.5:1883, a login and password if the broker requires them, and exact group names separated by commas, or leave the field empty for every group. The collection server is assigned automatically, or you pick it in the form if there are several."
        },
        {
          "q": "What does the agent see in Sparkplug B?",
          "a": "The metrics of nodes and devices in the chosen groups as tags with types, units and descriptions from BIRTH, their current values, history from the moment of connection and which nodes and devices are darkened by DEATH."
        },
        {
          "q": "Does the agent send commands to nodes?",
          "a": "No. The program publishes no STATE, NCMD or DCMD and writes nothing to the broker at all. Subscribe rights are enough for it."
        },
        {
          "q": "Metrics arrived without names. Why?",
          "a": "The node sends data by alias, and the program missed its BIRTH. The names appear from kept BIRTH messages if the broker is Sparkplug Aware, or from the node's next BIRTH."
        }
      ]
    }
  },
  {
    "key": "starline",
    "name": "StarLine",
    "name_en": "StarLine",
    "description": "Автосигнализация: GPS-координаты, состояние машины, дистанционные команды, OBD",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "starline",
    "description_en": "Car alarm: GPS location, vehicle state, remote commands and OBD",
    "search_terms": [
      "старлайн"
    ],
    "guide": {
      "url": "https://my.starline.ru",
      "steps": [
        {
          "title": "Войдите в my.starline.ru",
          "desc": "Нужен аккаунт StarLine ID, в списке устройств которого виден комплекс: ключи открывают только его машины. Логин и пароль понадобятся дальше.",
          "title_en": "Sign in to my.starline.ru",
          "desc_en": "Use the StarLine ID account whose device list shows the alarm system: the keys reach only its cars. Its login and password are needed later."
        },
        {
          "title": "Отправьте заявку в «Разработчикам»",
          "desc": "Раздел виден только при русском языке интерфейса. Опишите в заявке цели использования API: без описания её не рассматривают. Одобрение придёт письмом.",
          "title_en": "Submit a request under «Разработчикам»",
          "desc_en": "The «Разработчикам» section appears only with the Russian interface language. A request without a stated API purpose is not reviewed; acceptance comes by email."
        },
        {
          "title": "Создайте приложение и возьмите ключи",
          "desc": "После письма о принятии вернитесь в «Разработчикам» → «Создать приложение» и заполните форму. На карточке появятся AppId и Secret.",
          "title_en": "Create the app and copy its keys",
          "desc_en": "Once approved, open «Разработчикам» → «Создать приложение» (Create application) and fill in the form. The card then shows AppId and Secret."
        }
      ]
    },
    "seo": {
      "title": "StarLine API и ИИ-агент: где машина и стоит ли охрана",
      "description": "Ответит, где машина и на охране ли она, со временем последнего пакета: стоит на Ленинском 78, данные 4 минуты назад. Прогрев и охрана только после подтверждения.",
      "headline": "Узнавайте, где машина и что с ней, прямо в чате",
      "scenarios": [
        {
          "title": "Где сейчас машина",
          "desc": "Агент покажет координаты, скорость и время последнего обновления с GPS-модуля комплекса по каждому устройству в аккаунте."
        },
        {
          "title": "Состояние и диагностика",
          "desc": "Агент проверит охрану, двери и зажигание, уровень топлива, напряжение АКБ и температуру двигателя по данным OBD."
        },
        {
          "title": "Дистанционные команды",
          "desc": "Агент выполнит команды комплекса (постановку на охрану или прогрев двигателя) после вашего подтверждения в чате."
        },
        {
          "title": "Сводка по поездкам",
          "desc": "Агент соберёт сводку по расписанию: поездки за день, сработавшие тревоги и параметры, которые просели за неделю."
        },
        {
          "title": "Куда ездила машина вчера",
          "desc": "Агент поднимет трек за день по точкам GPS и покажет маршрут, остановки с их длительностью и пробег вместо листания карты в приложении."
        },
        {
          "title": "Все машины в одном ответе",
          "desc": "Агент пройдёт по устройствам аккаунта и сведёт их в один список: где стоит каждая машина, стоит ли на охране, сколько топлива и когда пришёл последний пакет."
        }
      ],
      "how_it_works": [
        "Агент ходит в API StarLine и начинает с аккаунта: читает профиль пользователя, забирает список устройств и уже по каждому устройству поднимает данные и состояние: координаты и скорость с GPS-модуля, охрану, двери и зажигание, уровень топлива, напряжение аккумулятора и температуру двигателя из OBD-диагностики, историю событий и сработавших тревог. Из этого собираются сводки по поездкам за день и по параметрам, которые просели за неделю.",
        "Телематика показывает не машину, а последний пакет, который комплекс успел отправить: в подземном паркинге или при слабой связи данные замирают. Поэтому агент всегда называет время последнего обновления рядом с координатами и не выдаёт вчерашнюю точку за текущую. По той же причине он различает состояние охраны, снятое с комплекса, и команду, которую вы только что отправили: пока не пришёл свежий пакет, это ещё не факт.",
        "Дистанционные команды (постановка на охрану, прогрев двигателя) действуют на настоящий автомобиль, поэтому агент выполняет их только после вашего явного подтверждения в чате и называет устройство, к которому обращается. После команды он перечитывает состояние комплекса и говорит, применилась она или нет. Всё остальное (координаты, диагностика, история поездок) идёт на чтение.",
        "Сессию коннектор поднимает сам: приложение подписывает запрос, аккаунт его подтверждает, и дальше агент работает по выданному токену, продлевая его при истечении. Опрос он ведёт по расписанию или по вашему запросу и укладывается в тысячу обращений в сутки, поэтому состояние машины не дёргается каждую минуту, а история поездок собирается пачкой за период. Про данные, которых комплекс не прислал (датчик не установлен или пропала связь), агент говорит прямо, а не подставляет ноль."
      ],
      "requirements": [
        "Аккаунт StarLine ID, в списке устройств которого числится машина",
        "Русский язык интерфейса кабинета, иначе раздел не появится",
        "Лимит физлица: 1000 запросов в сутки"
      ],
      "faq": [
        {
          "q": "Как подключить StarLine?",
          "a": "Четырьмя значениями: AppId и Secret приложения, созданного в my.starline.ru → «Разработчикам», плюс логин и пароль аккаунта StarLine ID, в списке устройств которого числится машина. Раздел виден только при русском языке интерфейса, одобрение приходит письмом."
        },
        {
          "q": "Что агент видит в StarLine?",
          "a": "Список устройств аккаунта, GPS-координаты и треки, состояние охраны и датчиков, показатели OBD-диагностики и историю событий комплекса."
        },
        {
          "q": "Пишет ли агент в StarLine?",
          "a": "Да, коннектор умеет дистанционные команды, например прогрев двигателя или постановку на охрану. Такие действия агент выполняет только после вашего явного подтверждения."
        },
        {
          "q": "Какие ограничения у API?",
          "a": "Физлицу StarLine отдаёт 1000 запросов в сутки, поэтому непрерывный трекинг секунда в секунду не выйдет: агент опрашивает состояние по расписанию или по вашему запросу."
        }
      ]
    },
    "seo_en": {
      "title": "StarLine API and an AI agent: where the car is right now",
      "description": "Tells you where the car is and whether the alarm is armed, with the time of the last update. Remote engine start and arming run only after you confirm.",
      "headline": "Find out where the car is and how it is doing, from chat",
      "scenarios": [
        {
          "title": "Where the car is right now",
          "desc": "The agent shows the coordinates, the speed and the time of the last update from the GPS module of the unit for every device in the account."
        },
        {
          "title": "State and diagnostics",
          "desc": "The agent checks the alarm, the doors and the ignition, the fuel level, the battery voltage and the engine temperature from OBD data."
        },
        {
          "title": "Remote commands",
          "desc": "The agent runs unit commands (arming the alarm or warming up the engine) after your confirmation in the chat."
        },
        {
          "title": "Trip summary",
          "desc": "On a schedule the agent puts together a summary: trips for the day, alarms that fired and the readings that dropped over the week."
        },
        {
          "title": "Where the car went yesterday",
          "desc": "The agent pulls the day's GPS track point by point and shows the route, the stops with how long each lasted and the mileage, instead of a map to scroll by hand."
        },
        {
          "title": "Every car in one answer",
          "desc": "The agent walks the devices on the account into a single list: where each car stands, whether it is armed, how much fuel is left and when the last packet arrived."
        }
      ],
      "how_it_works": [
        "The agent calls the StarLine API and starts from the account: it reads the user profile, collects the list of devices and then, for each device, pulls its data and state: coordinates and speed from the GPS module, the alarm, doors and ignition, the fuel level, the battery voltage and the engine temperature from OBD diagnostics, the event history and the alarms that fired. Out of that come summaries of the day's trips and of the readings that dropped over the week.",
        "Telematics shows not the car but the last packet the unit managed to send: in an underground car park or with a weak signal the data freezes. So the agent always names the time of the last update next to the coordinates and never passes yesterday's point off as the current one. For the same reason it distinguishes the alarm state read from the unit from a command you have just sent: until a fresh packet arrives, that is not yet a fact.",
        "Remote commands (arming the alarm, warming up the engine) are an action on a real car, so the agent runs them only after your explicit confirmation in the chat and names the device it is addressing. After a command it re-reads the state of the unit and says whether the command took effect or not. Everything else (coordinates, diagnostics, trip history) runs read-only.",
        "The connector raises the session itself: the application signs the request, the account confirms it, and from there the agent works on the issued token, renewing it when it expires. It polls on a schedule or on your request and stays inside the thousand calls a day, so the car's state is not pulled every minute and trip history is collected in one batch for the period. About data the unit did not send (a sensor that is not fitted, a lost signal), the agent says so plainly instead of filling in a zero."
      ],
      "requirements": [
        "A StarLine ID account whose device list holds the car",
        "The cabinet interface language set to Russian, or the section hides",
        "A personal account limit of 1000 requests per day"
      ],
      "faq": [
        {
          "q": "How do I connect StarLine?",
          "a": "With four values: the AppId and Secret of an application created at my.starline.ru under Developers, plus the login and password of the StarLine ID account whose device list holds the car. The section is visible only with the Russian interface language, and approval arrives by email."
        },
        {
          "q": "What does the agent see in StarLine?",
          "a": "The list of devices on the account, GPS coordinates and tracks, the state of the alarm and the sensors, OBD diagnostics readings and the event history of the unit."
        },
        {
          "q": "Does the agent write to StarLine?",
          "a": "Yes, the connector supports remote commands, such as warming up the engine or arming the alarm. The agent performs such actions only after your explicit confirmation."
        },
        {
          "q": "What are the API limits?",
          "a": "StarLine gives an individual 1000 requests per day, so continuous second-by-second tracking is out: the agent polls the state on a schedule or on your request."
        }
      ]
    }
  },
  {
    "key": "taxi_crm",
    "name": "taxiCRM",
    "name_en": "taxiCRM",
    "description": "Для таксопарков: водители, поездки, выплаты, смены, штрафы, авто, аренда",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "taxi-crm",
    "description_en": "For taxi fleets: drivers, rides, payouts, shifts, fines, cars and rentals",
    "search_terms": [
      "такси црм"
    ],
    "guide": {
      "url": "https://taxicrm.ru",
      "steps": [
        {
          "title": "Откройте кабинет парка и запишите поддомен",
          "desc": "Адрес кабинета выглядит как https://вашпарк.taxicrm.ru, и часть до .taxicrm.ru и есть поддомен. Публичный API живёт по тому же адресу.",
          "title_en": "Open the fleet dashboard, note the subdomain",
          "desc_en": "The account address looks like https://yourfleet.taxicrm.ru, and the part before .taxicrm.ru is the subdomain. The public API lives at the same address."
        },
        {
          "title": "В «Настройках компании» откройте «API»",
          "desc": "Путь: «Компания» → «Настройки компании» → «API». Здесь хранится API-ключ парка: им подписывается каждый запрос, подпись считается автоматически.",
          "title_en": "In Company settings open API",
          "desc_en": "Path: «Компания» → «Настройки компании» → “API” (Company → Company settings → API). The fleet API key lives here; every request is signed with it."
        },
        {
          "title": "Скопируйте API-ключ парка",
          "desc": "Ключ один на весь парк и открывает все его данные: водителей, поездки, смены, выплаты, штрафы, аренду. Держите его как пароль.",
          "title_en": "Copy the fleet API key",
          "desc_en": "One key covers the whole fleet and opens all of its data: drivers, trips, shifts, payouts, penalties, rentals. Treat it as a password."
        },
        {
          "title": "Запросите доступ к выплатам в поддержке",
          "desc": "Выплата водителю, изменение баланса и снятие блокировки транзакции открываются только по запросу в поддержку taxiCRM. Чтение данных работает сразу.",
          "title_en": "Ask support to open the payout methods",
          "desc_en": "Driver payout, balance change and payout-block change are granted only on request through taxiCRM support. Reading data works right away."
        }
      ]
    },
    "seo": {
      "title": "taxiCRM и ИИ-агент: минусовые балансы водителей",
      "description": "17 водителей из 143 в минусе на 86 400 ₽. Агент сводит смены с транзакциями taxiCRM до выплаты и показывает машины парка, простоявшие за неделю.",
      "headline": "Сводите балансы водителей до того, как уйдёт выплата",
      "scenarios": [
        {
          "title": "Балансы водителей перед выплатой",
          "desc": "Агент сведёт смены, поездки и транзакции и покажет, кто из водителей ушёл в минус и с каким балансом подходит к выплате."
        },
        {
          "title": "Штрафы и договоры аренды",
          "desc": "Агент соберёт неоплаченные штрафы и договоры аренды на паузе и свяжет их с конкретными машинами и водителями парка."
        },
        {
          "title": "Утренняя сводка по парку",
          "desc": "Агент каждое утро пришлёт итоги за вчера: поездки, смены и транзакции водителей в разрезе кабинетов агрегаторов."
        },
        {
          "title": "Разбор переписки с водителями",
          "desc": "Агент пройдёт по чатам парка, соберёт обращения водителей без ответа и покажет, какие вопросы повторяются чаще других."
        },
        {
          "title": "Найм водителей по воронке",
          "desc": "Агент пройдёт по сделкам воронки парка, покажет, на каком этапе застряли кандидаты, и заведёт нового водителя, когда вы передадите контакт."
        },
        {
          "title": "Машины, которые простояли",
          "desc": "Агент сопоставит автомобили парка со сменами и поездками за неделю и назовёт те, что простояли, хотя договор аренды по ним активен."
        }
      ],
      "how_it_works": [
        "Агент обращается к публичному API taxiCRM на поддомене вашего парка и начинает со списка кабинетов: именно к ним привязаны поездки и транзакции. Дальше читаются водители и их балансы, смены, поездки, выплаты и реквизиты, автомобили и договоры аренды, штрафы, чаты с водителями и воронки CRM парка. Из этого складываются утренняя сводка за вчера, картина задолженностей и список тех, кто подходит к выплате.",
        "Баланс водителя не строчка в карточке, а результат: смены, поездки, удержания, штрафы и переводы ложатся в него транзакциями, и агент пересобирает сумму из них, а не доверяет одному числу. Кабинетов агрегаторов у парка обычно несколько, и один водитель нередко работает сразу через два, так что итог по одному кабинету это часть заработка, а не весь. Поэтому агент всегда называет, по какому кабинету и за какой период посчитано.",
        "На запись агент делает то, что не двигает деньги: регистрирует водителя, заводит сделку в воронке парка или автомобиль, ставит договор аренды на паузу, пишет водителю в чат. Каждое такое действие показывается до отправки: сообщение уходит живому человеку за рулём, а не в отчёт. Денежные методы устроены жёстче: выплата водителю, изменение баланса и снятие блокировки транзакции по спецификации закрыты и отвечают 402, пока их не откроют по запросу в поддержку taxiCRM.",
        "Для подключения нужны поддомен парка и его API-ключ; подпись каждого запроса коннектор считает сам, передавать её вручную не нужно. Ключ парковый, а не пользовательский: отдельной учётной записи за агентом нет, он видит все кабинеты аккаунта, а доступ отзывается сменой ключа. Списки агент читает постранично и всегда с границами периода, поэтому большой парк не превращается в одну тяжёлую выгрузку, а старые смены не тянутся в свежую сводку. Если метод закрыт, смен за период не было или чат пуст, агент скажет это прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Кабинет парка в taxiCRM с доступом к настройкам компании",
        "Договорённость с поддержкой taxiCRM, если нужны выплаты водителям"
      ],
      "faq": [
        {
          "q": "Как подключить taxiCRM?",
          "a": "Поддоменом и API-ключом парка. Поддомен это часть адреса кабинета до .taxicrm.ru, ключ лежит в «Компания» → «Настройки компании» → «API». Подпись запроса коннектор считает сам, передавать её не нужно."
        },
        {
          "q": "Что агент видит в taxiCRM?",
          "a": "Водителей и их балансы, поездки, смены, транзакции, выплаты и реквизиты, автомобили и договоры аренды, штрафы, чаты с водителями и воронки CRM парка."
        },
        {
          "q": "Пишет ли агент в taxiCRM?",
          "a": "Может: регистрировать водителей, заводить сделки и автомобили, ставить аренду на паузу и писать в чат водителю. По умолчанию работает на чтение и сводки."
        },
        {
          "q": "Почему часть методов отвечает 402?",
          "a": "Выплата водителю, изменение баланса и снятие блокировки транзакции по спецификации открываются только по запросу в поддержку taxiCRM. Чтение данных работает сразу после подключения."
        }
      ]
    },
    "seo_en": {
      "title": "taxiCRM and AI agent: negative driver balances",
      "description": "17 of 143 drivers are 86,400 rubles in the red. The agent reconciles taxiCRM shifts with transactions before payout and lists cars that stood idle this week.",
      "headline": "Reconcile driver balances before the payout goes out",
      "scenarios": [
        {
          "title": "Driver balances before payout",
          "desc": "The agent reconciles shifts, trips and transactions and shows which drivers went negative and what balance each one brings into the payout."
        },
        {
          "title": "Fines and rental agreements",
          "desc": "The agent collects unpaid fines and paused rental agreements and links them to specific cars and drivers in the fleet."
        },
        {
          "title": "Morning fleet summary",
          "desc": "Every morning the agent sends yesterday totals: trips, shifts and driver transactions broken down by aggregator cabinets."
        },
        {
          "title": "Review of driver conversations",
          "desc": "The agent goes through fleet chats, collects driver requests left without a reply and shows which questions come up most often."
        },
        {
          "title": "Driver hiring in the pipeline",
          "desc": "The agent walks the deals in the fleet pipeline, shows which stage candidates got stuck at and registers a new driver once you hand over the contact."
        },
        {
          "title": "Cars that stood idle",
          "desc": "The agent matches the fleet cars against shifts and trips for the week and names the ones that never moved while their rental agreement stayed active."
        }
      ],
      "how_it_works": [
        "The agent calls the taxiCRM public API on your fleet subdomain and starts from the list of cabinets, since trips and transactions are tied to those. From there it reads drivers and their balances, shifts, trips, payouts and payment details, cars and rental agreements, fines, driver chats and the fleet CRM pipelines. Out of that come the morning summary for yesterday, the picture of who owes what and the list of drivers approaching a payout.",
        "A driver balance is not a line in a card but a result: shifts, trips, deductions, fines and transfers land in it as transactions, and the agent rebuilds the sum from them instead of trusting a single number. A fleet usually holds several aggregator cabinets, and one driver often works through two at once, so a total from one cabinet is a part of the earnings, not all of them. That is why the agent always names which cabinet and which period a figure covers.",
        "For writes the agent does what does not move money: registers a driver, creates a deal in the fleet pipeline or a car, pauses a rental agreement, messages a driver in chat. Every such action is shown before it is sent: a message goes to a live person behind the wheel, not into a report. Money methods are stricter: paying out a driver, changing a balance and unblocking a transaction are closed by the spec and answer 402 until they are opened on request to taxiCRM support.",
        "The connection is the fleet subdomain plus its API key; the connector signs every request itself, so no signature has to be passed by hand. The key belongs to the fleet rather than to a person: there is no separate user account behind the agent, it sees all the cabinets of the account, and access is revoked by replacing the key. Lists are read page by page and always inside period bounds, so a large fleet never turns into one heavy export and old shifts do not drift into a fresh summary. If a method is closed, there were no shifts in the period or a chat is empty, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A taxiCRM fleet cabinet with access to the company settings",
        "An arrangement with taxiCRM support if you need driver payouts"
      ],
      "faq": [
        {
          "q": "How do I connect taxiCRM?",
          "a": "With the fleet subdomain and API key: the subdomain is the part of your cabinet address before .taxicrm.ru, and the key sits under Company → Company settings → API. The connector signs the request itself, so you do not need to pass a signature."
        },
        {
          "q": "What does the agent see in taxiCRM?",
          "a": "Drivers and their balances, trips, shifts, transactions, payouts and payment details, cars and rental agreements, fines, driver chats and the fleet CRM pipelines."
        },
        {
          "q": "Does the agent write to taxiCRM?",
          "a": "It can: register drivers, create deals and cars, pause a rental and message a driver in chat. By default it works in read and summary mode."
        },
        {
          "q": "Why do some methods answer 402?",
          "a": "Paying out a driver, changing a balance and unblocking a transaction are opened only on request to taxiCRM support, as the spec states. Reading data works right after you connect."
        }
      ]
    }
  },
  {
    "key": "telegram",
    "name": "Telegram Bot",
    "name_en": "Telegram Bot",
    "description": "Собственный бот: агент отвечает в чатах от имени вашего бота",
    "category": "messengers",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "telegram",
    "short_name": "Telegram",
    "short_name_en": "Telegram",
    "description_en": "Your own bot: the agent replies in chats as your bot",
    "search_terms": [
      "телеграм",
      "телеграмм",
      "тг",
      "tg"
    ],
    "guide": {
      "url": "https://t.me/botfather",
      "steps": [
        {
          "title": "Отправьте /newbot в @BotFather",
          "desc": "Откройте @BotFather и отправьте /newbot. Он спросит имя и username: 5–32 символа, латиница, цифры, подчёркивания, окончание «bot».",
          "title_en": "Create the bot with /newbot in @BotFather",
          "desc_en": "Open @BotFather and send /newbot. It asks for a name and a username: 5–32 characters, Latin letters, digits, underscores, ending in “bot”."
        },
        {
          "title": "Скопируйте токен из ответа BotFather",
          "desc": "Токен приходит одним сообщением: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Если потеряли или засветили, новый выдаёт команда /revoke.",
          "title_en": "Copy the token from BotFather's reply",
          "desc_en": "The token arrives in one message: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw. Lost or leaked? Send /revoke for a new one."
        },
        {
          "title": "В «Bot Settings» выключите «Group Privacy»",
          "desc": "В @BotFather: /mybots → ваш бот → «Bot Settings» → «Group Privacy» → выключить. После смены добавьте бота в чат заново.",
          "title_en": "In Bot Settings turn off Group Privacy",
          "desc_en": "In @BotFather: /mybots → your bot → “Bot Settings” → “Group Privacy” → off. After the change, invite the bot to the chat again."
        },
        {
          "title": "Освободите бота от прежней интеграции",
          "desc": "У бота один активный вебхук, и пока он установлен, обновления уходят туда. Если бот уже обслуживает другой сервис или ваш скрипт, заведите отдельного.",
          "title_en": "Free the bot from a previous integration",
          "desc_en": "A bot has one active webhook, and while it is set all updates go there. If this bot already serves another service or your own script, create a separate one."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для Telegram: рассылка и заявки из бота",
      "description": "Разошлёт анонс подписчикам вашего бота и посчитает доставленные, соберёт заявки за неделю с контактами. Нужен только токен от @BotFather, свой сервер не нужен.",
      "headline": "ИИ для Телеграма: ответы в чатах бота без ручной переписки",
      "scenarios": [
        {
          "title": "Автоответы на входящие сообщения",
          "desc": "Агент читает сообщения вашего бота, отвечает на типовые вопросы в тоне бренда и передаёт сложные обращения человеку с готовой сводкой."
        },
        {
          "title": "Приём и сортировка заявок из бота",
          "desc": "Агент разбирает входящие заявки, вытаскивает контакт и суть запроса и складывает их списком, чтобы ничего не потерялось в чате."
        },
        {
          "title": "Уведомления и дайджесты в чат",
          "desc": "Агент присылает в Telegram сводки по продажам, задачам или заявкам на нужный час, без ручной выгрузки и захода в кабинеты."
        },
        {
          "title": "Рассылка сообщений подписчикам бота",
          "desc": "Агент подготовит и отправит сообщение пользователям бота, а после соберёт статистику доставки и ответов."
        },
        {
          "title": "Файлы, присланные в бот",
          "desc": "Агент прочитает вложения из диалога с ботом (фото документа, накладную, выгрузку) и ответит по их содержимому, не выходя из переписки."
        },
        {
          "title": "Команды в рабочей группе",
          "desc": "Агент отработает команды в группе и ответит на реплики к своим сообщениям, честно помечая, что при включённой приватности видит не всю переписку."
        }
      ],
      "how_it_works": [
        "Агент обращается к Bot API на api.telegram.org с токеном вашего бота от @BotFather. Первый вызов, getMe, подтверждает, что токен рабочий, и показывает, какой именно бот подключён. Дальше в работу идут входящие сообщения этого бота, данные их отправителей и вложения: из них агент вытаскивает контакт и суть обращения и складывает заявки списком, чтобы ничего не терялось в потоке чата.",
        "У бота есть две особенности, которые определяют всё остальное. Вебхук у него один: обновления уходят по единственному адресу, и два обработчика на одном токене не уживаются: второй просто перестаёт получать сообщения. А в группах при включённой настройке Group Privacy бот видит только команды и ответы на свои сообщения: остальную переписку Telegram ему не отдаёт, и такую группу агент считает частично видимой, а не пустой.",
        "Пишет агент от имени бота: отвечает на типовые вопросы в тоне бренда, присылает сводки в нужный час и рассылает сообщения пользователям, а после собирает статистику доставки и ответов. Первым он написать не может: Telegram разрешает боту отвечать только тем, кто сам начал с ним диалог. Сложное обращение агент не додумывает, а передаёт человеку с готовой сводкой переписки.",
        "Токен даёт права ровно этого бота: личные чаты вашего аккаунта и переписки, где бота нет, ему недоступны. Скомпрометированный токен отзывается у @BotFather без остановки остального, и старая строка перестаёт работать сразу. Ограничения Telegram на частоту отправки агент соблюдает сам, а если сообщений по запросу нет или бот их не получает из-за приватности, он скажет это прямо."
      ],
      "requirements": [
        "Аккаунт Telegram, с которого создаётся бот",
        "Права администратора в группе, куда добавляется бот"
      ],
      "faq": [
        {
          "q": "Как подключить Telegram-бота?",
          "a": "Создайте бота у @BotFather, скопируйте токен и вставьте его при подключении. Свой сервер не нужен: приём сообщений идёт через вебхук, который настраивается автоматически."
        },
        {
          "q": "Какие данные видит агент?",
          "a": "Только сообщения, которые приходят вашему боту, и данные их отправителей. К личной переписке и другим чатам аккаунта доступа нет: работает именно бот, а не ваш личный Telegram."
        },
        {
          "q": "Может ли агент писать от имени бота?",
          "a": "Да: агент отправляет ответы и рассылки от имени подключённого бота. Если нужно только читать входящие и уведомлять вас, так тоже можно настроить."
        },
        {
          "q": "Что происходит после подключения?",
          "a": "Бот сразу начинает получать сообщения, и агент отвечает по вашему сценарию. Ограничения Telegram на частоту отправки соблюдаются автоматически."
        },
        {
          "q": "Как сделать чат-бот с ИИ в Телеграме?",
          "a": "Чат-бот с ИИ здесь собирается без разработки: вы заводите бота у @BotFather, вставляете токен, и отвечает уже агент. Он разбирает входящие в тоне бренда, вытаскивает из переписки контакт и суть заявки, а то, что не берётся решить сам, передаёт человеку с готовой сводкой диалога."
        }
      ]
    },
    "seo_en": {
      "title": "Telegram bot AI agent: broadcasts and lead intake",
      "description": "Sends an announcement to your bot's subscribers and counts deliveries, then gathers the week's leads with contacts. Just a @BotFather token, no server of your own.",
      "headline": "Answer your Telegram bot messages without typing replies",
      "scenarios": [
        {
          "title": "Auto-replies to incoming messages",
          "desc": "The agent reads the messages sent to your bot, answers routine questions in your brand voice and hands complex cases to a human with a ready summary."
        },
        {
          "title": "Lead intake and triage from the bot",
          "desc": "The agent parses incoming requests, pulls out the contact and the gist of the request and files them in a list so nothing gets lost in the chat."
        },
        {
          "title": "Notifications and digests in chat",
          "desc": "The agent sends sales, task or lead summaries to Telegram at the hour you pick, with no manual exports and no logging into cabinets."
        },
        {
          "title": "Broadcasts to bot subscribers",
          "desc": "The agent prepares and sends a message to your bot users, then collects delivery and reply statistics."
        },
        {
          "title": "Files sent to the bot",
          "desc": "The agent reads the attachments from a chat with the bot (a photo of a document, a delivery note, an export) and answers on their content without leaving the thread."
        },
        {
          "title": "Commands in a work group",
          "desc": "The agent handles commands in a group and replies to messages that answer its own, flagging honestly that with privacy on it does not see the whole thread."
        }
      ],
      "how_it_works": [
        "The agent calls the Bot API at api.telegram.org with the token of your bot from @BotFather. The first call is getMe: it confirms the token works and shows which bot exactly is connected. From there the incoming messages of that bot, the data of their senders and the attachments go into the work: the agent pulls out the contact and the gist of the request and files the leads in a list, so nothing is lost in the flow of the chat.",
        "A bot has two traits that shape everything else. It has a single webhook: updates go to one address only, and two handlers on the same token cannot coexist: the second one simply stops receiving messages. And in groups, with Group Privacy switched on, the bot sees only commands and replies to its own messages: the rest of the conversation is not handed to it by Telegram, and the agent treats such a group as partly visible rather than empty.",
        "The agent writes as the bot: it answers routine questions in your brand voice, sends summaries at the hour you pick and broadcasts messages to users, then collects delivery and reply statistics. It cannot write first: Telegram lets a bot reply only to people who started the conversation themselves. A complex case is not improvised: the agent hands it to a human with a ready summary of the thread.",
        "The token carries exactly this bot's rights: the private chats of your account and conversations without the bot are out of reach. A compromised token is revoked in @BotFather without stopping anything else, and the old string stops working immediately. Telegram sending rate limits are respected by the agent itself, and if there are no messages for your request or the bot is not receiving them because of privacy, it says so directly."
      ],
      "requirements": [
        "A Telegram account to create the bot from",
        "Admin rights in the group the bot is added to"
      ],
      "faq": [
        {
          "q": "How do I connect a Telegram bot?",
          "a": "Create a bot with @BotFather, copy the token and paste it when connecting. You do not need your own server: messages arrive through a webhook that is set up automatically."
        },
        {
          "q": "What data does the agent see?",
          "a": "Only the messages that come to your bot and the data of their senders. There is no access to private correspondence or other chats in the account: the bot is what works, not your personal Telegram."
        },
        {
          "q": "Can the agent write as the bot?",
          "a": "Yes: the agent sends replies and broadcasts from the connected bot. If you only want it to read incoming messages and notify you, that can be set up too."
        },
        {
          "q": "What happens after connecting?",
          "a": "The bot starts receiving messages right away and the agent replies according to your scenario. Telegram sending rate limits are respected automatically."
        },
        {
          "q": "How do I build an AI chatbot in Telegram?",
          "a": "An AI chatbot here takes no development: you register a bot with @BotFather, paste the token, and the agent does the answering. It handles incoming messages in your brand voice, pulls the contact and the substance of a request out of the conversation, and hands anything it should not decide alone to a person with a ready summary of the thread."
        }
      ]
    }
  },
  {
    "key": "tilda",
    "name": "Tilda Publishing",
    "name_en": "Tilda Publishing",
    "description": "Конструктор сайтов: проекты, страницы, экспорт, вебхуки",
    "category": "content",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "tilda",
    "description_en": "Website builder: projects, pages, export and webhooks",
    "search_terms": [
      "тильда"
    ],
    "signup_url": "https://tilda.cc/registration/",
    "guide": {
      "url": "https://tilda.cc/projects/",
      "steps": [
        {
          "title": "Убедитесь, что на аккаунте тариф Business",
          "desc": "API на Тильде открыт только на тарифе Business: на Free и Personal раздел с ключами не появится. Тариф виден в настройках аккаунта на tilda.cc.",
          "title_en": "Make sure the account is on Business",
          "desc_en": "Tilda opens the API to Business plan subscribers only: on Free and Personal the key section does not appear. Check the plan in your tilda.cc account settings."
        },
        {
          "title": "В «Настройках сайта» откройте «Экспорт»",
          "desc": "На tilda.cc откройте проект: «Настройки сайта» → вкладка «Экспорт» → раздел «API». В английской локали: Export → API Integration.",
          "title_en": "In Site Settings open Export",
          "desc_en": "At tilda.cc open the project: Site Settings → Export → API Integration. In the Russian locale it reads «Настройки сайта» → «Экспорт» → “API”."
        },
        {
          "title": "Скопируйте публичный и секретный ключи",
          "desc": "Оба значения лежат рядом: публичный и секретный ключи, длинные цифро-буквенные строки без префикса. Заберите оба: по одному публичному API не отвечает.",
          "title_en": "Copy the public key and the secret key",
          "desc_en": "Both values sit side by side there: a public key and a secret key, long alphanumeric strings with no prefix. Take both: the API needs the secret one too."
        }
      ]
    },
    "seo": {
      "title": "Тильда (Tilda) и ИИ-агент: черновики и старые цены",
      "description": "Тильда (Tilda Publishing): агент покажет страницы, висящие черновиком, и где цены разошлись с прайсом, выгрузит HTML с картинками. Подключение парой ключей API.",
      "headline": "ИИ для Тильды: проверяйте страницы и выгружайте их HTML",
      "scenarios": [
        {
          "title": "Ревизия страниц проекта",
          "desc": "Агент соберёт проекты Тильды и страницы внутри них и покажет, что опубликовано, а что осталось черновиком с прошлой правки."
        },
        {
          "title": "Экспорт страницы на свой хостинг",
          "desc": "Агент выгрузит HTML страницы вместе с путями к её картинкам, стилям и скриптам, в варианте для размещения на своём сервере."
        },
        {
          "title": "Слежение за изменениями сайта",
          "desc": "Агент по расписанию сверит список страниц и сообщит, если появилась новая страница или изменился заголовок публикации."
        },
        {
          "title": "Инвентаризация текстов сайта",
          "desc": "Агент пройдёт по страницам проекта, соберёт их заголовки и содержимое и покажет, где текст дублируется или разошёлся с прайсом."
        },
        {
          "title": "Резервная копия сайта",
          "desc": "Агент выгрузит страницы проекта одну за другой вместе с картинками, стилями и скриптами и соберёт локальную копию сайта, укладываясь в часовой лимит."
        },
        {
          "title": "Что тянет страница",
          "desc": "Агент разберёт полный экспорт страницы и покажет, какие картинки, стили и скрипты она подключает и сколько из них приходит со стороны."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Тильды по паре ключей и начинает со списка проектов и их настроек, а дальше спускается на страницы: алиасы, заголовки, статус публикации. Содержимое он тоже забирает: HTML страницы либо только телом, либо полным документом вместе с путями к картинкам, стилям и скриптам, то есть в том виде, в каком страницу можно положить на свой сервер.",
        "Устройство Тильды диктует темп: список страниц приходит одним запросом, а вот содержимое каждой страницы приходит отдельным. Ревизия сайта на полсотни страниц это полсотни обращений, и агент планирует их под часовой лимит, а не упирается в него на середине. Ещё одна тонкость касается статуса публикации: страница, отредактированная в конструкторе, но не опубликованная, в экспорте отдаст прежнюю версию, и агент показывает такие расхождения.",
        "Писать в Тильду нельзя, и агент этого не скрывает: API отвечает только на GET, создать или изменить страницу через него невозможно. Он только читает и выгружает: сверяет список страниц по расписанию и сообщает о новой странице или смене заголовка, собирает тексты сайта и показывает, где они дублируются или разошлись с прайсом. Правки остаются за вами в конструкторе.",
        "Оба ключа уходят в каждый запрос параметрами: отдельной сессии Тильда не заводит, поэтому доступ отзывается перевыпуском ключей на стороне проекта, а не выходом из аккаунта. Лимит: 150 запросов в час на аккаунт, а дёргать API на каждый визит посетителя Тильда запрещает, поэтому массовый экспорт агент делает последовательно и кэширует выгруженное. Если страниц или доступа нет, он скажет об этом прямо."
      ],
      "requirements": [
        "Доступ к настройкам проекта: владелец или администратор аккаунта",
        "Готовность работать на чтение: страницу через API не изменить",
        "Лимит 150 запросов в час на аккаунт"
      ],
      "faq": [
        {
          "q": "Как подключить Tilda Publishing?",
          "a": "Парой ключей: откройте проект в tilda.cc и зайдите в «Настройки сайта» → «Экспорт» → «API»: публичный и секретный ключи лежат там рядом, нужны оба. Раздел с ключами появляется только на тарифе Business."
        },
        {
          "q": "Что агент видит в Tilda Publishing?",
          "a": "Список проектов и их настройки, страницы с алиасами и статусом публикации, а также HTML страницы: только body или полный документ с ассетами."
        },
        {
          "q": "Пишет ли агент в Tilda Publishing?",
          "a": "Нет. API Тильды отвечает только на GET, создать или изменить страницу через него невозможно, поэтому коннектор работает на чтение и экспорт."
        },
        {
          "q": "Что с лимитами?",
          "a": "150 запросов в час на аккаунт. Тильда запрещает дёргать API на каждый визит посетителя, поэтому при массовом экспорте агент идёт последовательно и кэширует выгруженное."
        }
      ]
    },
    "seo_en": {
      "title": "Tilda Publishing integration: find drafts and stale prices",
      "description": "Shows which site pages are still drafts and where prices drifted from your price list, and exports page HTML with images and styles. Connects with two API keys.",
      "headline": "Audit your Tilda project pages and export their HTML",
      "scenarios": [
        {
          "title": "Audit of project pages",
          "desc": "The agent collects your Tilda projects and the pages inside them and shows what is published and what stayed a draft since the last edit."
        },
        {
          "title": "Exporting a page to your own hosting",
          "desc": "The agent exports the page HTML together with the paths to its images, styles and scripts, in the variant meant for hosting on your own server."
        },
        {
          "title": "Watching the site for changes",
          "desc": "On a schedule the agent compares the page list and reports if a new page appeared or a publication title changed."
        },
        {
          "title": "Inventory of site copy",
          "desc": "The agent walks through project pages, collects their titles and content and shows where text is duplicated or has drifted from the price list."
        },
        {
          "title": "A backup copy of the site",
          "desc": "The agent exports the project pages one by one together with their images, styles and scripts and assembles a local copy of the site within the hourly limit."
        },
        {
          "title": "What a page pulls in",
          "desc": "The agent goes through the full page export and shows which images, styles and scripts it loads and how many of them come from outside."
        }
      ],
      "how_it_works": [
        "The agent calls the Tilda API with the pair of keys and starts from the list of projects and their settings, then goes down to the pages: aliases, titles, publication status. It fetches the content as well: the page HTML either as the body alone or as a full document together with the paths to its images, styles and scripts, that is, in the form in which the page can be put on your own server.",
        "The way Tilda is built sets the pace: the page list arrives in one request, but the content of each page takes a separate one. An audit of a fifty-page site means fifty calls, and the agent plans them against the hourly limit instead of hitting it halfway through. One more subtlety is the publication status: a page edited in the builder but not published returns its previous version in the export, and the agent points such discrepancies out.",
        "Writing to Tilda is not possible, and the agent does not hide that: the API answers GET only, so creating or changing a page through it cannot be done. All it does is read and export: it compares the page list on a schedule and reports a new page or a changed title, collects the site copy and shows where it is duplicated or has drifted from the price list. Edits stay with you in the builder.",
        "Both keys travel in every request as parameters: Tilda opens no session of its own, so access is revoked by reissuing the keys on the project side rather than by signing out. The limit is 150 requests per hour per account, and Tilda forbids hitting the API on every visitor, so the agent runs bulk exports sequentially and caches what it has already pulled. If there are no pages or no access, it says so directly."
      ],
      "requirements": [
        "Access to project settings: account owner or administrator",
        "Read-only work: a page cannot be changed through the API",
        "A limit of 150 requests per hour per account"
      ],
      "faq": [
        {
          "q": "How do I connect Tilda Publishing?",
          "a": "With a pair of keys: open the project at tilda.cc and go to Site settings → Export → API: the public and secret keys sit there side by side and you need both. The keys section appears only on the Business plan."
        },
        {
          "q": "What does the agent see in Tilda Publishing?",
          "a": "The list of projects and their settings, pages with aliases and publication status, and the page HTML, either the body alone or the full document with assets."
        },
        {
          "q": "Does the agent write to Tilda Publishing?",
          "a": "No. The Tilda API answers GET only, so creating or changing a page through it is not possible, and the connector works for reading and export."
        },
        {
          "q": "What about limits?",
          "a": "150 requests per hour per account. Tilda forbids hitting the API on every visitor, so during a bulk export the agent goes sequentially and caches what it has already pulled."
        }
      ]
    }
  },
  {
    "key": "tinkoff",
    "name": "Т-Банк Бизнес",
    "name_en": "T-Bank Business",
    "description": "Счета, выписки, платежи, зарплата, карты",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "tinkoff",
    "short_name": "Т-Банк",
    "short_name_en": "T-Bank",
    "description_en": "Accounts, statements, payments, payroll and cards",
    "search_terms": [
      "тинькофф"
    ],
    "guide": {
      "url": "https://business.tbank.ru",
      "steps": [
        {
          "title": "Войдите в Т-Бизнес под рабочим номером",
          "desc": "Откройте business.tbank.ru и войдите по номеру, к которому привязан доступ к компании. Если на номер оформлено несколько компаний, сверьте ИНН нужной.",
          "title_en": "Sign in to T-Business with your number",
          "desc_en": "Open business.tbank.ru and sign in with the number that holds access to the company. With several companies on one number, check the tax ID."
        },
        {
          "title": "В «Пользователях» проверьте уровень доступа",
          "desc": "«Настройки профиля и доступы» → «Компания» → «Пользователи»: уровня три («Директор», «Подписант», «Менеджер»). Менять уровни может только «Директор».",
          "title_en": "In «Пользователи» check your access level",
          "desc_en": "«Настройки профиля и доступы» → «Компания» → «Пользователи»: there are three levels, «Директор», «Подписант», «Менеджер». Only a «Директор» changes them."
        },
        {
          "title": "В «Доступе к счету» отметьте пользователя",
          "desc": "На главной выберите счёт → «Настройки» → «Доступ к счету» → отметьте пользователя → «Сохранить». Доступ настраивается по каждому счёту отдельно.",
          "title_en": "In «Доступ к счету» tick the user",
          "desc_en": "On the dashboard pick the account → «Настройки» → «Доступ к счету» → tick the user → «Сохранить». Access is per account: an unticked one stays unreachable."
        },
        {
          "title": "Учтите глубину выписки: с июня 2023",
          "desc": "Операции по счетам доступны начиная с июня 2023. За более ранние периоды выписку придётся выгружать из интернет-банка вручную.",
          "title_en": "Mind the depth: data from June 2023",
          "desc_en": "Account operations are available starting from June 2023. For earlier periods you will need a manual statement export from the online bank."
        }
      ]
    },
    "seo": {
      "title": "Т-Банк и ИИ-агент: кассовый разрыв и выписка по счетам",
      "description": "Выписка по счетам Т-Банк Бизнеса: агент заранее скажет, в какой день счёт уйдёт в минус, и сверит операции с проводками 1С. Подключается входом в интернет-банк.",
      "headline": "Получайте утреннюю сводку по счетам Т-Банка прямо в чате",
      "scenarios": [
        {
          "title": "Утренняя сводка по деньгам",
          "desc": "Агент соберёт остатки по счетам Т-Банка, поступления и списания за вчера и пришлёт сводку в Telegram к началу дня."
        },
        {
          "title": "Сверка выписки с 1С",
          "desc": "Агент сверит операции по выписке с проводками в 1С, найдёт расхождения по суммам и контрагентам и покажет недостающие документы."
        },
        {
          "title": "Контроль кассового разрыва",
          "desc": "Агент сведёт остатки, ожидаемые поступления и обязательные платежи на неделю и заранее предупредит о разрыве."
        },
        {
          "title": "Поручение готово к подписи",
          "desc": "Агент подготовит платёжное поручение с реквизитами, суммой и назначением и покажет документ, а подпись и отправка остаются в интернет-банке Т-Бизнеса."
        },
        {
          "title": "Кому и за что платим",
          "desc": "Агент разложит операции месяца по контрагентам и назначениям и покажет, кто из поставщиков стал забирать заметно больше денег, чем раньше."
        },
        {
          "title": "Год в разбивке по месяцам",
          "desc": "Агент соберёт выписку по всем счетам частями, сошьёт её в один ряд операций и покажет обороты по месяцам, назвав границу истории: июнь 2023 года."
        }
      ],
      "how_it_works": [
        "Агент ходит в открытый API Т-Банка Бизнеса: сначала определяет компанию по её реквизитам, затем забирает список расчётных счетов и уже по ним читает выписку. Из этого собираются остатки на утро, поступления и списания за вчера, разбивка операций по контрагентам, сверка выписки с проводками 1С и недельный прогноз кассового разрыва из остатков, ожидаемых поступлений и обязательных платежей.",
        "Выписку API отдаёт не одним срезом, а порциями по счёту и периоду, поэтому длинный отчёт агент собирает частями и сам сшивает их в один ряд операций, не теряя границы дней. Второе ограничение касается глубины истории: операции API отдаёт с июня 2023 года, поэтому годовые сравнения с более ранними периодами агент не строит и честно называет границу, а не достраивает её догадками.",
        "Платёжное поручение агент может подготовить, если выданные права это позволяют: он собирает реквизиты, сумму и назначение и показывает документ вам. Подпись и отправка остаются в банке: без вашего подтверждения деньги никуда не уйдут. Всё остальное происходит на чтение: сводки, сверки и прогнозы не меняют в кабинете ничего, а данные читаются по запросу и не выгружаются целиком.",
        "Подключение идёт входом в интернет-банк: вы авторизуетесь на business.tbank.ru, и доступ выдаётся без копирования токенов. Токен доступа короткоживущий и обновляется автоматически, поэтому регулярная утренняя сводка не рвётся на середине месяца. Список счетов агент перечитывает перед каждым разбором, а не запоминает раз и навсегда. Если данных за период нет или прав не хватает, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Компания с расчётным счётом в Т-Бизнесе.",
        "Права «Директор» у того, кто выдаёт доступ."
      ],
      "faq": [
        {
          "q": "Как подключить Т-Банк Бизнес?",
          "a": "Через вход Т-Банка в один клик (OAuth): вы авторизуетесь в своём интернет-банке, и доступ выдаётся без копирования токенов."
        },
        {
          "q": "Что агент видит по счетам?",
          "a": "Счета, выписки и операции компании в рамках выданных при входе прав. Данные читаются по запросу и не выгружаются целиком."
        },
        {
          "q": "Может ли агент отправить платёж?",
          "a": "Агент может подготовить платёжное поручение, если права это позволяют, но подпись и отправка остаются в банке: без вашего подтверждения деньги никуда не уйдут."
        }
      ]
    },
    "seo_en": {
      "title": "T-Bank AI agent: cash gap warning and statements",
      "description": "The agent adds up balances, incoming and outgoing payments for the week and tells you which day the account dips below zero. Connects by signing in to T-Bank.",
      "headline": "Get a morning summary of your T-Bank accounts right in chat",
      "scenarios": [
        {
          "title": "Morning cash summary",
          "desc": "The agent collects T-Bank account balances and yesterday incoming and outgoing payments and sends a summary to Telegram by the start of the day."
        },
        {
          "title": "Reconciling the statement with 1C",
          "desc": "The agent matches statement operations against entries in 1C, finds discrepancies in amounts and counterparties and shows which documents are missing."
        },
        {
          "title": "Cash-flow gap control",
          "desc": "The agent combines balances, expected incoming payments and mandatory payments for the week and warns about a gap in advance."
        },
        {
          "title": "An order ready to sign",
          "desc": "The agent prepares a payment order with the details, the amount and the purpose and shows you the document, while signing and sending stay in the T-Business internet bank."
        },
        {
          "title": "Who we pay and what for",
          "desc": "The agent splits the month's operations by counterparty and purpose and shows which suppliers started taking noticeably more money than before."
        },
        {
          "title": "A year month by month",
          "desc": "The agent collects the statement across all accounts in parts, stitches it into one run of operations and charts monthly turnover up to the June 2023 boundary."
        }
      ],
      "how_it_works": [
        "The agent calls the T-Bank Business open API: first it identifies the company by its details, then pulls the list of settlement accounts and reads the statement for them. Out of that come morning balances, yesterday's incoming and outgoing payments, a breakdown of operations by counterparty, a reconciliation of the statement against 1C entries and a weekly cash-gap forecast built from balances, expected receipts and mandatory payments.",
        "The API returns a statement in portions by account and period rather than in one slice, so the agent assembles a long report from parts and stitches them into a single run of operations without losing day boundaries. The second limit is history depth: the API returns operations from June 2023 onwards, so the agent builds no year-over-year comparison with earlier periods and names that boundary honestly instead of guessing past it.",
        "The agent can prepare a payment order if the granted rights allow it: it assembles the details, the amount and the purpose and shows you the document. Signing and sending stay in the bank: no money moves anywhere without your confirmation. Everything else happens read-only: summaries, reconciliations and forecasts change nothing in the account, and data is read on demand rather than exported wholesale.",
        "The connection runs as a sign-in to the internet bank: you log in at business.tbank.ru and access is granted without copying any tokens. The access token is short-lived and is refreshed automatically, so a recurring morning summary does not break off in the middle of the month. The agent re-reads the list of accounts before every run rather than memorising it once. If there is no data for the period or the rights fall short, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A company with a settlement account in T-Business.",
        "Director rights for whoever grants the access."
      ],
      "faq": [
        {
          "q": "How do I connect T-Bank Business?",
          "a": "Through T-Bank one-click sign-in (OAuth): you log in to your internet bank and access is granted without copying any tokens."
        },
        {
          "q": "What does the agent see in the accounts?",
          "a": "Company accounts, statements and operations within the rights granted at sign-in. Data is read on demand and is never exported wholesale."
        },
        {
          "q": "Can the agent send a payment?",
          "a": "The agent can prepare a payment order if the rights allow it, but signing and sending stay in the bank: no money moves anywhere without your confirmation."
        }
      ]
    }
  },
  {
    "key": "tinkoff_invest",
    "name": "Т-Инвестиции",
    "name_en": "T-Investments",
    "description": "Инвестиционный API: портфель, котировки, свечи, заявки, поиск инструментов",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "tinkoff-invest",
    "description_en": "Investment API: portfolio, quotes, candles, orders and instrument search",
    "search_terms": [
      "тинькофф инвестиции"
    ],
    "guide": {
      "url": "https://www.tbank.ru/invest/settings/",
      "steps": [
        {
          "title": "Откройте брокерский счёт",
          "desc": "Доступ к T-Invest API даётся после открытия брокерского счёта и подтверждения личности. На Инвесткопилку, Счёт под ключ и Смарт-счёт токен не выпускается.",
          "title_en": "Open a brokerage account",
          "desc_en": "API access is granted only after you open a brokerage account and confirm your identity. Invest Piggy Bank, Turnkey and Smart accounts get no token."
        },
        {
          "title": "Отключите подтверждение сделок кодом",
          "desc": "Пока «Подтверждение сделок кодом» включено, токен выпустить не получится. Второй потолок: сделки дороже 30 000 000 ₽ через API недоступны.",
          "title_en": "Turn off trade confirmation by code",
          "desc_en": "While «Подтверждение сделок кодом» (trade confirmation by code) is on, no token can be issued. Trades above 30,000,000 ₽ are unavailable via the API."
        },
        {
          "title": "Выпустите токен в настройках профиля",
          "desc": "Только в веб-версии: настройки профиля Т-Инвестиции на tbank.ru/invest/settings → выпустите токен T-Invest API для биржи.",
          "title_en": "Issue the token in profile settings",
          "desc_en": "Web version only: «Настройки профиля Т-Инвестиции» (T-Invest profile settings) at tbank.ru/invest/settings → issue a T-Invest API token for the exchange."
        },
        {
          "title": "Скопируйте токен сразу",
          "desc": "Значение видно только при выпуске, повторно его не показывают. Токен живёт три месяца с последнего использования, потом будет ошибка 40003.",
          "title_en": "Copy the token right away",
          "desc_en": "The value is visible only at issue time and never shown again. The token lives three months from its last use; after idling the API returns error 40003."
        }
      ]
    },
    "seo": {
      "title": "Т-Инвестиции и ИИ: портфель и неисполненные заявки",
      "description": "Стоимость портфеля по всем брокерским счетам и заявки, которые до сих пор не исполнены, одним ответом. Хватает токена T-Invest API в режиме read-only.",
      "headline": "Разбирайте портфель Т-Инвестиций и котировки прямо в чате",
      "scenarios": [
        {
          "title": "Состав портфеля",
          "desc": "Агент покажет портфель по всем брокерским счетам: какие бумаги лежат, в каких долях и сколько стоят сейчас."
        },
        {
          "title": "Котировки и динамика",
          "desc": "Агент соберёт котировки и свечи по нужным бумагам и посчитает, как за выбранный период двигалась ваша позиция."
        },
        {
          "title": "Поиск инструмента",
          "desc": "Агент найдёт инструмент по тикеру, названию или ISIN и покажет его параметры, чтобы бумагу не пришлось искать в приложении."
        },
        {
          "title": "Сводка по портфелю",
          "desc": "Агент пришлёт сводку по расписанию: стоимость портфеля, доходность и заметные движения за торговый день."
        },
        {
          "title": "Что висит в заявках",
          "desc": "Агент обойдёт все счета, соберёт выставленные заявки и покажет, что до сих пор не исполнено: по какому инструменту, в каком объёме и по какой цене."
        },
        {
          "title": "Заявка только с подтверждением",
          "desc": "Агент подготовит заявку, назовёт инструмент, объём и цену и отправит её на биржу лишь после вашего «да», а на read-only токене сразу скажет, что прав не хватит."
        }
      ],
      "how_it_works": [
        "Агент ходит в T-Invest API по адресу invest-public-api.tbank.ru/rest и читает четыре домена: брокерские счета и состав портфеля, котировки и свечи по инструментам, справочник бумаг с поиском по тикеру, названию и ISIN, а также выставленные заявки. Первым запросом он получает список счетов: без него неясно, по какому портфелю считать, а счетов у одного токена бывает несколько.",
        "REST здесь служит обёрткой над gRPC-контрактом: каждый вызов это POST на имя метода вида UsersService/GetAccounts, параметры уходят телом, привычных query-строк нет. Портфель отдаётся не общей кучей, а по каждому счёту отдельно, поэтому сводку «сколько всего» агент собирает сам, обойдя счета и сложив позиции. Стоимость в ответе означает текущую рыночную оценку, то есть срез на момент запроса, а не зафиксированный итог дня.",
        "На чтении агент самостоятелен, на действиях нет. Заявки он выставляет только если токен выпущен с full-access: на read-only токене API их просто не примет, и агент назовёт причину, а не сделает вид, что отправил. Перед отправкой на биржу такое действие он отдельно подтверждает с вами. Расчётного счёта, выписки и платёжных поручений здесь нет: это брокерский счёт, а банковские операции живут в коннекторе Т-Банк Бизнес.",
        "Доступ даёт один токен T-Invest API, и все запросы идут от его имени. Токен живёт три месяца с последнего использования: после простоя API отвечает ошибкой 40003, и агент называет эту причину, а не показывает пустую таблицу. Лимиты у методов разные: справочники и котировки щедрее, операции по счёту строже, поэтому историю за длинный период агент запрашивает окнами и держит около двух с половиной запросов в секунду."
      ],
      "requirements": [
        "Доступ к веб-версии: в мобильном приложении токен не выпускают",
        "Full-access, если агент должен выставлять заявки; иначе read-only"
      ],
      "faq": [
        {
          "q": "Как подключить Т-Инвестиции?",
          "a": "Токеном T-Invest API: он выпускается только в веб-версии, в настройках профиля на tbank.ru/invest/settings. Режима read-only хватает для портфеля и котировок, full-access нужен под заявки. Значение показывается один раз и живёт три месяца с последнего использования."
        },
        {
          "q": "Что агент видит в Т-Инвестициях?",
          "a": "Брокерские счета и состав портфеля, котировки и свечи по инструментам, справочник бумаг и выставленные заявки в пределах прав подключённого токена."
        },
        {
          "q": "Это то же, что Т-Банк Бизнес?",
          "a": "Нет. Т-Инвестиции это брокерский счёт: бумаги, котировки и заявки. Расчётный счёт, выписка и платёжные поручения живут в отдельном коннекторе Т-Банк Бизнес."
        },
        {
          "q": "Может ли агент выставить заявку?",
          "a": "Только если вы выпустили токен с full-access: на read-only токене API заявку не примет. Такие действия агент подтверждает с вами перед отправкой на биржу."
        }
      ]
    },
    "seo_en": {
      "title": "T-Investments AI agent: portfolio and open orders",
      "description": "See your portfolio value across all brokerage accounts and the orders still waiting to fill. A read-only T-Invest API token is enough to connect.",
      "headline": "Break down your T-Investments portfolio and quotes in chat",
      "scenarios": [
        {
          "title": "Portfolio composition",
          "desc": "The agent shows the portfolio across all brokerage accounts: which securities you hold, in what proportions and what they are worth right now."
        },
        {
          "title": "Quotes and dynamics",
          "desc": "The agent collects quotes and candles for the securities you need and works out how your position moved over the chosen period."
        },
        {
          "title": "Finding an instrument",
          "desc": "The agent finds an instrument by ticker, name or ISIN and shows its parameters, so you do not have to look the security up in the app."
        },
        {
          "title": "Portfolio summary",
          "desc": "The agent sends a summary on a schedule: portfolio value, returns and notable moves over the trading day."
        },
        {
          "title": "Orders still sitting open",
          "desc": "The agent walks every account, collects the placed orders and shows what is still unfilled: which instrument, in what size and at what price."
        },
        {
          "title": "An order only on confirmation",
          "desc": "The agent prepares an order, names the instrument, size and price and sends it to the exchange only after your yes, and on a read-only token it says upfront that rights fall short."
        }
      ],
      "how_it_works": [
        "The agent calls the T-Invest API at invest-public-api.tbank.ru/rest and reads four domains: brokerage accounts and portfolio composition, quotes and candles for instruments, the securities reference with search by ticker, name and ISIN, and placed orders. Its first request fetches the list of accounts: without it there is no telling which portfolio to count, and one token can cover several accounts.",
        "REST here is a wrapper over a gRPC contract: every call is a POST to a method name of the form UsersService/GetAccounts, parameters travel in the body, and the usual query strings do not exist. The portfolio comes back per account rather than as one pile, so the agent assembles the how-much-in-total summary itself, walking the accounts and adding up positions. The value in the response is the current market valuation, a snapshot at request time rather than a fixed end-of-day total.",
        "On reading the agent is self-sufficient, on actions it is not. It places orders only if the token was issued with full access: on a read-only token the API simply will not accept them, and the agent names the reason instead of pretending it sent something. Before anything goes to the exchange it confirms the action with you separately. There is no current account, statement or payment order here: this is a brokerage account, and banking operations live in the T-Bank Business connector.",
        "Access rests on a single T-Invest API token, and every request goes out in its name. The token lives three months from the last use: after idling the API answers with error 40003, and the agent names that reason instead of showing an empty table. Limits differ per method: reference books and quotes are generous, account operations are stricter, so history over a long period is requested in windows at around two and a half calls per second."
      ],
      "requirements": [
        "Access to the web version, since the mobile app cannot issue tokens",
        "Full access if the agent must place orders; read-only otherwise"
      ],
      "faq": [
        {
          "q": "How do I connect T-Investments?",
          "a": "With a T-Invest API token: it is issued only in the web version, in profile settings at tbank.ru/invest/settings. Read-only mode is enough for the portfolio and quotes, while full access is needed for orders. The value is shown once and lives for three months from the last use."
        },
        {
          "q": "What does the agent see in T-Investments?",
          "a": "Brokerage accounts and portfolio composition, quotes and candles for instruments, the securities reference and placed orders, within the rights of the connected token."
        },
        {
          "q": "Is this the same as T-Bank Business?",
          "a": "No. T-Investments is a brokerage account: securities, quotes and orders. The current account, statements and payment orders live in the separate T-Bank Business connector."
        },
        {
          "q": "Can the agent place an order?",
          "a": "Only if you issued a token with full access: the API will not accept an order on a read-only token. The agent confirms such actions with you before sending them to the exchange."
        }
      ]
    }
  },
  {
    "key": "tk_luch",
    "name": "ТК «Луч»",
    "name_en": "Luch Transport",
    "description": "Грузоперевозки по Уралу: расчёт стоимости, заявки на перевозку, статусы грузов",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "tk-luch",
    "description_en": "Freight across the Urals: cost quotes, shipping orders and cargo status",
    "guide": {
      "url": "https://sites.google.com/view/luch-api/otr-api",
      "steps": [
        {
          "title": "Попросите токены у ОТР ИТ: info@otr-it.ru",
          "desc": "Запрос на подключение к API ТК «Луч» пишется в свободной форме. Обычно ОТР ИТ заводит рабочий чат в Telegram с вашими сотрудниками.",
          "title_en": "Ask OTR IT for tokens: info@otr-it.ru",
          "desc_en": "The request to connect to the TK Luch API is free-form. OTR IT usually sets up a working Telegram chat with your team."
        },
        {
          "title": "Получите токены X-User и X-Token",
          "desc": "Оба токена приходят в рабочий чат и выглядят как длинные коды из букв и цифр. Для проверки и для работы пара одна и та же.",
          "title_en": "Receive the X-User and X-Token tokens",
          "desc_en": "Both tokens arrive in the working chat and look like UUIDs. The same pair works for the test stand and the production API."
        },
        {
          "title": "Проверьте договор с ТК «Луч»",
          "desc": "Заявки из API оформляются на организацию, к которой привязана учётная запись. Уточните у менеджера, кто плательщик и какой способ оплаты по договору.",
          "title_en": "Check your contract with TK Luch",
          "desc_en": "Orders placed through the API are filed under the organisation the account is tied to. Ask your manager who pays and which payment method the contract uses."
        }
      ]
    },
    "seo": {
      "title": "ТК «Луч» и ИИ-агент: расчёт стоимости и заявка по Уралу",
      "description": "Рассчитает стоимость на калькуляторе «Луча»: паллет 120 кг в Тюмень, 2 950 ₽ со страховкой. Заявку отправит после подтверждения, про забор после 15:00 предупредит.",
      "headline": "ИИ для грузоперевозок по Уралу: расчёт и заявки ТК «Луч» в чате",
      "scenarios": [
        {
          "title": "Стоимость перевозки за минуту",
          "desc": "Агент посчитает перевозку между городами Урала по весу, габаритам и объявленной стоимости, с забором, доставкой до двери и упаковкой."
        },
        {
          "title": "Заявка на перевозку",
          "desc": "Агент соберёт заявку с отправителем, получателем, грузоместами и услугами, покажет её целиком и отправит в ТК «Луч» после вашего подтверждения."
        },
        {
          "title": "Где сейчас груз",
          "desc": "Агент поднимет статус и историю перемещения по складам для каждой заявки и пришлёт сводку: что в пути, что прибыло и что ждёт оплаты."
        },
        {
          "title": "Заявки за период",
          "desc": "Агент выгрузит отправленные заявки за месяц с городами, получателями и статусами и сведёт их в таблицу для сверки с отгрузками."
        },
        {
          "title": "Проверка города перед отправкой",
          "desc": "Агент сверит город или отдалённый район со справочником ТК «Луч» и подскажет, где забор или доставка обязательны и какие ограничения по весу."
        },
        {
          "title": "Черновик поручения для ЭДО",
          "desc": "Агент получит XML-черновик поручения экспедитору по заявке, чтобы вы подписали его в своей системе ЭДО без ручного заполнения."
        }
      ],
      "how_it_works": [
        "Агент работает с OTR-API транспортной компании «Луч»: читает справочники городов, услуг и упаковок, считает стоимость перевозки на калькуляторе компании, создаёт заявки на грузоперевозку и поднимает по ним статус, суммы к оплате и историю движения по складам. Покрытие такое же, как у самой компании: весь Урал (Челябинская, Свердловская, Тюменская, Курганская и Оренбургская области, Пермский край, Башкортостан, Удмуртия), Татарстан и Самара, ХМАО и ЯНАО, Стрежевой и Казахстан. Точный список пунктов агент каждый раз берёт из справочника компании.",
        "Город в заявке задаётся не строкой, а идентификатором из справочника, и отдалённые районы записаны там в виде «Посёлок (Город)». Поэтому агент сначала находит город в справочнике и только потом считает или оформляет, а для расчёта просит у вас вес, габариты каждого места и объявленную стоимость груза. Размеры он не придумывает: цена перевозки зависит от объёма, и выдуманная коробка даёт выдуманную сумму.",
        "Всё, что тратит деньги, агент сначала показывает целиком: маршрут, грузоместа, услуги, кто и как платит. Заявка уходит в ТК «Луч» только после вашего подтверждения. Заявку на забор день в день компания принимает до 15:00 по Челябинску, и агент предупредит, если время уже прошло и забор перенесётся на завтра.",
        "Подключение держится на паре токенов X-User и X-Token, которые выдаёт разработчик системы, компания ОТР ИТ. Агент подписывает ими каждый запрос к B2B-части, а калькулятору передаёт только идентификатор, без секретного токена. Если какого-то значения в ответе нет, агент говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Токены X-User и X-Token от ОТР ИТ (запрос на Info@otr-it.ru)",
        "Ваше подтверждение перед созданием заявки на перевозку"
      ],
      "faq": [
        {
          "q": "Как подключить ТК «Луч»?",
          "a": "Парой токенов X-User и X-Token. Их выдаёт ОТР ИТ по письму в свободной форме на Info@otr-it.ru, обычно через рабочий чат в Telegram. Токены для тестового стенда и боевого API одинаковые."
        },
        {
          "q": "Что агент видит в ТК «Луч»?",
          "a": "Справочники городов, услуг и упаковок, расчёт стоимости перевозки, отправленные заявки за период, статус и историю каждой перевозки, суммы к оплате и черновик поручения экспедитору."
        },
        {
          "q": "Пишет ли агент в ТК «Луч»?",
          "a": "Да, агент создаёт заявки на грузоперевозку, и каждую он показывает вам и отправляет только после подтверждения. Остальная работа сводится к расчётам и чтению статусов."
        },
        {
          "q": "Куда возит ТК «Луч»?",
          "a": "По Уралу и соседним регионам: Челябинская, Свердловская, Тюменская, Курганская, Оренбургская и Самарская области, Пермский край, Башкортостан, Татарстан, Удмуртия, ХМАО, ЯНАО, Стрежевой в Томской области и Казахстан. Точный список городов и отдалённых районов, около 960 пунктов, агент берёт из справочника компании."
        }
      ]
    },
    "seo_en": {
      "title": "Luch Transport and an AI agent: Ural freight quotes",
      "description": "Prices a shipment on the Luch calculator: one pallet, 120 kg to Tyumen, 2,950 RUB insured. Files the order only after you confirm and flags the 15:00 pickup cutoff.",
      "headline": "AI for Ural freight: TK Luch quotes and shipment orders in chat",
      "scenarios": [
        {
          "title": "A freight quote in a minute",
          "desc": "The agent prices a shipment between Ural cities by weight, dimensions and declared value, including pickup, door delivery and packaging."
        },
        {
          "title": "A shipment order",
          "desc": "The agent assembles an order with sender, consignee, cargo places and services, shows it in full and sends it to TK Luch after you confirm."
        },
        {
          "title": "Where the cargo is now",
          "desc": "The agent pulls the status and warehouse movement history for every order and sends a summary: what is in transit, what arrived and what awaits payment."
        },
        {
          "title": "Orders for a period",
          "desc": "The agent exports the orders sent over a month with cities, consignees and statuses and lays them out in a table to reconcile against your shipments."
        },
        {
          "title": "City check before shipping",
          "desc": "The agent checks a city or remote area against the TK Luch directory and tells you where pickup or delivery is mandatory and what the weight limits are."
        },
        {
          "title": "A draft forwarding order for EDI",
          "desc": "The agent fetches the XML draft of the forwarding instruction for an order, so you can sign it in your EDI system without filling it in by hand."
        }
      ],
      "how_it_works": [
        "The agent works with the OTR-API of the Luch transport company: it reads the directories of cities, services and packaging, prices a shipment on the company calculator, creates freight orders and pulls their status, amounts due and warehouse movement history. Coverage matches the company itself: the whole Urals (the Chelyabinsk, Sverdlovsk, Tyumen, Kurgan and Orenburg regions, Perm Krai, Bashkortostan, Udmurtia), Tatarstan and Samara, KhMAO and YaNAO, Strezhevoy and Kazakhstan. The agent takes the exact list of points from the company directory every time.",
        "A city in an order is not a string but an identifier from the directory, and remote areas are listed there as «Village (City)». So the agent first finds the city in the directory and only then prices or files the order, and for a quote it asks you for the weight, the dimensions of every place and the declared value of the cargo. It does not invent dimensions: the price depends on volume, and an invented box gives an invented total.",
        "Anything that spends money the agent first shows in full: route, cargo places, services, who pays and how. The order goes to TK Luch only after your confirmation. The company accepts same-day pickup orders until 15:00 Chelyabinsk time, and the agent warns you when that time has passed and the pickup will move to the next day.",
        "The connection rests on a pair of tokens, X-User and X-Token, issued by the system developer, OTR IT. The agent signs every request to the B2B part with them, while the calculator receives only the identifier and never the secret token. When a value is missing from a response the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "X-User and X-Token from OTR IT (request at Info@otr-it.ru)",
        "Your confirmation before a freight order is created"
      ],
      "faq": [
        {
          "q": "How do I connect TK Luch?",
          "a": "With the X-User and X-Token pair. OTR IT issues them on a free-form request to Info@otr-it.ru, usually through a working Telegram chat. The tokens are the same for the test stand and the production API."
        },
        {
          "q": "What can the agent see in TK Luch?",
          "a": "Directories of cities, services and packaging, freight quotes, orders sent over a period, the status and history of every shipment, amounts due and the draft forwarding instruction."
        },
        {
          "q": "Does the agent write to TK Luch?",
          "a": "Yes, the agent creates freight orders, and it shows each one to you and sends it only after confirmation. Everything else is quoting and reading statuses."
        },
        {
          "q": "Where does TK Luch deliver?",
          "a": "Across the Urals and neighbouring regions: the Chelyabinsk, Sverdlovsk, Tyumen, Kurgan, Orenburg and Samara regions, Perm Krai, Bashkortostan, Tatarstan, Udmurtia, KhMAO, YaNAO, Strezhevoy in the Tomsk region and Kazakhstan. The exact list of cities and remote areas, about 960 points, the agent takes from the company directory."
        }
      ]
    }
  },
  {
    "key": "tochka",
    "name": "Точка Банк",
    "name_en": "Tochka Bank",
    "description": "Счета, выписки, платежи, СБП",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "tochka",
    "short_name": "Точка",
    "short_name_en": "Tochka Bank",
    "description_en": "Accounts, statements, payments and SBP fast payments",
    "guide": {
      "url": "https://enter.tochka.com",
      "steps": [
        {
          "title": "В «Сервисах» откройте «Интеграции и API»",
          "desc": "Интернет-банк Точки → «Сервисы» → «Все сервисы» → «Интеграции и API». Раздел открыт пользователю с правом на интеграции.",
          "title_en": "In «Сервисы» open «Интеграции и API»",
          "desc_en": "Tochka internet bank → the «Сервисы» tab → «Все сервисы» → «Интеграции и API». Sign in as the user whose phone you have: the key is confirmed by SMS."
        },
        {
          "title": "Нажмите «Создать JWT-ключ»",
          "desc": "Укажите название ключа и срок доступа, затем «Продолжить». Refresh-токена у JWT нет: по истечении срока ключ перевыпускается вручную.",
          "title_en": "Click «Создать JWT-ключ»",
          "desc_en": "Give the key a name and an access period, then «Продолжить». A JWT has no refresh token: once it expires you reissue by hand, and token and client_id change."
        },
        {
          "title": "Выдайте разрешения и подтвердите смс",
          "desc": "По умолчанию отмечены все разрешения; для нескольких компаний права задаются отдельно. Без прав на счета и выписки запросы вернут «Forbidden by consent».",
          "title_en": "Grant the permissions and confirm by SMS",
          "desc_en": "All permissions are ticked by default; with several companies rights are set per company. Without accounts and statements you get “Forbidden by consent”."
        },
        {
          "title": "В «JWT-ключах» скопируйте токен и client_id",
          "desc": "Ключ появится в разделе «JWT-ключи»: скопируйте его вместе с client_id рядом. Удаление ключа здесь же мгновенно закрывает доступ: запросы начнут отвечать 403.",
          "title_en": "In «JWT-ключи» copy the token and client_id",
          "desc_en": "The key lands in the «JWT-ключи» section; copy it together with the client_id shown next to it. Deleting it there cuts access instantly: requests return 403."
        }
      ]
    },
    "seo": {
      "title": "Точка и ИИ-агент: дубли платежей и поступления по СБП",
      "description": "Задвоенные платежи и забытые подписки за месяц, а заодно сумма поступлений по СБП. Точка Банк подключается JWT-токеном из кабинета, деньги агент не двигает.",
      "headline": "Следите за движением денег по счетам Точки прямо в чате",
      "scenarios": [
        {
          "title": "Движение денег за день",
          "desc": "Агент соберёт поступления, списания и остатки по счетам Точки и пришлёт короткую сводку каждое утро."
        },
        {
          "title": "Сверка банка с учётом",
          "desc": "Агент сверит выписку Точки с проводками 1С за период и покажет расхождения по суммам и контрагентам."
        },
        {
          "title": "Поиск дублей и лишних списаний",
          "desc": "Агент проверит платежи за месяц, найдёт задвоенные оплаты и забытые подписки."
        },
        {
          "title": "Платёжный календарь на неделю",
          "desc": "Агент сведёт обязательные платежи и ожидаемые поступления и предупредит о кассовом разрыве заранее."
        },
        {
          "title": "Поступления по СБП",
          "desc": "Агент поднимет операции СБП за период, разложит их по счетам и покажет, сколько пришло быстрыми платежами и в какие дни поток проседал."
        },
        {
          "title": "История по контрагенту",
          "desc": "Агент обойдёт счета, соберёт операции с контрагентом за квартал и покажет суммы и даты, сверяя по реквизитам, а не по тому, как имя написал плательщик."
        }
      ],
      "how_it_works": [
        "Агент работает с открытым банковским API Точки на enter.tochka.com/uapi: список счетов и остатки, выписки и операции за период, платежи и СБП. Из этого он считает утреннюю сводку по движению денег, ищет задвоенные оплаты и забытые подписки за месяц и строит платёжный календарь, где обязательные списания сведены с ожидаемыми поступлениями, чтобы кассовый разрыв был виден заранее, а не в день нехватки.",
        "Данные в Open Banking разложены по счетам: выписка запрашивается по конкретному счёту за конкретный период, поэтому агент сначала перечисляет счета организации, а затем обходит каждый: общая картина «по всем счетам» собирается на нашей стороне, готовой она не приходит. Имя контрагента в выписке показывает то, как его написал плательщик, поэтому при сверке с учётом агент опирается на сумму, дату и реквизиты, а строку названия использует как подсказку.",
        "Деньгами агент не распоряжается: подпись платежей остаётся на стороне банка, и вывести средства он не может по устройству доступа, а не по договорённости. Он показывает дубли и лишние списания, но не отменяет их сам; он сверяет выписку Точки с проводками 1С и выкладывает расхождения по суммам и контрагентам, оставляя решение за вами. Всё, что меняет остаток, заканчивается вашим подтверждением в интернет-банке.",
        "Выписку API отдаёт постранично и с небольшой задержкой после проводки, поэтому утреннюю сводку агент собирает по закрытому предыдущему дню, а не по текущему часу. Права на счета и выписки зашиты в сам ключ, и при их нехватке приходит «Forbidden by consent», и эту причину агент называет прямо, а не списывает пустоту на отсутствие операций. Срок доступа фиксируется при выпуске, refresh-токена в схеме нет."
      ],
      "requirements": [
        "Доступ в интернет-банк Точки под пользователем с правом на интеграции",
        "Телефон для смс-подтверждения под рукой",
        "Подпись платежей остаётся в банке: вывести деньги агент не может"
      ],
      "faq": [
        {
          "q": "Как подключить Точку?",
          "a": "JWT-токеном из кабинета Точка Банка (раздел API). Токен хранится в зашифрованном виде и отзывается в кабинете банка в любой момент."
        },
        {
          "q": "Какие операции доступны агенту?",
          "a": "Счета, выписки, операции и СБП в рамках прав токена. Для аналитики достаточно прав на чтение выписок."
        },
        {
          "q": "Насколько это безопасно?",
          "a": "Токен шифруется при хранении (AES-256/ГОСТ), передача по TLS 1.3, серверы в РФ, 152-ФЗ. Агент не может вывести деньги: подпись платежей остаётся на стороне банка."
        }
      ]
    },
    "seo_en": {
      "title": "Tochka Bank AI agent: duplicate payments and SBP inflow",
      "description": "The agent finds double payments and forgotten subscriptions for the month and totals what came in via SBP. Connects with a JWT token from the bank's cabinet.",
      "headline": "Follow the daily cash movement on Tochka accounts in chat",
      "scenarios": [
        {
          "title": "Daily cash movement",
          "desc": "The agent collects incoming payments, outgoing payments and balances across Tochka accounts and sends a short summary every morning."
        },
        {
          "title": "Reconciling the bank with accounting",
          "desc": "The agent matches the Tochka statement against entries in 1C for a period and shows discrepancies in amounts and counterparties."
        },
        {
          "title": "Finding duplicates and stray charges",
          "desc": "The agent checks the payments for the month and finds doubled charges and forgotten subscriptions."
        },
        {
          "title": "Payment calendar for the week",
          "desc": "The agent combines mandatory payments and expected incoming funds and warns about a cash-flow gap in advance."
        },
        {
          "title": "Incoming SBP payments",
          "desc": "The agent pulls SBP operations for a period, lays them out per account and shows how much came in through fast payments and on which days the flow dipped."
        },
        {
          "title": "History with one counterparty",
          "desc": "The agent walks the accounts, collects operations with one counterparty over the quarter and shows amounts and dates, matching by requisites rather than by the typed name."
        }
      ],
      "how_it_works": [
        "The agent works with the Tochka open banking API at enter.tochka.com/uapi: the list of accounts and balances, statements and operations for a period, payments and SBP. Out of that it builds the morning cash movement summary, looks for doubled charges and forgotten subscriptions over the month and puts together a payment calendar where mandatory charges meet expected incoming funds, so a cash-flow gap is visible in advance rather than on the day money runs short.",
        "Data in Open Banking is laid out per account: a statement is requested for a specific account over a specific period, so the agent first lists the accounts of the company and then walks each one: the picture across all accounts is assembled on our side, it does not arrive ready-made. The counterparty name in a statement is whatever the payer typed, so when reconciling against accounting the agent relies on the amount, the date and the requisites, and treats the name string as a hint.",
        "The agent does not handle money: payment signing stays on the bank side, and it cannot withdraw funds by the design of the access, not by agreement. It shows duplicates and stray charges but does not cancel them itself; it matches the Tochka statement against 1C entries and lays out discrepancies in amounts and counterparties, leaving the decision to you. Anything that changes a balance ends with your confirmation in the internet bank.",
        "Statements come back page by page and with a small delay after a transaction is posted, so the agent assembles the morning summary from the closed previous day rather than from the current hour. Account and statement permissions are baked into the key itself, and when they are missing the answer is Forbidden by consent, and the agent names that reason instead of passing the emptiness off as an absence of operations. The access period is fixed at issue time and the scheme has no refresh token."
      ],
      "requirements": [
        "Access to Tochka internet bank as a user allowed to manage integrations",
        "The phone that receives the confirmation SMS at hand",
        "Payment signing stays with the bank: the agent cannot move money"
      ],
      "faq": [
        {
          "q": "How do I connect Tochka?",
          "a": "With a JWT token from the Tochka Bank cabinet (the API section). The token is stored encrypted and can be revoked in the bank cabinet at any moment."
        },
        {
          "q": "Which operations are available to the agent?",
          "a": "Accounts, statements, operations and SBP, within the token rights. Read access to statements is enough for analytics."
        },
        {
          "q": "How safe is this?",
          "a": "The token is encrypted at rest (AES-256/GOST), transfer runs over TLS 1.3, servers are in Russia, compliant with Federal Law 152-FZ. The agent cannot withdraw money: payment signing stays on the bank side."
        }
      ]
    }
  },
  {
    "key": "twitter",
    "name": "Twitter (X)",
    "name_en": "Twitter (X)",
    "description": "Поиск твитов, упоминания, ответы, профили, подписчики, тренды, Spaces",
    "category": "messengers",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "never",
    "has_own_page": false,
    "integration_slug": null,
    "short_name": "X (Twitter)",
    "short_name_en": "X (Twitter)",
    "description_en": "Tweet search, mentions, replies, profiles, followers, trends and Spaces",
    "search_terms": [
      "твиттер"
    ],
    "guide": {
      "url": "https://twitterapi.io",
      "steps": [
        {
          "title": "Зарегистрируйтесь на twitterapi.io",
          "desc": "Аккаунт заводится по почте без карты, на баланс сразу падает $0,1 кредитов. Аккаунт X Developer и одобрение заявки не нужны: доступ выдаётся сразу.",
          "title_en": "Sign up at twitterapi.io",
          "desc_en": "An account is created with just an email, no card required, and $0.1 in free credits lands on the balance. No X Developer account and no application review."
        },
        {
          "title": "Скопируйте ключ с главной «Dashboard»",
          "desc": "После входа откройте «Dashboard»: ключ показан прямо на его главной странице. Скопируйте строку целиком, отдельного секрета к ключу нет.",
          "title_en": "Copy the key from the “Dashboard”",
          "desc_en": "After signing in open the “Dashboard”: the key is displayed right on its home page. Copy the whole string; there is no separate secret alongside it."
        },
        {
          "title": "Пополните баланс под объём задач",
          "desc": "Оплата поэлементная, без подписки: $0,15 за 1000 твитов и $0,18 за 1000 профилей. Стартовых $0,1 хватает на пробу, дальше баланс нужно пополнить.",
          "title_en": "Top up the balance for your workload",
          "desc_en": "Billing is per call, with no subscription: $0.15 per 1k tweets and $0.18 per 1k user profiles. The starting $0.1 covers a trial run; then you top up."
        }
      ]
    },
    "seo": {
      "title": "X (Twitter) и ИИ: упоминания бренда за сутки",
      "description": "Соберёт упоминания бренда за сутки и отметит те, что требуют ответа сегодня, разберёт аккаунт конкурента. Только чтение, ключ twitterapi.io вместо X Developer.",
      "headline": "Отслеживайте упоминания бренда в X без аккаунта разработчика",
      "scenarios": [
        {
          "title": "Упоминания бренда за сутки",
          "desc": "Агент соберёт упоминания вашего бренда в X за нужное окно и покажет, на какие из них стоит ответить первыми."
        },
        {
          "title": "Разбор аккаунта конкурента",
          "desc": "Агент посмотрит профиль конкурента: подписчиков, частоту постинга и то, какие твиты и ответы собрали заметный отклик."
        },
        {
          "title": "Тред и реакции на твит",
          "desc": "Агент развернёт тред целиком, соберёт реплаи и цитаты за нужное окно и покажет, как аудитория отреагировала на пост."
        },
        {
          "title": "Тренды и тематические списки",
          "desc": "Агент покажет актуальные тренды по региону и таймлайн нужного списка или сообщества, чтобы не листать ленту вручную."
        },
        {
          "title": "Кто пишет о вашей теме",
          "desc": "Агент прогонит расширенный поиск по ключевым словам за нужное окно и покажет, какие аккаунты обсуждают тему и чьи посты собрали заметный отклик."
        },
        {
          "title": "Портрет подписчиков аккаунта",
          "desc": "Агент поднимет список подписчиков профиля и покажет, кто из них заметен по размеру аудитории и о чём пишет, чтобы понимать, кто вас читает."
        }
      ],
      "how_it_works": [
        "Агент ходит в X через twitterapi.io: профиль и подписчики аккаунта, его последние твиты, расширенный поиск по запросу и временному окну, а дальше упоминания, реплаи, цитаты и треды целиком, тренды по регионам, листы, сообщества и метаданные Spaces. На этой основе он собирает мониторинг бренда за сутки, разбирает аккаунт конкурента по частоте постинга и отклику и показывает, на какие упоминания стоит ответить первыми.",
        "Ключевая особенность этого пути: доступ идёт не через аккаунт X Developer, а через сторонний сервис-посредник с одним ключом, поэтому одобрения заявки ждать не нужно, но и видно ровно то, что публично. Личных сообщений, приватных аккаунтов и внутренней аналитики вашего профиля здесь нет. Полнота выборки задаётся запросом и окном поиска: агент формулирует их явно и говорит, за какой период посчитал, а не выдаёт срез за случайный интервал.",
        "Пишущих действий у этой интеграции нет вообще: она работает только на чтение. Агент не публикует твиты, не отвечает и не ставит реакции от вашего имени: подготовленный ответ он отдаёт вам текстом, а разместить его вы решаете сами. Это ограничение источника, а не настройка прав: включить запись выдачей дополнительного доступа нельзя, поэтому и риска случайного действия в вашем аккаунте здесь не возникает.",
        "Оплата здесь поэлементная, без месячной подписки: счёт растёт с каждой тысячей прочитанных твитов и профилей, поэтому объём выборки напрямую стоит денег. Из-за этого агент не выгребает ленту подряд: он сужает запрос и окно поиска, забирает профили пачкой вместо запроса на каждого автора и переиспользует уже поднятые треды. Частоту запросов он выдерживает сам, а если данных нет из-за баланса или ключа, скажет об этом прямо, а не покажет пустой список."
      ],
      "requirements": [
        "Способ оплаты для пополнения баланса (подписки здесь нет)",
        "Интеграция только на чтение: публикация твитов недоступна"
      ],
      "faq": [
        {
          "q": "Как подключить Twitter (X)?",
          "a": "Одним ключом API от twitterapi.io: зарегистрируйтесь по почте, откройте «Dashboard» и скопируйте ключ с главной страницы. Аккаунт X Developer и одобрение заявки не нужны, отдельного секрета к ключу нет."
        },
        {
          "q": "Что агент видит в X?",
          "a": "Публичные данные: профили и подписчиков, твиты аккаунта, упоминания, реплаи, цитаты и треды, тренды по регионам, листы, сообщества и метаданные Spaces."
        },
        {
          "q": "Пишет ли агент в X?",
          "a": "Нет. Интеграция работает только на чтение: агент собирает и разбирает публичные данные, но не публикует твиты и не отвечает от вашего имени."
        },
        {
          "q": "Как оплачивается доступ?",
          "a": "Поэлементно, без месячной подписки: тарификация идёт за тысячу твитов и за тысячу профилей. Стартовых кредитов хватает на пробу, для регулярного мониторинга баланс нужно пополнить."
        }
      ]
    },
    "seo_en": {
      "title": "X (Twitter) AI agent: brand mentions over the past day",
      "description": "Gathers the past day's brand mentions, flags the ones that need a reply today and breaks down a competitor account. Read only, a twitterapi.io key, no X Developer.",
      "headline": "Track brand mentions on X without a developer account",
      "scenarios": [
        {
          "title": "Brand mentions over the past day",
          "desc": "The agent gathers mentions of your brand on X for the window you need and shows which ones deserve a reply first."
        },
        {
          "title": "Breakdown of a competitor account",
          "desc": "The agent looks through a competitor profile: followers, posting cadence and which tweets and replies drew real engagement."
        },
        {
          "title": "Thread and reactions to a tweet",
          "desc": "The agent unrolls the whole thread, collects replies and quotes for the window you need and shows how the audience reacted to the post."
        },
        {
          "title": "Trends and topical lists",
          "desc": "The agent surfaces current trends for a region and the timeline of the list or community you care about, so nobody scrolls the feed by hand."
        },
        {
          "title": "Who is talking about your topic",
          "desc": "The agent runs an advanced search on your keywords for the window you need and shows which accounts discuss the topic and whose posts drew real engagement."
        },
        {
          "title": "A portrait of the followers",
          "desc": "The agent pulls the follower list of a profile and shows which of them stand out by audience size and what they post about, so you know who is reading you."
        }
      ],
      "how_it_works": [
        "The agent reaches X through twitterapi.io: an account profile and its followers, its latest tweets, an advanced search by query and time window, and from there mentions, replies, quotes and whole threads, trends by region, lists, communities and Spaces metadata. On that basis it assembles a day of brand monitoring, breaks a competitor account down by posting cadence and engagement, and shows which mentions deserve a reply first.",
        "The key specific of this route is that access runs not through an X Developer account but through a third-party intermediary with a single key, so there is no application approval to wait for, and equally, only what is public is visible. Direct messages, private accounts and the internal analytics of your own profile are not here. How complete a sample is depends on the query and the search window: the agent states them explicitly and says which period it counted, rather than handing over a slice of some random interval.",
        "This integration has no write actions at all: it is read-only. The agent does not publish tweets, does not reply and does not react on your behalf: a drafted reply comes back to you as text, and posting it is your decision. That is a limit of the source, not a permissions setting: writing cannot be switched on by granting extra access, so no accidental action in your account can arise here either.",
        "Billing here is per item with no monthly subscription: the bill grows with every thousand tweets and profiles read, so the size of a sample is money spent directly. Because of that the agent does not sweep the feed row by row: it narrows the query and the search window, fetches profiles in batches instead of one call per author, and reuses threads it has already pulled. It holds the request rate itself, and if data is missing because of the balance or the key, it says so directly instead of showing an empty list."
      ],
      "requirements": [
        "A payment method to top up the balance (there is no plan)",
        "Read-only integration: publishing tweets is not available"
      ],
      "faq": [
        {
          "q": "How do I connect Twitter (X)?",
          "a": "With a single twitterapi.io API key: sign up with your email, open Dashboard and copy the key from the main page. No X Developer account and no application approval are required, and the key has no separate secret."
        },
        {
          "q": "What does the agent see on X?",
          "a": "Public data: profiles and followers, tweets from an account, mentions, replies, quotes and threads, trends by region, lists, communities and Spaces metadata."
        },
        {
          "q": "Does the agent post to X?",
          "a": "No. The integration is read-only: the agent collects and analyses public data, but it does not publish tweets and does not reply on your behalf."
        },
        {
          "q": "How is access billed?",
          "a": "Per item, with no monthly subscription: pricing is charged per thousand tweets and per thousand profiles. Starter credits are enough to try it out, and regular monitoring needs a topped-up balance."
        }
      ]
    }
  },
  {
    "key": "umnico",
    "name": "Umnico",
    "name_en": "Umnico",
    "description": "Обращения клиентов, история сообщений и события из подключённых каналов",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "umnico",
    "description_en": "Customer requests, message history and events from connected channels",
    "search_terms": [
      "умнико"
    ],
    "signup_url": "https://umnico.com/ru/register/",
    "guide": {
      "url": "https://umnico.com/ru/login/",
      "steps": [
        {
          "title": "Откройте «Настройки» → «Открытое API»",
          "desc": "Войдите в аккаунт Umnico, из которого нужны обращения и сообщения.",
          "title_en": "Open Settings → API in Umnico",
          "desc_en": "Sign in to the Umnico account whose inquiries and messages you want to use."
        },
        {
          "title": "Скопируйте токен аккаунта",
          "desc": "Вставьте значение из раздела «API» в поле «API-токен» и сохраните подключение. Вебхук зарегистрируется автоматически.",
          "title_en": "Copy the account API token",
          "desc_en": "Paste the token from the API section into the API token field and save the connection. Webhook registration starts automatically."
        }
      ]
    },
    "seo": {
      "title": "Umnico и ИИ-агент: обращения, которые ждут ответа",
      "description": "Покажет, какие обращения ждут ответа и какие из них дольше трёх часов, перескажет просьбу клиента о возврате и ответит в его канале. Нужен токен открытого API.",
      "headline": "Находите обращения без ответа в Umnico",
      "scenarios": [
        {
          "title": "Очередь без ответа",
          "desc": "Найдите обращения, в которых последнее сообщение осталось без ответа, и разберите их по каналам."
        },
        {
          "title": "История переписки",
          "desc": "Прочитайте историю по каждому каналу обращения и восстановите контекст разговора с клиентом."
        },
        {
          "title": "Задача на входящее сообщение",
          "desc": "Запустите задачу по событию Umnico после регистрации вебхука."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "API-токен аккаунта Umnico"
      ],
      "faq": [
        {
          "q": "Как подключить Umnico?",
          "a": "Войдите в Umnico, откройте «Настройки» → «Открытое API», скопируйте токен аккаунта и вставьте его в поле «API-токен». Вебхук для событий зарегистрируется сам."
        },
        {
          "q": "Что агент видит в Umnico?",
          "a": "Обращения с их статусами, каналы каждого обращения и историю переписки по ним, а также события: входящие и исходящие сообщения, новые обращения и клиенты, подключение и отключение каналов."
        },
        {
          "q": "Отвечает ли агент клиентам?",
          "a": "Может: агент пишет сообщение в существующее обращение через тот канал, по которому клиент написал. Новых обращений и рассылок он не создаёт."
        },
        {
          "q": "Можно ли запускать задачу на новое сообщение?",
          "a": "Да. После подключения задача «По событию» срабатывает на входящее сообщение, новое обращение или смену его статуса."
        }
      ]
    },
    "seo_en": {
      "title": "Umnico AI agent: inquiries still waiting for a reply",
      "description": "Shows which inquiries are waiting for a reply and which waited over three hours, recaps a client's return request and answers in their channel. Needs an API token.",
      "headline": "Find customer inquiries waiting for a reply in Umnico",
      "scenarios": [
        {
          "title": "Unanswered inquiries",
          "desc": "Find inquiries where the last message is still unanswered and group them by channel."
        },
        {
          "title": "Message history",
          "desc": "Read the history of each channel in an inquiry to recover the context of the conversation."
        },
        {
          "title": "A task for an incoming message",
          "desc": "Start a task from an Umnico event after the webhook is registered."
        }
      ],
      "how_it_works": [],
      "requirements": [
        "An Umnico account API token"
      ],
      "faq": [
        {
          "q": "How do I connect Umnico?",
          "a": "Sign in to Umnico, open Settings → API, copy the account token and paste it into the API token field. The webhook for events registers on its own."
        },
        {
          "q": "What does the agent see in Umnico?",
          "a": "Inquiries with their statuses, each inquiry's channels and their message history, plus events: incoming and outgoing messages, new inquiries and customers, channels connected and disconnected."
        },
        {
          "q": "Does the agent reply to customers?",
          "a": "It can: the agent writes a message into an existing inquiry through the channel the customer used. It does not open new inquiries or send broadcasts."
        },
        {
          "q": "Can a task start on a new message?",
          "a": "Yes. Once connected, an event task fires on an incoming message, a new inquiry or a change of its status."
        }
      ]
    }
  },
  {
    "key": "unisender",
    "name": "Unisender",
    "name_en": "Unisender",
    "description": "Email/SMS-рассылки: списки контактов, шаблоны, кампании, статистика",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "unisender",
    "description_en": "Email and SMS marketing: contact lists, templates, campaigns and statistics",
    "search_terms": [
      "юнисендер"
    ],
    "signup_url": "https://app.unisender.com/ru/v5/spa/registration/step/1",
    "guide": {
      "url": "https://app.unisender.com",
      "steps": [
        {
          "title": "Откройте «Настройки» кликом по email внизу",
          "desc": "В кабинете на app.unisender.com нажмите на свой email в левом нижнем углу и выберите «Настройки».",
          "title_en": "Click your email bottom-left, open Settings",
          "desc_en": "In the account at app.unisender.com click your email in the bottom-left corner and pick «Настройки» (Settings)."
        },
        {
          "title": "В «Интеграции и API» включите «Доступ к API»",
          "desc": "Откройте вкладку «Интеграция и API» и в разделе «Доступ к API» нажмите «Включить». Если уже включён, переходите дальше.",
          "title_en": "In Integration and API enable API access",
          "desc_en": "Open the «Интеграция и API» (Integration and API) tab and press «Включить» (Enable) in «Доступ к API» (API access). While access is off, the key does not work."
        },
        {
          "title": "Нажмите «Показать полностью», скопируйте ключ",
          "desc": "Рядом с ключом нажмите «Показать полностью» и подтвердите пароль учётной записи: ключ показан обрезанным, пока пароль не введён. Скопируйте строку целиком.",
          "title_en": "Press Show in full and copy the key",
          "desc_en": "Next to the key press «Показать полностью» (Show in full) and confirm your account password; the key stays truncated until you do. Copy the whole string."
        },
        {
          "title": "Запишите email входа как логин",
          "desc": "Логин это тот же email, под которым вы вошли в кабинет; он виден в левом нижнем углу. Поле необязательное, но помогает различить несколько аккаунтов Unisender.",
          "title_en": "Note the sign-in email as the login",
          "desc_en": "The login is the same email you signed in with, shown in the bottom-left corner. The field is optional but tells apart several Unisender accounts."
        }
      ]
    },
    "seo": {
      "title": "Unisender и ИИ-агент: чистка списков от мёртвых адресов",
      "description": "Найдёт в списках Unisender мёртвые адреса и покажет письма, которые просели по открытиям за месяц. Отправка только после тестового письма и вашего согласия.",
      "headline": "Держите списки и кампании Unisender в порядке из чата",
      "scenarios": [
        {
          "title": "Списки и контакты в порядке",
          "desc": "Агент соберёт все списки рассылки, покажет число контактов в каждом и найдёт, где копятся отписки и невалидные адреса."
        },
        {
          "title": "Разбор кампаний по кликам",
          "desc": "Агент разложит последние кампании по доставке, открытиям и переходам по ссылкам и назовёт письма, которые просели против обычного."
        },
        {
          "title": "Email- и SMS-рассылка",
          "desc": "Агент соберёт письмо из шаблона, проверит его тестовой отправкой и запустит кампанию по выбранному списку или отправит SMS."
        },
        {
          "title": "Регулярная сводка по базе",
          "desc": "Агент пришлёт по расписанию сводку по email- и SMS-рассылкам и приросту контактов, чтобы не заходить в кабинет за цифрами."
        },
        {
          "title": "Чистка базы перед отправкой",
          "desc": "Агент исключит из списка отписавшихся и невалидные адреса и назовёт реальное число адресатов до того, как вы подтвердите отправку."
        },
        {
          "title": "Сегмент под конкретное письмо",
          "desc": "Агент разложит контакты по тегам и дополнительным полям и соберёт из них отдельный список, например только клиентов из одного города."
        }
      ],
      "how_it_works": [
        "Агент работает с Unisender через https://api.unisender.com/ru/api, где каждый вызов задаётся именем метода, а ключ уходит параметром запроса. Читает он списки рассылки и контакты с их полями и тегами, письма и шаблоны, кампании и статистику доставок, открытий, переходов и отписок. Из этого собираются разбор кампании по кликам, картина по спискам и регулярная сводка по приросту базы за период.",
        "Часть данных Unisender считает не сразу: экспорт контактов и статистику доставки он ставит в очередь и возвращает идентификатор задачи, а не готовый ответ. Агент опрашивает такую задачу до готовности и показывает уже посчитанные цифры, а не полупустую выгрузку. Вторая тонкость касается размера списка: отписавшиеся и невалидные адреса остаются в нём со своим статусом, поэтому число контактов и число реальных адресатов у вас не совпадут, и агент разделяет их явно.",
        "На запись агент заводит списки и дополнительные поля, подписывает и исключает контакты, собирает письма из шаблонов и готовит кампании. Массовую отправку он не запускает сам: сначала тестовая отправка на проверку, затем ваше подтверждение с названным списком и числом адресатов, и только потом старт кампании. Транзакционные письма и SMS уходят тем же порядком, а результат агент перечитывает после отправки.",
        "Ключ один на аккаунт и не делится по разделам, поэтому агент видит весь кабинет: узкий доступ здесь выдать нельзя, а отзывается он только перевыпуском ключа. Уходит ключ параметром каждого запроса, так что перевыпуск обрывает доступ мгновенно, и агент скажет об этом, а не вернёт молча ноль. Контакты и статистику Unisender отдаёт порциями, и длинную выборку агент дочитывает до конца сам. Частоту он держит в пределах десяти запросов в секунду, а при нехватке данных или прав говорит об этом прямо."
      ],
      "requirements": [
        "Аккаунт на app.unisender.com с доступом в «Настройки».",
        "Пароль от учётной записи: им подтверждается показ ключа."
      ],
      "faq": [
        {
          "q": "Как подключить Unisender?",
          "a": "API-ключом из кабинета: клик по своему email → «Настройки» → вкладка «Интеграция и API», в разделе «Доступ к API» нажмите «Включить», затем «Показать полностью» и подтвердите пароль учётной записи. Логин необязателен, это тот же email."
        },
        {
          "q": "Что агент видит в Unisender?",
          "a": "Списки рассылки и контакты с их полями и тегами, письма и шаблоны, кампании и статистику доставок, открытий, переходов и отписок."
        },
        {
          "q": "Пишет ли агент в Unisender?",
          "a": "Может: заводить списки и поля, подписывать и исключать контакты, собирать письма и кампании, отправлять транзакционные письма и SMS. Массовую отправку агент запускает только по вашему подтверждению."
        },
        {
          "q": "Почему выгрузка возвращается не сразу?",
          "a": "Экспорт контактов и статистику доставки Unisender считает в фоне и отдаёт идентификатор задачи. Агент опрашивает результат до готовности и показывает уже готовые данные."
        }
      ]
    },
    "seo_en": {
      "title": "Unisender AI agent: clean dead addresses from your lists",
      "description": "Finds dead addresses to exclude from Unisender lists and shows which emails dropped in opens this month. Sends only after a test email and your explicit go-ahead.",
      "headline": "Keep Unisender lists and campaigns in order from the chat",
      "scenarios": [
        {
          "title": "Lists and contacts in order",
          "desc": "The agent pulls every mailing list, shows how many contacts each one holds and finds where unsubscribes and invalid addresses are piling up."
        },
        {
          "title": "Campaign breakdown by clicks",
          "desc": "The agent breaks recent campaigns down by delivery, opens and link clicks and names the emails that came in below their usual numbers."
        },
        {
          "title": "Email and SMS campaigns",
          "desc": "The agent builds an email from a template, checks it with a test send and launches the campaign to the list you choose, or sends an SMS."
        },
        {
          "title": "Regular summary on the base",
          "desc": "The agent sends a scheduled summary of email and SMS campaigns and contact growth, so nobody has to open the account for the numbers."
        },
        {
          "title": "Cleaning the base before a send",
          "desc": "The agent excludes unsubscribed and invalid addresses from a list and names the real number of recipients before you confirm the send."
        },
        {
          "title": "A segment for one email",
          "desc": "The agent sorts contacts by their tags and additional fields and gathers them into a separate list, say, only the customers from a single city."
        }
      ],
      "how_it_works": [
        "The agent works with Unisender through https://api.unisender.com/ru/api, where every call is a method name and the key travels as a request parameter. It reads mailing lists and contacts with their fields and tags, emails and templates, campaigns and statistics on deliveries, opens, clicks and unsubscribes. Out of that come the campaign breakdown by clicks, the picture across lists and the regular summary of how the base grew over a period.",
        "Some of the data Unisender does not compute on the spot: contact exports and delivery statistics are queued and return a task identifier instead of a ready answer. The agent polls such a task until it is done and shows the finished figures rather than a half-empty export. The second subtlety is list size: unsubscribed and invalid addresses stay in the list with their own status, so the contact count and the count of real recipients will not match, and the agent separates them explicitly.",
        "On the write side the agent creates lists and additional fields, subscribes and excludes contacts, assembles emails from templates and prepares campaigns. Bulk sending it never launches on its own: first a test send for review, then your confirmation with the list and the number of recipients named, and only then the campaign starts. Transactional emails and SMS follow the same order, and the agent re-reads the result after the send.",
        "The key is one per account and is not split by section, so the agent sees the whole account: narrow access cannot be granted here, and the only way to revoke it is to reissue the key. The key travels as a parameter of every request, so a reissue cuts access off instantly and the agent says so rather than quietly returning zero. Contacts and statistics come back from Unisender in portions, and a long selection is read to the end by the agent itself. It holds the rate within ten requests per second, and when data or permissions fall short it says so directly."
      ],
      "requirements": [
        "An account at app.unisender.com with access to Settings.",
        "The account password: it confirms revealing the key."
      ],
      "faq": [
        {
          "q": "How do I connect Unisender?",
          "a": "With an API key from your account: click your email, go to Settings, open the Integration and API tab, press Enable in the API access section, then press Show in full and confirm your account password. Login is an optional field and is the same email."
        },
        {
          "q": "What does the agent see in Unisender?",
          "a": "Mailing lists and contacts with their fields and tags, emails and templates, campaigns and statistics on deliveries, opens, clicks and unsubscribes."
        },
        {
          "q": "Does the agent write to Unisender?",
          "a": "It can: create lists and fields, subscribe and exclude contacts, assemble emails and campaigns, send transactional emails and SMS. Bulk sending is launched only once you confirm it."
        },
        {
          "q": "Why does an export not come back right away?",
          "a": "Unisender computes contact exports and delivery statistics in the background and returns a task identifier. The agent polls the result until it is ready and shows you the finished data."
        }
      ]
    }
  },
  {
    "key": "uzum_market",
    "name": "Uzum Market Seller API",
    "name_en": "Uzum Market Seller API",
    "description": "Товары, заказы, остатки и финансы продавца",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "uzum-market",
    "short_name": "Uzum Market",
    "short_name_en": "Uzum Market",
    "description_en": "Seller products, orders, stock and finances",
    "search_terms": [
      "узум"
    ],
    "guide": {
      "url": "https://seller.uzum.uz",
      "steps": [
        {
          "title": "Войдите в кабинет продавца Uzum Market",
          "desc": "Откройте seller.uzum.uz под аккаунтом, на который зарегистрирован магазин: токен выпускается на аккаунт целиком, и нужны права на настройки.",
          "title_en": "Sign in to the Uzum Market seller account",
          "desc_en": "Open seller.uzum.uz with the account the shop is registered to: the token covers the whole seller account and needs settings access to issue."
        },
        {
          "title": "В разделе API и интеграций выпустите токен",
          "desc": "В настройках профиля откройте раздел API и интеграций и выпустите токен Seller API: он открывает товары, заказы, остатки и финансы.",
          "title_en": "In API and integrations issue a Seller token",
          "desc_en": "In the profile settings open the API and integrations section and issue a Seller API token: it opens products, orders, stock and finance."
        },
        {
          "title": "Скопируйте токен сразу после создания",
          "desc": "Значение приходит одной длинной строкой без префикса: слово Bearer не добавляется, пробелов по краям быть не должно. Прежний токен восстановить нельзя.",
          "title_en": "Copy the token right after you create it",
          "desc_en": "The value comes as one long string with no prefix: no Bearer word, no spaces at the edges. Copy it at once: an old token cannot be recovered, only reissued."
        },
        {
          "title": "Проверьте, что магазин активен",
          "desc": "Агент сначала берёт список магазинов аккаунта, а потом заказы, остатки и финансы по выбранному. Без активного магазина список пуст.",
          "title_en": "Check that a shop is active",
          "desc_en": "The agent first requests the account's shop list, then orders, stock and finance for the shop you pick. With no active shop the list is empty."
        }
      ]
    },
    "seo": {
      "title": "Uzum Market API: маржа, комиссии и возвраты магазина",
      "description": "Покажет, сколько выручки на Uzum Market съели комиссия и логистика и какие товары дают возвраты. Работает через Seller Open API одним токеном продавца.",
      "headline": "Разбирайте продажи и остатки магазина на Uzum Market",
      "scenarios": [
        {
          "title": "Сводка продаж на Uzum",
          "desc": "Агент соберёт заказы и выручку по товарам за период и покажет динамику продаж магазина на Uzum Market."
        },
        {
          "title": "Контроль остатков",
          "desc": "Агент проверит остатки по складам, найдёт товары на грани out-of-stock и подготовит список к пополнению."
        },
        {
          "title": "Финансовая сверка",
          "desc": "Агент сверит начисления и выплаты маркетплейса с продажами и покажет, где комиссия съедает маржу."
        },
        {
          "title": "Откуда идут возвраты",
          "desc": "Агент соберёт возвраты за период, разложит их по товарам и покажет, какие позиции возвращают чаще прочих и сколько это забирает из уже посчитанной выручки."
        },
        {
          "title": "Накладные перед отгрузкой",
          "desc": "Агент пройдёт по накладным FBS, покажет состав каждой и заказы, которые в неё вошли, чтобы к отгрузке не потерялась ни одна позиция."
        },
        {
          "title": "Каждая витрина отдельно",
          "desc": "Агент пройдёт по всем магазинам токена и сведёт заказы, остатки и расходы по каждому порознь, подписав цифры именем витрины."
        }
      ],
      "how_it_works": [
        "Агент работает через Seller Open API Uzum Market: читает товары магазина, заказы FBS и накладные по ним, остатки по SKU, возвраты и финансовый контур: начисления по заказам и расходы. Из этого он собирает выручку за период с разбивкой по товарам, находит позиции на грани out-of-stock и показывает, сколько от продажи остаётся после комиссий и удержаний маркетплейса.",
        "Всё на Uzum привязано к магазину: под одним токеном продавца их может быть несколько, и почти каждый запрос идёт в контексте конкретного магазина. Поэтому агент начинает со списка магазинов, дальше держит нужный и не смешивает цифры соседних витрин в одной сводке. Разделы API живут в разных версиях (заказы, остатки и накладные обновлялись независимо), и агент обращается к актуальной для каждого.",
        "Финансовая правда здесь складывается из двух источников: начисления по заказам и расходы лежат порознь, и выручка по заказам ещё не то, что дойдёт до счёта. Агент берёт оба раздела и отдельно вычитает возвраты, которые уменьшают уже посчитанную продажу. Основная его работа по Uzum счётная и на чтение; там, где нужно поправить остаток или заказ, он показывает изменение до отправки и перечитывает результат после.",
        "Токен продавца агент подставляет в каждый запрос как есть, без префикса, и держит один на все разделы; отозванный в кабинете токен перестаёт работать в тот же момент, и агент скажет об этом сразу, а не после половины отчёта. Длинные списки заказов и остатков Uzum отдаёт страницами, поэтому период агент проходит постранично и складывает итог сам. Сводку он подписывает именем магазина, чтобы не перепутать витрины, а если раздел пуст, говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Аккаунт продавца Uzum Market с хотя бы одним активным магазином",
        "Права на настройки кабинета: сотруднику без них токен не выпустить",
        "Доступ к разделам товаров, заказов, остатков и финансов"
      ],
      "faq": [
        {
          "q": "Как подключить Uzum Market?",
          "a": "API-токеном продавца Uzum Market. Токен вводится один раз, хранится в зашифрованном виде и может быть отозван в кабинете."
        },
        {
          "q": "Что агент умеет по Uzum?",
          "a": "Читать товары, заказы, остатки и финансы Seller API: собирать отчёты по продажам, контролировать остатки, сверять выплаты."
        },
        {
          "q": "Можно ли получать отчёты регулярно?",
          "a": "Да, агент работает по расписанию: например, каждое утро присылает сводку заказов и остатков в Telegram."
        }
      ]
    },
    "seo_en": {
      "title": "Uzum Market Seller API: margin, fees and returns",
      "description": "Shows how much Uzum Market revenue went to commission and logistics and which products drive returns. Works through the Seller Open API with one seller token.",
      "headline": "Break down sales and stock for your Uzum Market store",
      "scenarios": [
        {
          "title": "Sales summary on Uzum",
          "desc": "The agent pulls orders and revenue by product for a period and shows how sales in your Uzum Market store are trending."
        },
        {
          "title": "Stock control",
          "desc": "The agent checks stock across warehouses, finds products on the edge of going out of stock and prepares a restock list."
        },
        {
          "title": "Financial reconciliation",
          "desc": "The agent reconciles marketplace charges and payouts against sales and shows where commission is eating your margin."
        },
        {
          "title": "Where the returns come from",
          "desc": "The agent collects returns for a period, breaks them down by product and shows which positions come back most often and how much that takes off the revenue already counted."
        },
        {
          "title": "Invoices before the shipment",
          "desc": "The agent goes through the FBS invoices, shows what each one holds and which orders went into it, so nothing gets lost on the way to the shipment."
        },
        {
          "title": "Every storefront on its own",
          "desc": "The agent walks all the stores under the token and puts orders, stock and expenses together for each one apart, signing the figures with the store name."
        }
      ],
      "how_it_works": [
        "The agent works through the Uzum Market Seller Open API: it reads the store's products, FBS orders and the invoices behind them, stock by SKU, returns and the finance side: charges on orders and expenses. Out of that it assembles revenue for a period broken down by product, finds the positions on the edge of going out of stock and shows how much of a sale is left after the marketplace commissions and deductions.",
        "Everything on Uzum is tied to a store: a single seller token may cover several of them, and almost every request runs in the context of one particular store. So the agent starts with the list of stores, then holds on to the right one and never mixes the figures of neighbouring storefronts into one summary. API sections live in different versions (orders, stock and invoices evolved independently), and the agent calls the current one for each.",
        "The financial truth here comes from two sources: charges on orders and expenses sit apart, and revenue on orders is not yet what reaches your account. The agent takes both sections and separately subtracts returns, which reduce a sale already counted. Its main work on Uzum is arithmetic and read-oriented; where a stock figure or an order has to be changed, it shows the change before sending and re-reads the result afterwards.",
        "The agent puts the seller token into every request as it is, with no prefix, and keeps one for all sections; a token revoked in the cabinet stops working at that very moment, and the agent says so at once rather than halfway through a report. Uzum hands out long lists of orders and stock in pages, so the agent walks the period page by page and adds the total up itself. It signs a summary with the store name so storefronts do not get confused, and if a section is empty it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A Uzum Market seller account with at least one active shop",
        "Rights to the cabinet settings, since staff without them cannot issue a token",
        "Access to the products, orders, stock and finance sections"
      ],
      "faq": [
        {
          "q": "How do I connect Uzum Market?",
          "a": "With an Uzum Market seller API token. The token is entered once, stored encrypted and can be revoked in your seller account."
        },
        {
          "q": "What can the agent do with Uzum?",
          "a": "Read products, orders, stock and finances through the Seller API: build sales reports, keep an eye on stock, reconcile payouts."
        },
        {
          "q": "Can I get reports on a regular basis?",
          "a": "Yes, the agent works on a schedule: for example, it can send an orders and stock summary to Telegram every morning."
        }
      ]
    }
  },
  {
    "key": "vk_ads",
    "name": "VK Реклама",
    "name_en": "VK Ads",
    "description": "Кампании, объявления, таргетинг, аудитории и статистика",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "vk-ads",
    "description_en": "Campaigns, ads, targeting, audiences and statistics",
    "search_terms": [
      "вк реклама",
      "майтаргет",
      "mytarget"
    ],
    "guide": {
      "url": "https://ads.vk.ru",
      "steps": [
        {
          "title": "Войдите в кабинет на ads.vk.ru",
          "desc": "Это новый кабинет VK Рекламы с собственным API. Старый кабинет ВКонтакте с методами ads.* на api.vk.com это другая система: ключ оттуда здесь не подойдёт.",
          "title_en": "Sign in to the account at ads.vk.ru",
          "desc_en": "This is the new VK Ads account with its own API. The legacy VKontakte ads account with ads.* methods on api.vk.com will not work here."
        },
        {
          "title": "В настройках откройте «Доступ к API»",
          "desc": "Найдите в настройках кабинета «Доступ к API» и заполните данные сотрудника, на которого оформляется доступ: заявка в поддержку не нужна.",
          "title_en": "In Settings open API access",
          "desc_en": "In the account settings find “API access” and fill in the details of the employee the access is issued to: no support request needed."
        },
        {
          "title": "Скопируйте client_id в «Доступе к API»",
          "desc": "После выдачи доступа client_id показывается в том же разделе и остаётся там всегда, скопировать его можно в любой момент.",
          "title_en": "Copy the client_id under API access",
          "desc_en": "Once access is granted the client_id is shown in the same section and stays available, so you can copy it at any time."
        },
        {
          "title": "Сгенерируйте client_secret и скопируйте",
          "desc": "Секрет показывается по кнопке и только 10 минут, повторно его не выдают. Access-токен обновляется сам, вставлять его руками не нужно.",
          "title_en": "Generate the client_secret and copy it",
          "desc_en": "The secret is revealed by a button for 10 minutes only and never shown again. The access token then refreshes itself, with nothing to paste."
        }
      ]
    },
    "seo": {
      "title": "VK Реклама и ИИ-агент: на сколько хватит бюджета",
      "description": "Скажет, до какого дня хватит денег в кабинете VK Рекламы при текущем темпе, и сравнит кампании по цене клика. Вход парой client_id и client_secret.",
      "headline": "Считайте расход и CTR кампаний VK Рекламы без выгрузок",
      "scenarios": [
        {
          "title": "Расход и CTR по кампаниям",
          "desc": "Агент сведёт статистику кампаний и объявлений (показы, клики, CTR и расход) за нужный период, без ручной выгрузки отчётов из кабинета."
        },
        {
          "title": "Остаток бюджета кабинета",
          "desc": "Агент покажет остаток на счёте кабинета и темп открутки и предупредит, что реклама встанет раньше, чем закончится неделя."
        },
        {
          "title": "Сравнение объявлений между собой",
          "desc": "Агент разложит объявления внутри кампании по цене клика и CTR и покажет, какие креативы тянут результат вниз."
        },
        {
          "title": "Ежедневная сводка по кабинету",
          "desc": "Агент пришлёт в чат сводку за вчера по кампаниям VK Рекламы: расход, клики и заметные отклонения от привычных значений."
        },
        {
          "title": "Аудитория, которая кликает",
          "desc": "Агент снимет дневную статистику по аудитории и покажет, какие сегменты дают клики дешевле, а на каких расход уходит впустую."
        },
        {
          "title": "Группы внутри кампании",
          "desc": "Агент разложит кампанию по группам объявлений, поставит рядом настройки таргетинга и расход и покажет, какая группа съедает бюджет."
        }
      ],
      "how_it_works": [
        "Агент ходит в API кабинета на ads.vk.ru и читает три уровня структуры: кампании в /api/v2/ad_plans.json, группы в /api/v2/ad_groups.json и объявления в /api/v2/banners.json, а цифры снимает из дневной статистики /api/v2/statistics по каждому из этих уровней и по аудитории. Из этого он считает показы, клики, CTR, цену клика и расход за период и сравнивает объявления внутри кампании между собой.",
        "У ВКонтакте два разных рекламных API, и это главная путаница: старый кабинет на api.vk.com с методами вида ads.getStatistics на ads.vk.ru просто не существует: хост отвечает HTML-страницей с ошибкой 404. Агент это знает и не подбирает соседние пути вслепую, а сразу говорит, что нужны ключи именно из VK Рекламы. Статистика здесь дневная, поэтому сегодняшний день до его закрытия остаётся неполным, и агент называет период, за который взял цифры.",
        "По умолчанию кабинет используется на чтение: агент собирает и разбирает статистику, не трогая настройки кампаний, ставки и бюджеты: рекламные деньги откручиваются в реальном времени, и молчаливая правка ставки обходится дороже любой ошибки в отчёте. Вместо этого он предупреждает заранее: показывает остаток на счёте и темп открутки и говорит, что реклама встанет раньше, чем закончится неделя, оставляя решение вам.",
        "Access-токен агент получает по client_credentials и обновляет сам: истёкший он меняет между запросами, не теряя начатую выгрузку. Статистику он снимает окнами по датам и по уровням, поэтому отчёт за квартал собирается несколькими вызовами и сводится уже на нашей стороне. Частоту агент держит в пределах пяти запросов в секунду и о нехватке данных или прав говорит прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Новый кабинет VK Рекламы: ключи старого кабинета не подойдут",
        "Доступ к кабинету у сотрудника, на которого оформляется заявка",
        "Права кабинета ограничивают доступные кампании и статистику"
      ],
      "faq": [
        {
          "q": "Как подключить VK Реклама?",
          "a": "Парой client_id и client_secret: в кабинете на ads.vk.ru откройте «Настройки» → «Доступ к API» и запросите доступ. client_secret показывается только по кнопке и только 10 минут, скопируйте сразу. Access-токен сервис получает и обновляет сам."
        },
        {
          "q": "Что агент видит в VK Рекламе?",
          "a": "Рекламные кампании, группы и объявления кабинета, их настройки и статистику по показам, кликам и расходу в пределах прав того кабинета, чьи ключи подключены."
        },
        {
          "q": "Подойдёт ли токен старого кабинета ВКонтакте?",
          "a": "Нет. Старый рекламный кабинет на api.vk.com использует другой API с другими методами, его токен здесь не работает. Нужны ключи именно из кабинета VK Рекламы на ads.vk.ru."
        },
        {
          "q": "Меняет ли агент кампании?",
          "a": "По умолчанию VK Реклама используется на чтение: агент собирает и разбирает статистику, не трогая настройки кампаний, ставки и бюджеты."
        }
      ]
    },
    "seo_en": {
      "title": "VK Ads API agent: how long the account budget lasts",
      "description": "Tells you which day the VK Ads account balance runs out at the current pace and compares campaigns by cost per click. Uses a client_id and client_secret pair.",
      "headline": "Track VK Ads campaign spend and CTR without report exports",
      "scenarios": [
        {
          "title": "Spend and CTR by campaign",
          "desc": "The agent totals campaign and ad statistics (impressions, clicks, CTR and spend) for the period you need, with no manual report exports from the account."
        },
        {
          "title": "Account budget left",
          "desc": "The agent shows the balance left on the account and the pace of spend, and warns you when ads will stop before the week is out."
        },
        {
          "title": "Ads compared against each other",
          "desc": "The agent lines up the ads inside a campaign by cost per click and CTR and shows which creatives are dragging results down."
        },
        {
          "title": "Daily account summary",
          "desc": "The agent sends yesterday in chat for your VK Ads campaigns: spend, clicks and any notable swings away from the usual numbers."
        },
        {
          "title": "The audience that clicks",
          "desc": "The agent pulls the daily audience statistics and shows which segments bring clicks cheaper and which ones are burning the spend for nothing."
        },
        {
          "title": "Ad groups inside a campaign",
          "desc": "The agent breaks a campaign down into ad groups, puts their targeting settings next to the spend and shows which group is eating the budget."
        }
      ],
      "how_it_works": [
        "The agent calls the account API at ads.vk.ru and reads three levels of the structure: campaigns from /api/v2/ad_plans.json, ad groups from /api/v2/ad_groups.json and ads from /api/v2/banners.json, taking the figures from the daily statistics at /api/v2/statistics for each of those levels and for the audience. Out of that it calculates impressions, clicks, CTR, cost per click and spend for a period, and compares the ads inside a campaign against each other.",
        "VKontakte has two different advertising APIs, and that is the main source of confusion: the old account on api.vk.com with methods like ads.getStatistics simply does not exist on ads.vk.ru: the host replies with an HTML page and a 404. The agent knows this and does not blindly try neighbouring paths; it says straight away that keys from VK Ads itself are required. Statistics here are daily, so the current day stays incomplete until it closes, and the agent names the period the figures were taken for.",
        "By default the account is used read-only: the agent collects and analyses statistics without touching campaign settings, bids or budgets: ad money is spent in real time, and a silent bid edit costs more than any error in a report. Instead it warns in advance: it shows the balance left on the account and the pace of spend and says that ads will stop before the week is out, leaving the decision to you.",
        "The agent obtains the access token itself via client_credentials and refreshes it with no manual renewal: an expired one is swapped between calls without losing the export in progress. Statistics are taken in windows by date and by level, so a quarterly report is assembled from several calls and joined on our side. The agent holds the rate within five requests per second and states any shortage of data or permissions directly instead of showing an empty table."
      ],
      "requirements": [
        "The new VK Ads cabinet: old VKontakte keys will not work here",
        "Cabinet access for the employee the request is issued to",
        "Cabinet permissions bound the campaigns and statistics available"
      ],
      "faq": [
        {
          "q": "How do I connect VK Ads?",
          "a": "With a client_id and client_secret pair: in the account at ads.vk.ru open Settings, then API access, and request access. The client_secret is shown only behind a button and only for 10 minutes, so copy it right away. The service obtains and refreshes the access token itself."
        },
        {
          "q": "What does the agent see in VK Ads?",
          "a": "The account campaigns, ad groups and ads, their settings and statistics on impressions, clicks and spend, within the permissions of the account whose keys are connected."
        },
        {
          "q": "Will a token from the old VKontakte ad account work?",
          "a": "No. The old ad account on api.vk.com is a different API with different methods, and its token does not work here. You need keys from the VK Ads account at ads.vk.ru."
        },
        {
          "q": "Does the agent change campaigns?",
          "a": "By default VK Ads is used read-only: the agent collects and analyses statistics without touching campaign settings, bids or budgets."
        }
      ]
    }
  },
  {
    "key": "vkteams",
    "name": "VK Teams",
    "name_en": "VK Teams",
    "description": "Корпоративный мессенджер ВКонтакте: чаты, сообщения, файлы",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "vkteams",
    "description_en": "VK company messenger: chats, messages and files",
    "search_terms": [
      "вк тимс"
    ],
    "guide": {
      "url": "https://teams.vk.com",
      "steps": [
        {
          "title": "Войдите в VK Teams и найдите «Метабот»",
          "desc": "Токен выдаёт не админка, а служебный бот: наберите «Метабот» в поиске по чатам. Входить нужно тем аккаунтом, который останется владельцем бота.",
          "title_en": "Sign in to VK Teams and find Metabot",
          "desc_en": "The token comes from a service bot, not an admin panel: type «Метабот» (Metabot) in the chat search. Sign in with the account that will stay the bot owner."
        },
        {
          "title": "Отправьте Метаботу команду /newbot",
          "desc": "В ответ он попросит имя для нового бота. Имя обязано заканчиваться на bot, иначе Метабот его не примет и попросит другое.",
          "title_en": "Send the /newbot command to Metabot",
          "desc_en": "It will ask for a name for the new bot. The name must end with bot, otherwise Metabot rejects it and asks for another one."
        },
        {
          "title": "Отправьте Метаботу команду /setjoingroups",
          "desc": "Отправьте Метаботу /setjoingroups, затем ник или id бота, затем слово enable. Без этого бот живёт только в личных диалогах, а в чат его добавляет админ.",
          "title_en": "Send /setjoingroups to Metabot",
          "desc_en": "Send /setjoingroups to Metabot, then your bot's nick or id, then the word enable. Without it the bot stays in private dialogs; only a chat admin can add it."
        },
        {
          "title": "Скопируйте токен из ответа Метабота",
          "desc": "Токен приходит сообщением сразу после создания: 001.2659914704.0218887601:747432131, четыре блока с точками и двоеточием. Если потерялся, отправьте /token.",
          "title_en": "Copy the token from Metabot's reply",
          "desc_en": "The token arrives right after creation: 001.2659914704.0218887601:747432131, four numeric blocks with dots and a colon. If the message is lost, send /token."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для VK Teams: сводка в чат с закреплением",
      "description": "VK Teams (ВК Тимс) через Bot API: агент отправит сводку в чат отдела и закрепит её, перечислит файлы за неделю. Бот создаётся у Метабота командой /newbot.",
      "headline": "Присылайте отчёты и напоминания в чаты VK Teams от имени бота",
      "scenarios": [
        {
          "title": "Сообщения в рабочий чат",
          "desc": "Агент напишет от имени бота прямо в чат VK Teams: отчёт, напоминание или предупреждение придут туда, где сидит команда."
        },
        {
          "title": "Состав и модерация чата",
          "desc": "Агент покажет участников, администраторов и заявки на вступление, разберёт заявки, удалит из чата и заблокирует нарушителя."
        },
        {
          "title": "Сводка по расписанию",
          "desc": "Агент пришлёт сводку в нужный чат в согласованное время и закрепит её в шапке, чтобы её не искали в переписке."
        },
        {
          "title": "Кнопки и уточняющие вопросы",
          "desc": "Агент отправит сообщение с кнопками, обработает нажатие через callback и отредактирует текст, когда ответ уже устарел."
        },
        {
          "title": "О чём говорили в чате",
          "desc": "Агент дочитает поток событий с той точки, где остановился, и соберёт пересказ: что решили, о чём спросили и какие вопросы остались без ответа."
        },
        {
          "title": "Файлы из переписки",
          "desc": "Агент соберёт файлы, которые кидали в чат за неделю (с именем, размером и автором), чтобы нужный документ не искали пролистыванием."
        },
        {
          "title": "Обсуждение вместо ветки в чате",
          "desc": "Агент откроет тред к нужному сообщению, отвечает в нём и покажет, кто на обсуждение подписан, чтобы разбор одной задачи не тонул в общем потоке."
        }
      ],
      "how_it_works": [
        "Агент работает в VK Teams через бота: первым запросом читает данные самого бота, а дальше чаты, куда его добавили. Оттуда он берёт сообщения, состав участников, администраторов и заблокированных, заявки на вступление и информацию о файлах. Этого хватает, чтобы прислать отчёт или напоминание туда, где сидит команда, и разобрать, что происходит в рабочем чате.",
        "Граница видимости здесь жёсткая: бот видит только те чаты, куда его добавили, и ничего за их пределами. Историю до момента добавления он тоже не получит: события приходят с той минуты, как бот оказался в чате, поэтому сводка за прошлый месяц по свежему чату физически не собирается. Вебхуков у VK Teams нет вовсе: новые сообщения агент забирает лентой событий, держа соединение открытым, и подхватывает разговор ровно с той точки, где остановился. Курсор здесь односторонний: отмотать ленту назад к уже прочитанному нельзя, поэтому пропустить событие агент не даёт. Пока бота в чат не добавили, он честно скажет, что чат недоступен, вместо пустой сводки.",
        "На запись агент делает много: отправляет, редактирует и удаляет сообщения, закрепляет сводку в шапке чата, шлёт сообщения с кнопками и обрабатывает нажатия через callback, отправляет файлы и голосовые, открывает обсуждения к сообщениям, меняет название, описание, правила и аватар чата, разбирает заявки на вступление, удаляет из чата и блокирует нарушителя. Добавление участников единственное, что доступно не всем: это приватный метод, который работает только в on-premise-сборках VK Teams и только после того, как его включит системный администратор; в облаке агент скажет об этом прямо, вместо того чтобы молча не справиться. Сообщение в рабочем чате видят все, а удаление и исключение не откатить, поэтому перед такими действиями агент называет чат и текст и ждёт подтверждения.",
        "Подключение идёт по токену бота. Он уходит параметром запроса, так что хранить его нужно как пароль, а отозвать доступ можно только пересозданием бота. Всё, что делает агент, делается от имени бота и так и подписано в чате: за сообщением видно робота, а не человека, и ответить ему можно там же. Объём модерации ограничен правами бота в конкретном чате: без прав администратора он не удалит чужое сообщение и не исключит участника, и об этой нехватке сообщает прямо, а не пробует вслепую."
      ],
      "requirements": [
        "Рабочий аккаунт VK Teams: он останется владельцем бота навсегда",
        "Права администратора в чате, куда бота будут добавлять"
      ],
      "faq": [
        {
          "q": "Как подключить VK Teams?",
          "a": "Токеном бота. В VK Teams найдите в поиске «Метабот», отправьте ему команду /newbot и имя, оканчивающееся на bot, а затем скопируйте токен из ответа. Если сообщение потерялось, помогает команда /token."
        },
        {
          "q": "Что агент видит в VK Teams?",
          "a": "Данные самого бота, чаты, куда он добавлен: сообщения, состав участников, администраторов, заблокированных и заявки на вступление, а также информацию о файлах."
        },
        {
          "q": "Пишет ли агент в VK Teams?",
          "a": "Да: отправляет, редактирует и удаляет сообщения, закрепляет их, шлёт файлы и голосовые, открывает обсуждения, меняет название, описание, правила и аватар чата, разбирает заявки на вступление и удаляет участников."
        },
        {
          "q": "Почему агент не может добавить человека в чат?",
          "a": "Добавление участников это приватный метод Bot API: он есть только в on-premise-сборках VK Teams и включается системным администратором для конкретного бота. В облачной версии метод недоступен никому, поэтому агент предупредит об этом заранее, а не после неудачной попытки."
        },
        {
          "q": "Почему бота не пускает в групповой чат?",
          "a": "По умолчанию бот живёт только в личных диалогах. Отправьте Метаботу /setjoingroups, ник бота и слово enable, а в сам чат бота добавляет его администратор."
        }
      ]
    },
    "seo_en": {
      "title": "VK Teams bot API: pinned digests from an AI agent",
      "description": "Posts a digest to a team chat and pins it at the top, lists the files shared during the week. Create the bot with /newbot in Metabot and give the agent its token.",
      "headline": "Post reports and reminders to VK Teams chats as a bot",
      "scenarios": [
        {
          "title": "Messages to a work chat",
          "desc": "The agent writes as the bot straight into a VK Teams chat: a report, a reminder or an alert lands where the team already sits."
        },
        {
          "title": "Chat roster and moderation",
          "desc": "The agent shows members, admins and join requests, resolves the requests, removes people from the chat and blocks anyone breaking the rules."
        },
        {
          "title": "Scheduled summary",
          "desc": "The agent sends a summary to the chat you pick at the agreed time and pins it at the top so nobody hunts for it in the thread."
        },
        {
          "title": "Buttons and follow-up questions",
          "desc": "The agent sends a message with buttons, handles the tap through a callback and edits the text once the answer is out of date."
        },
        {
          "title": "What the chat talked about",
          "desc": "The agent reads the event stream on from where it stopped and puts together a recap: what was decided, what was asked and which questions nobody answered."
        },
        {
          "title": "Files from the thread",
          "desc": "The agent gathers the files dropped into the chat over the week (with the name, the size and who posted them), so the right document is not hunted by scrolling."
        },
        {
          "title": "A discussion instead of a branch in the chat",
          "desc": "The agent opens a thread on the message that needs it, replies inside it and shows who is subscribed, so working one task out does not sink into the general stream."
        }
      ],
      "how_it_works": [
        "The agent works in VK Teams through a bot: its first request reads the bot's own data, and after that come the chats the bot has been added to. From there it takes messages, the list of members, admins and blocked users, join requests and information about files. That is enough to post a report or a reminder where the team already sits and to work out what is going on in a work chat.",
        "The visibility boundary here is hard: the bot sees only the chats it has been added to and nothing beyond them. History from before it joined is out of reach as well: events start at the minute the bot appeared in the chat, so a digest for last month in a freshly created chat simply cannot be assembled. VK Teams has no webhooks at all: new messages arrive on an event feed the agent holds open, and it picks the conversation up exactly where it stopped. The cursor there only moves forward (already-read events cannot be rewound to), so the agent never lets one slip past. Until the bot is added, it says plainly that the chat is out of reach instead of returning an empty summary.",
        "On the write side the agent does plenty: it sends, edits and deletes messages, pins a summary at the top of the chat, sends messages with buttons and handles taps through a callback, sends files and voice messages, opens threads on messages, changes the chat title, description, rules and avatar, resolves join requests, removes people from the chat and blocks anyone breaking the rules. Adding members is the one thing not available everywhere: it is a private method that works only in on-premise VK Teams builds and only once a system administrator enables it, and in the cloud the agent says so outright rather than quietly failing. A message in a work chat is seen by everyone, and deletions and removals cannot be rolled back, so before such actions the agent names the chat and the text and waits for confirmation.",
        "The connection is a bot token. It travels as a request parameter, so it has to be kept like a password, and the only way to revoke access is to recreate the bot. Everything the agent does is done as the bot and is signed that way in the chat: people see a robot behind the message, not a colleague, and can reply to it right there. How much moderation is possible depends on the bot's rights in that particular chat: without admin rights it will not delete someone else's message or remove a member, and it reports that shortfall directly instead of trying blindly."
      ],
      "requirements": [
        "A work VK Teams account: it stays the bot owner permanently",
        "Administrator rights in the chat where the bot will be added"
      ],
      "faq": [
        {
          "q": "How do I connect VK Teams?",
          "a": "With a bot token. In VK Teams search for Metabot, send it the /newbot command and a name ending in bot, then copy the token from the reply. If the message gets lost, the /token command helps."
        },
        {
          "q": "What does the agent see in VK Teams?",
          "a": "The bot own data and the chats it has been added to: messages, the list of members, admins and blocked users, join requests, and information about files."
        },
        {
          "q": "Does the agent write in VK Teams?",
          "a": "Yes: it sends, edits and deletes messages, pins them, sends files and voice messages, opens threads, changes the chat title, description, rules and avatar, resolves join requests and removes members."
        },
        {
          "q": "Why can the agent not add someone to a chat?",
          "a": "Adding members is a private Bot API method: it exists only in on-premise VK Teams builds and is switched on by a system administrator for a specific bot. In the cloud version it is available to nobody, so the agent warns you up front rather than after a failed attempt."
        },
        {
          "q": "Why is the bot not allowed into a group chat?",
          "a": "By default the bot lives only in direct messages. Send Metabot /setjoingroups, the bot nickname and the word enable, and have a chat admin add the bot to the chat itself."
        }
      ]
    }
  },
  {
    "key": "wappi",
    "name": "Wappi",
    "name_en": "Wappi",
    "description": "WhatsApp, Telegram и MAX личного аккаунта: сообщения, чаты, группы",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "wappi",
    "description_en": "WhatsApp, Telegram and MAX personal accounts: messages, chats and groups",
    "search_terms": [
      "ваппи",
      "whatsapp api",
      "telegram user api",
      "макс",
      "вотсап",
      "ватсап"
    ],
    "signup_url": "https://wappi.pro/registration",
    "guide": {
      "url": "https://wappi.pro/dashboard",
      "steps": [
        {
          "title": "Подключите профиль мессенджера",
          "desc": "В кабинете Wappi создайте профиль WhatsApp, Telegram или MAX и войдите в нём в свой аккаунт QR-кодом или по номеру. Без входа сообщения не уходят.",
          "title_en": "Connect a messenger profile",
          "desc_en": "In your Wappi account create a WhatsApp, Telegram or MAX profile and sign your account in with a QR code or by number. Without it nothing goes out."
        },
        {
          "title": "Скопируйте API-токен",
          "desc": "Откройте страницу профиля в кабинете: токен API показан там. Он один на весь аккаунт Wappi и открывает все его профили.",
          "title_en": "Copy the API token",
          "desc_en": "Open the profile page in your account: the API token is shown there. It is one per Wappi account and opens all of its profiles."
        },
        {
          "title": "Вставьте токен при подключении",
          "desc": "Если профилей несколько, агент спросит, через какой писать. Id профиля (profile_id) показан в кабинете на странице профиля рядом с токеном.",
          "title_en": "Paste the token when connecting",
          "desc_en": "When there are several profiles the agent asks which one to write through. The profile id (profile_id) is shown on the profile page next to the token."
        }
      ]
    },
    "seo": {
      "title": "Wappi и ИИ-агент: какой мессенджер отвалился",
      "description": "Проверит, какие профили WhatsApp, Telegram и MAX на связи, и найдёт клиентов без ответа; пишет с вашего обычного номера. Подключается API-токеном кабинета Wappi.",
      "headline": "Пишите клиентам в WhatsApp, Telegram и MAX со своего аккаунта",
      "scenarios": [
        {
          "title": "Сообщение клиенту в мессенджер",
          "desc": "Агент отправит сообщение или файл в WhatsApp, Telegram или MAX по номеру, @username или из списка чатов, с вашего же аккаунта, а не с отдельного бизнес-номера."
        },
        {
          "title": "Кому ещё не ответили",
          "desc": "Агент пройдёт по последним чатам, прочитает переписку и соберёт тех, чьё сообщение осталось последним без ответа."
        },
        {
          "title": "Поиск по переписке",
          "desc": "Агент найдёт в WhatsApp сообщение со счётом, адресом или договорённостью по словам и покажет, в каком чате и когда оно было."
        },
        {
          "title": "Голосовые в текст",
          "desc": "Агент расшифрует голосовое сообщение в MAX и перескажет, о чём просил клиент."
        },
        {
          "title": "Состояние профилей",
          "desc": "Агент проверит, какие профили авторизованы и до какого числа оплачены, и назовёт тот, что отвалился, раньше, чем клиент останется без ответа."
        },
        {
          "title": "Отправка с паузой",
          "desc": "Агент поставит несколько напоминаний в очередь со случайной паузой между ними и проверит, дошло ли каждое."
        }
      ],
      "how_it_works": [
        "Агент работает с HTTP API Wappi с токеном вашего аккаунта. Профиль Wappi — это ваш авторизованный аккаунт WhatsApp, Telegram или MAX, и сообщения уходят от его имени, как с телефона. Первым делом агент читает список профилей: это и проверка токена, и выбор, через какой мессенджер писать.",
        "Отправка бывает синхронной и через очередь. Одно сообщение агент отправляет сразу и получает его номер; серию ставит в очередь с паузой между сообщениями и потом проверяет итог каждой задачи, а не считает постановку в очередь доставкой.",
        "Агент читает списки чатов, историю конкретного чата, ищет сообщения по словам, скачивает файлы из входящих по ссылке и расшифровывает голосовые MAX. Писать, удалять и менять что-то в аккаунте он может только после вашего подтверждения; выйти из мессенджера, оплатить профиль с баланса или запустить массовую рассылку — только по прямой просьбе.",
        "Это личный аккаунт, а не бизнес-API, поэтому главное ограничение ставит мессенджер: за рассылку незнакомым людям и флуд WhatsApp и MAX блокируют аккаунт, Telegram временно ограничивает отправку. Агент пишет тем, с кем есть переписка, выдерживает паузу, которую назвал Telegram, и не трогает адрес вебхука, если его использует другая ваша интеграция."
      ],
      "requirements": [
        "Аккаунт Wappi с оплаченным или пробным профилем",
        "Авторизованный в профиле аккаунт WhatsApp, Telegram или MAX"
      ],
      "faq": [
        {
          "q": "Как подключить Wappi?",
          "a": "API-токеном. Он показан на странице профиля в кабинете Wappi и открывает все профили аккаунта."
        },
        {
          "q": "С какого номера уходят сообщения?",
          "a": "С того аккаунта мессенджера, который авторизован в профиле Wappi: клиент видит ваш обычный WhatsApp, Telegram или MAX."
        },
        {
          "q": "Видит ли агент входящие?",
          "a": "Он читает историю чатов по запросу. Адрес вебхука для входящих настраивается в кабинете Wappi: агент его не меняет, чтобы не отключить другую интеграцию."
        },
        {
          "q": "Не заблокируют ли аккаунт?",
          "a": "За обычную переписку нет. Блокируют за спам и рассылку незнакомым, поэтому массовую рассылку агент запускает только по вашей прямой просьбе и с паузами."
        }
      ]
    },
    "seo_en": {
      "title": "Wappi AI agent: which messenger profile dropped",
      "description": "Checks which WhatsApp, Telegram and MAX profiles are up and finds clients left without a reply; writes from your usual number. Connects with an API token.",
      "headline": "Message clients on WhatsApp, Telegram and MAX from your own account",
      "scenarios": [
        {
          "title": "A message to a client in a messenger",
          "desc": "The agent sends a message or a file on WhatsApp, Telegram or MAX by phone number, @username or from the chat list, from your own account rather than a separate business number."
        },
        {
          "title": "Who is still waiting for a reply",
          "desc": "The agent goes through recent chats, reads the correspondence and collects the people whose message is still the last one with no answer."
        },
        {
          "title": "Search across conversations",
          "desc": "The agent finds a WhatsApp message with an invoice, an address or an agreement by its words and shows which chat it was in and when."
        },
        {
          "title": "Voice messages to text",
          "desc": "The agent transcribes a voice message on MAX and retells what the client asked for."
        },
        {
          "title": "Profile health",
          "desc": "The agent checks which profiles are signed in and paid until when, and names the one that dropped before a client is left without an answer."
        },
        {
          "title": "Sending with a pause",
          "desc": "The agent queues several reminders with a random pause between them and checks that each one was delivered."
        }
      ],
      "how_it_works": [
        "The agent works with the Wappi HTTP API using your account token. A Wappi profile is your signed-in WhatsApp, Telegram or MAX account, and messages go out in its name, as from the phone. The first thing the agent reads is the list of profiles: that is both a token check and the choice of which messenger to write through.",
        "Sending is either synchronous or through a queue. A single message goes out at once and comes back with its id; a series is queued with a pause between messages, and the agent then checks the outcome of each task instead of taking queueing for delivery.",
        "The agent reads chat lists and the history of a given chat, searches messages by words, downloads files from incoming messages by link and transcribes MAX voice messages. It writes, deletes or changes anything in the account only after your confirmation; signing out of a messenger, paying for a profile from the balance or starting a mass mailing happen only on a direct request.",
        "This is a personal account, not a business API, so the main restriction comes from the messenger: WhatsApp and MAX block an account for messaging strangers and flooding, Telegram temporarily limits sending. The agent writes to people you already talk to, waits out the pause Telegram names, and leaves the webhook address alone when another integration of yours uses it."
      ],
      "requirements": [
        "A Wappi account with a paid or trial profile",
        "A WhatsApp, Telegram or MAX account signed in to the profile"
      ],
      "faq": [
        {
          "q": "How do I connect Wappi?",
          "a": "With the API token. It is shown on the profile page in your Wappi account and opens every profile of the account."
        },
        {
          "q": "Which number do the messages come from?",
          "a": "From the messenger account signed in to the Wappi profile: the client sees your regular WhatsApp, Telegram or MAX."
        },
        {
          "q": "Does the agent see incoming messages?",
          "a": "It reads chat history on request. The webhook address for incoming messages is set in your Wappi account: the agent does not change it so as not to switch off another integration."
        },
        {
          "q": "Will the account get blocked?",
          "a": "Not for ordinary correspondence. Accounts are blocked for spam and messaging strangers, so the agent starts a mass mailing only on your direct request and with pauses."
        }
      ]
    }
  },
  {
    "key": "wazzup",
    "name": "Wazzup24",
    "name_en": "Wazzup24",
    "description": "WhatsApp, Telegram, Instagram: сообщения, каналы, контакты",
    "category": "messengers",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "wazzup",
    "description_en": "WhatsApp, Telegram and Instagram: messages, channels and contacts",
    "search_terms": [
      "ваззап"
    ],
    "signup_url": "https://app.wazzup24.ru/signup/",
    "guide": {
      "url": "https://app.wazzup24.com",
      "steps": [
        {
          "title": "В разделе «Каналы» подключите канал",
          "desc": "В кабинете откройте раздел «Каналы» и добавьте WhatsApp, Telegram или Instagram. Пока ни один канал не подключён, интеграцию по API включить не получится.",
          "title_en": "In Channels connect at least one channel",
          "desc_en": "In your account open «Каналы» (Channels) and add WhatsApp, Telegram or Instagram. Without a connected channel the API integration stays off."
        },
        {
          "title": "В «Интеграции с CRM» подключите API",
          "desc": "Раздел «Интеграция с CRM» → выберите в списке API → «Подключить». Это тот же раздел, где подключают amoCRM и Битрикс24.",
          "title_en": "In CRM integration connect API",
          "desc_en": "Open «Интеграция с CRM» (CRM integration), pick API in the list and click «Подключить» (Connect). It is the same section where amoCRM and Bitrix24 are set up."
        },
        {
          "title": "Скопируйте ключ API из «Дополнительно»",
          "desc": "Кабинет покажет строку из 32 символов: цифры и латинские буквы в нижнем регистре. Если окно закрыли, ключ там же: «Интеграция с CRM» → вкладка «Дополнительно».",
          "title_en": "Copy the API key from the Advanced tab",
          "desc_en": "The key is a 32-character string of digits and lowercase Latin letters. Closed the window? It stays in «Интеграция с CRM» → «Дополнительно»."
        }
      ]
    },
    "seo": {
      "title": "Интеграция Wazzup24 с ИИ: живы ли каналы и кто без ответа",
      "description": "Назовёт каналы, которые лежат со вчерашнего вечера, найдёт неотвеченные обращения и отправит шаблон вне окна 24 часов. Подключается ключом API из кабинета.",
      "headline": "Пишите клиентам в WhatsApp и Telegram прямо из диалога",
      "scenarios": [
        {
          "title": "Сообщение клиенту в мессенджер",
          "desc": "Агент отправит клиенту сообщение в WhatsApp, Telegram или Instagram по номеру или юзернейму прямо из диалога, а не с телефона."
        },
        {
          "title": "Состояние подключённых каналов",
          "desc": "Агент проверит каналы и назовёт те, что отвалились: слетел QR, потеряна связь с телефоном или канал не оплачен."
        },
        {
          "title": "Неотвеченные обращения",
          "desc": "Агент соберёт неотвеченные сообщения за последние дни по всем каналам и покажет, кому из клиентов до сих пор не ответили."
        },
        {
          "title": "Шаблон вне окна 24 часов",
          "desc": "Агент отправит согласованный WABA-шаблон, когда суточное окно переписки в WhatsApp уже закрылось и обычное сообщение не дойдёт."
        },
        {
          "title": "Входящее сразу в работу",
          "desc": "Агент разберёт входящее сообщение по вебхуку, поймёт, о чём просит клиент, и передаст обращение нужному менеджеру, не дожидаясь, пока кто-то откроет кабинет."
        },
        {
          "title": "Контакты и сделки из чатов",
          "desc": "Агент найдёт в кабинете контакты без сделки и воронки, сверит их с перепиской по каналам и синхронизирует карточки, чтобы номер из чата не остался безымянным."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Wazzup24 третьей версии с ключом вашего кабинета. Первым делом он читает список каналов: это и проверка ключа, и карта того, через что вообще можно писать: WhatsApp, Telegram, Instagram. Дальше в работе контакты, сделки и воронки, шаблоны сообщений и неотвеченные обращения, всё в пределах одного кабинета и подключённых в нём каналов.",
        "Канал в Wazzup означает живую связь с реальным аккаунтом мессенджера, и она рвётся: слетает QR, теряется связь с телефоном, канал остаётся неоплаченным. Снаружи кабинет при этом выглядит рабочим, поэтому агент сверяет состояние каналов и называет отвалившиеся по имени и причине, а не отправляет сообщения в канал, который уже ничего не доставит. Про упавший канал вы узнаёте раньше, чем клиент останется без ответа.",
        "На отправке главное ограничение ставит не Wazzup, а WhatsApp: суточное окно переписки. Пока клиент писал последние 24 часа, уходит обычное сообщение; когда окно закрылось, дойдёт только согласованный WABA-шаблон, и агент выбирает нужный вариант, а не отправляет вслепую. Он пишет по номеру или юзернейму через конкретный канал, правит отправленное и синхронизирует контакты.",
        "Ключ API открывает каналы и контакты всего кабинета, а не отдельного менеджера, и выдавать его стоит с этим пониманием. Входящие приходят вебхуком: агент разбирает сообщение сразу после доставки и не опрашивает кабинет по кругу, а если вебхук не настроен, честно скажет, что видит историю, но не новые обращения. Частоту запросов он выдерживает сам, а при отсутствии данных или прав говорит об этом прямо, а не показывает пустой список диалогов."
      ],
      "requirements": [
        "Доступ в кабинет Wazzup с правами администратора",
        "Аккаунт мессенджера для канала: WhatsApp, Telegram или Instagram",
        "Согласованный WABA-шаблон для сообщений вне суточного окна"
      ],
      "faq": [
        {
          "q": "Как подключить Wazzup24?",
          "a": "Ключом API. Подключите в кабинете хотя бы один канал, откройте «Интеграция с CRM», выберите в списке API и нажмите «Подключить», и кабинет покажет ключ из 32 символов. Позже он лежит на вкладке «Дополнительно»."
        },
        {
          "q": "Что агент видит в Wazzup24?",
          "a": "Список подключённых каналов и их состояние, контакты, сделки и воронки, шаблоны сообщений и неотвеченные обращения."
        },
        {
          "q": "Пишет ли агент в мессенджеры?",
          "a": "Да: отправляет и редактирует сообщения в WhatsApp, Telegram и Instagram через подключённые каналы, отправляет WABA-шаблоны и синхронизирует контакты."
        },
        {
          "q": "Что нужно сделать до подключения?",
          "a": "Подключить хотя бы один канал в разделе «Каналы». Пока ни одного канала нет, интеграцию по API в кабинете включить не получится."
        }
      ]
    },
    "seo_en": {
      "title": "Wazzup24 AI agent: dead channels and unanswered chats",
      "description": "Names the channels that have been down since last night, finds unanswered conversations and sends a template outside the 24-hour window. Connects with an API key.",
      "headline": "Message clients on WhatsApp and Telegram right from the chat",
      "scenarios": [
        {
          "title": "A message to a client in a messenger",
          "desc": "The agent sends a client a message on WhatsApp, Telegram or Instagram by phone number or username, right from the conversation, not from a phone."
        },
        {
          "title": "State of the connected channels",
          "desc": "The agent checks the channels and names the ones that dropped: the QR expired, the link to the phone was lost, or the channel is unpaid."
        },
        {
          "title": "Unanswered conversations",
          "desc": "The agent collects unanswered messages from the past few days across every channel and shows which clients are still waiting for a reply."
        },
        {
          "title": "A template outside the 24-hour window",
          "desc": "The agent sends an approved WABA template once the 24-hour WhatsApp conversation window has closed and a regular message would not arrive."
        },
        {
          "title": "An incoming message straight into work",
          "desc": "The agent parses an incoming message from the webhook, works out what the client is asking for and hands the conversation to the right manager without waiting for anyone to open the account."
        },
        {
          "title": "Contacts and deals out of the chats",
          "desc": "The agent finds contacts with no deal or pipeline behind them, checks them against the correspondence across channels and syncs the cards so a number from a chat does not stay nameless."
        }
      ],
      "how_it_works": [
        "The agent calls the third version of the Wazzup24 API with the key of your account. The first thing it reads is the list of channels: that is both a check of the key and a map of what can actually be written through: WhatsApp, Telegram, Instagram. From there contacts, deals and pipelines, message templates and unanswered conversations go into the work, all within one account and the channels connected in it.",
        "A channel in Wazzup is a live link to a real messenger account, and that link breaks: the QR expires, the connection to the phone is lost, the channel goes unpaid. From the outside the account still looks fine, so the agent checks the state of the channels and names the ones that dropped, with the reason, instead of sending messages into a channel that will deliver nothing. You learn about a channel that went down before the client is left without an answer.",
        "On sending, the main restriction comes not from Wazzup but from WhatsApp: the 24-hour conversation window. While the client has written within the last 24 hours a regular message goes out; once the window is closed only an approved WABA template arrives, and the agent picks the right option rather than sending blind. It writes by phone number or username through a specific channel, edits what it sent and syncs contacts.",
        "The API key opens the channels and contacts of the whole account, not of a single manager, so it is worth handing out with that in mind. Incoming messages arrive over a webhook: the agent parses a message right after delivery instead of polling the account in circles, and if no webhook is configured it says plainly that it sees the history but not new conversations. It holds the request rate itself, and when data or permissions are missing it says so directly rather than showing an empty list of dialogues."
      ],
      "requirements": [
        "Admin access to the Wazzup account",
        "A messenger account for the channel: WhatsApp, Telegram or Instagram",
        "An approved WABA template for messages outside the 24-hour window"
      ],
      "faq": [
        {
          "q": "How do I connect Wazzup24?",
          "a": "With an API key. Connect at least one channel in your account, open CRM integration, pick API from the list and press Connect, and the account shows a 32-character key. Later it lives on the Advanced tab."
        },
        {
          "q": "What does the agent see in Wazzup24?",
          "a": "The list of connected channels and their state, contacts, deals and pipelines, message templates and unanswered conversations."
        },
        {
          "q": "Does the agent write to messengers?",
          "a": "Yes: it sends and edits messages on WhatsApp, Telegram and Instagram through the connected channels, sends WABA templates and syncs contacts."
        },
        {
          "q": "What has to be done before connecting?",
          "a": "Connect at least one channel in the Channels section. Until there is a channel, the account will not let you enable the API integration."
        }
      ]
    }
  },
  {
    "key": "wildberries",
    "name": "Wildberries API",
    "name_en": "Wildberries API",
    "description": "Товары, заказы, цены, остатки и аналитика продавца",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "wildberries",
    "short_name": "Wildberries",
    "short_name_en": "Wildberries",
    "description_en": "Seller products, orders, prices, stock and analytics",
    "search_terms": [
      "вб",
      "wb",
      "вайлдберриз",
      "валберис"
    ],
    "guide": {
      "url": "https://seller.wildberries.ru/supplier-settings/access-to-api",
      "steps": [
        {
          "title": "Войдите в WB Partners владельцем кабинета",
          "desc": "Откройте seller.wildberries.ru и войдите под учётной записью владельца кабинета: выпускать и удалять API-токены может только он, другим ролям раздел не виден.",
          "title_en": "Sign in to WB Partners as the owner",
          "desc_en": "Open seller.wildberries.ru and sign in as the account owner: only the owner issues and deletes API tokens."
        },
        {
          "title": "В «Настройках» откройте «Доступ к API»",
          "desc": "Наведите курсор на имя продавца в правом верхнем углу и перейдите «Настройки → Доступ к API» → «Создать новый токен».",
          "title_en": "In Settings open API access",
          "desc_en": "Hover over the seller name in the top-right corner and go to “Settings → API access”. The page lists issued tokens and has the “Create new token” button."
        },
        {
          "title": "Создайте токен типа «Базовый»",
          "desc": "На вкладке «Ручная интеграция» задайте имя и выберите тип «Базовый». Наш сервис в каталоге решений WB искать не нужно: «Сервисный» WB выдаёт только сервисам оттуда.",
          "title_en": "Create a token of the “Base” type",
          "desc_en": "On the “Manual integration” tab name the token and pick “Base”. Skip the WB solutions catalogue: WB issues “Service” only to services listed there."
        },
        {
          "title": "Отметьте категории и «Чтение и запись»",
          "desc": "Нужны все десять: Контент, Аналитика, Цены и скидки, Маркетплейс, Статистика, Продвижение, Вопросы и отзывы, Чат с покупателями, Возвраты покупателями, Финансы.",
          "title_en": "Tick the categories and “Read and write”",
          "desc_en": "All ten are needed: Content, Analytics, Prices and discounts, Marketplace, Statistics, Promotion, Questions and reviews, Buyer chat, Buyer returns, Finance."
        },
        {
          "title": "Скопируйте токен сразу после создания",
          "desc": "Токен показывается один раз: если закрыли окно, останется выпустить заново. Строка с началом eyJ живёт 180 дней.",
          "title_en": "Copy the token right after it is created",
          "desc_en": "The token is shown only once: close the dialog and you can only issue a new one. It starts with eyJ and lives 180 days."
        }
      ]
    },
    "seo": {
      "title": "Wildberries и ИИ-агент: что закончится на складах",
      "description": "Назовёт артикулы Wildberries, которые уйдут в ноль на складах за неделю, и посчитает маржу по SKU с реальным расходом на рекламу. Подключается одним API-токеном.",
      "headline": "Разбирайте продажи и остатки Wildberries прямо в чате",
      "scenarios": [
        {
          "title": "Найти, где просела выручка на WB",
          "desc": "Агент сравнит продажи по неделям, разложит падение по категориям и SKU и отделит сезонность от проблем с карточкой или остатками."
        },
        {
          "title": "Разбор возвратов по причинам",
          "desc": "Агент соберёт возвраты за период, сгруппирует по причинам и артикулам и покажет, какие карточки генерируют убыток."
        },
        {
          "title": "Мониторинг отзывов и рейтинга",
          "desc": "Агент проверит новые отзывы, подготовит ответы и предупредит, если рейтинг карточки пошёл вниз."
        },
        {
          "title": "Юнит-экономика по артикулам",
          "desc": "Агент сведёт продажи, комиссии, логистику и хранение WB в одну таблицу и посчитает реальную маржу по каждому SKU."
        },
        {
          "title": "План пополнения складов",
          "desc": "Агент соберёт остатки по всем складам, своим (FBS, DBS) и складам WB, сопоставит их со скоростью продаж и покажет, что и в каком объёме пора отгружать, чтобы не уйти в ноль."
        },
        {
          "title": "Куда уходит рекламный бюджет",
          "desc": "Агент сложит расходы стандартных и медийных кампаний, посчитает ДРР по каждому артикулу и отметит, где реклама съедает маржу сильнее нормы."
        }
      ],
      "how_it_works": [
        "Агент подключается к Wildberries одним API-токеном и закрывает весь контур продавца: остатки на своих складах и складах WB, реализацию, юнит-экономику, рекламу, отзывы, вопросы, чаты, цены и отгрузки. По остаткам он собирает сводку по всем складам продавца и FBW-остатки по артикулам одним вызовом, а не циклом по складам, и на этой основе строит план пополнения с учётом скорости продаж и страхового запаса. Разделы у WB разнесены по разным API (контент, статистика, аналитика, цены, отзывы), и агент сам решает, куда идти за ответом, вместо того чтобы держать это в голове у вас.",
        "Деньги агент считает по отчёту реализации v5 с правильной курсорной пагинацией: WB кладёт в ответ поле, похожее на курсор, но настоящий курсор это идентификатор последней строки, и агент это знает, поэтому не зацикливается и не теряет строки. Отчёт отдаётся не чаще раза в минуту, так что длинные периоды агент собирает частями и сам держит паузы, а не упирается в 429. Комиссию, логистику и хранение он берёт из того же отчёта, а не из прайса, поэтому маржа по SKU считается по фактически удержанным суммам.",
        "Юнит-экономика по каждому артикулу собирается с реальным рекламным расходом. У WB реклама живёт в двух независимых контурах (стандартные кампании в advert-api и медийная реклама в advert-media-api), и агент опрашивает оба, иначе половина расходов просто пропала бы из отчёта. Поверх считается ДРР по SKU с уровнями тревоги и помесячный P&L по кабинету.",
        "Отзывы, вопросы и чаты покупателей агент собирает в единую ленту неотвеченного: отвечает на отзыв и на вопрос, закрепляет лучший отзыв на карточке и считает скорость вашей реакции. Раздел отзывов у WB ограничен одним запросом в секунду, поэтому длинную ленту агент разбирает порциями. Wildberries не присылает события сторонним сервисам, поэтому новые отзывы, вопросы, чаты и заказы проверяет задача по расписанию: поставьте ленту неотвеченного на расписание, и сводка будет приходить сама.",
        "Самое ценное: агент знает характер WB API. WB может ответить «успешно» на запрос с опечаткой и молча ничего не сделать, поэтому после каждой записи агент перечитывает состояние и убеждается, что изменение применилось. Обновление карточки это полная перезапись, и частичную агент не отправляет; загрузка медиа падает целиком из-за одного битого URL, поэтому ссылки проверяются заранее. Пока асинхронная загрузка карточек не завершилась (до 30 минут), агент не трогает цены и остатки, иначе изменения применятся частично. Жёсткие лимиты вроде пропуска FBS раз в 10 минут и смены привязки склада раз в сутки он учитывает при планировании. И всё, что меняет данные (цены, ставки, ответы), сначала показывается как план и применяется только после вашего явного подтверждения."
      ],
      "requirements": [
        "Активный кабинет продавца на seller.wildberries.ru.",
        "Решение, что делает агент: только аналитика или ещё отзывы и цены.",
        "Токен хранится зашифрованным и отзывается в кабинете WB в любой момент."
      ],
      "faq": [
        {
          "q": "Какой токен нужен для подключения Wildberries?",
          "a": "API-токен из личного кабинета продавца: «Настройки → Доступ к API», выпускает владелец кабинета. Наш сервис подключается базовым токеном, в каталоге решений WB его искать не нужно: на вкладке «Ручная интеграция» выберите тип «Базовый» и отметьте категории «Контент», «Аналитика», «Цены и скидки», «Маркетплейс», «Статистика», «Продвижение», «Вопросы и отзывы», «Чат с покупателями», «Возвраты покупателями», «Финансы» с доступом «Чтение и запись». Токен без любой из них не примется при подключении, и отказ назовёт недостающие."
        },
        {
          "q": "Токен даёт доступ ко всему кабинету?",
          "a": "Нет. WB выпускает токены с гранулярными правами по категориям, и вы сами выбираете, какие разделы открыть. Токен хранится в зашифрованном виде и отзывается в кабинете WB в любой момент."
        },
        {
          "q": "Какие задачи агент делает по Wildberries чаще всего?",
          "a": "Анализ продаж и остатков, разбор возвратов, мониторинг отзывов, сверку поставок и расчёт юнит-экономики с учётом комиссий и логистики. Результат: таблица, отчёт или регулярная сводка в Telegram."
        },
        {
          "q": "Обновляются ли данные автоматически?",
          "a": "Агент запрашивает API при каждой задаче, поэтому работает с актуальными данными. Регулярные отчёты можно поставить по расписанию, и агент сам соберёт и пришлёт сводку."
        }
      ]
    },
    "seo_en": {
      "title": "Wildberries AI agent: stock-outs and true ad spend",
      "description": "Names Wildberries SKUs that will run out of stock within a week and computes margin per SKU with real ad spend from both ad APIs. Connects with one API token.",
      "headline": "Break down Wildberries sales and stock right in chat",
      "scenarios": [
        {
          "title": "Find where revenue dropped on WB",
          "desc": "The agent compares sales week over week, breaks the drop down by category and SKU and separates seasonality from problems with the listing or stock."
        },
        {
          "title": "Returns broken down by reason",
          "desc": "The agent collects returns for the period, groups them by reason and article number and shows which listings are generating losses."
        },
        {
          "title": "Review and rating monitoring",
          "desc": "The agent checks new reviews, drafts replies and warns you when a listing rating starts sliding."
        },
        {
          "title": "Unit economics by article number",
          "desc": "The agent brings WB sales, commissions, logistics and storage into a single table and computes the real margin on every SKU."
        },
        {
          "title": "Replenishment plan for the warehouses",
          "desc": "The agent pulls stock across every warehouse, your own (FBS, DBS) and WB's, matches it against sales velocity and shows what to ship and in what volume before you run out."
        },
        {
          "title": "Where the ad budget goes",
          "desc": "The agent adds up standard and media campaign spend, computes the ad-cost share per article number and flags where advertising eats more margin than it should."
        }
      ],
      "how_it_works": [
        "The agent connects to Wildberries with a single API token and covers the whole seller loop: stock on your own and WB warehouses, the sales report, unit economics, advertising, reviews, questions, chats, prices and shipments. For stock it pulls a summary across every seller warehouse and FBW balances per article number in one call rather than looping over warehouses, and builds a replenishment plan on top of it that accounts for sales velocity and safety stock. WB spreads those sections across separate APIs (content, statistics, analytics, prices, reviews), and the agent works out which one to ask instead of leaving that for you to remember.",
        "Money is counted from the v5 sales report with correct cursor pagination: WB returns a field that looks like a cursor, but the real cursor is the identifier of the last row. The agent knows this, so it neither loops forever nor drops rows. The report is served no more than once a minute, so long periods are assembled in chunks with the agent holding the pauses itself instead of running into 429s. Commission, logistics and storage are taken from that same report rather than from a price list, so SKU margin is computed on the amounts actually withheld.",
        "Unit economics per article number is assembled with the real advertising spend. On WB advertising lives in two independent loops (standard campaigns in advert-api and media advertising in advert-media-api), and the agent queries both, otherwise half of the spend would simply be missing from the report. On top of that it computes ad-cost share by SKU with alert levels and a month-by-month P&L for the account.",
        "Reviews, questions and buyer chats are collected into a single feed of unanswered items: the agent replies to a review and to a question, pins the best review on the listing and measures your response speed. The reviews section on WB is limited to one request per second, so a long feed is worked through in portions. Wildberries does not push events to third-party services, so new reviews, questions, chats and orders are checked by a scheduled task: put the unanswered feed on a schedule and the summary arrives on its own.",
        "The most valuable part is that the agent knows the character of the WB API. WB can answer «success» to a request with a typo and silently do nothing, so after every write the agent re-reads the state and confirms the change was applied. A listing update is a full overwrite, and the agent never sends a partial one; a media upload fails entirely because of a single broken URL, so links are checked in advance. While an asynchronous card upload is still running (up to 30 minutes), the agent leaves prices and stock alone, otherwise changes are applied only partially. Hard limits such as one FBS pass per 10 minutes and one warehouse rebinding per day are factored into its planning. And anything that changes data (prices, bids, replies) is first shown as a plan and applied only after your explicit confirmation."
      ],
      "requirements": [
        "An active seller account at seller.wildberries.ru.",
        "A decision on the agent's job: analytics only, or reviews and prices too.",
        "The token is stored encrypted and can be revoked in WB at any moment."
      ],
      "faq": [
        {
          "q": "Which token do I need to connect Wildberries?",
          "a": "An API token from the seller account: Settings, then API access, issued by the account owner. Our service connects with a Base token, so there is no need to look for it in the WB solutions catalogue: on the Manual integration tab pick the Base type and tick Content, Analytics, Prices and discounts, Marketplace, Statistics, Promotion, Questions and reviews, Buyer chat, Buyer returns and Finance with Read and write access. A token missing any of them is refused at connection, and the refusal names the missing ones."
        },
        {
          "q": "Does the token give access to the whole account?",
          "a": "No. WB issues tokens with granular permissions per category, so you choose which sections to open. The token is stored encrypted and can be revoked in the WB account at any moment."
        },
        {
          "q": "Which Wildberries tasks does the agent handle most often?",
          "a": "Sales and stock analysis, returns breakdowns, review monitoring, supply reconciliation and unit economics that account for commissions and logistics. The result is a table, a report or a regular summary in Telegram."
        },
        {
          "q": "Is the data refreshed automatically?",
          "a": "The agent queries the API on every task, so it always works with current data. Regular reports can be put on a schedule and the agent will assemble and send the summary itself."
        }
      ]
    }
  },
  {
    "key": "yandex_calendar",
    "name": "Яндекс Календарь",
    "name_en": "Yandex Calendar",
    "description": "Календарь и расписания Яндекс 360",
    "category": "calendar",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-calendar",
    "description_en": "Yandex 360 calendars and schedules",
    "guide": {
      "url": "https://calendar.yandex.ru",
      "steps": [
        {
          "title": "Решите, под каким аккаунтом Яндекса входить",
          "desc": "Агент увидит календари ровно одного аккаунта: рабочий на домене компании и личный @yandex.ru дают разные наборы. Выйдите в браузере из лишних аккаунтов.",
          "title_en": "Decide which Yandex account to sign in with",
          "desc_en": "The agent sees the calendars of exactly one account: a work domain account and a personal @yandex.ru one hold different sets."
        },
        {
          "title": "Проверьте список на calendar.yandex.ru",
          "desc": "Видны только календари из панели слева на calendar.yandex.ru. Чужой появится там после того, как вы нажмёте «Принять» в письме-приглашении (с компьютера).",
          "title_en": "Check the calendar list at calendar.yandex.ru",
          "desc_en": "Only calendars from the left-hand panel at calendar.yandex.ru are visible. Someone else's appears after you click “Accept” in the invitation email."
        },
        {
          "title": "Попросите у владельца права в «Доступе»",
          "desc": "Владелец: «Открыть настройки» → вкладка «Доступ» → «Выдать права доступа» → «Редактирование содержимого календаря». Иначе закрытые события агенту не видны.",
          "title_en": "Ask the owner for edit rights in Access",
          "desc_en": "The owner opens the calendar settings → the “Access” tab → “Grant access rights” and picks “Edit calendar contents”. Otherwise private events stay invisible."
        },
        {
          "title": "Календари из «Подписки»: только чтение",
          "desc": "Календарь, добавленный по ics-адресу в разделе «Подписки», нельзя править и дополнять, а обновляется он до двух суток.",
          "title_en": "Note: subscribed calendars are read-only",
          "desc_en": "A calendar added by its .ics address via “New subscription” cannot be edited or added to, and refreshes slowly."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Календарь по CalDAV и ИИ: перенос планёрки",
      "description": "Яндекс Календарь подключается по CalDAV (caldav.yandex.ru) кодом Яндекс ID. Агент перенесёт планёрку на пятницу и разошлёт приглашения всем участникам.",
      "headline": "Узнавайте расписание дня по календарям Яндекс 360",
      "scenarios": [
        {
          "title": "Расписание на сегодня",
          "desc": "Агент пройдёт по календарям аккаунта и назовёт встречи на сегодня и завтра, включая календари, к которым вам выдали доступ."
        },
        {
          "title": "Встреча в свободное окно",
          "desc": "Агент найдёт свободное окно нужной длины и заведёт встречу с участниками, местом и напоминанием либо подвинет уже назначенную."
        },
        {
          "title": "Перенос и отмена встреч",
          "desc": "Агент подвинет событие на другое время, обновит список участников и удалит встречу, когда договорённость отменилась."
        },
        {
          "title": "Утренняя сводка по расписанию",
          "desc": "Агент пришлёт по расписанию сводку дня: сколько встреч назначено, где они накладываются и какие часы остались свободными."
        },
        {
          "title": "Свободные часы недели",
          "desc": "Агент пройдёт по встречам недели и покажет, какие часы остались свободными: события, помеченные как не влияющие на занятость, он в занятое время не записывает."
        },
        {
          "title": "Серия встреч по датам",
          "desc": "Агент развернёт повторяющуюся серию в конкретные даты, приведёт время к вашему часовому поясу и покажет, где она сталкивается с уже назначенным."
        }
      ],
      "how_it_works": [
        "Агент работает с расписанием по протоколу CalDAV через caldav.yandex.ru. Сначала он забирает список календарей подключённого аккаунта (личные, общие и те, к которым вам выдали доступ), затем читает события нужного периода вместе со временем, участниками, местом и напоминаниями. На этом строится расписание на сегодня и завтра, находятся наложения встреч, считаются свободные окна нужной длины и собирается утренняя сводка дня.",
        "Календари Яндекса разнородны, и агент это учитывает: у каждого свой адрес коллекции, и события он запрашивает по одному календарю за раз, а не общим списком. CalDAV отдаёт встречу целым ics-объектом, поэтому повторяющуюся серию агент разворачивает в конкретные даты сам, а часовой пояс приводит к вашему. Событие, помеченное в календаре как не влияющее на занятость, он в занятое время не записывает.",
        "На запись агент заводит встречу в найденное свободное окно (с участниками, местом и напоминанием), переносит событие на другое время, обновляет список приглашённых и удаляет встречу, когда договорённость отменилась. Правка ложится поверх сохранённой записи, поэтому всё, чего агент не менял, остаётся нетронутым, а если встречу тем временем поправили в самом Календаре, он остановится и перечитает её, вместо того чтобы затереть чужое изменение. Прежде чем занять слот, он сверяется с уже назначенным, а отмену и удаление подтверждает у вас: участникам уйдут уведомления, и откатить это одним движением нельзя.",
        "Доступ подтверждается кодом на странице Яндекс ID, токен вводить руками не нужно: он обновляется сам и гаснет, как только вы отзываете разрешение в аккаунте. Календарь, закрытый для записи, агент отличает от несуществующего события и говорит, что именно мешает записи, вместо общей ошибки. Частоту обращений он выдерживает сам, длинные периоды забирает окнами по датам, а при нехватке доступа говорит прямо, а не показывает пустой день."
      ],
      "requirements": [
        "Согласие на доступ ко всем календарям аккаунта разом.",
        "Аккаунт Яндекс ID с включённым Календарём."
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Календарь?",
          "a": "По коду подтверждения Яндекс ID: нажмите «Подключить», введите показанный код на странице Яндекса и подтвердите доступ тем аккаунтом, где лежат нужные календари. Токен сохраняется сам, вводить его руками не нужно."
        },
        {
          "q": "Какие календари видит агент?",
          "a": "Только те, что в панели слева на calendar.yandex.ru у подключённого аккаунта. Чужой календарь появляется там после того, как вы нажали «Принять» в письме-приглашении."
        },
        {
          "q": "Может ли агент создавать и менять встречи?",
          "a": "Да, если владелец календаря выдал в «Открыть настройки» → «Доступ» право «Редактирование содержимого календаря». С правом «Просмотр открытых событий» закрытые события агенту не видны."
        },
        {
          "q": "Почему календарь из «Подписки» не меняется?",
          "a": "Календарь, добавленный по ics-адресу в разделе «Подписки», доступен только на чтение и обновляется от нескольких часов до двух дней. Встречи, которыми управляет агент, держите в своём календаре."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Calendar CalDAV and AI: move a meeting to Friday",
      "description": "Move the stand-up to Friday and every attendee gets the new invite. The agent works over CalDAV via caldav.yandex.ru, and access is granted with a Yandex ID code.",
      "headline": "See your whole day across Yandex 360 calendars",
      "scenarios": [
        {
          "title": "Today schedule",
          "desc": "The agent walks through the account calendars and names the meetings for today and tomorrow, including calendars you were given access to."
        },
        {
          "title": "A meeting in a free slot",
          "desc": "The agent finds a free slot of the length you need and books a meeting with attendees, a location and a reminder, or moves one already scheduled."
        },
        {
          "title": "Rescheduling and cancelling meetings",
          "desc": "The agent moves an event to another time, updates the attendee list and deletes the meeting once the arrangement is called off."
        },
        {
          "title": "Morning schedule summary",
          "desc": "The agent sends a scheduled summary of the day: how many meetings are booked, where they overlap and which hours are still free."
        },
        {
          "title": "The free hours of the week",
          "desc": "The agent walks through the week's meetings and shows which hours are still free: events marked as not affecting availability are never counted as busy time."
        },
        {
          "title": "A recurring series by dates",
          "desc": "The agent expands a recurring series into concrete dates, converts the time to your zone and shows where it collides with what is already scheduled."
        }
      ],
      "how_it_works": [
        "The agent works with your schedule over the CalDAV protocol through caldav.yandex.ru. First it fetches the list of calendars of the connected account (personal ones, shared ones and the ones you were given access to), then reads the events of the period you need together with their time, attendees, location and reminders. That is what the schedule for today and tomorrow is built on, where meeting overlaps are found, free slots of the length you need are counted and the morning summary of the day is assembled.",
        "Yandex calendars are not uniform, and the agent takes that into account: each one has its own collection address, so events are requested per calendar rather than as a single list. CalDAV hands a meeting back as a whole ics object, so the agent expands a recurring series into concrete dates itself and converts the time zone to yours. An event marked in the calendar as not affecting availability is never written into a busy slot.",
        "On the write side the agent books a meeting into a free slot it has found (with attendees, a location and a reminder), moves an event to another time, updates the invitee list and deletes a meeting once the arrangement is called off. An edit is laid on top of the stored record, so everything the agent did not touch stays intact, and if the meeting was changed in Calendar meanwhile, it stops and re-reads instead of overwriting someone else's edit. Before taking a slot it checks against what is already scheduled, and it confirms cancellations and deletions with you: attendees get notified, and that cannot be rolled back in one move.",
        "Access is confirmed with a code on the Yandex ID page, with no token to type by hand: it refreshes itself and dies the moment you revoke the grant in the account. A calendar closed for writing is told apart from a missing event, and the agent names which of the two blocks a write instead of raising a generic error. It holds the request rate itself, fetches long periods in date windows, and when access falls short it says so directly instead of showing an empty day."
      ],
      "requirements": [
        "Consent covering every calendar of the account at once.",
        "A Yandex ID account with Calendar enabled."
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Calendar?",
          "a": "With a Yandex ID confirmation code: press Connect, enter the code shown on the Yandex page and confirm access with the account that holds the calendars you need. The token is saved for you, with nothing to type in by hand."
        },
        {
          "q": "Which calendars does the agent see?",
          "a": "Only the ones in the left panel at calendar.yandex.ru for the connected account. Someone else calendar appears there after you press Accept in the invitation email."
        },
        {
          "q": "Can the agent create and change meetings?",
          "a": "Yes, if the calendar owner granted the Edit calendar content permission under Open settings, then Access. With the View public events permission, private events stay invisible to the agent."
        },
        {
          "q": "Why does a calendar from Subscriptions not change?",
          "a": "A calendar added by ics link in the Subscriptions section is read-only and refreshes anywhere from a few hours to two days. Keep the meetings the agent manages in your own calendar."
        }
      ]
    }
  },
  {
    "key": "yandex_cloud",
    "name": "Яндекс Облако",
    "name_en": "Yandex Cloud",
    "description": "Облако клиента: функции, ВМ, Kubernetes, сети, DNS, бакеты, managed-БД, секреты, биллинг",
    "category": "dev",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-cloud",
    "description_en": "Your cloud: functions, VMs, Kubernetes, networks, DNS, buckets, managed DBs, secrets, billing",
    "guide": {
      "url": "https://console.yandex.cloud",
      "steps": [
        {
          "title": "В IAM создайте сервисный аккаунт",
          "desc": "Консоль управления → сервис «Identity and Access Management» → «Создать сервисный аккаунт». Имя: 3–63 символа, строчная латиница, цифры и дефисы.",
          "title_en": "In IAM create a service account",
          "desc_en": "Management console → “Identity and Access Management” → “Create service account”. The name is 3 to 63 characters: lowercase Latin letters, digits and hyphens."
        },
        {
          "title": "В «Правах доступа» облака выдайте роль",
          "desc": "Выберите облако вверху → вкладка «Права доступа» → «Настроить доступ» → аккаунт → «Добавить роль»: viewer для чтения, editor чтобы менять ресурсы.",
          "title_en": "In the cloud's Access bindings add a role",
          "desc_en": "Pick the cloud in the top panel → “Access bindings” → “Configure access” → the account → “Add role”: viewer to read, editor to change resources."
        },
        {
          "title": "В карточке аккаунта скачайте JSON-ключ",
          "desc": "В карточке аккаунта: «Создать новый ключ» → «Создать авторизованный ключ» → «Скачать файл с ключами». Закрытая часть показывается один раз.",
          "title_en": "On the account page download the JSON key",
          "desc_en": "On the account page: “Create new key” → “Create authorized key” → “Download file with keys”. The private part is shown once and cannot be recovered."
        },
        {
          "title": "Скопируйте Folder ID с дашборда каталога",
          "desc": "Идентификатор каталога виден на дашборде под именем каталога и в адресе console.yandex.cloud/folders/<id>; он начинается с b1.",
          "title_en": "Copy the Folder ID from the folder dashboard",
          "desc_en": "The folder ID is shown on the dashboard under the folder name and in the console.yandex.cloud/folders/<id> address; it starts with b1."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Облако и ИИ-агент: простаивающие машины по каталогам",
      "description": "Соберёт ресурсы по всем каталогам облака, найдёт виртуальные машины, которые простаивают, и остановит их только после вашего «да». Ключ сервисного аккаунта.",
      "headline": "Собирайте инвентарь Яндекс Облака и держите его в порядке по каталогам",
      "scenarios": [
        {
          "title": "Инвентарь ресурсов облака",
          "desc": "Агент соберёт в один список виртуальные машины, кластеры Kubernetes и managed-БД, serverless-функции, бакеты и DNS-зоны по всем каталогам облака."
        },
        {
          "title": "Бюджеты и лимиты расходов",
          "desc": "Агент заведёт бюджет на платёжный аккаунт с порогами оповещения и покажет, какие каталоги и сервисы к этим порогам привязаны."
        },
        {
          "title": "Сводка изменений за сутки",
          "desc": "Агент по расписанию пришлёт, какие машины и кластеры запустились, остановились и появились за сутки, по журналу операций каждого ресурса."
        },
        {
          "title": "Проверка DNS и сертификатов",
          "desc": "Агент пройдёт по DNS-зонам и записям, сверит их с сертификатами Certificate Manager и назовёт то, у чего скоро истекает срок."
        },
        {
          "title": "Почему падают функции",
          "desc": "Агент поднимет логи и метрики мониторинга по serverless-функциям и контейнерам, найдёт всплеск ошибок и покажет, когда он начался и на чём."
        },
        {
          "title": "Погасить простаивающие машины",
          "desc": "Агент сверит метрики загрузки виртуальных машин с их размером и покажет кандидатов на остановку, а выключит только после вашего «да», дождавшись операции."
        }
      ],
      "how_it_works": [
        "У Яндекс Облака нет единого адреса API: каждый сервис живёт на своём хосте: compute для виртуальных машин, mks для Kubernetes, serverless-functions и serverless-containers, vpc с балансировщиками, dns и cdn, certificate-manager, storage и container-registry, mdb с ydb и trino, lockbox с kms, logging, monitoring, audit-trails, billing, resource-manager и organization-manager. Агент раскладывает запрос по нужным хостам сам и сводит ответы в один инвентарь в разрезе каталогов.",
        "Начинает агент с resource-manager: сначала список облаков и каталогов, потому что почти во всех перечислениях ресурсов идентификатор каталога служит обязательным полем самого API, а не удобством. Каталог по умолчанию берётся из подключения, а при пустом поле Folder ID это каталог, где создан сервисный аккаунт; список облаков и каталогов нужен только для работы по соседним. Изменяющие вызовы облако возвращает не результатом, а операцией, и агент дожидается её завершения на operations-хосте, вместо того чтобы считать ответ 200 подтверждением того, что ресурс уже создан.",
        "На чтении агент собирает инвентарь по каталогам, сверяет DNS-записи с сертификатами Certificate Manager и поднимает метрики мониторинга, а по расписанию присылает, что запустилось и остановилось за сутки. По деньгам API отдаёт платёжный аккаунт, бюджеты с порогами и справочник тарифов; построчная детализация потребления в API не выдаётся вовсе: её Облако кладёт выгрузкой в бакет, и агент честно скажет это, а не соберёт сумму по кусочкам. Меняет ресурсы он теми же методами API, что и консоль, но останавливается и спрашивает перед необратимым: удалением ресурса, остановкой машины, правкой DNS-зоны. Значения секретов Lockbox лежат на отдельном payload-хосте, и без прямой просьбы агент их не тянет.",
        "Авторизованный ключ агент меняет на короткоживущий IAM-токен и обновляет его сам, поэтому долгий обход инвентаря не обрывается на середине. Границы видимого задаёт роль сервисного аккаунта: облако, куда роль не выдана, агент не увидит вовсе, а сервис, закрытый правами, отличит от пустого каталога. Частоту вызовов агент выдерживает сам, а когда каталог пуст или роли не хватает, называет причину прямо, вместо того чтобы показать пустой инвентарь."
      ],
      "requirements": [
        "Облако в Yandex Cloud с привязанным платёжным аккаунтом",
        "Права администратора или владельца этого облака",
        "Доступ к консоли управления console.yandex.cloud"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Облако?",
          "a": "JSON авторизованного ключа сервисного аккаунта: в консоли создайте аккаунт в «Identity and Access Management», выдайте роль на само облако и скачайте файл ключа, а его содержимое вставьте в поле целиком. Folder ID заполнять не обязательно: без него агент работает в каталоге, где создан сервисный аккаунт."
        },
        {
          "q": "Что агент видит в облаке?",
          "a": "Функции, контейнеры и API-шлюзы, виртуальные машины и диски, кластеры Kubernetes и managed-БД, сети с балансировщиками, DNS-зоны, CDN и сертификаты, бакеты и реестр образов, секреты Lockbox и ключи KMS, лог-группы, метрики мониторинга, аудит-трейлы, биллинг-аккаунт с бюджетами и организацию с её группами в пределах роли сервисного аккаунта."
        },
        {
          "q": "Покажет ли агент, сколько потрачено по каждому каталогу?",
          "a": "Нет, и это ограничение самого API Облака, а не коннектора: в биллинге доступны платёжный аккаунт, бюджеты с порогами оповещения и справочник тарифов, а построчного потребления там нет ни в каком виде. Детализацию Облако выгружает в бакет Object Storage по расписанию; агент назовёт это прямо и предложит завести бюджет с порогом вместо выдуманной сводки."
        },
        {
          "q": "Может ли агент менять ресурсы?",
          "a": "Да, если сервисному аккаунту выдана роль editor: агент вызывает те же методы API, что и консоль управления. С ролью viewer доступно только чтение."
        },
        {
          "q": "Что будет, если не указать Folder ID?",
          "a": "Агент работает в каталоге, где создан сервисный аккаунт: Яндекс Облако называет его по ключу, и идентификатор подставляется сам. Поле нужно, только если работать надо в другом каталоге; по соседним каталогам облака агент тоже пройдёт, если роль выдана на облако."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Cloud AI agent: idle VMs across every folder",
      "description": "Inventories resources across all cloud folders, flags idle virtual machines and stops them only after you say yes. Connects with a service account key.",
      "headline": "Inventory Yandex Cloud and keep it in order, folder by folder",
      "scenarios": [
        {
          "title": "Cloud resource inventory",
          "desc": "The agent gathers virtual machines, Kubernetes and managed database clusters, serverless functions, buckets and DNS zones across every cloud folder into one list."
        },
        {
          "title": "Budgets and spending thresholds",
          "desc": "The agent sets a budget with alert thresholds on the billing account and shows which folders and services are bound to those thresholds."
        },
        {
          "title": "Daily summary of changes",
          "desc": "On a schedule, the agent reports which machines and clusters started, stopped and appeared over the past day, read from each resource's operation log."
        },
        {
          "title": "DNS and certificate check",
          "desc": "The agent walks through DNS zones and records, matches them against Certificate Manager certificates and names whatever is about to expire."
        },
        {
          "title": "Why functions keep failing",
          "desc": "The agent pulls logs and monitoring metrics for serverless functions and containers, finds the spike of errors and shows when it began and where."
        },
        {
          "title": "Shut down idle machines",
          "desc": "The agent matches virtual machine load metrics against their size, shows the candidates for shutdown and stops them only after your yes, waiting for the operation."
        }
      ],
      "how_it_works": [
        "Yandex Cloud has no single API address: every service lives on its own host: compute for virtual machines, mks for Kubernetes, serverless-functions and serverless-containers, vpc with its load balancers, dns and cdn, certificate-manager, storage and container-registry, mdb with ydb and trino, lockbox with kms, logging, monitoring, audit-trails, billing, resource-manager and organization-manager. The agent routes each request to the right host itself and folds the answers into a single inventory broken down by folder.",
        "The agent starts with resource-manager: the list of clouds and folders first, because in almost every resource listing the folder identifier is a required field of the API itself rather than a convenience. The default folder comes from the connection, and with Folder ID left empty it is the folder the service account was created in; the list of clouds and folders is needed only to work across the others. Mutating calls come back from the cloud as an operation rather than a result, and the agent waits for it to finish on the operations host instead of treating a 200 as proof that the resource already exists.",
        "On the read side the agent assembles an inventory by folder, matches DNS records against Certificate Manager certificates and pulls monitoring metrics, and on a schedule it reports what started and stopped over the past day. On money the API offers the billing account, budgets with thresholds and the price catalogue; line-by-line consumption is not exposed through the API at all: the cloud delivers it as an export into a bucket, and the agent says so rather than assembling a total out of fragments. It changes resources through the same API methods the console uses, but stops and asks before anything irreversible: deleting a resource, stopping a machine, editing a DNS zone. Lockbox secret values sit on a separate payload host, and the agent does not pull them unasked.",
        "The agent exchanges the authorized key for a short-lived IAM token and refreshes it on its own, so a long inventory sweep is never cut off halfway. What is visible is bounded by the service account's role: a cloud where no role was granted stays out of reach entirely, and a service closed by permissions is told apart from an empty folder. The agent holds the call rate itself, and when a folder is empty or the role falls short it names the reason directly instead of showing an empty inventory."
      ],
      "requirements": [
        "A cloud in Yandex Cloud with a billing account attached",
        "Administrator or owner rights on that cloud",
        "Access to the management console at console.yandex.cloud"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Cloud?",
          "a": "With the JSON of an authorized key for a service account: in the console create the account under Identity and Access Management, grant a role on the cloud itself and download the key file, then paste its contents into the field in full. Folder ID is optional: without it the agent works in the folder the service account was created in."
        },
        {
          "q": "What does the agent see in the cloud?",
          "a": "Functions, containers and API gateways, virtual machines and disks, Kubernetes and managed database clusters, networks with load balancers, DNS zones, CDN and certificates, buckets and the container registry, Lockbox secrets and KMS keys, log groups, monitoring metrics, audit trails, the billing account with its budgets and the organization with its groups, within the service account role."
        },
        {
          "q": "Will the agent show how much each folder spent?",
          "a": "No, and that is a limit of the Yandex Cloud API rather than of the connector: billing exposes the payment account, budgets with alert thresholds and the price catalogue, and no line-by-line consumption in any form. The cloud delivers that detail as a scheduled export into an Object Storage bucket; the agent will say so plainly and offer a budget threshold instead of an invented summary."
        },
        {
          "q": "Can the agent change resources?",
          "a": "Yes, if the service account has the editor role: the agent calls the same API methods as the management console. With the viewer role only reading is available."
        },
        {
          "q": "What happens if I leave Folder ID empty?",
          "a": "The agent works in the folder the service account was created in: Yandex Cloud names it from the key, and the identifier is supplied automatically. The field is needed only to work in a different folder; the agent can also go across the cloud's other folders when the role is granted on the cloud."
        }
      ]
    }
  },
  {
    "key": "yandex_datalens",
    "name": "Яндекс DataLens",
    "name_en": "Yandex DataLens",
    "description": "Визуализация данных: дашборды, датасеты, графики, подключения",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-datalens",
    "description_en": "Data visualization: dashboards, datasets, charts and connections",
    "search_terms": [
      "даталенс"
    ],
    "guide": {
      "url": "https://console.yandex.cloud",
      "steps": [
        {
          "title": "В IAM создайте сервисный аккаунт",
          "desc": "Консоль Yandex Cloud → «Identity and Access Management» → «Создать сервисный аккаунт» в облаке той организации, где работает DataLens.",
          "title_en": "Create a service account in IAM",
          "desc_en": "Yandex Cloud console → “Identity and Access Management” → “Create service account”, in a cloud of the organization where DataLens runs."
        },
        {
          "title": "В организации выдайте ему роль DataLens",
          "desc": "Cloud Center → «Права доступа» организации → «Назначить права» → сервисный аккаунт: datalens.admin для полного доступа или datalens.visitor для входа.",
          "title_en": "Grant it a DataLens role in the org",
          "desc_en": "Cloud Center → organization “Access bindings” → “Assign bindings” → the service account: datalens.admin for full access or datalens.visitor to sign in."
        },
        {
          "title": "На коллекциях назначьте роль viewer",
          "desc": "Роль на организацию содержимого не открывает: на каждой коллекции и воркбуке назначьте аккаунту datalens.collections.viewer и datalens.workbooks.viewer.",
          "title_en": "Assign the viewer role on collections",
          "desc_en": "An organization role alone does not expose content: assign datalens.collections.viewer and datalens.workbooks.viewer to the account on each collection and workbook."
        },
        {
          "title": "В карточке аккаунта скачайте JSON-ключ",
          "desc": "«Создать новый ключ» → «Создать авторизованный ключ» → «Скачать файл с ключами» и вставьте JSON целиком: организацию подключение найдёт само.",
          "title_en": "Download the JSON key from the account",
          "desc_en": "“Create new key” → “Create authorized key” → “Download file with keys”, then paste the whole JSON. The connection finds the organization by itself."
        }
      ]
    },
    "seo": {
      "title": "Яндекс DataLens и ИИ-агент: где лежит дашборд и его дубль",
      "description": "Яндекс DataLens (Даталенс): агент найдёт, в какой коллекции и воркбуке лежит дашборд и есть ли у него дубль, посчитает объекты и датасеты без единого чарта.",
      "headline": "Находите нужный дашборд и датасет DataLens из чата",
      "scenarios": [
        {
          "title": "Навигация по коллекциям и воркбукам",
          "desc": "Агент обойдёт коллекции и воркбуки организации и подскажет, где лежит нужный дашборд, датасет или подключение к источнику."
        },
        {
          "title": "Инвентаризация отчётов",
          "desc": "Агент соберёт список дашбордов, чартов и датасетов, найдёт дубли одного и того же отчёта и покажет связи между объектами."
        },
        {
          "title": "Аудит доступов и изменений",
          "desc": "Агент покажет права на объекты, проверит доступ конкретного пользователя и поднимет историю изменений начиная с нужной даты."
        },
        {
          "title": "Перенос воркбука между коллекциями",
          "desc": "Агент запустит экспорт воркбука, дождётся готовности файла и импортирует его в другую коллекцию той же организации."
        },
        {
          "title": "Лицензии и embed-ссылки",
          "desc": "Агент поднимет лицензии организации и embed-ссылки объектов и покажет, какие отчёты выведены наружу и на что хватает текущего тарифа."
        },
        {
          "title": "Из чего собран датасет",
          "desc": "Агент раскроет поля датасета, его источники и настройки: видно, какие срезы вообще есть, а за самими цифрами он пойдёт в исходную систему."
        }
      ],
      "how_it_works": [
        "Агент ходит в api.datalens.tech и обходит кабинет через RPC-ручки: листает директорию коллекций и воркбуков постранично, спускается внутрь и собирает дашборды, чарты, датасеты и подключения к источникам. Дальше он выстраивает связи между объектами (какой чарт на каком датасете, какой датасет на каком подключении), находит дубли одного отчёта и подсказывает, где лежит нужный.",
        "Агент читает конфигурацию отчётов и получает строки датасетов через экспериментальный getDatasetData API v3. Для запроса нужны GUID полей; при выгрузке частями агент учитывает сортировку и сообщает о неполном результате.",
        "API поддерживает создание, изменение и удаление объектов, доступы и экспорт/импорт воркбуков. Агент выполняет изменения по запросу пользователя в рамках выданных прав и проверяет результат. Перенос воркбука между коллекциями идёт экспортом и импортом: агент дожидается готовности файла.",
        "Подключение идёт по авторизованному ключу сервисного аккаунта Yandex Cloud: организацию DataLens подключение находит по ключу само, а IAM-токен агент обновляет без участия человека. Обход кабинета идёт постранично, и на большой организации агент забирает директорию частями, складывая связи объектов по мере спуска, а не одним запросом. Частоту он держит в пределах лимита, а пустой результат называет прямо и отличает «отчётов нет» от «отчёты не видны», а не выдаёт одно за другое."
      ],
      "requirements": [
        "Сервисный аккаунт Yandex Cloud с ролью в DataLens нужной организации.",
        "Доступ сервисного аккаунта к коллекциям и воркбукам уровня viewer.",
        "Права администратора DataLens у того, кто выдаёт роль."
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс DataLens?",
          "a": "Ключом сервисного аккаунта Yandex Cloud: вставьте JSON-файл авторизованного ключа целиком, организацию подключение найдёт само. Права в DataLens выдаются на организацию, поэтому аккаунту нужна роль в ней, а на коллекциях и воркбуках нужен доступ уровня viewer, иначе содержимое останется невидимым."
        },
        {
          "q": "Что агент видит в DataLens?",
          "a": "Структуру кабинета: коллекции, воркбуки, дашборды, чарты, датасеты и подключения, их связи и права, историю изменений, лицензии организации и embed-ссылки."
        },
        {
          "q": "Может ли агент показать цифры из дашборда?",
          "a": "Да, через экспериментальный метод getDatasetData API v3, если источник и выданные права допускают чтение. Сама конфигурация дашборда чисел не содержит."
        },
        {
          "q": "Пишет ли агент в DataLens?",
          "a": "Агент может создавать, изменять и удалять объекты, работать с доступами и переносить воркбуки по запросу пользователя в рамках выданных прав."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex DataLens AI agent: find a dashboard and its duplicate",
      "description": "Finds which collection and workbook hold a dashboard and whether it has a twin, counts the org's objects and flags datasets that feed no chart.",
      "headline": "Find the right DataLens dashboard and dataset from chat",
      "scenarios": [
        {
          "title": "Navigating collections and workbooks",
          "desc": "The agent walks through your organization's collections and workbooks and points you to the dashboard, dataset or source connection you need."
        },
        {
          "title": "Report inventory",
          "desc": "The agent lists dashboards, charts and datasets, spots duplicates of the same report and shows how the objects relate to each other."
        },
        {
          "title": "Access and change audit",
          "desc": "The agent shows permissions on objects, checks what a specific user can reach and pulls change history from any date you name."
        },
        {
          "title": "Moving a workbook between collections",
          "desc": "The agent exports a workbook, waits for the file to be ready and imports it into another collection in the same organization."
        },
        {
          "title": "Licenses and embed links",
          "desc": "The agent pulls the organization licenses and the embed links of objects and shows which reports are exposed outside and what the current plan still covers."
        },
        {
          "title": "What a dataset is built from",
          "desc": "The agent opens up the dataset fields, sources and settings so you can see which breakdowns exist at all; for the numbers themselves it goes to the source system."
        }
      ],
      "how_it_works": [
        "The agent calls api.datalens.tech and walks the account through RPC endpoints: it lists the directory of collections and workbooks page by page, descends into them and collects dashboards, charts, datasets and source connections. It then maps out how the objects relate (which chart sits on which dataset, which dataset on which connection), spots duplicates of the same report and points you to the one you need.",
        "The agent reads report configuration and can retrieve dataset rows through the experimental getDatasetData endpoint in API v3. It uses field GUIDs, checks ordering for paginated exports, and marks incomplete results.",
        "The API supports object creation, updates, deletion, access management, and workbook export/import. Changes follow the user request and granted permissions, and the agent checks the result. A workbook moves between collections by export and import, and the agent waits for the file to be ready.",
        "The connection is a Yandex Cloud service-account authorized key: the connection finds the DataLens organization from the key itself, and the agent renews the IAM token without anyone's help. The walk through the account is paginated, so on a large organization the agent takes the directory in parts and builds up the object links as it descends rather than in one call. It holds the request rate within the limit and names an empty result plainly, telling «no reports» apart from «reports not visible» instead of passing one off as the other."
      ],
      "requirements": [
        "A Yandex Cloud service account with a DataLens role in the right organization.",
        "Viewer access for the service account on collections and workbooks.",
        "DataLens admin rights for whoever grants the role."
      ],
      "faq": [
        {
          "q": "How do I connect Yandex DataLens?",
          "a": "With a Yandex Cloud service-account key: paste the whole authorized-key JSON file, and the connection finds the organization by itself. DataLens grants permissions at the organization level, so the account needs a role there, plus viewer access on collections and workbooks, otherwise their contents stay invisible."
        },
        {
          "q": "What does the agent see in DataLens?",
          "a": "The structure of your account: collections, workbooks, dashboards, charts, datasets and connections, how they relate, their permissions, change history, organization licenses and embed links."
        },
        {
          "q": "Can the agent show the numbers from a dashboard?",
          "a": "Yes, through the experimental getDatasetData endpoint in API v3, when the source and granted permissions allow it. Dashboard configuration itself does not contain the figures."
        },
        {
          "q": "Does the agent write to DataLens?",
          "a": "The agent can create, update, and delete objects, manage access, and transfer workbooks as requested and within the granted permissions."
        }
      ]
    }
  },
  {
    "key": "yandex_delivery",
    "name": "Яндекс Доставка",
    "name_en": "Yandex Delivery",
    "description": "Курьерская доставка: расчёт цены, заявки на курьера сегодня, доставка по России, ПВЗ, трекинг",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-delivery",
    "description_en": "Courier delivery: quotes, same-day orders, delivery across Russia, pickup points, tracking",
    "guide": {
      "url": "https://dostavka.yandex.ru",
      "steps": [
        {
          "title": "Войдите в кабинет dostavka.yandex.ru",
          "desc": "Откройте dostavka.yandex.ru и войдите с логином и паролем, которые выдал менеджер Яндекс Доставки.",
          "title_en": "Sign in at dostavka.yandex.ru",
          "desc_en": "Open dostavka.yandex.ru and sign in with the login and password issued by your Yandex Delivery manager."
        },
        {
          "title": "Вкладка «Интеграция» → «Получить токен»",
          "desc": "На вкладке «Интеграция» в разделе «Активируйте интеграцию» нажмите «Получить токен» и скопируйте его.",
          "title_en": "On the Integration tab, press Get token",
          "desc_en": "On the Integration tab, under Activate integration, press Get token and copy it."
        },
        {
          "title": "Скопируйте токен в поле ниже",
          "desc": "Вставьте токен в поле подключения. После смены пароля кабинета токен перестанет работать, его нужно получить заново.",
          "title_en": "Copy the token into the field below",
          "desc_en": "Paste the token into the connection field. Changing the account password revokes the token, so you will need a new one."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Доставка и ИИ-агент: курьер по заказу с ценой",
      "description": "Отправит заказ курьером: со склада на Складской, 7 за 612 ₽, приедет за 25 минут. Цену покажет до вызова, исполнителя ищет после согласия. Нужен токен кабинета.",
      "headline": "Курьер Яндекс Доставки из чата: цена, заявка и трекинг",
      "scenarios": [
        {
          "title": "Цена до вызова курьера",
          "desc": "Агент посчитает варианты доставки по адресам, весу и габаритам и покажет цену, окно забора и время доставки ещё до создания заявки."
        },
        {
          "title": "Курьер на сегодня",
          "desc": "Агент создаст заявку, дождётся оценки и покажет итоговую цену, адреса и срок, а подтвердит её только после вашего согласия."
        },
        {
          "title": "Где сейчас курьер",
          "desc": "Агент поднимет статус заявки, прогноз прибытия на каждую точку и ссылку для отслеживания, которую можно отправить получателю."
        },
        {
          "title": "Доставка по России",
          "desc": "Агент подберёт пункт выдачи рядом с получателем, рассчитает стоимость и срок и оформит заказ со склада после вашего подтверждения."
        },
        {
          "title": "Отмена без сюрпризов",
          "desc": "Агент сначала узнает, бесплатна ли отмена прямо сейчас, и скажет об этом до того, как отменять заявку."
        },
        {
          "title": "Сводка по заявкам",
          "desc": "Агент соберёт заявки за период с их статусами и ценой и покажет, какие зависли на поиске курьера или вернулись отправителю."
        }
      ],
      "how_it_works": [
        "Агент работает с API Яндекс Доставки по токену из личного кабинета dostavka.yandex.ru. Экспресс-доставка идёт через заявки: агент считает варианты доставки по координатам точек, весу и габаритам, создаёт заявку, читает её оценку и ведёт её по статусам до вручения. Для доставки в другой день он ищет пункты выдачи, считает стоимость и интервалы и читает заказы логистической платформы.",
        "Создание заявки у Яндекса ещё не вызов курьера. Сначала сервис оценивает заявку и называет цену, которая держится около десяти минут, и только подтверждение запускает поиск исполнителя и списание. Поэтому агент создаёт заявку, дожидается статуса готовности к подтверждению и показывает вам итог целиком: откуда, куда, тариф, цену и срок. Подтверждает он только после вашего явного да, а если цена успела устареть, пересчитывает её и спрашивает снова.",
        "Отмену агент тоже начинает с вопроса к сервису: до прибытия курьера она бесплатна, после прибытия платная, а после передачи груза возможна только через поддержку. Условие отмены вы видите до того, как агент её выполнит. Каждой новой заявке агент даёт свой ключ идемпотентности и повторяет его только при сбое сервера, чтобы за одним заказом не приехали два курьера.",
        "Координаты точек агент передаёт в порядке долгота, широта, габариты в метрах, вес в килограммах, телефоны в формате +7: иначе заявка не пройдёт оценку. Частота запросов держится в пределах пяти в секунду."
      ],
      "requirements": [
        "Договор с Яндекс Доставкой и доступ к личному кабинету",
        "Ваше подтверждение на каждую платную заявку и отмену"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Доставку?",
          "a": "Токеном из личного кабинета dostavka.yandex.ru: вкладка «Интеграция», раздел «Активируйте интеграцию», кнопка «Получить токен». Токен бессрочный, но перестаёт работать после смены пароля кабинета."
        },
        {
          "q": "Что агент видит в Яндекс Доставке?",
          "a": "Заявки на экспресс-доставку с их статусами, ценой и маршрутом, положение курьера и ссылки для отслеживания, а также заказы доставки по России, пункты выдачи и расчёт стоимости."
        },
        {
          "q": "Может ли агент сам заказать курьера?",
          "a": "Агент создаёт заявку и показывает цену, адреса и срок, а подтверждает её, то есть запускает курьера и оплату, только после вашего согласия. Платную отмену он тоже согласует с вами."
        },
        {
          "q": "Заявка уйдёт реальному курьеру?",
          "a": "Да, коннектор работает с боевым кабинетом: подтверждённая заявка зовёт настоящего курьера и списывает деньги. Поэтому агент называет цену с НДС, адреса и срок и подтверждает заявку только после вашего согласия."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Delivery and an AI agent: a courier with a price",
      "description": "Sends an order by courier: from the warehouse for 612 RUB, arriving in 25 minutes. You see the price before the call, and the courier is booked once you agree.",
      "headline": "Book Yandex Delivery couriers from chat: quote, order, track",
      "scenarios": [
        {
          "title": "A price before the courier",
          "desc": "The agent calculates delivery options from the addresses, weight and dimensions and shows the price, pickup window and delivery time before any order exists."
        },
        {
          "title": "A courier for today",
          "desc": "The agent creates the order, waits for the estimate and shows the final price, addresses and timing, then confirms it only once you agree."
        },
        {
          "title": "Where the courier is now",
          "desc": "The agent pulls the order status, the arrival forecast for every stop and a tracking link you can forward to the recipient."
        },
        {
          "title": "Delivery across Russia",
          "desc": "The agent picks a pickup point near the recipient, calculates the cost and timing and places the warehouse order after your confirmation."
        },
        {
          "title": "Cancelling without surprises",
          "desc": "The agent first asks whether cancelling is free right now and tells you before it cancels anything."
        },
        {
          "title": "Orders at a glance",
          "desc": "The agent gathers the orders for a period with their statuses and prices and flags the ones stuck on courier search or returned to the sender."
        }
      ],
      "how_it_works": [
        "The agent works with the Yandex Delivery API using a token from the dostavka.yandex.ru account. Express delivery runs on claims: the agent calculates delivery options from the point coordinates, weight and dimensions, creates a claim, reads its estimate and follows it through the statuses to handover. For next-day delivery it searches pickup points, calculates cost and intervals and reads the orders of the logistics platform.",
        "Creating a claim at Yandex is not yet calling a courier. The service first estimates the claim and names a price that holds for about ten minutes, and only the confirmation starts the courier search and the charge. So the agent creates the claim, waits for it to become ready for approval and shows you the whole picture: from where, to where, tariff, price and timing. It confirms only after your explicit yes, and if the price has expired it recalculates and asks again.",
        "Cancelling also starts with a question to the service: before the courier arrives it is free, after arrival it is paid, and after handover it is only possible through support. You see the cancellation terms before the agent acts on them. Every new claim gets its own idempotency key, repeated only after a server failure, so that one order never brings two couriers.",
        "The agent sends point coordinates as longitude then latitude, dimensions in metres, weight in kilograms and phones in the +7 format, or the claim will not pass the estimate. The request rate stays within five per second."
      ],
      "requirements": [
        "A contract with Yandex Delivery and access to its account",
        "Your confirmation for every paid order and cancellation"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Delivery?",
          "a": "With a token from the dostavka.yandex.ru account: open the Integration tab, find Activate integration and press Get token. The token does not expire, but it stops working after the account password changes."
        },
        {
          "q": "What can the agent see in Yandex Delivery?",
          "a": "Express delivery claims with their statuses, prices and routes, the courier position and tracking links, plus next-day delivery orders, pickup points and cost calculations."
        },
        {
          "q": "Can the agent book a courier on its own?",
          "a": "The agent creates the claim and shows the price, addresses and timing, and it confirms the claim, which starts the courier and the payment, only after you agree. A paid cancellation is agreed with you as well."
        },
        {
          "q": "Will the claim reach a real courier?",
          "a": "Yes, the connector works with your production account: a confirmed claim calls a real courier and charges the account. That is why the agent names the price including VAT, the addresses and the timing and confirms the claim only after you agree."
        }
      ]
    }
  },
  {
    "key": "yandex_direct",
    "name": "Яндекс Директ",
    "name_en": "Yandex Direct",
    "description": "Контекстная реклама: кампании, объявления, ключевые слова, ставки и аналитика",
    "category": "ads",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-direct",
    "description_en": "Search ads: campaigns, ads, keywords, bids and analytics",
    "guide": {
      "url": "https://direct.yandex.ru",
      "steps": [
        {
          "title": "Выберите логин, зарегистрированный в Директе",
          "desc": "API пускает представителя бизнеса, агентство или клиента агентства. Решите, под каким логином входить, и выйдите из лишних аккаунтов Яндекса.",
          "title_en": "Pick a login registered in Direct",
          "desc_en": "The API admits a business representative, an agency, or an agency client granted access. Decide which login to use and sign out of your other accounts."
        },
        {
          "title": "Проверьте, где лежат кампании",
          "desc": "Под агентским логином клиентские кампании не подтянутся, поэтому входите под логином рекламодателя, на котором лежат кампании.",
          "title_en": "Check where the campaigns live",
          "desc_en": "The agent works with campaigns of the login that confirmed access. Client campaigns under an agency login won't show up, so use the advertiser's login."
        },
        {
          "title": "Проверьте уровень прав на кампании",
          "desc": "Права из веб-интерфейса переносятся в API один в один: при доступе «только на чтение» агент лишь получает данные. Право на редактирование выдаёт агентство.",
          "title_en": "Check your rights on the campaigns",
          "desc_en": "Web interface rights carry over as is: with read-only access the agent can only fetch data, not change bids or statuses. The agency grants edit rights."
        },
        {
          "title": "Примите условия на странице «Настройки API»",
          "desc": "Пользоваться API можно после принятия условий соглашения на странице «Настройки API». На вкладке «Параметры» список разрешённых IP-адресов должен быть пустым.",
          "title_en": "Accept the terms on the API Settings page",
          "desc_en": "API use requires accepting the agreement on the API Settings page. On its Parameters tab the allowed IP list must be empty, or other addresses are rejected."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Директ и ИИ-агент: фразы, которые жгут бюджет",
      "description": "Найдёт ключевые фразы Яндекс Директа, которые съели бюджет при нуле конверсий, и разложит расход месяца по кампаниям. Вход подтверждением кода у Яндекса.",
      "headline": "Считайте расход и конверсии кампаний Яндекс Директа",
      "scenarios": [
        {
          "title": "Расход и конверсии по кампаниям",
          "desc": "Агент соберёт отчёт по показам, кликам, CTR, расходу и конверсиям за период и покажет, какие кампании окупаются, а какие тратят бюджет впустую."
        },
        {
          "title": "Поисковые запросы, которые жгут бюджет",
          "desc": "Агент выгрузит отчёт по реальным поисковым запросам, сведёт их с фразами и автотаргетингом и назовёт те, у которых есть расход и ноль конверсий."
        },
        {
          "title": "Ставки и остановки по бюджету",
          "desc": "Агент проверит ставки по фразам, состояние и статус модерации кампаний и назовёт те, что встали из-за дневного бюджета, отклонённых объявлений или пустого счёта."
        },
        {
          "title": "Ежедневная сводка по расходу",
          "desc": "Агент пришлёт в чат расход за вчера, сравнит с прошлой неделей и назовёт кампании, у которых просел CTR или выросла цена конверсии."
        },
        {
          "title": "Где именно кликают",
          "desc": "Агент разложит показы, клики и расход по регионам показа и назовёт города, где цена конверсии заметно выше средней по кампании."
        },
        {
          "title": "Ставки вниз по подтверждению",
          "desc": "Агент покажет текущую и предлагаемую ставку и число затронутых фраз, после вашего согласия применит изменение или остановит кампанию и перечитает результат."
        }
      ],
      "how_it_works": [
        "Агент работает с API Директа пятой версии на https://api.direct.yandex.com/json/v5: кампании, группы, объявления, ключевые фразы и автотаргетинги со ставками, минус-фразы, портфельные стратегии, корректировки, справочники регионов и отчёты. Из этого он собирает расход, показы, клики, CTR и конверсии за период, спускается с уровня кампании до отдельной фразы и до реального поискового запроса и находит то, что тратит бюджет и не приносит ни одной конверсии.",
        "Включённая кампания в Директе не значит работающую: состояние и статус здесь разные вещи, и кампания может стоять из-за отклонённой модерации, исчерпанного дневного бюджета или пустого счёта, оставаясь при этом «включённой». Агент смотрит оба поля вместе со статусом оплаты и называет настоящую причину остановки. Статистика за текущий день ещё дописывается, поэтому сравнения он строит по закрытым дням и всегда называет период, за который взял цифры.",
        "Единая перфоманс-кампания живёт на отдельном адресе API, а прежние динамические кампании и смарт-баннеры в неё переведены и заново не создаются. Агент читает такие кампании там, где они действительно лежат, и не выдаёт «ничего не нашлось» за отсутствие рекламы. Автотаргетинг он показывает наравне с фразами: в ЕПК он включён по умолчанию, и расход без единой ключевой фразы обычно именно он.",
        "Менять ставки и останавливать кампании агент может, если у логина есть право на редактирование: права переносятся из веб-интерфейса один в один, и при доступе только на чтение остаётся аналитика. Но ставка означает деньги в реальном времени, поэтому агент сначала показывает текущее значение, предлагаемое и число затронутых фраз, ждёт подтверждения и перечитывает результат после применения, а не считает успехом сам факт принятого запроса: Директ отвечает «успешно» и на пачку, где часть строк отклонена.",
        "Подключение идёт подтверждением кода на странице Яндекса. Токены копировать не нужно, дальше доступ продлевается сам. Директ считает баллы Units с суточной квотой: каждый запрос стоит баллов, а неудачный стоит двадцати, поэтому агент просит только нужные поля и не долбит API одним и тем же битым телом. Параллельных запросов не больше пяти, так что выборки он дробит постранично, тяжёлые отчёты заказывает в офлайн-режиме и дожидается готовности, а о нехватке данных или прав говорит прямо."
      ],
      "requirements": [
        "Одобренная заявка на доступ к API Директа",
        "Принятые условия соглашения об API в настройках Директа",
        "Пустой список разрешённых IP-адресов в настройках API",
        "Агентству: логин клиента в поле «Логин рекламодателя»",
        "Суточная квота баллов (Units) на рекламодателя"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Директ?",
          "a": "Подтвердите код на странице Яндекса, копировать токены не нужно. Прямой рекламодатель входит под своим логином и может оставить «Логин рекламодателя» пустым. Агентство входит под логином представителя агентства и указывает логин клиента в этом поле. Для каждого клиента подключите отдельный кабинет. Условия соглашения и заявка на доступ находятся на странице «Настройки API»."
        },
        {
          "q": "Что агент видит в Директе?",
          "a": "Кампании всех типов, включая ЕПК, группы, объявления, ключевые фразы и автотаргетинги со ставками, минус-фразы, портфельные стратегии, корректировки ставок, фиды, ретаргетинг, справочники регионов и отчёты API v5 выбранного рекламодателя: своего аккаунта или клиента агентства, чей логин указан при подключении."
        },
        {
          "q": "Может ли агент менять ставки и кампании?",
          "a": "Да, если у логина есть право на редактирование: агент останавливает и запускает кампании, выставляет ставки по фразам и корректировки. Права переносятся из веб-интерфейса один в один, и при доступе «только на чтение» остаётся аналитика. Любое изменение идёт через подтверждение и перечитывается после применения."
        },
        {
          "q": "Откуда агент берёт расход в рублях?",
          "a": "Из отчётов API за закрытые дни: расход, показы, клики, CTR, цена клика и конверсии приходят уже в рублях за названный период. Цифры за сегодня Директ ещё дописывает, поэтому в сравнениях агент их не использует и всегда называет границы периода."
        },
        {
          "q": "Что с лимитами API Директа?",
          "a": "Директ считает баллы (Units) и держит суточную квоту на рекламодателя, параллельных запросов допускает не больше пяти, а к сервису отчётов не больше двадцати за десять секунд и пяти отчётов в очереди. Агент дробит выборки постранично, а тяжёлые отчёты заказывает в офлайн-режиме и дожидается готовности."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Direct AI agent: keywords that burn budget",
      "description": "Finds Yandex Direct keywords that ate budget with zero conversions and splits the month's spend by campaign. Connects by confirming a code on the Yandex page.",
      "headline": "Track spend and conversions across Yandex Direct campaigns",
      "scenarios": [
        {
          "title": "Spend and conversions by campaign",
          "desc": "The agent pulls a report on impressions, clicks, CTR, spend and conversions for the period and shows which campaigns pay off and which just burn budget."
        },
        {
          "title": "Search queries that burn budget",
          "desc": "The agent pulls the report on the actual search queries, matches them against keywords and autotargeting and names the ones with spend and zero conversions."
        },
        {
          "title": "Bids and budget stoppages",
          "desc": "The agent checks keyword bids, campaign state and moderation status and names the ones stalled by a daily budget cap, by rejected ads or by an empty account."
        },
        {
          "title": "Daily spend digest",
          "desc": "The agent posts yesterday's spend in chat, compares it with last week and names the campaigns whose CTR slipped or whose cost per conversion went up."
        },
        {
          "title": "Where the clicks come from",
          "desc": "The agent breaks impressions, clicks and spend down by display region and names the cities where the cost per conversion sits well above the campaign average."
        },
        {
          "title": "Bid changes you confirm",
          "desc": "The agent shows the current bid, the proposed one and the number of keywords affected, applies the change or pauses the campaign once you agree, and re-reads the result."
        }
      ],
      "how_it_works": [
        "The agent works with version five of the Direct API at https://api.direct.yandex.com/json/v5: campaigns, ad groups, ads, keywords and autotargetings with their bids, negative keywords, portfolio strategies, bid adjustments, region reference books and reports. Out of that it assembles spend, impressions, clicks, CTR and conversions for a period, goes down from the campaign level to an individual keyword and on to the actual search query, and finds what burns budget without bringing in a single conversion.",
        "An enabled campaign in Direct does not mean a running one: state and status are different things here, and a campaign can be stalled by rejected moderation, an exhausted daily budget or an empty account while still being «enabled». The agent reads both fields together with the payment status and names the real reason for the stop. Statistics for the current day are still being written in, so it builds comparisons on closed days and always names the period the figures were taken for.",
        "The unified performance campaign lives at its own API address, and the former dynamic campaigns and smart banners have been migrated into it and are no longer created anew. The agent reads such campaigns where they actually sit rather than reporting «nothing found» for advertising that exists. Autotargeting is shown next to keywords: in a unified campaign it is on by default, and spend without a single keyword is usually exactly that.",
        "The agent can change bids and pause campaigns if the login has edit rights: permissions carry over from the web interface one to one, and with read-only access you still get the analytics. But a bid is money in real time, so the agent first shows the current value, the proposed one and the number of keywords affected, waits for confirmation and re-reads the result after applying it, because Direct answers «success» even for a batch in which some rows were rejected.",
        "The connection is made by confirming a code on a Yandex page: there are no tokens to copy, and access is renewed on its own afterwards. Direct counts Units against a daily quota: every request costs points and a failed one costs twenty, so the agent asks only for the fields it needs and does not hammer the API with the same broken body. No more than five requests run in parallel, so it paginates through selections, orders heavy reports in offline mode and waits until they are ready, and states any shortage of data or permissions directly."
      ],
      "requirements": [
        "An approved Direct API access request",
        "The API agreement terms accepted in Direct API settings",
        "An empty allowed IP list in the Direct API settings",
        "Agencies: the client's login in the Advertiser login field",
        "The daily Units quota per advertiser"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Direct?",
          "a": "Confirm a code on a Yandex page, with no tokens to copy. Direct advertisers sign in with their own login and can leave Advertiser login empty. Agencies sign in as an agency representative and enter the client's login in that field. Connect a separate cabinet for each client. The agreement terms and the access request live on the API Settings page."
        },
        {
          "q": "What does the agent see in Direct?",
          "a": "Campaigns of every type including unified performance ones, ad groups, ads, keywords and autotargetings with bids, negative keywords, portfolio strategies, bid adjustments, feeds, retargeting, region reference books and API v5 reports for the selected advertiser: your own account or the agency client whose login you entered at connection."
        },
        {
          "q": "Can the agent change bids and campaigns?",
          "a": "Yes, if the login has edit rights: the agent pauses and resumes campaigns and sets keyword bids and adjustments. Permissions carry over from the web interface one to one, and with read-only access you still get the analytics. Every change goes through confirmation and is re-read after it is applied."
        },
        {
          "q": "Where does the agent get spend in roubles?",
          "a": "From API reports over closed days: spend, impressions, clicks, CTR, cost per click and conversions arrive already in roubles for the named period. Direct is still writing in today's figures, so the agent keeps them out of comparisons and always names the period boundaries."
        },
        {
          "q": "What about Direct API limits?",
          "a": "Direct counts Units and holds a daily quota per advertiser, allows no more than five parallel requests, and no more than twenty requests to the reports service per ten seconds with five reports in the queue. The agent paginates through selections and orders heavy reports in offline mode, waiting until they are ready."
        }
      ]
    }
  },
  {
    "key": "yandex_disk",
    "name": "Яндекс Диск",
    "name_en": "Yandex Disk",
    "description": "Облачное хранилище Яндекс 360",
    "category": "files",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-disk",
    "description_en": "Yandex 360 cloud storage",
    "guide": {
      "url": "https://disk.yandex.ru",
      "steps": [
        {
          "title": "Выберите аккаунт, чей Диск подключаете",
          "desc": "Доступ выдаёт тот аккаунт, под которым вы подтвердите код. Для рабочих файлов войдите на disk.yandex.ru под аккаунтом Яндекс 360 организации.",
          "title_en": "Pick the account whose Disk you connect",
          "desc_en": "Access is granted by whichever account confirms the code. For work files, sign in to disk.yandex.ru with your Yandex 360 organization account first."
        },
        {
          "title": "Примите общие папки коллег на свой Диск",
          "desc": "Владелец папки жмёт «Настроить доступ» и выдаёт «Редактирование» или «Просмотр». Принятая папка места на вашем Диске не занимает.",
          "title_en": "Accept shared folders onto your Disk",
          "desc_en": "The folder owner clicks «Настроить доступ» and grants «Редактирование» or «Просмотр». An accepted folder costs no space on your Disk."
        },
        {
          "title": "Сверьте объём прав до подтверждения кода",
          "desc": "Права: «Чтение всего Диска», «Запись в любом месте на Диске», «Доступ к информации о Диске» и «Доступ к папке приложения на Диске». Частично выдать нельзя.",
          "title_en": "Check the access scope before you confirm",
          "desc_en": "The request covers reading the whole Disk, writing anywhere, Disk info and app-folder access. It cannot be granted partially."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Диск с ИИ: найти акт и почистить дубли в папке",
      "description": "Работа с документами на Яндекс Диске: агент найдёт акт по контрагенту с путём и датой загрузки и покажет дубли в папке «Договоры». Работает через REST API Диска.",
      "headline": "Находите файлы на Яндекс Диске и считайте по выгрузкам",
      "scenarios": [
        {
          "title": "Поиск документа на Диске",
          "desc": "Агент найдёт файл по названию, типу или папке и пришлёт ссылку, не заставляя листать дерево папок вручную."
        },
        {
          "title": "Расчёт по выгрузке с Диска",
          "desc": "Агент заберёт выгрузку или отчёт прямо с Диска, посчитает по ней цифры и положит результат обратно в нужную папку."
        },
        {
          "title": "Разбор папок и публичные ссылки",
          "desc": "Агент создаст папку, скопирует или перенесёт файлы и опубликует ссылку на документ, которым нужно поделиться."
        },
        {
          "title": "Место и новые файлы",
          "desc": "Агент раз в неделю пришлёт, сколько места осталось на Диске и какие файлы появились в рабочих папках за эти дни."
        },
        {
          "title": "Возврат из корзины",
          "desc": "Агент заглянет в корзину Диска, найдёт удалённый на днях документ по названию и дате и вернёт его обратно в рабочую папку."
        },
        {
          "title": "Дубли и старые версии",
          "desc": "Агент сверит имена, размеры и даты изменения в рабочей папке и покажет дубли и старые версии одного документа, которые можно убрать."
        }
      ],
      "how_it_works": [
        "Агент обращается к REST API Диска по адресу cloud-api.yandex.net и работает с деревом подключённого аккаунта: перечисляет папки и файлы, читает метаданные (имя, тип, размер, дату изменения), ищет документ по названию, расширению или папке и отдаёт ссылку вместо ручного листания. Он же берёт выгрузку или отчёт прямо с Диска, считает по ней цифры и следит за остатком места и появлением новых файлов в рабочих папках.",
        "Файл агент кладёт на Диск сам: отчёт, выгрузку или документ из чата, в нужную папку и под понятным именем. Чужая папка попадает в его поле зрения лишь после того, как владелец выдал на неё «Просмотр» или «Редактирование» в «Настроить доступ», а удалённое уходит в корзину, откуда его ещё можно достать.",
        "На запись агент создаёт папки, копирует и переносит файлы, удаляет ненужное и публикует ссылки на документы, которыми надо поделиться. Перед перезаписью файла с тем же именем и перед удалением он спрашивает, а публикацию выделяет отдельно: публичная ссылка открывает документ любому, кто её получит, и в рабочих папках это решение принимаете вы, а не агент. Что именно и куда он положил, называется явно, путём, а не «готово».",
        "Большие операции (копирование и перенос папки) API выполняет асинхронно: в ответ приходит ссылка на статус, и агент дожидается завершения, а не рапортует «готово» на полпути. Точечно открыть доступ к одной папке REST API Диска не умеет, права всегда охватывают весь Диск, поэтому под ограниченный доступ заводят отдельный аккаунт. Частоту запросов агент держит сам, а пустую папку называет пустой, а не молчит."
      ],
      "requirements": [
        "Аккаунт Яндекс 360 организации, если нужны рабочие файлы",
        "Место на Диске под новые файлы"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Диск?",
          "a": "По коду подтверждения Яндекс ID: нажмите «Подключить», введите код на странице Яндекса и подтвердите доступ тем аккаунтом, чей Диск нужен. Для рабочих файлов это аккаунт Яндекс 360 организации, у личного аккаунта Диск другой."
        },
        {
          "q": "Что агент видит на Диске?",
          "a": "Файлы и папки подключённого аккаунта вместе с корзиной, включая общие папки коллег: чужая папка видна после того, как владелец выдал на неё «Просмотр» или «Редактирование» в «Настроить доступ»."
        },
        {
          "q": "Может ли агент загружать файлы?",
          "a": "Агент создаёт папки, копирует, переносит и удаляет файлы и публикует ссылки. Файл из чата или с вашего компьютера он загружает на Диск в указанную папку."
        },
        {
          "q": "Можно ли выдать доступ только к части файлов?",
          "a": "Нет: запрашиваются права на весь Диск: чтение, запись, информация о Диске и папка приложения. Частично их выдать нельзя, поэтому под ограниченный доступ заводят отдельный аккаунт."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Disk API and AI agent: find a file, clear duplicates",
      "description": "Ask where an act is and get its path and upload date, or see how many duplicates clog a folder and how much space they take. Built on the Disk REST API.",
      "headline": "Find files on Yandex Disk and crunch the exports",
      "scenarios": [
        {
          "title": "Finding a document on Disk",
          "desc": "The agent finds a file by name, type or folder and sends you the link, so you never have to scroll the folder tree by hand."
        },
        {
          "title": "Crunching an export from Disk",
          "desc": "The agent picks up an export or report straight from Disk, runs the numbers on it and files the result back into the right folder."
        },
        {
          "title": "Sorting folders and public links",
          "desc": "The agent creates a folder, copies or moves files and publishes a link to the document you need to share."
        },
        {
          "title": "Storage space and new files",
          "desc": "Once a week the agent reports how much space is left on Disk and which files showed up in your work folders over those days."
        },
        {
          "title": "Back out of the trash",
          "desc": "The agent looks into the Disk trash, finds the document deleted the other day by its name and date and puts it back into the work folder."
        },
        {
          "title": "Duplicates and old versions",
          "desc": "The agent compares names, sizes and modification dates in a work folder and shows the duplicates and older versions of one document that can go."
        }
      ],
      "how_it_works": [
        "The agent calls the Disk REST API at cloud-api.yandex.net and works with the tree of the connected account: it lists folders and files, reads metadata (name, type, size, modification date), finds a document by name, extension or folder and hands over the link instead of making you scroll. It also picks up an export or report straight from Disk, runs the numbers on it and keeps an eye on remaining space and on new files appearing in your work folders.",
        "The agent puts files on Disk itself: a report, an export or a document from the chat, into the right folder under a clear name. Someone else folder enters its field of view only after the owner grants it View or Edit in the sharing settings, and whatever is deleted goes to the trash, where it can still be retrieved.",
        "On the write side the agent creates folders, copies and moves files, deletes what is no longer needed and publishes links to documents you have to share. It asks before overwriting a file with the same name and before deleting, and it treats publishing as a decision of its own: a public link opens the document to anyone who receives it, and in work folders that call is yours, not the agent's. What it put where is stated explicitly, as a path rather than a «done».",
        "Large operations (copying or moving a folder) are performed asynchronously by the API: the response is a link to a status, and the agent waits for completion instead of reporting «done» halfway. The Disk REST API cannot open access to a single folder, rights always cover the whole Disk, which is why limited access is set up as a separate account. The agent holds the request rate itself, and it calls an empty folder empty instead of staying silent."
      ],
      "requirements": [
        "An organization Yandex 360 account if you need work files",
        "Free space on the Disk for new files"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Disk?",
          "a": "With a Yandex ID confirmation code: click Connect, enter the code on the Yandex page and confirm access with the account whose Disk you need. For work files that is your organization's Yandex 360 account, as a personal account has a different Disk."
        },
        {
          "q": "What does the agent see on Disk?",
          "a": "Files and folders of the connected account along with the trash, including folders shared by colleagues: someone else's folder becomes visible once the owner grants it View or Edit under the sharing settings."
        },
        {
          "q": "Can the agent upload files?",
          "a": "The agent creates folders, copies, moves and deletes files and publishes links. It uploads a file from the chat or from your computer to the folder you name."
        },
        {
          "q": "Can I grant access to only part of my files?",
          "a": "No: the rights requested cover the whole Disk: read, write, Disk info and the app folder. They cannot be granted partially, so for limited access people set up a separate account."
        }
      ]
    }
  },
  {
    "key": "yandex_fleet",
    "name": "Yandex Fleet",
    "name_en": "Yandex Fleet",
    "description": "Автопарк Яндекс Такси: автомобили, водители и курьеры, заказы, GPS-треки, транзакции",
    "category": "logistics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-fleet",
    "description_en": "Yandex Taxi fleet: cars, drivers and couriers, orders, GPS tracks and transactions",
    "search_terms": [
      "яндекс флит",
      "яндекс такси"
    ],
    "guide": {
      "url": "https://fleet.yandex.ru",
      "steps": [
        {
          "title": "Войдите на fleet.yandex.ru как «Директор»",
          "desc": "Кабинет автопарка: fleet.yandex.ru. Раздел «API» редактирует только сотрудник с ролью «Директор»: под другой ролью создать ключ не получится.",
          "title_en": "Sign in at fleet.yandex.ru as Director",
          "desc_en": "The fleet dashboard is fleet.yandex.ru. Only an employee with the \"Director\" role can edit the \"API\" section; any other role cannot create a key."
        },
        {
          "title": "В «Настройках» Диспетчерской откройте «API»",
          "desc": "В меню Диспетчерской выберите «Настройки» и перейдите в раздел «API». Там создаются ключи и рядом показаны идентификаторы партнёра и клиента.",
          "title_en": "In dispatch panel Settings open API",
          "desc_en": "In the control room menu pick \"Settings\" and go to the \"API\" section. Keys are created there, and the partner ID and client ID are shown next to them."
        },
        {
          "title": "Создайте ключ и скопируйте три значения",
          "desc": "Нужны ровно три: идентификатор партнёра (park_id), идентификатор клиента (X-Client-ID) и секретный API-ключ (X-API-Key). Ключ показывается один раз.",
          "title_en": "Create a key and copy three values",
          "desc_en": "Exactly three are needed: partner ID (park_id), client ID (X-Client-ID) and the secret API key (X-API-Key). The secret key is shown once, at creation time."
        }
      ]
    },
    "seo": {
      "title": "Yandex Fleet (fleet.yandex.ru) с ИИ: отмены водителей",
      "description": "ИИ-агент разберёт смену парка такси в Яндекс Флит (Диспетчерская): четверо водителей дали 31 отмену из 486 заказов. Подключение API-ключом, ID клиента и парка.",
      "headline": "Разбирайте смены водителей и заказы автопарка прямо в чате",
      "scenarios": [
        {
          "title": "Разбор смены",
          "desc": "Агент соберёт заказы за смену и покажет, у каких водителей больше отмен и незавершённых поездок и как это меняется по дням."
        },
        {
          "title": "Транзакции и выплаты",
          "desc": "Агент сверит транзакции по водителям и заказам с условиями работы парка и покажет, у кого заблокирован баланс перед выплатой."
        },
        {
          "title": "Кто реально на линии",
          "desc": "Агент пройдёт по профилям водителей и карточкам автомобилей и покажет, кто выходит на линию, а кто только числится в парке."
        },
        {
          "title": "Треки по спорным заказам",
          "desc": "Агент поднимет GPS-трек конкретного заказа и часы на линии исполнителя, когда нужно разобрать жалобу или спорную поездку."
        },
        {
          "title": "Заявки на подключение",
          "desc": "Агент разберёт заявки водителей и курьеров, покажет, какие висят без движения, и назовёт тех, кто оформился, но так и не вышел на первый заказ."
        },
        {
          "title": "Часы на линии за неделю",
          "desc": "Агент сложит часы исполнителей на линии по дням и покажет, кто не добрал до нормы парка, а кто закрывает неделю с явной переработкой."
        }
      ],
      "how_it_works": [
        "Агент ходит в Fleet API Яндекс.Такси и читает парк целиком: автомобили и профили водителей и курьеров, заявки на подключение, заказы вместе с их GPS-треками, транзакции и заблокированный баланс, условия работы парка и часы исполнителей на линии. Из этих кусков он и собирает разбор смены, сверку транзакций с условиями работы и картину того, кто действительно выходит на линию, а кто просто числится.",
        "Каждый запрос здесь привязан к конкретному парку: идентификатор партнёра уходит и в заголовке, и в параметрах, и в теле запроса, поэтому агент всегда работает в границах одного автопарка и не смешивает данные разных. Заказ в Fleet не одна строка, а связка с водителем, машиной, треком и транзакциями, и статус заказа сам по себе не отвечает на вопрос, довезли ли пассажира: за этим агент идёт в трек и в историю транзакций.",
        "По природе своей работа тут читающая: агент собирает отчёты, поднимает трек по спорной поездке, показывает водителей с растущими отменами и тех, у кого перед выплатой заблокирован баланс. Карточки водителей и машин он не правит без вашего явного запроса: в парке за такой правкой стоит живой человек и его смена. Выводы агент подкрепляет цифрами из тех же разделов, откуда их взял.",
        "Лимиты у Fleet API жёсткие и разные по разделам: список заказов отдаётся в разы медленнее машин и транзакций, а выгрузка за длинный период упирается и в размер страницы, и в частоту запросов. Поэтому период агент режет на куски, идёт по страницам и заранее говорит, сколько это займёт, а не обрывает отчёт на середине. Треки и транзакции он поднимает точечно, по конкретным заказам, а не по всему парку сразу, и прямо сообщает, если раздел закрыт и данных нет."
      ],
      "requirements": [
        "Подключённый кабинет автопарка на fleet.yandex.ru",
        "Сотрудник с ролью «Директор» в парке",
        "Запас по времени: у Fleet API жёсткие лимиты выгрузок"
      ],
      "faq": [
        {
          "q": "Как подключить Yandex Fleet?",
          "a": "Тремя значениями из кабинета fleet.yandex.ru: секретный API-ключ, идентификатор клиента и идентификатор партнёра (park_id). Ключи создаются в разделе «Настройки» → «API» Диспетчерской, а редактировать его может только сотрудник с ролью «Директор»."
        },
        {
          "q": "Что агент видит в парке?",
          "a": "Автомобили, профили водителей и курьеров, заявки, заказы и их GPS-треки, транзакции, заблокированный баланс, условия работы и часы на линии."
        },
        {
          "q": "Пишет ли агент в Fleet?",
          "a": "По умолчанию агент читает данные парка и собирает по ним отчёты. Изменения в карточках водителей и машин он не вносит без вашего явного запроса."
        },
        {
          "q": "Почему выгрузка идёт медленно?",
          "a": "У Fleet API жёсткие лимиты, и список заказов отдаётся заметно медленнее остальных разделов. Длинные периоды агент собирает частями и предупреждает, сколько это займёт."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Fleet API and an AI agent: who cancels the orders",
      "description": "Breaks down a fleet shift: four drivers gave 31 cancellations out of 486 orders, 64% of the fleet's total. Connects with the API key, client ID and park ID.",
      "headline": "Break down driver shifts and fleet orders right in chat",
      "scenarios": [
        {
          "title": "Shift breakdown",
          "desc": "The agent collects the orders from a shift and shows which drivers have the most cancellations and unfinished trips, and how that changes day to day."
        },
        {
          "title": "Transactions and payouts",
          "desc": "The agent reconciles driver and order transactions against the fleet's work rules and shows whose balance is blocked ahead of a payout."
        },
        {
          "title": "Who is really on the road",
          "desc": "The agent goes through driver profiles and car records and shows who actually takes shifts and who is merely listed in the fleet."
        },
        {
          "title": "Tracks for disputed orders",
          "desc": "The agent pulls the GPS track of a specific order and the contractor's hours on the road when you need to settle a complaint or a disputed trip."
        },
        {
          "title": "Onboarding applications",
          "desc": "The agent goes through driver and courier applications, shows which ones have sat without movement and names those who signed up but never took a first order."
        },
        {
          "title": "Hours on the road this week",
          "desc": "The agent adds up contractor hours on the road day by day and shows who fell short of the fleet norm and who closes the week clearly overworked."
        }
      ],
      "how_it_works": [
        "The agent calls the Yandex Taxi Fleet API and reads the whole fleet: cars and the profiles of drivers and couriers, onboarding applications, orders together with their GPS tracks, transactions and blocked balance, the fleet work rules and the contractors' hours on the road. Out of these pieces it assembles a shift breakdown, a reconciliation of transactions against the work rules and a picture of who really takes shifts and who is merely listed.",
        "Every request here is bound to a specific fleet: the partner id goes into the header, into the parameters and into the request body, so the agent always works within the boundaries of one fleet and never mixes data from different ones. An order in Fleet is not a single row but a bundle with a driver, a car, a track and transactions, and the order status on its own does not answer whether the passenger was delivered: for that the agent goes to the track and to the transaction history.",
        "By its nature the work here is read-only: the agent builds reports, pulls the track for a disputed trip, shows the drivers with growing cancellations and the ones whose balance is blocked ahead of a payout. It does not edit driver or car records without your explicit request: behind such an edit in a fleet stands a living person and their shift. The agent backs its conclusions with figures from the same sections it took them from.",
        "The Fleet API limits are hard and differ by section: the order list is returned many times slower than cars and transactions, and an export over a long period runs into both the page size and the request rate. So the agent cuts the period into chunks, walks the pages and says upfront how long it will take instead of breaking the report off halfway. Tracks and transactions it pulls pointwise, for specific orders rather than for the whole fleet at once, and it states plainly when a section is closed and there is no data."
      ],
      "requirements": [
        "An active fleet account on fleet.yandex.ru",
        "An employee with the Director role in the fleet",
        "Patience for exports: the Fleet API has hard rate limits"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Fleet?",
          "a": "With three values from the fleet.yandex.ru account: the secret API key, the client id and the partner id (park_id). Keys are created in the Dispatcher under Settings, API, and only a staff member with the Director role can edit them."
        },
        {
          "q": "What does the agent see in the fleet?",
          "a": "Cars, driver and courier profiles, applications, orders and their GPS tracks, transactions, blocked balance, work rules and hours on the road."
        },
        {
          "q": "Does the agent write to Fleet?",
          "a": "By default the agent reads fleet data and builds reports on it. It makes no changes to driver or car records without your explicit request."
        },
        {
          "q": "Why is the export so slow?",
          "a": "The Fleet API has hard limits, and the order list is returned noticeably slower than other sections. The agent collects long periods in chunks and warns you upfront how long it will take."
        }
      ]
    }
  },
  {
    "key": "yandex_mail",
    "name": "Яндекс Почта",
    "name_en": "Yandex Mail",
    "description": "Электронная почта Яндекс 360 для бизнеса",
    "category": "mail",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-mail",
    "description_en": "Yandex 360 for Business email",
    "guide": {
      "url": "https://mail.yandex.ru/#setup/client",
      "steps": [
        {
          "title": "Войдите в тот ящик, который подключаете",
          "desc": "Авторизуйтесь на mail.yandex.ru под тем самым адресом: доступ получит ящик, подтвердивший код. В Яндекс 360 логин вида user@company.ru.",
          "title_en": "Sign in to the mailbox you are connecting",
          "desc_en": "Log in at mail.yandex.ru under that address: access goes to whichever mailbox confirms the code. In Yandex 360 the login is user@company.ru."
        },
        {
          "title": "Включите IMAP в «Почтовых программах»",
          "desc": "Настройки почты → «Почтовые программы» → включите «С сервера imap.yandex.ru по протоколу IMAP».",
          "title_en": "Enable IMAP in «Почтовые программы»",
          "desc_en": "Mail settings → «Почтовые программы» (Mail clients) → turn on «С сервера imap.yandex.ru по протоколу IMAP»."
        },
        {
          "title": "В том же разделе включите OAuth-токены",
          "desc": "В том же разделе проверьте, что активен пункт «Пароли приложений и OAuth-токены», и сохраните настройки.",
          "title_en": "In the same section allow OAuth tokens",
          "desc_en": "In the same section make sure «Пароли приложений и OAuth-токены» (App passwords and OAuth tokens) is active and save."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Почта и ИИ-агент: письма, которые ждут ответа",
      "description": "ИИ-агент для Яндекс Почты (Яндекс 360): пять писем ждут ответа, два из них третий день. Ответ уходит с вашего адреса только после того, как вы одобрили текст.",
      "headline": "Разбирайте почту Яндекс 360 и отвечайте прямо из чата",
      "scenarios": [
        {
          "title": "Поиск писем по теме",
          "desc": "Агент найдёт письма по теме, отправителю или папке и вернёт выжимку по переписке, не заставляя листать ящик руками."
        },
        {
          "title": "Ответ от вашего имени",
          "desc": "Агент подготовит ответ или новое письмо с вложениями и отправит его с вашего адреса после того, как вы одобрите текст."
        },
        {
          "title": "Разбор входящих",
          "desc": "Агент разложит письма по папкам, отметит разобранные прочитанными и покажет, какие обращения остались без ответа."
        },
        {
          "title": "Сводка по почте за сутки",
          "desc": "Агент по расписанию пришлёт сводку: сколько писем пришло за сутки, что среди них важное и что ждёт ответа второй день."
        },
        {
          "title": "Вложения из писем",
          "desc": "Агент найдёт письма со счетами и актами, разберёт вложения и сведёт их в один список (суммы, даты и отправителя), не выкачивая ящик целиком."
        },
        {
          "title": "Пересылка нужному человеку",
          "desc": "Агент найдёт письмо по теме и отправителю, подготовит пересылку коллеге с короткой сопроводительной запиской и покажет текст до отправки."
        }
      ],
      "how_it_works": [
        "С почтой агент работает не через веб-интерфейс, а по тем же протоколам, что и обычный почтовый клиент: читает ящик по IMAP, отправляет по SMTP. Он проходит по папкам, находит письма по теме, отправителю, дате или папке, разбирает текст и вложения и возвращает выжимку по переписке вместо списка заголовков. На этом же строятся разбор входящих и суточная сводка: что пришло, что важное и что ждёт ответа второй день.",
        "IMAP хранит письма папками, а не диалогами, поэтому переписку агент собирает сам (по теме и служебным заголовкам цепочки), а не получает готовым тредом. Отбор идёт на стороне сервера: агент просит ящик выбрать письма по отправителю, дате или папке и выкачивает целиком только выбранное, поэтому за десятком нужных писем не читает тысячу. Вложения он разбирает у тех же писем, а тяжёлые файлы называет именем и размером, не пересказывая содержимое.",
        "Письма агент готовит, но не отправляет молча: текст ответа, нового письма или пересылки вы одобряете до отправки, потому что отозвать ушедшее по SMTP письмо нельзя. Остальные действия те же, что у почтового клиента: пометить прочитанным, перенести между папками, удалить. Разбор входящих агент делает пачками и называет, что именно и куда переложил, а на удаление писем спрашивает отдельно.",
        "Работа идёт правами mail:imap_full и mail:smtp, а токен продлевается сам, так что подтверждать доступ заново не приходится; если его отозвали в Яндекс ID, агент сразу скажет, что подключение нужно восстановить, вместо молчаливых повторов. Если почтовый сервер блокирует отправку как спам, агент сообщает об отказе и ставит задачу рассылки на паузу до устранения причины. Число одновременных IMAP-сессий у ящика ограничено, поэтому действия подряд идут в одном соединении с ящиком, а длинные выборки агент читает страницами. Если писем по запросу нет, он так и говорит."
      ],
      "requirements": [
        "Аккаунт Яндекс ID того ящика, чью почту подключаете.",
        "Агент читает все папки ящика и отправляет письма от вашего имени.",
        "Другие ящики организации агенту не видны."
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Почту?",
          "a": "По коду подтверждения Яндекс ID: нажмите «Подключить», введите код на странице Яндекса и подтвердите доступ под тем адресом, чью почту подключаете. Заранее в настройках почты, в разделе «Почтовые программы», включите доступ по IMAP и пункт «Пароли приложений и OAuth-токены»."
        },
        {
          "q": "Что агент видит в почте?",
          "a": "Папки и письма ящика по IMAP: тему, отправителя, дату, текст и вложения, только того адреса, под которым подтверждён код доступа."
        },
        {
          "q": "Отправляет ли агент письма сам?",
          "a": "Агент готовит письмо и отправляет его по SMTP с вашего адреса, а также отвечает на письма и пересылает их. Отправка идёт после того, как вы одобрили текст."
        },
        {
          "q": "Что ещё агент делает с письмами?",
          "a": "Помечает прочитанными, переносит между папками и удаляет: те же действия, что доступны обычному почтовому клиенту по IMAP."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Mail and AI agent: emails still waiting for a reply",
      "description": "Five emails await a reply, two of them for three days: that is the digest of your Yandex 360 inbox. Replies go out from your address only after you approve the text.",
      "headline": "Clear your Yandex 360 inbox and reply from chat",
      "scenarios": [
        {
          "title": "Finding emails by subject",
          "desc": "The agent finds messages by subject, sender or folder and returns a summary of the thread, so you do not have to scroll the mailbox by hand."
        },
        {
          "title": "A reply in your name",
          "desc": "The agent drafts a reply or a new message with attachments and sends it from your address once you approve the text."
        },
        {
          "title": "Clearing the inbox",
          "desc": "The agent files messages into folders, marks the handled ones as read and shows which requests are still waiting for an answer."
        },
        {
          "title": "Daily mail digest",
          "desc": "On a schedule the agent sends a digest: how many emails arrived over the day, what matters among them and what has been waiting for a reply a second day."
        },
        {
          "title": "Attachments out of your mail",
          "desc": "The agent finds messages with invoices and acts, parses the attachments and pulls them into one list (amounts, dates and sender) without downloading the whole mailbox."
        },
        {
          "title": "Forwarding to the right person",
          "desc": "The agent finds a message by subject and sender, prepares a forward to a colleague with a short covering note and shows you the text before it goes out."
        }
      ],
      "how_it_works": [
        "The agent works with mail not through the web interface but over the same protocols an ordinary mail client uses: it reads the mailbox over IMAP and sends over SMTP. It walks the folders, finds messages by subject, sender, date or folder, parses the body and attachments and returns a summary of the thread instead of a list of headers. Clearing the inbox and the daily digest are built on the same ground: what arrived, what matters and what has been waiting for a reply a second day.",
        "IMAP stores messages in folders rather than conversations, so the agent assembles a thread itself (from the subject and the threading headers) instead of receiving one ready-made. The selection happens on the server side: the agent asks the mailbox to pick messages by sender, date or folder and downloads only that selection in full, so it never reads a thousand messages to find ten. Attachments are parsed for those same messages, and heavy files are named by title and size rather than retold.",
        "The agent drafts messages but never sends them silently: you approve the text of a reply, a new message or a forward before it goes out, because a message already sent over SMTP cannot be recalled. The rest of the actions are those of a mail client: mark as read, move between folders, delete. Inbox clearing is done in batches, and the agent states exactly what it filed where, while deleting messages is confirmed separately.",
        "The work runs on the mail:imap_full and mail:smtp permissions, and the token renews itself, so access never has to be confirmed again; revoke it in Yandex ID and the agent says straight away that the connection has to be restored instead of retrying in silence. If the mail server blocks sending as spam, the agent reports the rejection and pauses the mailing task until its cause is resolved. A mailbox allows only a limited number of simultaneous IMAP sessions, so consecutive actions share one connection to the mailbox and the agent reads long selections page by page. When a search turns up no messages, it says so."
      ],
      "requirements": [
        "A Yandex ID account for the mailbox you are connecting.",
        "The agent reads every folder and sends mail on your behalf.",
        "Other mailboxes in the organization stay invisible to it."
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Mail?",
          "a": "With a Yandex ID confirmation code: click Connect, enter the code on the Yandex page and confirm access under the address whose mail you are connecting. Beforehand, in mail settings under email clients, turn on IMAP access and the option for app passwords and OAuth tokens."
        },
        {
          "q": "What does the agent see in the mailbox?",
          "a": "Folders and messages over IMAP: subject, sender, date, body and attachments, only for the address whose access code was confirmed."
        },
        {
          "q": "Does the agent send emails itself?",
          "a": "The agent composes the message and sends it over SMTP from your address, and it can also reply and forward. Sending happens after you approve the text."
        },
        {
          "q": "What else does the agent do with email?",
          "a": "Marks messages as read, moves them between folders and deletes them: the same actions any ordinary mail client has over IMAP."
        }
      ]
    }
  },
  {
    "key": "yandex_market",
    "name": "Яндекс Маркет",
    "name_en": "Yandex Market",
    "description": "Кампании, заказы, товары, цены, остатки",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-market",
    "description_en": "Campaigns, orders, products, prices and stock",
    "search_terms": [
      "ям"
    ],
    "guide": {
      "url": "https://partner.market.yandex.ru",
      "steps": [
        {
          "title": "Выберите долгий аккаунт Яндекса",
          "desc": "Доступ выдаётся конкретному логину Яндекса, а не кабинету. Берите аккаунт, который останется у бизнеса надолго: смена пароля или 2FA обнуляет доступ.",
          "title_en": "Pick a long-lived Yandex account",
          "desc_en": "Access is issued to a specific Yandex login, not to the account. Use an account the business will keep: a password change, a 2FA change or recovery revokes it."
        },
        {
          "title": "Пригласите логин на partner.market.yandex.ru",
          "desc": "Владелец приглашает логин на partner.market.yandex.ru и назначает роль по каждому магазину. Агент увидит только кампании, к которым есть доступ.",
          "title_en": "Invite the login at partner.market.yandex.ru",
          "desc_en": "The owner invites the login into the partner account at partner.market.yandex.ru and sets a role per shop. The agent sees only campaigns it can reach."
        },
        {
          "title": "Проверьте, что роль открывает «API и модули»",
          "desc": "Раздел доступен ролям «Администратор кабинета», «Менеджер кабинета», «Администратор магазина», «Разработчик» и «Оператор». «Контент-менеджер» его не видит.",
          "title_en": "Check the role opens «API и модули»",
          "desc_en": "The section is open to the account admin, manager, shop admin, developer and operator roles. A «Контент-менеджер» (content manager) cannot see it."
        },
        {
          "title": "Сверьте список магазинов до подключения",
          "desc": "Войдите этим логином и откройте «Настройки» → «API и модули». Если раздел открывается и в кабинете видны все нужные магазины, подключение привяжет ровно их.",
          "title_en": "Verify the shop list before connecting",
          "desc_en": "Sign in with that login and open «Настройки» → «API и модули». If the section opens and every shop you need is visible, the connection binds exactly those."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Маркет и ИИ-агент: невыкупы и удержания",
      "description": "Разберёт невыкупы на Яндекс Маркете и потери на обратной логистике, посчитает, сколько Маркет удержал за услуги, и поднимет буст по SKU. Вход через OAuth Яндекса.",
      "headline": "Разбирайте продажи, цены и буст продаж Маркета прямо в чате",
      "scenarios": [
        {
          "title": "Сводка продаж по кампаниям Маркета",
          "desc": "Агент соберёт заказы и выручку по всем кампаниям и моделям размещения (FBY/FBS/DBS) и покажет динамику по неделям."
        },
        {
          "title": "Контроль цен и остатков",
          "desc": "Агент сверит цены и остатки на Маркете с учётной системой, найдёт расхождения и карточки, которые скрыты из продажи."
        },
        {
          "title": "Разбор невыкупов и возвратов",
          "desc": "Агент проанализирует невыкупленные заказы и возвраты за период, сгруппирует по причинам и посчитает потери на логистике."
        },
        {
          "title": "Ставки буста продаж",
          "desc": "Агент покажет текущие ставки по SKU, подберёт рекомендации под целевую долю показов и применит их только после вашего подтверждения, в копейках, без ошибки в сто раз."
        },
        {
          "title": "Отзывы без ответа",
          "desc": "Агент соберёт свежие отзывы, ответит по шаблону на типовые вопросы и благодарности, а негатив вынесет вам: жалобы в автоответ он не отдаёт."
        },
        {
          "title": "Тревоги из кабинета",
          "desc": "Агент напишет в чат сразу, как Маркет пришлёт новый заказ, запрос отмены, возврат, отзыв или вопрос о товаре, без опроса по расписанию."
        }
      ],
      "how_it_works": [
        "Агент работает с кабинетом Маркета по OAuth-токену Яндекса и видит обе плоскости сразу (уровень кабинета и уровень отдельного магазина): заказы, остатки, цены, буст продаж, отзывы и финансовые отчёты. Первую ловушку Маркета он обходит сам: часть методов Partner API ждёт идентификатор бизнеса, часть идентификатор кампании, и перепутанный уровень даёт «не найдено» на живых данных. Вторая ловушка кроется в форматах дат: разные методы ждут разные, и агент подставляет нужный на каждом.",
        "Заказы агент забирает как по одному магазину, так и по всем магазинам кабинета одной лентой, без ручного перебора кампаний. Воронку «показы → корзина → заказ → доставлено» и процент выкупа по SKU он получает одним асинхронным отчётом «Аналитика продаж», а не сотнями запросов по каждой кампании: там, где наивная автоматизация взрывается на десятках магазинов, у агента один отчёт. Генерация отчётов у Маркета жёстко лимитирована, поэтому агент планирует запуски и дожидается готовности, а не долбит эндпоинт.",
        "Финансы агент берёт из официальных отчётов, а не из пересчёта заказов: помесячный оборот и все услуги Маркета из united-orders, взаиморасчёты по неделям из united-netting. Excel-выгрузки Маркета со «Сводками» и русскими шапками он разбирает по содержимому листов, а не по их порядку, поэтому очередной сдвиг листов в отчёте не превращается в перепутанные цифры. Сами отчёты Маркет отдаёт асинхронно: агент ставит задачу, дожидается готового файла и разбирает его сам, без ручной выгрузки из кабинета.",
        "Буст продаж закрывает полный цикл: текущие ставки по SKU, рекомендации под целевую долю показов, применение. Ставки Маркет принимает в копейках, и агент не ошибётся в сто раз. Массовые операции (цены, остатки, ставки, ответы на отзывы) идут чанками с учётом особенности Маркета: ошибка в одном элементе откатывает весь пакет, поэтому агент проверяет результат каждого чанка и повторяет именно проблемные. На отзывы он умеет отвечать массово по шаблону-генератору, но негатив в автоответ не отдаёт: жалобы требуют человека.",
        "Часть событий приходит без опроса: агент слушает уведомления Маркета о новых заказах, смене их статуса, отменах и возвратах, об отзывах и вопросах о товаре и о сообщениях покупателей в чате, а покупателю в чате может ответить сам, если так настроена задача. Права ключа он диагностирует честно: «данных нет» от Маркета часто означает нехватку прав доступа, а не пустоту, и тогда агент попросит переподключить интеграцию с нужными правами, вместо того чтобы отрапортовать ноль продаж. Любое изменение (цены, ставки, ответы) сначала показывается планом и применяется только после вашего подтверждения."
      ],
      "requirements": [
        "Аккаунт Яндекса с доступом к кабинету партнёра Маркета",
        "Хотя бы одна кампания в кабинете: FBY, FBS или DBS",
        "Роль выше «Контент-менеджера»: ему раздел API недоступен"
      ],
      "faq": [
        {
          "q": "Как подключается Яндекс Маркет?",
          "a": "Через OAuth-авторизацию Яндекса: вы входите под аккаунтом, у которого есть доступ к кабинету партнёра, и API-ключи копировать не нужно. Есть и вариант подключения по статическому API-ключу из кабинета."
        },
        {
          "q": "Что агент видит в кабинете Маркета?",
          "a": "Кампании, заказы, товары, цены и остатки: те разделы Partner API, к которым у вашего аккаунта есть доступ. Права определяются ролью аккаунта в кабинете."
        },
        {
          "q": "Можно ли работать с несколькими кампаниями сразу?",
          "a": "Да. Агент видит все кампании подключённого кабинета и может сводить их в один отчёт, например сравнить FBY и FBS по марже."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Market AI agent: non-pickups and marketplace fees",
      "description": "Breaks down Yandex Market non-pickups and reverse logistics losses, totals what Market withheld for services and sets boost bids per SKU. Signs in via Yandex OAuth.",
      "headline": "Work Market sales, prices and boost bids right in chat",
      "scenarios": [
        {
          "title": "Sales summary across Market campaigns",
          "desc": "The agent collects orders and revenue across every campaign and fulfillment model (FBY/FBS/DBS) and shows the trend week by week."
        },
        {
          "title": "Price and stock control",
          "desc": "The agent reconciles Market prices and stock against your accounting system and finds the discrepancies and the listings hidden from sale."
        },
        {
          "title": "Unredeemed orders and returns",
          "desc": "The agent analyzes unredeemed orders and returns for the period, groups them by reason and counts what the logistics cost you."
        },
        {
          "title": "Sales boost bids",
          "desc": "The agent shows the current bids per SKU, works out recommendations for a target share of impressions and applies them only after your confirmation, in kopecks, never off by a hundred."
        },
        {
          "title": "Reviews with no reply",
          "desc": "The agent collects fresh reviews, answers routine questions and thank-yous from a template and hands the negative ones to you: complaints never go into an auto-reply."
        },
        {
          "title": "Alerts from the cabinet",
          "desc": "The agent posts to chat the moment Market sends a new order, a cancellation request, a return, a review or a product question, with no polling on a schedule."
        }
      ],
      "how_it_works": [
        "The agent works with the Market cabinet over a Yandex OAuth token and sees both planes at once (the cabinet level and the individual shop level): orders, stock, prices, sales boost, reviews and financial reports. It handles Market's first trap itself: some Partner API methods expect the business identifier, others the campaign identifier, and the wrong level returns \"not found\" on live data. The second trap is date formats: different methods expect different ones, and the agent supplies the right one for each.",
        "Orders come either for a single shop or for every shop in the cabinet as one feed, with no manual walk over campaigns. The \"impressions → cart → order → delivered\" funnel and the buyout rate per SKU come from a single asynchronous Sales Analytics report instead of hundreds of per-campaign calls: where naive automation explodes on dozens of shops, the agent has one report. Market rate-limits report generation hard, so the agent schedules the runs and waits for readiness instead of hammering the endpoint.",
        "Financials come from the official reports rather than from re-adding orders: monthly turnover and every Market service from united-orders, weekly settlements from united-netting. Market's Excel exports with their summary sheets and Russian headers are parsed by sheet content, not by sheet order, so the next reshuffle of sheets in the export does not turn into scrambled numbers. Market hands those reports over asynchronously: the agent queues the job, waits for the finished file and parses it itself, with no manual export from the cabinet.",
        "Sales boost is the full cycle: current bids per SKU, recommendations for a target share of impressions, and applying them. Market takes bids in kopecks, so the agent will not be off by a factor of a hundred. Bulk operations (prices, stock, bids, review replies) run in chunks with Market's quirk in mind: one bad item rolls back the whole batch, so the agent checks the result of every chunk and retries exactly the failing ones. It can reply to reviews in bulk from a template generator, but never auto-replies to negatives: complaints need a human.",
        "Some events arrive without polling: the agent listens to Market notifications about new orders, their status changes, cancellations and returns, product reviews and questions, and buyer messages in chat, and can answer the buyer in that chat itself when the task is set up to. It diagnoses key permissions honestly: \"no data\" from Market often means missing access rights rather than an empty result, and in that case the agent asks you to reconnect the integration with the right permissions instead of reporting zero sales. Any change (prices, bids, replies) is shown as a plan first and applied only after your confirmation."
      ],
      "requirements": [
        "A Yandex account with access to the Market partner cabinet",
        "At least one campaign in the cabinet: FBY, FBS or DBS",
        "A role above content manager, which cannot open the API section"
      ],
      "faq": [
        {
          "q": "How does Yandex Market connect?",
          "a": "Through Yandex OAuth: you sign in with an account that has access to the partner cabinet, so there are no API keys to copy. There is also the option to connect with a static API key from the cabinet."
        },
        {
          "q": "What does the agent see in the Market cabinet?",
          "a": "Campaigns, orders, products, prices and stock: the Partner API sections your account has access to. Permissions follow your account's role in the cabinet."
        },
        {
          "q": "Can it work with several campaigns at once?",
          "a": "Yes. The agent sees every campaign in the connected cabinet and can roll them into a single report, comparing FBY and FBS by margin, for example."
        }
      ]
    }
  },
  {
    "key": "yandex_market_api_key",
    "name": "Яндекс Маркет (API-ключ)",
    "name_en": "Yandex Market (API key)",
    "description": "Подключение по API-ключу из кабинета партнёра, если вход через аккаунт Яндекса не подошёл",
    "category": "marketplaces",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "inside_primary",
    "has_own_page": false,
    "integration_slug": "yandex-market",
    "short_name": "Яндекс Маркет API",
    "short_name_en": "Yandex Market (API key)",
    "description_en": "Connect with an API key from the partner account when Yandex sign-in did not work",
    "variant_of": "yandex_market",
    "guide": {
      "url": "https://partner.market.yandex.ru",
      "steps": [
        {
          "title": "В «Настройках» откройте «API и модули»",
          "desc": "На partner.market.yandex.ru откройте «Настройки» → «API и модули» под ролью, которая управляет доступом к API.",
          "title_en": "In Settings open API and modules",
          "desc_en": "In partner.market.yandex.ru, open Settings → API and modules with a role that can manage API access."
        },
        {
          "title": "Выпустите статический ключ Partner API",
          "desc": "Выпустите статический ключ Partner API для тех бизнесов и магазинов, с которыми будет работать агент.",
          "title_en": "Issue a static Partner API key",
          "desc_en": "Issue a static Partner API key for the businesses and shops the agent should access."
        },
        {
          "title": "Вставьте ключ в форму подключения",
          "desc": "Вставьте ключ в форму и после подключения проверьте, что видны все нужные магазины.",
          "title_en": "Paste the key into the connection form",
          "desc_en": "Paste the key into the form and verify that all required shops appear after connection."
        }
      ]
    }
  },
  {
    "key": "yandex_metrica",
    "name": "Яндекс Метрика",
    "name_en": "Yandex Metrica",
    "description": "Веб-аналитика: счётчики, цели, отчёты и логи посещений",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-metrica",
    "description_en": "Web analytics: counters, goals, reports and visit logs",
    "guide": {
      "url": "https://metrika.yandex.ru",
      "steps": [
        {
          "title": "Выберите Яндекс ID для входа",
          "desc": "Агент увидит ровно те счётчики, к которым есть доступ у выбранного аккаунта. Выйдите в браузере из лишних аккаунтов Яндекса.",
          "title_en": "Pick the Yandex ID to sign in with",
          "desc_en": "The agent sees exactly the counters one Yandex account has access to. Sign out of the other accounts in the browser first."
        },
        {
          "title": "Проверьте свой логин во вкладке «Доступ»",
          "desc": "Откройте metrika.yandex.ru, выберите счётчик и зайдите в «Настройки» → вкладка «Доступ». Ваш логин должен быть в списке или быть владельцем счётчика.",
          "title_en": "Check your login on the Access tab",
          "desc_en": "Open metrika.yandex.ru, pick the counter and go to Settings → the Access tab. Your login must be listed there or own the counter, otherwise it stays invisible."
        },
        {
          "title": "Попросите «Добавить пользователя» у владельца",
          "desc": "В «Настройки» → «Доступ» владелец нажимает «Добавить пользователя» и указывает ваш логин. Уровня «Только просмотр» достаточно.",
          "title_en": "Ask the owner to click Add user",
          "desc_en": "In Settings → Access the counter owner clicks Add user and enters your Yandex login. The View level is enough for reports on visits, traffic sources and goals."
        },
        {
          "title": "Для всех счётчиков: «Добавить представителя»",
          "desc": "Владелец чужого аккаунта открывает «Настройка аккаунта» → «Представители» → «Добавить представителя»: доступ даётся ко всем счётчикам.",
          "title_en": "For all counters: Add representative",
          "desc_en": "If there are many counters on someone else's account, its owner opens Account settings → Representatives → Add representative: access covers the whole account."
        }
      ]
    },
    "seo": {
      "title": "ИИ-агент для Яндекс Метрики: почему просели заявки",
      "description": "Сравнит закрытые недели и покажет, какой канал увёл заявки, сведёт визиты и конверсию в цель по источникам за месяц. Вход через аккаунт Яндекса, без токенов.",
      "headline": "Разбирайте падение трафика и конверсии прямо в чате",
      "scenarios": [
        {
          "title": "Разобрать падение трафика или конверсии",
          "desc": "Агент сравнит период с предыдущим, найдёт источники и страницы, где просели визиты и цели, и покажет, что именно сломалось."
        },
        {
          "title": "Отчёт по источникам и целям",
          "desc": "Агент сведёт трафик по каналам, посчитает конверсию в цели и подскажет, какие источники приводят покупателей, а какие сливают бюджет."
        },
        {
          "title": "Поиск аномалий посещаемости",
          "desc": "Агент отследит всплески и провалы по счётчику, свяжет их с источниками и устройствами и предупредит о резких изменениях."
        },
        {
          "title": "Сводка по метрикам без захода в кабинет",
          "desc": "Агент подтянет ключевые показатели счётчика (визиты, отказы, конверсии) и пришлёт короткую сводку прямо в чат."
        },
        {
          "title": "Путь клиента до заявки",
          "desc": "Агент поднимет логи посещений и покажет, через какие страницы шли визиты с достижением цели и на каком шаге остальные обрывали путь."
        },
        {
          "title": "Все сайты в одной таблице",
          "desc": "Агент пройдёт по всем доступным счётчикам, сведёт визиты, отказы и конверсию по каждому сайту в одну таблицу и покажет, где отдача просела."
        }
      ],
      "how_it_works": [
        "Агент начинает со списка счётчиков, доступных вашему аккаунту, и дальше работает через API Метрики: строит отчёты по визитам, источникам, страницам и устройствам, считает достижения целей и конверсию, а когда агрегатов не хватает, спускается к логам посещений за подробностями отдельного визита. Период он всегда сравнивает с предыдущим, чтобы просадка была видна как изменение, а не как одно число.",
        "Две особенности Метрики агент держит в голове. Первая: данные дозревают (свежий хвост суток обработан не полностью), поэтому «вчера против позавчера» легко показывает ложный провал, и для сравнений агент берёт закрытые периоды. Вторая: конверсия существует ровно настолько, насколько в счётчике заведены цели. Если цель не настроена, в отчёте её не будет, и агент скажет, что цели нет, а не что конверсия нулевая.",
        "На запись агент в Метрику не ходит: он не создаёт и не переименовывает цели, не трогает фильтры, сегменты и настройки счётчика. Вся работа сводится к чтению и разбору: сведение трафика по каналам, поиск источников и страниц, где просели визиты и цели, всплески и провалы посещаемости в связке с источниками и устройствами, короткая сводка ключевых показателей вместо захода в кабинет.",
        "Отчёты агент строит через API отчётов: метрики и измерения он подбирает под вопрос, а не тянет весь набор, и длинный период разбивает на окна. Когда агрегатов не хватает, он уходит в логи посещений, а те не отвечают сразу, а готовят выгрузку, поэтому детализация по визитам приходит позже сводки. Частоту запросов агент выдерживает сам, а если данных за период нет или счётчик недоступен, он скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Аккаунт Яндекса с правами на нужные счётчики",
        "Достаточно доступа «Только просмотр»: Метрика читается",
        "Подключение в один клик: токены и ключи копировать не нужно"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Метрику?",
          "a": "Входом в аккаунт Яндекса в один клик: вы подтверждаете доступ, и агент видит счётчики, к которым у вас есть права. Копировать токены и ключи не нужно."
        },
        {
          "q": "Какие данные видит агент?",
          "a": "Счётчики, цели, отчёты по визитам, источникам и устройствам и логи посещений по тем счётчикам, к которым у вашего аккаунта есть доступ."
        },
        {
          "q": "Может ли агент что-то изменить в Метрике?",
          "a": "Нет. Метрика используется на чтение: агент только собирает и анализирует отчёты, ничего не меняя в настройках счётчиков."
        },
        {
          "q": "Насколько свежие данные получает агент?",
          "a": "Агент запрашивает отчёты через Reporting API по вашему запросу, поэтому данные соответствуют актуальному состоянию счётчика с учётом обычной задержки обработки Метрики."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Metrica AI agent: why leads dropped last week",
      "description": "Compares closed weeks to show which channel cost you leads, and breaks down visits and goal conversion by source for the month. Sign in with Yandex, no tokens.",
      "headline": "Dig into traffic and conversion drops right in the chat",
      "scenarios": [
        {
          "title": "Digging into a traffic or conversion drop",
          "desc": "The agent compares the period with the previous one, finds the sources and pages where visits and goals slipped and shows what actually broke."
        },
        {
          "title": "Report on sources and goals",
          "desc": "The agent rolls up traffic by channel, calculates goal conversion and points out which sources bring buyers and which drain the budget."
        },
        {
          "title": "Spotting traffic anomalies",
          "desc": "The agent tracks spikes and dips on the counter, ties them to sources and devices and warns you about sharp changes."
        },
        {
          "title": "Metrics digest without opening the cabinet",
          "desc": "The agent pulls the counter's key numbers (visits, bounces, conversions) and sends a short digest straight to chat."
        },
        {
          "title": "The path to a conversion",
          "desc": "The agent pulls the visit logs and shows which pages the sessions that reached a goal walked through and at which step the rest broke off."
        },
        {
          "title": "Every site in one table",
          "desc": "The agent goes through all the counters it can reach, rolls visits, bounces and conversion for each site into one table and shows where the returns have slipped."
        }
      ],
      "how_it_works": [
        "The agent starts from the list of counters your account can reach and then works through the Metrica API: it builds reports on visits, sources, pages and devices, counts goal completions and conversion, and when the aggregates are not enough it drops down to visit logs for the details of an individual session. It always compares a period against the previous one, so a drop shows up as a change rather than as a single number.",
        "The agent keeps two Metrica specifics in mind. First, data ripens: the freshest tail of the day is not fully processed, so «yesterday versus the day before» easily shows a false dip, and for comparisons the agent takes closed periods. Second, conversion exists exactly as far as goals are configured in the counter. If a goal is not set up it will not appear in the report, and the agent says the goal is missing rather than that conversion is zero.",
        "The agent never writes to Metrica: it does not create or rename goals and does not touch filters, segments or counter settings. All the work is reading and analysis: rolling up traffic by channel, finding the sources and pages where visits and goals slipped, spikes and dips in traffic tied to sources and devices, and a short digest of the key numbers instead of opening the cabinet.",
        "The agent builds reports through the reporting API: it picks the metrics and dimensions the question needs rather than pulling the whole set, and splits a long period into windows. When the aggregates are not enough it goes to the visit logs, which do not answer at once but prepare an export, so per-visit detail arrives after the summary. The agent holds the request rate itself, and if there is no data for the period or the counter is unavailable it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A Yandex account with rights to the counters you need",
        "View-only access is enough: Metrica is used read-only",
        "One-click sign-in: no tokens or keys to copy"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Metrica?",
          "a": "By signing in to your Yandex account in one click: you confirm access and the agent sees the counters you have rights to. No tokens or keys to copy."
        },
        {
          "q": "What data does the agent see?",
          "a": "Counters, goals, reports on visits, sources and devices, and visit logs, for the counters your account has access to."
        },
        {
          "q": "Can the agent change anything in Metrica?",
          "a": "No. Metrica is used read-only: the agent only collects and analyzes reports, changing nothing in the counter settings."
        },
        {
          "q": "How fresh is the data the agent gets?",
          "a": "The agent requests reports through the Reporting API on demand, so the data matches the counter's current state, allowing for Metrica's usual processing delay."
        }
      ]
    }
  },
  {
    "key": "yandex_tracker",
    "name": "Яндекс Трекер",
    "name_en": "Yandex Tracker",
    "description": "Управление задачами и проектами: создание, отслеживание, спринты и очереди",
    "category": "pm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-tracker",
    "description_en": "Tasks and projects: create and track issues, sprints and queues",
    "guide": {
      "url": "https://tracker.yandex.ru",
      "steps": [
        {
          "title": "Войдите в Трекер под рабочим Яндекс ID",
          "desc": "Откройте tracker.yandex.ru тем аккаунтом, чьи задачи нужны: запросы к API идут от его имени. Личный Яндекс ID вне организации очередей не увидит.",
          "title_en": "Sign in to Tracker with your work Yandex ID",
          "desc_en": "Open tracker.yandex.ru under the account whose issues you need: API calls run on its behalf. A personal Yandex ID outside the organization sees no queues."
        },
        {
          "title": "Проверьте, что доступ не «Только чтение»",
          "desc": "Без активной подписки на Трекер роль по умолчанию «Только чтение»: задачи видно, но не изменить. Для записи нужен «Полный доступ» или «Администратор».",
          "title_en": "Make sure the account is not read-only",
          "desc_en": "Without an active Tracker subscription the default role is read-only: issues are visible but not editable. Writing needs full access or administrator."
        },
        {
          "title": "В «Правах доступа» очереди выдайте просмотр",
          "desc": "«Очереди» → очередь → значок настроек → «Права доступа»: выдайте просмотр задач, для правок редактирование. Настраивает владелец очереди.",
          "title_en": "In the queue's Access grant issue viewing",
          "desc_en": "In Queues open a queue → settings icon → Access: grant issue viewing, plus editing for changes. Only the queue owner or an admin can."
        },
        {
          "title": "Сверьте организацию в «Администрировании»",
          "desc": "Трекер работает в контексте организации: «Администрирование» → «Организации» показывает, в какой состоит аккаунт. Нужные очереди должны лежать в ней же.",
          "title_en": "Check the org in Administration",
          "desc_en": "Tracker always works in the context of an organization: Administration → Organizations shows which one the account belongs to. The queues must live there too."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Трекер API: просрочка по очередям через ИИ-агента",
      "description": "Интеграция с Яндекс Трекером через API: агент считает просрочку по очередям (11 из 63 задач в SUPPORT), сводит worklog и заводит задачи из переписки.",
      "headline": "Разбирайте очереди Яндекс Трекера и заводите задачи из чата",
      "scenarios": [
        {
          "title": "Разбор очередей",
          "desc": "Агент соберёт задачи из ваших очередей и покажет, что просрочено, что осталось без исполнителя и на ком висит больше всего."
        },
        {
          "title": "Задача из переписки",
          "desc": "Агент заведёт задачу в нужной очереди с описанием, исполнителем, приоритетом и сроком прямо из обсуждения в чате."
        },
        {
          "title": "Сводка по спринту",
          "desc": "Агент пришлёт по расписанию итоги спринта: что закрыто, что переезжает дальше и где задачи стоят без движения."
        },
        {
          "title": "Статусы, комментарии и время",
          "desc": "Агент переведёт задачу по статусам, допишет комментарий, обновит чек-лист и спишет затраченное время в worklog."
        },
        {
          "title": "Кто кого блокирует",
          "desc": "Агент пройдёт по связям задач и покажет цепочки блокировок: какая задача держит остальные, у кого она в работе и сколько уже стоит без движения."
        },
        {
          "title": "Куда ушло время",
          "desc": "Агент соберёт записи worklog за период и покажет, сколько часов легло на каждый проект, очередь и человека, а где списаний не было вовсе."
        }
      ],
      "how_it_works": [
        "Агент ходит в API Трекера на api.tracker.yandex.net и первым делом спрашивает, кем он подключён: от этого зависит, какие очереди ему вообще видны. Дальше он забирает задачи, комментарии, чек-листы, связи, спринты, доски и проекты и считает по ним то, что в интерфейсе приходится собирать глазами: что просрочено, что осталось без исполнителя, на ком висит больше всего и где задачи стоят без движения.",
        "Трекер устроен вокруг очередей, и это не просто папки: у каждой свой набор полей, свои статусы и свой воркфлоу. Перевести задачу можно только по разрешённому в очереди переходу (произвольный статус API не примет), поэтому агент сверяется с доступными переходами до правки, а не после отказа. Вторая граница проходит по организации: аккаунт может состоять в нескольких, и очередь из соседней организации для подключения просто не существует.",
        "На запись агент заводит задачу в нужной очереди с описанием, исполнителем, приоритетом и сроком, двигает её по статусам, дописывает комментарии, обновляет чек-листы и списывает время в worklog. Комментарий и смена статуса видны всей команде и уходят в уведомления, поэтому массовые изменения (перевод пачки задач, переназначение исполнителей) агент показывает списком и выполняет после вашего подтверждения.",
        "Доступ подтверждается кодом на странице Яндекс ID, запросы идут от имени рабочего аккаунта и в пределах его прав. Запрашиваются tracker:read и tracker:write, но последнее слово за ролью в организации: скоуп токена прав не добавляет, он лишь не даёт выйти за уже имеющиеся. Задачи агент забирает поисковым запросом на стороне Трекера и постранично, а не перебором очередей, поэтому крупный проект отвечает так же быстро, как мелкий. Частоту запросов он держит сам, а если очередь не видна из-за прав или организации, называет причину прямо."
      ],
      "requirements": [
        "Аккаунт Яндекс ID состоит в организации с Трекером",
        "Роль «Полный доступ» или «Администратор» для создания задач",
        "Нужные очереди лежат в той же организации, что и аккаунт"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Трекер?",
          "a": "По коду подтверждения Яндекс ID: нажмите «Подключить», введите код на странице Яндекса и подтвердите доступ рабочим аккаунтом. Запросы к API идут от имени этого пользователя и в пределах его прав в организации."
        },
        {
          "q": "Что агент видит в Трекере?",
          "a": "Очереди, задачи, комментарии, чек-листы, связи, спринты, доски и проекты: ровно те, что открыты подключённому пользователю в «Правах доступа» очереди."
        },
        {
          "q": "Может ли агент создавать задачи?",
          "a": "Да, если у пользователя «Полный доступ» или «Администратор». Роль «Только чтение», которая стоит по умолчанию без подписки на Трекер, позволяет лишь смотреть задачи."
        },
        {
          "q": "Почему агент не видит нужную очередь?",
          "a": "Либо очередь не открыта пользователю в её «Правах доступа», либо она лежит в другой организации: состав организаций аккаунта видно в «Администрирование» → «Организации»."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Tracker API: overdue issues in every queue via AI",
      "description": "63 open issues in the SUPPORT queue, 11 overdue. The agent counts them through the Tracker API, totals the worklog by queue and files issues from a chat.",
      "headline": "Triage Yandex Tracker queues and file issues from chat",
      "scenarios": [
        {
          "title": "Going through the queues",
          "desc": "The agent collects issues from your queues and shows what is overdue, what has no assignee and who is carrying the most."
        },
        {
          "title": "An issue straight from the conversation",
          "desc": "The agent files an issue in the right queue with a description, assignee, priority and due date, right out of the chat discussion."
        },
        {
          "title": "Sprint summary",
          "desc": "On a schedule the agent sends the sprint results: what closed, what rolls over and where issues are stuck without movement."
        },
        {
          "title": "Statuses, comments and time",
          "desc": "The agent moves an issue through statuses, adds a comment, updates the checklist and logs spent time to the worklog."
        },
        {
          "title": "Who is blocking whom",
          "desc": "The agent walks the issue links and shows the blocking chains: which issue is holding the rest, who is working on it and how long it has stood still."
        },
        {
          "title": "Where the hours went",
          "desc": "The agent collects worklog entries for the period and shows how many hours landed on each project, queue and person, and where nothing was logged at all."
        }
      ],
      "how_it_works": [
        "The agent calls the Tracker API at api.tracker.yandex.net and its first question is who it is connected as: that determines which queues are visible to it at all. From there it pulls issues, comments, checklists, links, sprints, boards and projects and works out what the interface makes you piece together by eye: what is overdue, what has no assignee, who is carrying the most and where issues are stuck without movement.",
        "Tracker is built around queues, and those are not merely folders: each has its own set of fields, its own statuses and its own workflow. An issue can only be moved along a transition the queue allows (the API will not accept an arbitrary status), so the agent checks the available transitions before editing rather than after a rejection. The second boundary is the organization: an account may belong to several, and a queue in a neighbouring one simply does not exist for this connection.",
        "On the write side the agent files an issue in the right queue with a description, assignee, priority and due date, moves it through statuses, adds comments, updates checklists and logs time to the worklog. A comment and a status change are visible to the whole team and trigger notifications, so bulk changes (moving a batch of issues, reassigning owners) are shown as a list and carried out only after you confirm.",
        "Access is confirmed with a code on the Yandex ID page, and requests run on behalf of the work account and within its permissions. The tracker:read and tracker:write scopes are requested, but the role in the organization has the last word: a scope grants nothing extra, it only keeps the token inside rights the account already has. Issues are fetched through a search query on the Tracker side, page by page, rather than by walking queues, so a large project answers as fast as a small one. It holds the request rate itself, and when a queue is invisible because of permissions or the organization it names the reason directly."
      ],
      "requirements": [
        "A Yandex ID account that belongs to the organization with Tracker",
        "The Full access or Administrator role to create and edit issues",
        "The queues you need live in the same organization as the account"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Tracker?",
          "a": "With a Yandex ID confirmation code: click Connect, enter the code on the Yandex page and confirm access with your work account. API requests run on behalf of that user and within their permissions in the organization."
        },
        {
          "q": "What does the agent see in Tracker?",
          "a": "Queues, issues, comments, checklists, links, sprints, boards and projects: exactly the ones open to the connected user in the queue's access settings."
        },
        {
          "q": "Can the agent create issues?",
          "a": "Yes, if the user has Full access or Administrator. The Read-only role, which is the default without a Tracker subscription, allows viewing issues and nothing more."
        },
        {
          "q": "Why does the agent not see the queue I need?",
          "a": "Either the queue is not open to the user in its access settings, or it belongs to another organization: the organizations an account belongs to are listed under Administration, Organizations."
        }
      ]
    }
  },
  {
    "key": "yandex_webmaster",
    "name": "Яндекс Вебмастер",
    "name_en": "Yandex Webmaster",
    "description": "Поиск Яндекса для сайта: индексация, поисковые запросы, диагностика, sitemap, ссылки",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-webmaster",
    "description_en": "Yandex Search for your site: indexing, search queries, diagnostics, sitemaps and links",
    "guide": {
      "url": "https://webmaster.yandex.ru",
      "steps": [
        {
          "title": "Войдите под логином, где заведены сайты",
          "desc": "Откройте webmaster.yandex.ru под тем логином Яндекса, на котором заведены ваши сайты, и примите пользовательское соглашение.",
          "title_en": "Sign in with the login that owns the sites",
          "desc_en": "Open webmaster.yandex.ru under the Yandex login your sites belong to and accept the user agreement."
        },
        {
          "title": "Добавьте сайт в «Мои сайты»",
          "desc": "На странице «Мои сайты» нажмите «Добавить сайт» и укажите адрес с протоколом: example.com и www.example.com это разные сайты.",
          "title_en": "Add the site under «Мои сайты» (My sites)",
          "desc_en": "On «Мои сайты» (My sites) click «Добавить сайт» (Add site) and enter the address with protocol: example.com and www.example.com are separate sites."
        },
        {
          "title": "Нажмите «Подтвердить права» и выберите способ",
          "desc": "«Подтвердить права» → способ на выбор: файл yandex_*.html в корне сайта, метатег yandex-verification в <head> главной или TXT-запись в DNS.",
          "title_en": "Click Verify rights and pick a method",
          "desc_en": "Click «Подтвердить права» (Verify rights) and pick a method: a yandex_*.html file in the site root, a yandex-verification meta tag, or a DNS TXT record."
        },
        {
          "title": "Дождитесь статуса «Подтверждён»",
          "desc": "Проверка занимает до суток: пока сайт не подтверждён, данные по нему закрыты. Сайт заведён на коллеге? Попросите выдать вашему аккаунту полный доступ.",
          "title_en": "Wait for the verified status",
          "desc_en": "The check takes up to a day: until a site is verified its data is closed. If a colleague owns it, ask them to grant your account full access."
        }
      ]
    },
    "seo": {
      "title": "Подключение Яндекс Вебмастера к ИИ: выпавшие страницы",
      "description": "Найдёт страницы, выпавшие из поиска после переезда каталога, и отправит исправленные адреса на переобход в пределах квоты; покажет запросы с просевшими позициями.",
      "headline": "Ловите просадку позиций и запросов сайта прямо в чате",
      "scenarios": [
        {
          "title": "Просадка позиций и запросов",
          "desc": "Агент сравнит показы, клики и средние позиции по запросам за два периода и назовёт запросы и страницы, где сайт потерял выдачу."
        },
        {
          "title": "Индексация и выпавшие страницы",
          "desc": "Агент сверит страницы в поиске, найдёт исключённые URL и ответы сервера при обходе и покажет, что чинить в первую очередь."
        },
        {
          "title": "Диагностика и sitemap",
          "desc": "Агент соберёт проблемы сайта из диагностики, проверит состояние карт сайта и при необходимости добавит недостающий sitemap."
        },
        {
          "title": "Переобход обновлённых страниц",
          "desc": "Агент проверит остаток суточной квоты переобхода, отправит обновлённые URL роботу и проследит статус поставленных задач."
        },
        {
          "title": "Кто ссылается на сайт",
          "desc": "Агент соберёт внешние ссылки на сайт, покажет, какие домены появились и пропали за период, и положит рядом историю ИКС."
        },
        {
          "title": "Новый сайт под наблюдение",
          "desc": "Агент добавит хост в список сайтов, запустит проверку прав и напомнит, что версия с www считается отдельным сайтом со своей статистикой."
        }
      ],
      "how_it_works": [
        "Агент ходит в четвёртую версию API Вебмастера: сначала получает идентификатор пользователя, затем список ваших хостов, а дальше разбирает их по разделам: поисковые запросы с показами, кликами и средними позициями, обойдённые роботом URL с ответами сервера, страницы в поиске, внешние ссылки, карты сайта, проблемы диагностики и историю ИКС. Периоды он сравнивает попарно, чтобы просадка была видна по запросам и страницам.",
        "Главная ловушка Вебмастера кроется в понятии сайта. Это не домен, а хост: example.com, www.example.com и версия по https считаются разными сайтами, у каждого свои права и своя статистика. Агент работает с тем хостом, который подтверждён под вашим логином, и не смешивает их данные. Сводку он собирает по каждому хосту отдельно, поэтому сравнение домена с его www-версией требует двух обходов, а расхождение цифр между ними означает разные сайты, а не ошибку выгрузки.",
        "Пишет агент ограниченно и по делу: добавляет сайт в список, запускает проверку прав, добавляет недостающую карту сайта и отправляет обновлённые URL на переобход. Перед отправкой он смотрит остаток суточной квоты переобхода, чтобы не сжечь её на служебных страницах, а после следит за статусом поставленных задач. Содержимое сайта, его позиции и выдачу это не меняет: робот лишь приходит раньше.",
        "Подключение идёт входом в аккаунт Яндекса в его окне, с правами на сведения о сайтах и подтверждение прав; токены копировать не нужно, доступ продлевается сам. Аналитику запросов агент опрашивает заметно медленнее остальных разделов (эта ручка лимитирована жёстче), поэтому отчёт по большому сайту он собирает частями и говорит, за какой период уже посчитал. Длинные периоды он берёт окнами и складывает сам, а когда данных нет из-за прав или неподтверждённого хоста, говорит об этом прямо."
      ],
      "requirements": [
        "Доступ к корню сайта или к DNS-записям домена",
        "Полные права на сайт, если он заведён на другом логине"
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Вебмастер?",
          "a": "Входом в аккаунт Яндекса во всплывающем окне: копировать токены не нужно. Агент увидит только сайты, заведённые в «Мои сайты» этого логина и подтверждённые файлом, метатегом или TXT-записью в DNS."
        },
        {
          "q": "Что агент видит в Вебмастере?",
          "a": "Список сайтов и их карточки, сводку и историю ИКС, поисковые запросы с показами, кликами и позициями, обойдённые роботом URL, страницы в поиске, внешние ссылки, sitemap и проблемы диагностики."
        },
        {
          "q": "Пишет ли агент в Вебмастер?",
          "a": "Да, ограниченно: он может добавить сайт, запустить проверку прав, отправить URL на переобход и добавить карту сайта. Содержимое сайта и его позиции при этом не меняются."
        },
        {
          "q": "Почему по сайту нет данных?",
          "a": "Либо права ещё не подтверждены (проверка занимает до суток), либо сайт заведён на другом логине и вам не выдан полный доступ. Учтите, что example.com и www.example.com Вебмастер считает разными сайтами."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Webmaster AI agent: pages that fell out of search",
      "description": "Finds pages that dropped out of search after URLs changed and sends fixed ones for recrawl within the daily quota; shows queries where positions slipped.",
      "headline": "Catch drops in your site's positions and queries in chat",
      "scenarios": [
        {
          "title": "Slipping positions and queries",
          "desc": "The agent compares impressions, clicks and average positions by query across two periods and names the queries and pages where the site lost ground."
        },
        {
          "title": "Indexing and dropped pages",
          "desc": "The agent checks which pages are in search, finds excluded URLs and crawler response codes and shows what to fix first."
        },
        {
          "title": "Diagnostics and sitemaps",
          "desc": "The agent collects site problems from diagnostics, checks the state of your sitemaps and adds a missing one when needed."
        },
        {
          "title": "Recrawling updated pages",
          "desc": "The agent checks how much of the daily recrawl quota is left, submits updated URLs to the robot and follows the status of the queued tasks."
        },
        {
          "title": "Who links to the site",
          "desc": "The agent collects the external links to the site, shows which domains appeared and disappeared over the period and lays the SQI history beside them."
        },
        {
          "title": "A new site under watch",
          "desc": "The agent adds a host to the site list, starts the verification check and reminds you that the www version is a separate site with statistics of its own."
        }
      ],
      "how_it_works": [
        "The agent calls the fourth version of the Webmaster API: first it gets the user identifier, then the list of your hosts, and from there it goes through them section by section: search queries with impressions, clicks and average positions, URLs crawled by the robot with their server responses, pages in search, external links, sitemaps, diagnostics problems and SQI history. It compares periods in pairs so that a drop is visible by query and by page.",
        "The main Webmaster trap is what counts as a site. It is not a domain but a host: example.com, www.example.com and the https version are treated as different sites, each with its own rights and its own statistics. The agent works with the host verified under your login and never mixes their data. It assembles the picture host by host, so comparing a domain with its www version is two passes rather than one request, and a gap between their numbers means different sites, not a broken export.",
        "The agent writes within limits and to the point: it adds a site to the list, starts a verification check, adds a missing sitemap and submits updated URLs for recrawl. Before submitting it looks at how much of the daily recrawl quota is left, so it is not burned on service pages, and afterwards it follows the status of the queued tasks. None of this changes the site's content, its positions or the search results: the robot simply arrives sooner.",
        "The connection is a sign-in to a Yandex account in a Yandex pop-up window, carrying site information and verification rights; no tokens to copy, and access renews itself. The agent polls query analytics noticeably slower than the other sections (that endpoint is limited more tightly), so a report on a large site is assembled in parts and it tells you which period is already counted. Long ranges are taken in windows and stitched together, and when data is missing because of rights or an unverified host, it says so directly."
      ],
      "requirements": [
        "Access to the site root files or to the domain DNS records",
        "Full rights on the site if it is registered under another login"
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Webmaster?",
          "a": "By signing in to your Yandex account in a pop-up window; no tokens to copy. The agent only sees the sites listed under My sites for that login and verified with a file, a meta tag or a DNS TXT record."
        },
        {
          "q": "What does the agent see in Webmaster?",
          "a": "The list of sites and their profiles, the SQI summary and history, search queries with impressions, clicks and positions, the URLs crawled by the robot, pages in search, external links, sitemaps and diagnostics problems."
        },
        {
          "q": "Does the agent write to Webmaster?",
          "a": "Yes, within limits: it can add a site, start a verification check, submit URLs for recrawl and add a sitemap. Nothing about the site's content or its positions changes in the process."
        },
        {
          "q": "Why is there no data for my site?",
          "a": "Either the rights are not verified yet (the check takes up to a day) or the site is registered under a different login and you were not granted full access. Keep in mind that Webmaster treats example.com and www.example.com as separate sites."
        }
      ]
    }
  },
  {
    "key": "yandex_wiki",
    "name": "Яндекс Вики",
    "name_en": "Yandex Wiki",
    "description": "Корпоративная база знаний: страницы, разделы, динамические таблицы, вложения",
    "category": "files",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "device_code",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-wiki",
    "description_en": "Company knowledge base: pages, sections, dynamic tables and attachments",
    "guide": {
      "url": "https://wiki.yandex.ru",
      "steps": [
        {
          "title": "Войдите в Вики рабочим аккаунтом",
          "desc": "Вики живёт в организации Яндекс 360 для бизнеса. Откройте wiki.yandex.ru, при нескольких организациях нажмите «Продолжить».",
          "title_en": "Sign in to Wiki with a work account",
          "desc_en": "Wiki lives in a Yandex 360 for Business organization. Open wiki.yandex.ru; with several organizations pick one and continue."
        },
        {
          "title": "Возьмите обычный, а не сервисный аккаунт",
          "desc": "Сервисным аккаунтам API Вики закрыт, а федеративным нужен IAM-токен Яндекс Облака. Подойдёт обычный рабочий аккаунт.",
          "title_en": "Use a regular account, not a service one",
          "desc_en": "Service accounts are barred from the Wiki API, federated (SSO) ones need a Yandex Cloud IAM token. A regular account works."
        },
        {
          "title": "Нажмите «Всем сотрудникам» над страницей",
          "desc": "Права в API те же, что у аккаунта в Вики. Нажмите сверху кнопку доступа («Всем сотрудникам»), и откроется «Доступ к странице».",
          "title_en": "Click the access button at the top",
          "desc_en": "API rights mirror the account's Wiki rights. At the top click the access button («Всем сотрудникам») to open «Доступ к странице»."
        },
        {
          "title": "В «Доступе к странице» выберите роль себе",
          "desc": "В поле «Добавить сотрудника или группу» укажите себя и выберите роль: «Читатель» для чтения, «Редактор» для правок страниц.",
          "title_en": "In Page access pick a role for yourself",
          "desc_en": "In the «Добавить сотрудника или группу» field pick yourself and a role: «Читатель» reads pages, «Редактор» edits them."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Вики (Yandex Wiki) и ИИ: ответы по регламентам",
      "description": "Yandex Wiki (Яндекс Вики): на вопрос «как оформить командировку» агент отвечает из регламента со ссылкой на страницу, а через API находит устаревшие страницы.",
      "headline": "Отвечайте по регламентам из базы знаний Яндекс Вики",
      "scenarios": [
        {
          "title": "Ответ по регламенту",
          "desc": "Агент найдёт нужное в страницах базы знаний, соберёт ответ и укажет, на какой именно странице это записано."
        },
        {
          "title": "Страница с итогами встречи",
          "desc": "Агент заведёт страницу в нужном разделе, разложит итоги и решения по пунктам и приложит к ней файлы обсуждения."
        },
        {
          "title": "Динамическая таблица статусов",
          "desc": "Агент обновит строки динамической таблицы по расписанию и допишет короткую сводку в конец страницы."
        },
        {
          "title": "Ревизия раздела базы знаний",
          "desc": "Агент пройдёт по дереву страниц раздела, покажет, что давно не обновлялось, и соберёт список страниц-дублей."
        },
        {
          "title": "Обновить устаревшую инструкцию",
          "desc": "Агент перечитает текущую версию страницы, впишет изменения в нужные пункты и сохранит поверх свежего текста, и чужие правки при этом не затрутся."
        },
        {
          "title": "Что лежит во вложениях",
          "desc": "Агент пройдёт по вложениям страниц раздела, скажет, какие файлы к ним приложены, и вытащит нужные цифры со ссылкой на страницу-источник."
        }
      ],
      "how_it_works": [
        "Агент работает с базой знаний через API на api.wiki.yandex.net: обходит дерево разделов и страниц, читает тексты, вложения и динамические таблицы. На этом он отвечает по внутренним регламентам и всегда называет страницу-источник, а при ревизии раздела показывает, что давно не обновлялось, и собирает список дублей: на этот вопрос в интерфейсе Вики отвечают перелистыванием дерева вручную.",
        "Страница в Вики адресуется своим путём: агент запрашивает её по slug и явно перечисляет нужные поля, потому что API не отдаёт всё содержимое по умолчанию. Отсюда практическое следствие: если страницу перенесли в другой раздел, её адрес меняется, и агент ищет заново по дереву и заголовку, а не считает, что документа больше нет. Ссылку в ответе он даёт на ту страницу, откуда взял факт.",
        "На запись агент заводит страницу в нужном разделе, раскладывает по пунктам итоги и решения, прикладывает файлы обсуждения, обновляет строки динамической таблицы по расписанию и дописывает сводку в конец. Правка страницы означает замену содержимого, поэтому перед сохранением агент перечитывает текущую версию и складывает новое поверх неё, а не поверх устаревшей копии. Удаление подстраниц он подтверждает у вас отдельно.",
        "Видит агент ровно то, что видит подключённый аккаунт, и правит только те страницы, где у аккаунта есть право на запись. Дерево разделов он обходит порциями, а не выкачивает базу знаний целиком: сначала оглавление, потом содержимое нужных страниц и вложений, поэтому большой раздел не превращается в сотни запросов подряд. Частоту он выдерживает сам, а закрытую страницу называет закрытой, вместо того чтобы ответить будто её не существует."
      ],
      "requirements": [
        "Организация в Яндекс 360 для бизнеса с подключённой Вики.",
        "Понимание, что нужно агенту: только чтение или ещё правки страниц."
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Вики?",
          "a": "По коду подтверждения Яндекс ID: нажмите «Подключить», введите код на странице Яндекса и подтвердите доступ обычным рабочим аккаунтом организации. Сервисным аккаунтам API Вики закрыт, а федеративным нужен IAM-токен Яндекс Облака."
        },
        {
          "q": "Что агент видит в Вики?",
          "a": "Ровно те страницы, разделы, вложения и динамические таблицы, что видны подключённому аккаунту: чего он не видит в Вики, того не будет и у агента."
        },
        {
          "q": "Может ли агент править страницы?",
          "a": "Да, если аккаунту выдана роль «Редактор» и выше: «Редактор» правит страницу, «Редактор +» ещё создаёт подстраницы и удаляет их. Роль «Читатель» даёт только чтение."
        },
        {
          "q": "Как открыть агенту нужную страницу?",
          "a": "На странице сверху нажмите кнопку текущего доступа («Всем сотрудникам» или «Некоторым сотрудникам»), в окне «Доступ к странице» добавьте подключённый аккаунт и выберите роль."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Wiki API and AI agent: answers from your policies",
      "description": "Ask how a business trip is approved and get the answer from your policy page with a link to it. Through the Wiki API it also flags pages due for an update.",
      "headline": "Answer from your Yandex Wiki knowledge base",
      "scenarios": [
        {
          "title": "Answers straight from your internal policies",
          "desc": "The agent finds the right knowledge base pages, builds an answer and points to the exact page where it is written down."
        },
        {
          "title": "Meeting notes as a wiki page",
          "desc": "The agent creates a page in the right section, lays out outcomes and decisions point by point and attaches the files from the discussion."
        },
        {
          "title": "Dynamic status grid kept current",
          "desc": "The agent refreshes the rows of a dynamic grid on a schedule and adds a short summary at the end of the page."
        },
        {
          "title": "Knowledge base section audit",
          "desc": "The agent walks the page tree of a section, shows what has not been updated in a long time and collects a list of duplicate pages."
        },
        {
          "title": "Refresh an outdated policy page",
          "desc": "The agent re-reads the current version of the page, writes the changes into the right points and saves over the fresh text, so edits made by others are not wiped."
        },
        {
          "title": "What sits in the attachments",
          "desc": "The agent goes through the attachments of the pages in a section, says which files hang on what and pulls the figures you need with a link to the source page."
        }
      ],
      "how_it_works": [
        "The agent works with the knowledge base through the API at api.wiki.yandex.net: it walks the tree of sections and pages and reads texts, attachments and dynamic grids. On that basis it answers from your internal policies and always names the source page, and in a section audit it shows what has not been updated in a long time and collects a list of duplicates, a question the Wiki interface only answers by paging through the tree by hand.",
        "A Wiki page is addressed by its path: the agent requests it by slug and lists the fields it needs explicitly, because the API does not hand over the whole content by default. The practical consequence: if a page has been moved to another section its address changes, and the agent searches the tree and the title again instead of concluding that the document is gone. The link it puts in the answer points to the page the fact came from.",
        "On the write side the agent creates a page in the right section, lays out outcomes and decisions point by point, attaches the files from the discussion, refreshes the rows of a dynamic grid on a schedule and adds a summary at the end. Editing a page replaces its content, so before saving the agent re-reads the current version and lays the new text over that rather than over a stale copy. Deleting subpages is confirmed with you separately.",
        "The agent sees exactly what the connected account sees, and it edits only the pages that account may write to. It walks the section tree in portions instead of pulling the whole knowledge base down: the table of contents first, then the content of the pages and attachments it actually needs, so a large section does not turn into hundreds of requests in a row. It holds the request rate itself, and it calls a restricted page restricted instead of answering as though it did not exist."
      ],
      "requirements": [
        "A Yandex 360 for Business organization with Wiki enabled.",
        "A clear idea of what the agent needs: reading only, or edits too."
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Wiki?",
          "a": "With a Yandex ID confirmation code: click Connect, enter the code on the Yandex page and approve access with a regular company work account. The Wiki API is closed to service accounts, and federated accounts need a Yandex Cloud IAM token."
        },
        {
          "q": "What does the agent see in Wiki?",
          "a": "Exactly the pages, sections, attachments and dynamic grids visible to the connected account: whatever it cannot see in Wiki will not reach the agent either."
        },
        {
          "q": "Can the agent edit pages?",
          "a": "Yes, if the account has the Editor role or higher: Editor edits a page, Editor + also creates and deletes subpages. The Reader role gives read access only."
        },
        {
          "q": "How do I give the agent access to a specific page?",
          "a": "At the top of the page click the current access button (All employees or Some employees), then in the Page access dialog add the connected account and pick a role."
        }
      ]
    }
  },
  {
    "key": "yandex_wordstat",
    "name": "Яндекс Вордстат",
    "name_en": "Yandex Wordstat",
    "description": "Статистика поисковых запросов: топ фраз, динамика, распределение по регионам",
    "category": "analytics",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yandex-wordstat",
    "description_en": "Search query statistics: top phrases, trends and regional breakdown",
    "guide": {
      "url": "https://console.yandex.cloud",
      "steps": [
        {
          "title": "Заведите сервисный аккаунт в Yandex Cloud",
          "desc": "Консоль Yandex Cloud → «Identity and Access Management» → «Сервисные аккаунты» → «Создать сервисный аккаунт».",
          "title_en": "Create a service account in Yandex Cloud",
          "desc_en": "Yandex Cloud console → “Identity and Access Management” → “Service accounts” → “Create service account”. The cloud must be linked to a billing account."
        },
        {
          "title": "Дайте аккаунту роль search-api.webSearch.user",
          "desc": "На каталоге назначьте сервисному аккаунту роль search-api.webSearch.user. Устаревшую search-api.executor не используйте.",
          "title_en": "Grant the search-api.webSearch.user role",
          "desc_en": "On the folder, assign the service account the search-api.webSearch.user role. Do not use the deprecated search-api.executor."
        },
        {
          "title": "В карточке аккаунта создайте API-ключ",
          "desc": "В карточке аккаунта: «Создать новый ключ» → «Создать API-ключ», в поле «Область действия» выберите yc.search-api.execute. Ключ показывается один раз.",
          "title_en": "On the account page create an API key",
          "desc_en": "On the account page: “Create new key” → “Create API key”, pick yc.search-api.execute in the “Scope” field. The key starts with AQVN and is shown once."
        },
        {
          "title": "Скопируйте Folder ID под названием каталога",
          "desc": "В консоли откройте нужный каталог: идентификатор показан под названием и копируется по клику. Строка примерно из 20 символов, начинается с b1.",
          "title_en": "Copy the folder ID under the folder name",
          "desc_en": "In the console open the folder you need: its ID is shown under the name and copies on click. It is a roughly 20-character string starting with b1."
        }
      ]
    },
    "seo": {
      "title": "Яндекс Вордстат для ИИ-агента: какую формулировку ищут чаще",
      "description": "Сравнит частотность формулировок, например «доставка» против «самовывоза», соберёт похожие фразы и пик сезона по месяцам. Нужны API-ключ Yandex Cloud и Folder ID.",
      "headline": "Собирайте семантику под новую страницу прямо в чате",
      "scenarios": [
        {
          "title": "Семантика под новую страницу",
          "desc": "Агент соберёт топ фраз с вашим ключевым словом и похожие запросы за последние 30 дней и покажет, какими формулировками вас ищут."
        },
        {
          "title": "Сезонность спроса",
          "desc": "Агент построит динамику запросов по дням, неделям или месяцам и покажет подъёмы и провалы раньше, чем они дойдут до выручки."
        },
        {
          "title": "Спрос по регионам",
          "desc": "Агент разложит частотность фраз по регионам и городам и покажет, где спрос выше, чем ваша нынешняя доля присутствия."
        },
        {
          "title": "Проверка формулировок перед запуском",
          "desc": "Агент сравнит частотность нескольких вариантов названия или услуги и покажет, какой из них ищут, а какой в поиске почти не встречается."
        },
        {
          "title": "Спрос с телефонов",
          "desc": "Агент разложит частотность фразы по устройствам и покажет, какая доля спроса приходит с телефонов, а какая с десктопа, за один период и регион."
        },
        {
          "title": "Длинный список фраз",
          "desc": "Агент наберёт частотность по списку из сотен фраз постепенно, примерно по запросу в полминуты, и вернёт готовую таблицу, не упёршись в лимит сервиса."
        }
      ],
      "how_it_works": [
        "Агент ходит в раздел wordstat Search API Yandex Cloud: отправляет фразу и получает топ запросов с этим словом, похожие формулировки за последние 30 дней, динамику по дням, неделям и месяцам и разрез частотности по регионам и устройствам. Справочник регионов он подтягивает отдельным запросом, чтобы фильтры и названия городов в отчёте совпадали со справочником сервиса, а не подставлялись на глаз.",
        "Вордстат считает показы в поиске, а не людей и не будущий трафик, и агент называет цифру именно так. Частотность широкой фразы вбирает в себя все её уточнения, поэтому число по слову всегда больше суммы конкретных запросов, а смена региона переписывает картину целиком. К каждому числу агент проговаривает период и регион, из которых оно взято, чтобы сравнение вариантов названия шло на одной базе.",
        "Писать здесь нечего и агент не притворяется, что может: он не создаёт и не меняет ничего в Yandex Cloud, ключ используется только на запросы статистики. Работа целиком аналитическая: собрать семантику под новую страницу, увидеть подъёмы и провалы спроса раньше, чем они дойдут до выручки, найти регионы, где спрос выше вашей доли присутствия, и сравнить несколько формулировок услуги до запуска.",
        "Ключ уходит заголовком авторизации в каждый запрос и хранится зашифрованным; отзыв ключа в облаке гасит подключение сразу, а дальше статистики доступ всё равно не тянется: область ключа этим и ограничена. Обращения намеренно разрежены (порядка одного запроса в полминуты), так что длинный список фраз набирается постепенно, а тарификация идёт по факту обращений. Пустую выдачу по фразе агент называет прямо, а не выдаёт её за отсутствие спроса."
      ],
      "requirements": [
        "Аккаунт Yandex Cloud с правами администратора каталога.",
        "Облако, привязанное к платёжному аккаунту: Search API платный."
      ],
      "faq": [
        {
          "q": "Как подключить Яндекс Вордстат?",
          "a": "Двумя значениями из Yandex Cloud: API-ключ сервисного аккаунта, начинающийся с AQVN, и идентификатор каталога Folder ID. Аккаунту нужна роль search-api.webSearch.user, а ключ создаётся с областью действия yc.search-api.execute."
        },
        {
          "q": "Что агент получает из Вордстата?",
          "a": "Частотность поисковых фраз и похожие запросы, динамику по дням, неделям и месяцам, разрез по регионам и устройствам и справочник регионов для фильтров."
        },
        {
          "q": "Пишет ли агент что-то в сервис?",
          "a": "Нет, это справочная статистика: агент отправляет фразу и получает цифры спроса. Создавать или менять что-либо в Yandex Cloud он не может: ключ используется только для запросов Search API."
        },
        {
          "q": "Почему большой список фраз собирается долго?",
          "a": "Обращения к Search API намеренно разрежены во времени, поэтому пачка фраз набирается постепенно. Запросы тарифицируются по факту, а облако должно быть привязано к платёжному аккаунту."
        }
      ]
    },
    "seo_en": {
      "title": "Yandex Wordstat AI agent: which wording people search for",
      "description": "Compares search volume for competing phrasings, gathers related queries and finds the seasonal peak by month. Needs a Yandex Cloud API key and a folder ID.",
      "headline": "Collect the semantics for a new landing page in chat",
      "scenarios": [
        {
          "title": "Semantics for a new landing page",
          "desc": "The agent collects the top phrases containing your keyword plus related queries for the last 30 days and shows the wording people actually search for."
        },
        {
          "title": "Seasonality of demand",
          "desc": "The agent charts query dynamics by day, week or month and surfaces the peaks and dips before they show up in revenue."
        },
        {
          "title": "Demand by region",
          "desc": "The agent breaks phrase frequency down by region and city and shows where demand runs ahead of your current presence."
        },
        {
          "title": "Testing the wording before launch",
          "desc": "The agent compares the frequency of several names or service wordings and shows which one people search for and which one barely appears at all."
        },
        {
          "title": "Demand coming from phones",
          "desc": "The agent breaks phrase frequency down by device and shows what share of demand comes from phones and what from desktop, over the same period and region."
        },
        {
          "title": "A long list of phrases",
          "desc": "The agent works through a list of hundreds of phrases gradually, roughly one request every half a minute, and returns a finished table without hitting the service limit."
        }
      ],
      "how_it_works": [
        "The agent calls the wordstat section of the Yandex Cloud Search API: it sends a phrase and gets back the top queries containing that word, related wordings for the last 30 days, dynamics by day, week and month, and a frequency breakdown by region and device. It pulls the region reference list with a separate request so that filters and city names in the report match the service's own directory instead of being guessed.",
        "Wordstat counts impressions in search, not people and not future traffic, and the agent labels the number exactly that way. The frequency of a broad phrase absorbs all of its refinements, so the figure for a word is always larger than the sum of the specific queries, and switching the region rewrites the whole picture. With every number the agent states the period and the region it came from, so that comparing naming options runs on the same basis.",
        "There is nothing to write here and the agent does not pretend otherwise: it creates and changes nothing in Yandex Cloud, and the key is used only for statistics requests. The work is entirely analytical: collecting the semantics for a new page, seeing the peaks and dips of demand before they reach revenue, finding the regions where demand runs ahead of your presence, and comparing several wordings of a service before launch.",
        "The key travels as an authorization header on every request and is stored encrypted; revoking it in the cloud kills the connection at once, and the scope never reaches past statistics into the rest of the cloud anyway. Calls are deliberately spaced out (on average around one request every half a minute), so a long list of phrases fills in gradually and billing goes by actual usage. An empty result for a phrase is named as such, not passed off as absent demand."
      ],
      "requirements": [
        "A Yandex Cloud account with admin rights on the folder.",
        "A cloud linked to a billing account: Search API is paid."
      ],
      "faq": [
        {
          "q": "How do I connect Yandex Wordstat?",
          "a": "With two values from Yandex Cloud: a service account API key starting with AQVN and the catalog Folder ID. The account needs the search-api.webSearch.user role, and the key is created with the yc.search-api.execute scope."
        },
        {
          "q": "What does the agent get from Wordstat?",
          "a": "Search phrase frequency and related queries, dynamics by day, week and month, breakdowns by region and device, and the region reference list for filters."
        },
        {
          "q": "Does the agent write anything to the service?",
          "a": "No, this is reference statistics: the agent sends a phrase and gets demand figures back. It cannot create or change anything in Yandex Cloud, the key is used only for Search API requests."
        },
        {
          "q": "Why does a long list of phrases take so long?",
          "a": "Search API calls are deliberately spaced out in time, so a batch of phrases fills in gradually. Requests are billed as used, and the cloud must be linked to a billing account."
        }
      ]
    }
  },
  {
    "key": "yclients",
    "name": "Yclients",
    "name_en": "Yclients",
    "description": "Для салонов красоты: записи, клиенты, услуги и расписание",
    "category": "crm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yclients",
    "short_name": "YCLIENTS",
    "short_name_en": "YCLIENTS",
    "description_en": "For beauty salons: appointments, clients, services and schedules",
    "signup_url": "https://www.yclients.ru/onboarding/first",
    "guide": {
      "url": "https://yclients.com/appstore/developers",
      "steps": [
        {
          "title": "Откройте кабинет разработчика YCLIENTS",
          "desc": "Войдите под пользователем, который управляет филиалом, и откройте yclients.com/appstore/developers. Кабинет виден только тому, из-под кого создан.",
          "title_en": "Open the YCLIENTS developer portal",
          "desc_en": "Sign in to YCLIENTS as the user who manages the branch and open yclients.com/appstore/developers. Only the user who created it sees the keys."
        },
        {
          "title": "В «Настройках аккаунта» скопируйте API-ключ",
          "desc": "В кабинете разработчика откройте «Настройки аккаунта» и скопируйте API-ключ, это partner token. Без него API не отвечает даже на публичные методы.",
          "title_en": "In Account settings copy the API key",
          "desc_en": "In the developer portal open «Настройки аккаунта» and copy the API key; this is the partner token. Without it the API rejects even public methods."
        },
        {
          "title": "В «Моих приложениях» создайте приложение",
          "desc": "В разделе «Мои приложения» создайте приложение, затем в его разделе «Доступ к API» отметьте права системного пользователя: клиенты, записи, услуги.",
          "title_en": "In My applications create an app",
          "desc_en": "In «Мои приложения» create an application, then in its «Доступ к API» section tick the system user's rights: clients, records, services."
        },
        {
          "title": "Заберите User token и номер филиала",
          "desc": "После создания приложения в том же разделе появится поле «User token», скопируйте его. ID филиала это число в адресной строке кабинета филиала.",
          "title_en": "Grab the User token and the branch number",
          "desc_en": "Once the app is created, the “User token” field appears in the same section; copy it. The branch ID is the number in the branch dashboard's address bar."
        }
      ]
    },
    "seo": {
      "title": "YCLIENTS и ИИ-агент: свободные окна мастеров до выходных",
      "description": "63 свободных слота до воскресенья, около 189 тыс. ₽ незанятого времени. Агент находит окна в графике мастеров YCLIENTS и клиентов, которые перестали ходить.",
      "headline": "Находите окна в расписании мастеров, пока их можно продать",
      "scenarios": [
        {
          "title": "Окна в расписании мастеров",
          "desc": "Агент соберёт записи на неделю вперёд и покажет свободные слоты по мастерам, которые ещё можно продать."
        },
        {
          "title": "Клиенты, переставшие ходить",
          "desc": "Агент поднимет клиентскую базу и найдёт тех, кто не был дольше обычного, с услугами и суммами последних визитов."
        },
        {
          "title": "Выручка и Z-отчёт филиала",
          "desc": "Агент сведёт финансовые транзакции и Z-отчёты по дням и покажет, из чего сложилась выручка филиала за период."
        },
        {
          "title": "Товарные остатки салона",
          "desc": "Агент проверит склады филиала и товарные транзакции и покажет, какая косметика на исходе и что списывается быстрее, чем продаётся."
        },
        {
          "title": "Загрузка и средний чек мастеров",
          "desc": "Агент сведёт состоявшиеся визиты по мастерам: сколько часов заняты в графике, какие услуги делают чаще и какой средний чек выходит у каждого."
        },
        {
          "title": "Запись клиента и перенос",
          "desc": "Агент найдёт клиента по телефону, проверит свободный слот у мастера и заведёт или перенесёт запись, назвав, кого и на когда двигает, и дождавшись подтверждения."
        }
      ],
      "how_it_works": [
        "Агент работает с API Yclients в разрезе одного филиала: его номер участвует в каждом запросе, и все цифры относятся именно к нему. Он читает записи и историю визитов, клиентов, услуги и категории, мастеров с их расписанием, свободные слоты, товары и склады, финансовые транзакции, лояльность и аналитику. Свободное окно он считает не по пустому месту в сетке, а по графику мастера и длительности услуги, иначе слот выглядит продаваемым, но не продаётся.",
        "Запись и визит в салоне не одно и то же: запись остаётся в расписании, даже если клиент не пришёл, и загрузка мастеров, посчитанная по записям, всегда красивее реальной. Агент опирается на статус визита и на оплату. Выручку он тоже берёт не из стоимости услуг в записях, а из финансовых транзакций и Z-отчётов по дням: скидки, сертификаты, абонементы и депозиты меняют сумму, и сходится только касса.",
        "На запись агент создаёт и переносит записи, заводит клиентов и товарные операции в объёме прав системного пользователя, не шире. Перед созданием он проверяет, свободен ли слот у мастера, и ищет клиента по телефону, чтобы в базе не появился второй такой же. Перенос и отмена задевают живого человека с напоминанием на телефоне, поэтому агент называет, кого и на когда двигает, и ждёт подтверждения.",
        "Доступ собран из двух токенов: партнёрский открывает только публичные методы, а данные филиала (записи, клиентов, финансы) отдаёт связка партнёрского и пользовательского вместе с номером филиала. Частота запросов у Yclients небольшая, поэтому агент не гоняет расписание по кругу и выбирает периоды осознанно. Если метод закрыт правами системного пользователя или записей за период не было, он скажет это прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Права администратора филиала в YCLIENTS",
        "Активный филиал в аккаунте: токены выдаются именно на него"
      ],
      "faq": [
        {
          "q": "Как подключить Yclients?",
          "a": "Токенами из кабинета разработчика yclients.com/appstore/developers: обязательны partner token из «Настройки аккаунта» и ID филиала (число в адресной строке кабинета), user token из раздела «Доступ к API» вашего приложения можно добавить позже."
        },
        {
          "q": "Что агент видит в Yclients?",
          "a": "Записи и историю визитов, клиентов, услуги и категории, мастеров и расписание, свободные слоты, товары и склады, финансовые транзакции, лояльность и аналитику филиала."
        },
        {
          "q": "Пишет ли агент в Yclients?",
          "a": "Может: создавать и переносить записи, заводить клиентов и товарные операции. Объём записи задают права системного пользователя, отмеченные в разделе «Доступ к API»."
        },
        {
          "q": "Зачем user token и номер филиала?",
          "a": "Partner token открывает только публичные методы. Данные филиала (записи, клиентов, финансы) отдаёт связка partner и user token, а company_id указывает, о каком филиале речь."
        }
      ]
    },
    "seo_en": {
      "title": "YCLIENTS and AI agent: open staff slots before the weekend",
      "description": "63 open slots until Sunday, about 189,000 rubles of unbooked time. The agent finds gaps in the YCLIENTS staff schedule and clients who stopped coming.",
      "headline": "Find open slots in the staff schedule while they still sell",
      "scenarios": [
        {
          "title": "Open slots in the staff schedule",
          "desc": "The agent pulls appointments for the week ahead and shows the free slots per specialist that are still sellable."
        },
        {
          "title": "Clients who stopped coming",
          "desc": "The agent goes through the client base and finds those who have been away longer than usual, with the services and amounts of their last visits."
        },
        {
          "title": "Branch revenue and Z-report",
          "desc": "The agent reconciles financial transactions and Z-reports day by day and shows what the branch revenue for the period was made of."
        },
        {
          "title": "Salon stock levels",
          "desc": "The agent checks branch warehouses and goods transactions and shows which cosmetics are running out and what is written off faster than it sells."
        },
        {
          "title": "Utilisation and average bill per specialist",
          "desc": "The agent groups the visits that actually happened by specialist: hours booked in the schedule, the services they do most often and the average bill each one lands."
        },
        {
          "title": "Booking and moving a client",
          "desc": "The agent looks the client up by phone, checks the specialist's slot is free and creates or reschedules the appointment, naming who is moved and to when and waiting for your go-ahead."
        }
      ],
      "how_it_works": [
        "The agent works with the Yclients API in the scope of a single branch: its number takes part in every request, and every figure belongs to that branch. It reads appointments and visit history, clients, services and categories, staff with their schedules, open slots, goods and warehouses, financial transactions, loyalty and analytics. An open slot is counted not from a blank space in the grid but from the specialist's schedule and the duration of the service, otherwise a slot looks sellable and never sells.",
        "An appointment and a visit are different things in a salon: the appointment stays in the schedule even when the client never showed up, and staff utilisation counted from appointments always looks better than the real one. The agent leans on the visit status and on the payment. Revenue is taken not from the price of services in the appointments either, but from financial transactions and Z-reports day by day: discounts, gift cards, packages and deposits shift the amount, and only the till adds up.",
        "For writes the agent creates and reschedules appointments, adds clients and goods operations as far as the system user's permissions reach, no wider. Before creating one it checks whether the specialist's slot is free and looks the client up by phone so a second copy does not appear in the base. Rescheduling and cancelling touch a live person with a reminder on their phone, so the agent names who is being moved and to when, and waits for confirmation.",
        "Access is assembled from two tokens: the partner one opens only public methods, while branch data (appointments, clients, finances) is returned by the partner and user pair together with the branch number. The Yclients request rate is low, so the agent does not run the schedule in circles and picks periods deliberately. If a method is closed by the system user's permissions or there were no appointments in the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "Administrator rights for the branch in YCLIENTS",
        "An active branch in the account: the tokens are issued for it"
      ],
      "faq": [
        {
          "q": "How do I connect Yclients?",
          "a": "With tokens from the developer account at yclients.com/appstore/developers: the partner token from Account settings and the branch ID (the number in the address bar of your account) are required; the user token from the API access section of your application is optional."
        },
        {
          "q": "What does the agent see in Yclients?",
          "a": "Appointments and visit history, clients, services and categories, staff and the schedule, open slots, goods and warehouses, financial transactions, loyalty and branch analytics."
        },
        {
          "q": "Does the agent write to Yclients?",
          "a": "It can: create and reschedule appointments, add clients and goods operations. How much it may write is set by the permissions of the system user marked in the API access section."
        },
        {
          "q": "Why do I need a user token and a branch number?",
          "a": "The partner token opens only public methods. Branch data, appointments, clients and finances, is returned by the partner and user token pair, while company_id states which branch is meant."
        }
      ]
    }
  },
  {
    "key": "yookassa",
    "name": "ЮKassa",
    "name_en": "YooKassa",
    "description": "Приём платежей: платежи, возвраты, чеки, счета, автоплатежи, сделки",
    "category": "banks",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yookassa",
    "description_en": "Accept payments: payments, refunds, receipts, invoices, autopayments and deals",
    "search_terms": [
      "юкасса",
      "яндекс касса"
    ],
    "signup_url": "https://yookassa.ru/joinups",
    "guide": {
      "url": "https://yookassa.ru/my/",
      "steps": [
        {
          "title": "Войдите в кабинет ЮKassa с нужной ролью",
          "desc": "Ключи доступны владельцу магазина и пользователю с ролью «Разработчик». Если роли нет, попросите владельца добавить вас с ней, иначе раздел не откроется.",
          "title_en": "Sign in to YooKassa with the right role",
          "desc_en": "API keys are available to the shop owner and to a user with the “Developer” role. Without it the keys section stays closed, so ask the owner."
        },
        {
          "title": "Скопируйте shopId из «Настройки → Магазин»",
          "desc": "Вверху кабинета выберите магазин и откройте «Настройки → Магазин»: идентификатор подписан там как shopId. У каждого магазина, включая тестовый, он свой.",
          "title_en": "Copy shopId from Settings → Shop",
          "desc_en": "Pick the shop at the top, then open “Settings → Shop”: the identifier is labelled shopId. Every shop, test ones included, has its own value."
        },
        {
          "title": "Выпустите ключ в «Интеграция → Ключи API»",
          "desc": "Откройте «Интеграция → Ключи API», в блоке секретного ключа нажмите «Выпустить ключ» и подтвердите операцию SMS-паролем на телефон, привязанный к кабинету.",
          "title_en": "Issue the key in Integration → API keys",
          "desc_en": "Open “Integration → API keys”, click “Issue key” in the secret key block and confirm the action with the SMS password sent to the phone linked to the account."
        },
        {
          "title": "Скопируйте ключ из одноразового окна",
          "desc": "Секретный ключ показывается один раз: «Ключ доступен только в этом окне». После закрытия останется только перевыпустить; прежний работает ещё 48 часов.",
          "title_en": "Copy the key from the one-time window",
          "desc_en": "The secret key is shown only once, in that window alone. Once closed you cannot view it again, only reissue it; the previous key works for 48 more hours."
        }
      ]
    },
    "seo": {
      "title": "ЮKassa и ИИ-агент: выручка за вычетом возвратов",
      "description": "Сколько магазин собрал за месяц за вычетом возвратов и какую долю съели возвраты, видно без выгрузок из кабинета. Нужны shopId и секретный ключ.",
      "headline": "Принимайте платежи и считайте выручку ЮKassa прямо в чате",
      "scenarios": [
        {
          "title": "Ссылка на оплату для покупателя",
          "desc": "Агент создаст платёж на нужную сумму и отдаст ссылку на оплату, а потом сам проверит, оплатил ли покупатель. Каждое такое действие вы подтверждаете в карточке."
        },
        {
          "title": "Свод выручки за период",
          "desc": "Агент сведёт платежи за период: сколько прошло, сколько отменено и сколько вернули. Без выгрузок из кабинета."
        },
        {
          "title": "Разбор конкретного платежа",
          "desc": "Агент найдёт платёж по дате, сумме или статусу и покажет способ оплаты, фискальный чек и связанные с ним возвраты."
        },
        {
          "title": "Ежедневная сводка выручки",
          "desc": "Агент пришлёт сводку в рабочий чат по расписанию: выручка за день, отмены и возвраты по подключённому магазину."
        },
        {
          "title": "Возвраты и их причины",
          "desc": "Агент соберёт возвраты за период, свяжет их с исходными платежами и покажет, по каким способам оплаты их больше всего."
        },
        {
          "title": "Чеки под платежами",
          "desc": "Агент пройдёт по платежам периода и назовёт те, у которых нет фискального чека, и нехватка всплывёт раньше вопроса от бухгалтерии."
        },
        {
          "title": "Оплаты, которые не дошли",
          "desc": "Агент соберёт отменённые и незавершённые платежи за период и покажет, на каких способах оплаты покупатели срываются чаще всего."
        }
      ],
      "how_it_works": [
        "Агент ходит в API ЮKassa версии v3 и читает всё, что относится к приёму платежей: сами платежи и их статусы, возвраты, фискальные чеки и способы оплаты. Первым запросом он спрашивает /me и подтверждает, чей магазин подключён, чтобы сводка не оказалась про соседний shopId. Дальше считает выручку за период, отмены и возвраты, разбирает конкретный платёж по дате, сумме или статусу и присылает сводку по расписанию.",
        "Возврат в ЮKassa является отдельным объектом, связанный с платежом, а не правка самого платежа. Поэтому агент считает выручку как платежи периода за вычетом привязанных к ним возвратов и отдельно помечает те возвраты, что пришли позже исходной оплаты: иначе месяц закрывается красивее, чем он есть. И принятый платёж ещё не деньги на расчётном счёте: на счёт они приходят выплатой, и увидеть её можно уже в банковском коннекторе.",
        "Агент не только читает, но и принимает платежи: создаёт платёж и отдаёт покупателю ссылку на оплату, подтверждает или отменяет двухстадийный платёж, оформляет возврат, регистрирует чек по 54-ФЗ, в том числе второй чек, выставляет счёт и списывает автоплатёж по сохранённому способу оплаты. Каждое такое действие владелец магазина подтверждает в карточке согласия. Выплаты через API недоступны: «ЮKassa Выплаты» это отдельный продукт со своими agent_id и ключом.",
        "Доступ даёт пара shopId и секретного ключа: она подставляется в каждый запрос и жёстко привязана к одному магазину, поэтому сводка всегда про него, а не про соседний. Подписки на вебхуки этой парой не задаются (уведомления настраиваются в кабинете ЮKassa), поэтому агент забирает данные сам, по запросу и по расписанию, листая список платежей курсором. Если данных за период нет, он говорит об этом прямо, а не показывает пустую таблицу."
      ],
      "requirements": [
        "Магазин, подключённый к ЮKassa.",
        "Телефон, привязанный к кабинету: выпуск ключа подтверждают по SMS."
      ],
      "faq": [
        {
          "q": "Как подключить ЮKassa?",
          "a": "Парой значений: shopId из «Настройки» → «Магазин» и секретный ключ из «Интеграция» → «Ключи API» → «Выпустить ключ» с подтверждением SMS-паролем. Нужна роль владельца или «Разработчик», иначе раздел не откроется, а ключ показывается только один раз."
        },
        {
          "q": "Что агент умеет в ЮKassa?",
          "a": "Видит платежи и их статусы, возвраты, фискальные чеки и способы оплаты того магазина, чей shopId подключён. С вашего подтверждения создаёт платёж со ссылкой на оплату, подтверждает и отменяет двухстадийные платежи, делает возвраты, регистрирует чеки, выставляет счета и проводит автоплатежи."
        },
        {
          "q": "Чем это отличается от банка?",
          "a": "ЮKassa отвечает за приём платежей от покупателей: агент видит платежи и возвраты, а не выписку по расчётному счёту. На счёт деньги приходят выплатой, и её видно уже в банковском коннекторе."
        },
        {
          "q": "Что недоступно по этому ключу?",
          "a": "Разделы выплат и подписки на вебхуки под парой shopId и секретного ключа не работают: выплаты являются отдельным продуктом со своим ключом, а уведомления настраиваются в кабинете ЮKassa."
        }
      ]
    },
    "seo_en": {
      "title": "YooKassa AI agent: revenue net of refunds",
      "description": "The agent totals a shop's monthly revenue net of refunds and shows what share refunds took. Connects with your shopId and a secret key from the dashboard.",
      "headline": "Accept YooKassa payments and total revenue right in chat",
      "scenarios": [
        {
          "title": "A payment link for the customer",
          "desc": "The agent creates a payment for the amount you need, hands over the payment link and later checks on its own whether the customer has paid. You confirm every such action in a card."
        },
        {
          "title": "Revenue totals for a period",
          "desc": "The agent totals payments for a period: how much went through, how much was canceled and how much was refunded, with no exports from the merchant account."
        },
        {
          "title": "Breakdown of a single payment",
          "desc": "The agent finds a payment by date, amount or status and shows the payment method, the fiscal receipt and the refunds linked to it."
        },
        {
          "title": "Daily revenue summary",
          "desc": "The agent posts a summary to your work chat on a schedule: revenue for the day, cancellations and refunds for the connected shop."
        },
        {
          "title": "Refunds and what caused them",
          "desc": "The agent collects refunds for a period, ties them back to the original payments and shows which payment methods generate the most."
        },
        {
          "title": "Receipts behind the payments",
          "desc": "The agent walks the payments of a period and names the ones with no fiscal receipt, so the gap surfaces before the accounting department asks about it."
        },
        {
          "title": "Payments that never landed",
          "desc": "The agent collects canceled and unfinished payments for a period and shows which payment methods customers drop off on most often."
        }
      ],
      "how_it_works": [
        "The agent calls the YooKassa API version v3 and reads everything that belongs to accepting payments: the payments themselves and their statuses, refunds, fiscal receipts and payment methods. Its first request goes to /me and confirms whose shop is connected, so the summary does not turn out to be about a neighbouring shopId. After that it totals revenue for a period, cancellations and refunds, breaks down a single payment by date, amount or status and sends a summary on a schedule.",
        "A refund in YooKassa is a separate object linked to a payment, not an edit of the payment itself. So the agent counts revenue as the payments of the period minus the refunds tied to them, and separately flags the refunds that arrived later than the original charge: otherwise the month closes prettier than it really is. And an accepted payment is not yet money on the current account: it reaches the account as a payout, and that is visible in the banking connector.",
        "The agent does not only read, it accepts payments: it creates a payment and hands the customer a payment link, captures or cancels a two-stage payment, issues a refund, registers a 54-FZ fiscal receipt including the second receipt, issues an invoice and charges a recurring payment against a saved payment method. The shop owner confirms every such action in a consent card. Payouts are out of reach over the API: YooKassa Payouts is a separate product with its own agent_id and key.",
        "Access is a shopId and secret key pair: it is attached to every request and is bound to one shop only, so a summary is always about that shop and never about a neighbouring one. Webhook subscriptions cannot be set with this pair (notifications are configured in the YooKassa account), so the agent fetches data itself, on request and on a schedule, paging through the payment list with a cursor. If there is no data for the period, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A shop connected to YooKassa.",
        "The phone linked to the account: issuing a key is confirmed by SMS."
      ],
      "faq": [
        {
          "q": "How do I connect YooKassa?",
          "a": "With a pair of values: the shopId from Settings and Shop, and the secret key from Integration, API keys, Issue key, confirmed with an SMS password. You need the owner or Developer role, otherwise the section will not open, and the key is shown only once."
        },
        {
          "q": "What can the agent do in YooKassa?",
          "a": "It sees payments and their statuses, refunds, fiscal receipts and payment methods for the shop whose shopId is connected. With your confirmation it creates a payment with a payment link, captures and cancels two-stage payments, issues refunds, registers receipts, issues invoices and charges recurring payments."
        },
        {
          "q": "How is this different from a bank?",
          "a": "YooKassa is about collecting payments from customers: the agent sees payments and refunds, not your current account statement. Money reaches the account as a payout, and that is visible in the banking connector."
        },
        {
          "q": "What is not available with this key?",
          "a": "The payouts section and webhook subscriptions do not work with a shopId and secret key pair: payouts are a separate product with its own key, and notifications are configured in the YooKassa merchant account."
        }
      ]
    }
  },
  {
    "key": "yougile",
    "name": "YouGile",
    "name_en": "YouGile",
    "description": "Доски, колонки, задачи, чаты, департаменты",
    "category": "pm",
    "markets": [
      "com",
      "ru"
    ],
    "auth_flow": "credentials",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "yougile",
    "description_en": "Boards, columns, tasks, chats and departments",
    "search_terms": [
      "югайл"
    ],
    "guide": {
      "url": "https://ru.yougile.com/api-v2#/operations/AuthKeyController_create",
      "steps": [
        {
          "title": "Войдите под администратором компании",
          "desc": "Ключ наследует права создателя: под обычным сотрудником API увидит только его доски. Мастер-ключ ко всем объектам компании создавайте под администратором.",
          "title_en": "Sign in as the company administrator",
          "desc_en": "A key inherits its creator's rights: under a regular employee the API sees only that person's boards. Create a master key as an administrator."
        },
        {
          "title": "Нажмите Ctrl+Alt+Q, и скопируется companyId",
          "desc": "Откройте любую страницу своей компании и нажмите Ctrl+Alt+Q (на Mac Ctrl+Option+Q): companyId молча скопируется в буфер. В меню интерфейса этого значения нет.",
          "title_en": "Press Ctrl+Alt+Q to copy the companyId",
          "desc_en": "Open any page of your company and press Ctrl+Alt+Q (Ctrl+Option+Q on Mac): the companyId is silently copied to the clipboard. No menu item shows it."
        },
        {
          "title": "Откройте AuthKeyController_create в доках",
          "desc": "Ключ выдаётся только через API: откройте https://ru.yougile.com/api-v2#/operations/AuthKeyController_create, там есть интерактивная консоль.",
          "title_en": "Open AuthKeyController_create in the docs",
          "desc_en": "Keys come only from the API. Go to https://ru.yougile.com/api-v2#/operations/AuthKeyController_create, where the method page has an interactive console."
        },
        {
          "title": "Нажмите «Send API Request» и скопируйте key",
          "desc": "Укажите login (email аккаунта), password и companyId, нажмите «Send API Request». В ответе придёт {{\"key\": \"…\"}}: скопируйте строку, около 48 символов.",
          "title_en": "Press Send API Request and copy the key",
          "desc_en": "Fill in login (account email), password and companyId, then press “Send API Request”. The response returns {{\"key\": \"…\"}}; copy the string, about 48 chars."
        }
      ]
    },
    "seo": {
      "title": "Интеграция YouGile с ИИ: просрочка по всем доскам",
      "description": "Итог переписки в чате задачи на 78 сообщений и просрочка по всем доскам YouGile в одном ответе. Агент читает проекты, задачи и чаты через api-v2.",
      "headline": "Ловите просроченные задачи YouGile по всем доскам",
      "scenarios": [
        {
          "title": "Просрочка по доскам",
          "desc": "Агент пройдёт по проектам, доскам и колонкам и покажет, какие задачи просрочены по дедлайну и у кого они зависли."
        },
        {
          "title": "Задача в нужной колонке",
          "desc": "Агент создаст задачу в выбранной колонке, назначит исполнителя и распишет постановку, не открывая доску вручную."
        },
        {
          "title": "Переписка в чате задачи",
          "desc": "Агент прочитает чат задачи, соберёт суть обсуждения и допишет туда комментарий по итогам разговора."
        },
        {
          "title": "Сводка по проектам за сутки",
          "desc": "Агент по расписанию пришлёт, какие задачи созданы, изменены и завершены за сутки по каждому проекту компании."
        },
        {
          "title": "Нагрузка по департаментам",
          "desc": "Агент сведёт открытые задачи с сотрудниками и департаментами и покажет, на кого приходится половина работы, а у кого в колонках почти пусто."
        },
        {
          "title": "Реакция на новую задачу",
          "desc": "Агент узнаёт о созданной и изменённой задаче сразу, перечитывает карточку через API и скажет, если постановка ушла без срока или без исполнителя."
        }
      ],
      "how_it_works": [
        "Агент ходит в YouGile через api-v2: читает проекты, доски и колонки, задачи со сроками и исполнителями, чаты задач, сотрудников и департаменты. Из этого собирается разбор по компании: что просрочено по дедлайну, у кого зависло, что создано, изменено и завершено за сутки по каждому проекту. Обход идёт сверху вниз, от проекта к колонке, поэтому задача не теряется на доске, о которой вы забыли.",
        "Устроен YouGile вокруг чатов: обсуждение задачи живёт не в поле описания, а в её ленте сообщений, и настоящая причина переноса срока или смены исполнителя чаще всего написана именно там, а не в самой карточке. Поэтому агент читает чат задачи целиком и достаёт из него суть договорённостей, а не судит о ходе работы по одним лишь полям карточки и положению в колонке.",
        "На запись агент создаёт задачу в выбранной колонке, расписывает постановку, назначает исполнителя и срок, переносит задачи между колонками и пишет сообщения в чат задачи. Перед созданием он проверяет, что проект, доска и колонка существуют и открыты ключу, а после изменения перечитывает задачу, чтобы показать её фактическое состояние. Сообщение в чат уходит от лица владельца ключа, и агент об этом предупреждает.",
        "Ключ один на все запросы, и агент видит ровно те доски, что открыты этому ключу: закрытая доска для него просто не существует, а не отвечает ошибкой. Списки YouGile отдаёт страницами, поэтому разбор по компании означает обход проектов, досок и колонок, а не один запрос, и агент следит, что дошёл до конца. Уведомления о новой и изменённой задаче приходят без подписи, поэтому агент считает их сигналом и перечитывает данные через API; если чего-то не видно, он скажет прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Логин и пароль от аккаунта YouGile: их спрашивает метод создания ключа",
        "Права администратора, если ключ нужен ко всем доскам компании",
        "Тариф не важен: API работает на любом плане YouGile"
      ],
      "faq": [
        {
          "q": "Как подключить YouGile?",
          "a": "Одним полем, API-ключом. В интерфейсе его не выдают: нажмите Ctrl+Alt+Q на странице своей компании, чтобы скопировать companyId, и вызовите метод создания ключа в документации API, указав login, password и companyId."
        },
        {
          "q": "Что агент видит в YouGile?",
          "a": "Проекты, доски, колонки, задачи со сроками и исполнителями, чаты задач, сотрудников и департаменты в пределах прав аккаунта, под которым выпущен ключ."
        },
        {
          "q": "Пишет ли агент в YouGile?",
          "a": "Да: создаёт и обновляет задачи, переносит их между колонками, назначает исполнителей и пишет сообщения в чат задачи."
        },
        {
          "q": "Почему агент видит не все доски?",
          "a": "Ключ наследует права своего создателя: под обычным сотрудником видны только его доски. Мастер-ключ ко всем объектам компании выпускают под администратором."
        }
      ]
    },
    "seo_en": {
      "title": "YouGile integration with AI: overdue tasks on every board",
      "description": "The outcome of a 78-message task chat and overdue work across every YouGile board in one reply. The agent reads projects, tasks and chats through api-v2.",
      "headline": "Catch overdue YouGile tasks across every board",
      "scenarios": [
        {
          "title": "Overdue work across boards",
          "desc": "The agent walks through projects, boards and columns and shows which tasks are past their deadline and with whom they are stuck."
        },
        {
          "title": "A task in the right column",
          "desc": "The agent creates a task in the column you pick, assigns an owner and writes out the brief, without opening the board by hand."
        },
        {
          "title": "The conversation inside a task chat",
          "desc": "The agent reads the task chat, distills what the discussion was about and posts a follow-up comment with the outcome."
        },
        {
          "title": "Daily project digest",
          "desc": "On a schedule the agent reports which tasks were created, changed and completed in the last 24 hours for every company project."
        },
        {
          "title": "Load across departments",
          "desc": "The agent lines up open tasks with employees and departments and shows who carries half of the work and whose columns are all but empty."
        },
        {
          "title": "Reacting to a new task",
          "desc": "The agent hears about a created or changed task at once, re-reads the card through the API and tells you when a brief went out with no deadline or no owner."
        }
      ],
      "how_it_works": [
        "The agent calls YouGile through api-v2: it reads projects, boards and columns, tasks with their deadlines and assignees, task chats, employees and departments. Out of that it assembles a company-wide triage: what is past its deadline, with whom it is stuck, what was created, changed and completed in the last 24 hours for every project. The walk goes top down, from project to column, so a task does not get lost on a board you forgot about.",
        "YouGile is built around chats: the discussion of a task lives in its message feed rather than in the description field, and the real reason a deadline moved or an assignee changed is most often written exactly there rather than on the card itself. So the agent reads the whole task chat and pulls the substance of what was agreed out of it, instead of judging the state of the work from the card fields and the column position alone.",
        "In writing, the agent creates a task in the column you pick, writes out the brief, assigns an owner and a deadline, moves tasks between columns and posts messages in the task chat. Before creating anything it checks that the project, board and column exist and are open to the key, and after a change it re-reads the task to show its actual state. A chat message goes out under the key owner name, and the agent says so in advance.",
        "One key serves every request, and the agent sees exactly the boards that key is open to: a closed board simply does not exist for it rather than answering with an error. YouGile hands over lists in pages, so a company-wide triage is a walk through projects, boards and columns rather than a single request, and the agent makes sure it reached the end. Notifications about a new or changed task arrive unsigned, so the agent treats them as a signal and re-reads the data through the API; if something is out of sight, it says so directly instead of showing an empty table."
      ],
      "requirements": [
        "The YouGile account login and password: the creation method asks for them",
        "Administrator rights if the key must cover every board",
        "Any YouGile plan works: the API is not a paid add-on"
      ],
      "faq": [
        {
          "q": "How do I connect YouGile?",
          "a": "With a single field, the API key. The interface does not issue it: press Ctrl+Alt+Q on your company page to copy the companyId, then call the key creation method from the API documentation with your login, password and companyId."
        },
        {
          "q": "What does the agent see in YouGile?",
          "a": "Projects, boards, columns, tasks with deadlines and assignees, task chats, employees and departments, within the permissions of the account the key was issued under."
        },
        {
          "q": "Does the agent write to YouGile?",
          "a": "Yes: it creates and updates tasks, moves them between columns, assigns owners and posts messages in the task chat."
        },
        {
          "q": "Why does the agent see only some boards?",
          "a": "The key inherits the rights of its creator: under a regular employee only their boards are visible. A master key covering every company object is issued under an administrator."
        }
      ]
    }
  },
  {
    "key": "youtube",
    "name": "YouTube",
    "name_en": "YouTube",
    "description": "Каналы, видео, плейлисты, комментарии и аналитика YouTube",
    "category": "messengers",
    "markets": [
      "com",
      "keepmeposted",
      "ru"
    ],
    "auth_flow": "popup_oauth",
    "catalog_visibility": "tile",
    "has_own_page": true,
    "integration_slug": "youtube",
    "description_en": "Channels, videos, playlists, comments and YouTube analytics",
    "search_terms": [
      "ютуб"
    ],
    "guide": {
      "url": "https://studio.youtube.com",
      "steps": [
        {
          "title": "Сверьте каналы в «Управлении каналами»",
          "desc": "Проверьте список: профиль на youtube.com → «Настройки» → «Аккаунт» → «Управление каналами». Аккаунт без канала умеет только смотреть и подписываться.",
          "title_en": "Check channels in Add or manage channels",
          "desc_en": "Check your channel list: profile on youtube.com → \"Settings\" → \"Account\" → \"Add or manage channel(s)\". An account with no channel can only watch and subscribe."
        },
        {
          "title": "Откройте «Разрешения» в YouTube Студии",
          "desc": "Откройте studio.youtube.com → «Настройки» → «Разрешения». Список видят только владелец и менеджеры: если раздел не открывается, роли не хватает.",
          "title_en": "Open Permissions in YouTube Studio",
          "desc_en": "Open studio.youtube.com → \"Settings\" → \"Permissions\". Only the owner and managers see the list: if it will not open, your role is not enough."
        },
        {
          "title": "Нажмите «Перенести разрешения»",
          "desc": "Если каналом управляют через аккаунт бренда, в разделе «Разрешения» нажмите «Перенести разрешения». Роль каждому пользователю владелец назначает вручную.",
          "title_en": "Click Move Permissions",
          "desc_en": "If the channel is still managed through a Brand Account, click \"Move Permissions\" in \"Permissions\". The owner then assigns each user a role manually."
        },
        {
          "title": "Через «Пригласить» выдайте роль «Менеджер»",
          "desc": "«Разрешения» → «Пригласить» → e-mail аккаунта Google → роль. «Менеджер» даёт всё, кроме удаления канала.",
          "title_en": "Invite the email with the Manager role",
          "desc_en": "\"Permissions\" → \"Invite\" → the Google Account email → role. \"Manager\" covers everything but deleting the channel; \"Viewer\" leaves read-only access."
        }
      ]
    },
    "seo": {
      "title": "YouTube и ИИ-агент: пересказ вебинара по субтитрам",
      "description": "Перескажет часовой вебинар по субтитрам, чтобы не смотреть его целиком, и сравнит просмотры канала за неделю с прошлой. Подключается входом через Google.",
      "headline": "Разбирайте статистику канала и роликов YouTube прямо в чате",
      "scenarios": [
        {
          "title": "Статистика канала и видео",
          "desc": "Агент соберёт просмотры, подписчиков и число роликов, разберёт метаданные и статистику видео и покажет, что тянет канал вверх."
        },
        {
          "title": "Комментарии и ответы",
          "desc": "Агент прочитает свежие ветки комментариев под видео, отделит вопросы от спама и опубликует ответы верхнего уровня."
        },
        {
          "title": "Плейлисты и подписки",
          "desc": "Агент заведёт плейлист, добавит в него нужные ролики и подпишется на канал, за которым вы решили следить."
        },
        {
          "title": "Субтитры и разбор видео",
          "desc": "Агент возьмёт список субтитров ролика, скачает файл в SRT и разберёт содержание выступления без просмотра целиком."
        },
        {
          "title": "Разбор соседнего канала",
          "desc": "Агент соберёт публичные ролики интересного вам канала с просмотрами и датами выхода и покажет, как часто там публикуют и что заходит лучше."
        },
        {
          "title": "Еженедельная сводка по каналу",
          "desc": "Агент раз в неделю снимет статистику канала и роликов, сравнит её с прошлой неделей и пришлёт, что выросло по просмотрам, а что просело."
        }
      ],
      "how_it_works": [
        "Агент работает с YouTube Data API v3: читает ваш канал со статистикой просмотров, подписчиков и числа роликов, метаданные и метрики отдельных видео, плейлисты, ветки комментариев, подписки, субтитры и категории видео по региону. По этим данным он сводит динамику канала за период, показывает, какие ролики тянут его вверх, а список субтитров скачивает в SRT и разбирает содержание выступления без просмотра целиком.",
        "Тонкость YouTube в том, что аккаунт Google и канал не одно и то же, и объём доступного определяет роль в YouTube Студии, а не факт входа. Роль «Менеджер» даёт всё, кроме удаления канала, а «Пользователь с правом просмотра» оставляет только чтение, и агент честно упрётся в это на первом же пишущем действии. Квота Data API с лета 2026 разложена по отдельным суточным корзинам: у поиска своя сотня вызовов в день, у загрузки видео своя, а всё остальное чтение и запись делят общий дневной запас. Поэтому агент собирает ролики канала через список загрузок, а не поиском, и так поисковая корзина остаётся целой.",
        "На запись агент заводит плейлисты и добавляет в них ролики, публикует ответы верхнего уровня в комментариях, ставит лайк и подписывается на каналы. Комментарии он сначала разбирает: отделяет вопросы от спама и показывает, кому собирается ответить: ответ уходит от имени вашего канала и виден публично, поэтому шаг остаётся за вами. Опубликованное агент не удаляет и чужие ветки не чистит.",
        "Токен доступа живёт около часа и продлевается автоматически, так что переподключаться вручную не приходится. Статистика в Data API приходит агрегатом по каналу и по видео: поминутной аналитики и источников трафика здесь нет, за ними нужен отдельный API отчётов. Если раздел закрыт ролью на канале или доступ отозван, агент скажет об этом прямо, а не покажет пустую таблицу."
      ],
      "requirements": [
        "Канал уже создан: аккаунт без канала подключить нельзя",
        "Владелец канала на связи: роли выдаёт только он",
        "Подключение через вход в Google: ключи и токены вводить не нужно"
      ],
      "faq": [
        {
          "q": "Как подключить YouTube?",
          "a": "Входом через Google: нажмите кнопку подключения, во всплывающем окне выберите аккаунт с каналом и подтвердите доступ. Вручную ничего вводить не нужно: ключи и токены не потребуются."
        },
        {
          "q": "Что агент видит в YouTube?",
          "a": "Ваш канал и его статистику, видео с метаданными и метриками, плейлисты, ветки комментариев, подписки, субтитры и категории видео по региону."
        },
        {
          "q": "Пишет ли агент в YouTube?",
          "a": "Может: создавать плейлисты и добавлять в них видео, публиковать ответы в комментариях, ставить лайк и подписываться на каналы."
        },
        {
          "q": "Какая роль нужна на канале?",
          "a": "Роль «Менеджер» в YouTube Студии: она даёт всё, кроме удаления канала. С ролью «Пользователь с правом просмотра» агент сможет только читать."
        }
      ]
    },
    "seo_en": {
      "title": "YouTube AI agent: summarize a webinar from captions",
      "description": "Summarizes an hour-long webinar from its captions so you don't have to watch it, and compares the channel's weekly views with the week before. Signs in with Google.",
      "headline": "Break down YouTube channel and video stats right in chat",
      "scenarios": [
        {
          "title": "Channel and video statistics",
          "desc": "The agent collects views, subscribers and video count, goes through video metadata and stats and shows what is pulling the channel up."
        },
        {
          "title": "Comments and replies",
          "desc": "The agent reads fresh comment threads under a video, separates real questions from spam and publishes top-level replies."
        },
        {
          "title": "Playlists and subscriptions",
          "desc": "The agent creates a playlist, adds the videos you want to it and subscribes to the channel you decided to follow."
        },
        {
          "title": "Captions and video breakdown",
          "desc": "The agent takes the caption list for a video, downloads the SRT file and breaks down what was said without watching the whole thing."
        },
        {
          "title": "A look at a neighbouring channel",
          "desc": "The agent collects the public videos of a channel you follow with their views and publish dates and shows how often they post and what lands best."
        },
        {
          "title": "Weekly channel digest",
          "desc": "The agent takes channel and video statistics once a week, compares them with the previous week and sends over what grew in views and what slipped."
        }
      ],
      "how_it_works": [
        "The agent works with the YouTube Data API v3: it reads your channel with its view, subscriber and video counts, the metadata and metrics of individual videos, playlists, comment threads, subscriptions, captions and video categories by region. From that data it puts together the channel dynamics for a period and shows which videos are pulling it up, while the caption list is downloaded as SRT so what was said can be broken down without watching the whole thing.",
        "The subtlety with YouTube is that a Google account and a channel are not the same thing, and how much is available is decided by the role in YouTube Studio rather than by the fact of signing in. The Manager role covers everything except deleting the channel, while the Viewer role leaves read-only access, and the agent runs into that honestly at the first write. Since summer 2026 the Data API quota is split into separate daily baskets: search has its own hundred calls a day, video uploads have theirs, and everything else shares one daily allowance. That is why the agent collects a channel's videos from its uploads list rather than by searching, which leaves the search basket untouched.",
        "As writes the agent creates playlists and adds videos to them, publishes top-level replies in comments, likes videos and subscribes to channels. Comments are sorted through first: real questions are separated from spam and the agent shows who it intends to answer: a reply goes out from your channel and is publicly visible, so that step stays with you. The agent does not delete what has been published and does not clean up other people threads.",
        "The access token lives for about an hour and is refreshed automatically, so nothing has to be reconnected by hand. Statistics in the Data API arrive aggregated per channel and per video: there is no minute-level analytics and no traffic sources here, those need the separate reporting API. If a section is closed by your role on the channel or access has been revoked, the agent says so directly instead of showing an empty table."
      ],
      "requirements": [
        "A channel already created: an account without one cannot connect",
        "The channel owner reachable: only they can assign roles",
        "Connection is a Google sign-in, with no keys or tokens to type in"
      ],
      "faq": [
        {
          "q": "How do I connect YouTube?",
          "a": "By signing in with Google: click the connect button, pick the account that owns the channel in the popup and approve access. Nothing to type in by hand, no keys or tokens needed."
        },
        {
          "q": "What does the agent see in YouTube?",
          "a": "Your channel and its statistics, videos with metadata and metrics, playlists, comment threads, subscriptions, captions and video categories by region."
        },
        {
          "q": "Does the agent write to YouTube?",
          "a": "It can: create playlists and add videos to them, publish replies in comments, like videos and subscribe to channels."
        },
        {
          "q": "What role do I need on the channel?",
          "a": "The Manager role in YouTube Studio, which covers everything except deleting the channel. With the Viewer role the agent can only read."
        }
      ]
    }
  }
]
