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

# Подробная инструкция по подключению талантов

> Пошаговые инструкции по конкретным сервисам: Bitrix24, amoCRM, Travelline, Bnovo, MEWS, платежи, базы данных.

Каждый сервис подключается своими полями: одному нужен ключ, другому — вход через OAuth, третьему — идентификатор отеля. Раскройте нужную строку — внутри что понадобится, шаги и как проверить, что заработало.

<Tip>**Общий порядок для любого таланта:** нажмите на карточку во вкладке **Таланты** → авторизуйтесь в сервисе или вставьте API-ключ → посмотрите список доступных инструментов → пропишите в [Персоне](/ru/guides/persona), когда сотрудник их использует → проверьте в тест-чате.</Tip>

## CRM

<AccordionGroup>
  <Accordion title="Как подключить Bitrix24">
    Bitrix24 живёт в платформе дважды: [каналом](/ru/channels/bittrix24) — чтобы сообщения из Открытых линий приходили в чаты AI TEXTURA, и талантом — чтобы сотрудник создавал лиды и сделки, искал контакты и ставил задачи. Это два независимых подключения, обычно нужны оба.

    Нажмите карточку **Bitrix24** в каталоге и выберите вкладку.

    <Tabs>
      <Tab title="Через подключённый канал">
        Самый короткий путь: талант берёт авторизацию у канала, отдельный вебхук создавать не нужно.

        <Steps>
          <Step title="Выберите канал">
            В списке — каналы Bitrix24, уже подключённые к вашей организации.
          </Step>

          <Step title="Нажмите «Далее»">
            Талант получит права канала и появится на подвкладке **Подключённые**.
          </Step>
        </Steps>

        <Note>Список пуст, если канал Bitrix24 ещё не подключён. Тогда [подключите канал](/ru/channels/bittrix24) или идите путём вебхука.</Note>
      </Tab>

      <Tab title="Через входящий вебхук">
        Подходит, когда канал не используется или таланту нужен отдельный набор прав.

        <Steps>
          <Step title="В Bitrix24 создайте вебхук">
            **Приложения → Разработчикам → Другое → Входящий вебхук**.
          </Step>

          <Step title="Отметьте права">
            Нужны все шесть: **CRM** (`crm`), **Пользователи** (`user`), **Задачи** (`task`), **Чат и уведомления** (`im`), **Создание и управление Чат-ботами** (`imbot`), **Открытые линии** (`imopenlines`).
          </Step>

          <Step title="Скопируйте адрес вебхука">
            Он выглядит так: `https://ваш-портал.bitrix24.ru/rest/1/abcdef0123456/`.
          </Step>

          <Step title="Вставьте адрес в AI TEXTURA">
            Вернитесь в окно таланта Bitrix24, вставьте адрес в поле и нажмите **Подключить**.
          </Step>
        </Steps>
      </Tab>
    </Tabs>

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/15-talent-bitrix24-modal.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=84718c04763a3f711c4490cded3b89a4" alt="Окно подключения таланта Bitrix24: вкладки «Подключённый канал» и «Вебхук»" width="1440" height="900" data-path="public/screenshots/15-talent-bitrix24-modal.png" />
    </Frame>

    **Проверка.** Напишите в тест-чате: «Хочу оставить заявку, меня зовут Иван, телефон 900-000-00-00». В Bitrix24 должна появиться сделка или лид с этими данными.

    Если её нет:

    * **Сотрудник отвечает, а в CRM пусто** — в [Персоне](/ru/guides/persona) нет правила, когда создавать сделку. Допишите его явно.
    * **Действие не проходит** — в вебхуке не отмечено право **CRM**. Пересоздайте вебхук со всеми шестью правами.
    * **Работало и перестало** — вебхук отозван на стороне Bitrix24. Создайте новый и вставьте адрес заново.
  </Accordion>

  <Accordion title="Как подключить amoCRM">
    amoCRM подключается входом через OAuth — логины и ключи вводить не нужно.

    <Steps>
      <Step title="Откройте карточку amoCRM">
        В каталоге талантов найдите её поиском по названию.
      </Step>

      <Step title="Выберите способ авторизации">
        **Новое подключение** — платформа перебросит вас на страницу входа amoCRM. **Существующий аккаунт** — если вы уже авторизовали amoCRM раньше, выберите его из списка.
      </Step>

      <Step title="Войдите под нужной учётной записью">
        Права таланта равны правам этой учётной записи: войдите под той, у которой есть доступ к нужной воронке.
      </Step>

      <Step title="Нажмите «Подключить талант»">
        Талант появится на подвкладке **Подключённые**.
      </Step>
    </Steps>

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/17-talent-amocrm-modal.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=5c69723a77ed1d2aaa98bc1640e586e1" alt="Окно подключения таланта amoCRM: новое подключение или существующий аккаунт" width="1440" height="900" data-path="public/screenshots/17-talent-amocrm-modal.png" />
    </Frame>

    **Проверка.** Попросите сотрудника в тест-чате оформить заявку — в amoCRM должна появиться сделка.

    <Note>amoCRM, как и Bitrix24, может работать ещё и каналом — см. [Каналы](/ru/channels/amocrm). Талант отвечает только за действия в CRM.</Note>
  </Accordion>

  <Accordion title="Как подключить Kommo">
    Kommo — международная версия amoCRM, подключается так же: **Новое подключение** или **Существующий аккаунт**, дальше вход через OAuth под учётной записью с доступом к воронке.

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/21-talent-kommo.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=d1f43aabaea148182ffc9130d0ac97d4" alt="Окно подключения таланта Kommo" width="1440" height="900" data-path="public/screenshots/21-talent-kommo.png" />
    </Frame>

    Если OAuth-сессия истечёт, талант перестанет срабатывать — переподключите его на подвкладке **Подключённые**.
  </Accordion>

  <Accordion title="Как подключить Salesforce, Zoho CRM, HubSpot, Zendesk, ServiceNow">
    Salesforce и Zoho CRM подключаются входом через OAuth, HubSpot, Zendesk и ServiceNow — API-ключом из настроек соответствующего сервиса.

    Порядок общий: карточка в каталоге → авторизация или ключ → **Подключить талант**. Права таланта равны правам учётной записи или ключа, поэтому заводите отдельный технический доступ с минимально нужными правами.
  </Accordion>
</AccordionGroup>

## PMS — отели и апартаменты

PMS даёт сотруднику номерной фонд: свободные даты, категории, тарифы. Без неё он не ответит на «свободно ли на 5 ноября» и не оформит бронь.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/RmsnbSfPguQ" title="Как подключить PMS-систему" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

| PMS                 | Регион      | Тип объектов                   | Чем подключается                     |
| ------------------- | ----------- | ------------------------------ | ------------------------------------ |
| **MEWS**            | Глобальный  | Отели, сети отелей             | Configuration ID + токены коннектора |
| **Travelline**      | РФ, РБ, мир | Отели, гостиницы               | Hotel ID + регион                    |
| **Bnovo**           | РФ, СНГ     | Малые отели, гостевые дома     | Hotel ID + логин и пароль            |
| **RealtyCalendar**  | РФ          | Апартаменты, посуточная аренда | API-ключ                             |
| **Bronirui Online** | РФ          | Гостевые дома, мини-отели      | API-ключ                             |
| **MeHotel**         | РФ          | Отели, апартаменты             | API-ключ                             |

Карточки PMS лежат на вкладке **Таланты** → **Обзор приложений**, фильтр **Travel & Hospitality**. Подключённая PMS даёт сотруднику проверить свободные даты, показать категории и тарифы, оформить черновик брони или передать данные менеджеру, ответить по существующей броне и посмотреть заезды и выезды дня. Точный набор зависит от API конкретной системы и прав учётной записи.

<Warning>Креды PMS — это доступ к бронированиям, тарифам и данным гостей. Заводите отдельную техническую учётную запись с минимально нужными правами: её можно отозвать в любой момент, не трогая рабочие.</Warning>

<AccordionGroup>
  <Accordion title="Как подключить Travelline">
    **Что понадобится:** Hotel ID из личного кабинета Travelline и регион, в котором работает отель.

    <Steps>
      <Step title="Откройте карточку Travelline">
        Вкладка **Таланты** → **Обзор приложений** → фильтр **Travel & Hospitality** или поиск по названию.
      </Step>

      <Step title="Заполните два поля">
        **Hotel ID** — цифровой идентификатор из кабинета Travelline. **Регион** — `РФ`, `РБ` или `МИР`: от него зависит, к какому серверу Travelline пойдут запросы.
      </Step>

      <Step title="Назовите экземпляр">
        Если отелей несколько, название вида «Travelline — Приморский» сэкономит время потом.
      </Step>

      <Step title="Нажмите «Подключить талант»">
        Талант появится на подвкладке **Подключённые**.
      </Step>
    </Steps>

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/19-talent-travelline.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=142c633bd2b8ad4e6caeef5ce3ef49ed" alt="Окно подключения таланта Travelline: поля Hotel ID и Регион" width="1440" height="900" data-path="public/screenshots/19-talent-travelline.png" />
    </Frame>

    Допишите в [Персону](/ru/guides/persona) правило — без него сотрудник в PMS не пойдёт:

    > Когда гость спрашивает про свободные даты или стоимость номера — проверь наличие в Travelline и покажи доступные варианты с ценами.

    **Проверка.** Спросите в тест-чате: «Свободен ли номер с 5 по 7 ноября?» Сотрудник должен ответить конкретными категориями и ценами.

    Если ответ общими словами:

    * **«Не могу проверить доступность»** — проверьте Hotel ID и регион, а заодно права учётной записи в Travelline.
    * **Отвечает по ценам, но не по датам** — учётной записи не хватает прав на чтение календаря.
    * **Вообще не идёт в PMS** — нет правила в Персоне.
  </Accordion>

  <Accordion title="Как подключить Bnovo">
    **Что понадобится:** Hotel ID, логин и пароль учётной записи Bnovo.

    <Steps>
      <Step title="Откройте карточку Bnovo">
        Каталог талантов → поиск по названию.
      </Step>

      <Step title="Заполните три поля">
        **Hotel ID** — идентификатор объекта в Bnovo. **Login** и **Password** — данные учётной записи, от имени которой сотрудник будет ходить в PMS.
      </Step>

      <Step title="Нажмите «Подключить талант»">
        Талант появится на подвкладке **Подключённые**.
      </Step>
    </Steps>

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/20-talent-bnovo.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=1af9cbac51d7cedc1df5174c65ba8f44" alt="Окно подключения таланта Bnovo: Hotel ID, логин и пароль" width="1440" height="900" data-path="public/screenshots/20-talent-bnovo.png" />
    </Frame>

    <Tip>Заведите в Bnovo отдельную техническую учётную запись для интеграции. Так проще выдать ей ровно нужные права и отозвать доступ, не трогая рабочие аккаунты.</Tip>

    **Проверка.** Спросите в тест-чате про свободные даты — сотрудник должен вернуть категории и цены из Bnovo.
  </Accordion>

  <Accordion title="Как подключить MEWS">
    MEWS требует больше всего данных, и почти все выдаёт партнёр-менеджер MEWS: запросите у него конфигурацию для интеграции с AI TEXTURA.

    **Что понадобится:**

    | Поле                                                     | Где взять                             |
    | -------------------------------------------------------- | ------------------------------------- |
    | **Configuration ID**                                     | Выдаёт MEWS под конкретную интеграцию |
    | **Client Name**                                          | Настройки MEWS                        |
    | **Hotel ID**                                             | Настройки MEWS                        |
    | **Age Category Adult** и **Children**                    | Категории гостей в MEWS               |
    | **Hotel Timezone**                                       | Настройки отеля                       |
    | **Connector Client Token**, **Access Token**, **Client** | Выдаёт MEWS                           |
    | **Enterprise ID**                                        | Настройки MEWS, для сетей             |

    <Frame>
      <img src="https://mintcdn.com/aitextura/RUgF9PTnaDyK7QnO/public/screenshots/18-talent-mews.png?fit=max&auto=format&n=RUgF9PTnaDyK7QnO&q=85&s=52fc295b2a98a1708e72b48b3ce0a532" alt="Окно подключения таланта MEWS с полями конфигурации" width="1440" height="900" data-path="public/screenshots/18-talent-mews.png" />
    </Frame>

    Заполните поля в карточке **MEWS** и нажмите **Подключить талант**. Для сети отелей заведите на каждый отель своего ИИ-сотрудника — со своими Configuration ID и Hotel ID.
  </Accordion>

  <Accordion title="Как подключить RealtyCalendar, Bronirui Online, MeHotel">
    Все три подключаются одинаково — API-ключом из личного кабинета соответствующей системы.

    <Steps>
      <Step title="Получите API-ключ">
        В кабинете RealtyCalendar, Bronirui Online или MeHotel — раздел настроек или интеграций.
      </Step>

      <Step title="Вставьте ключ в карточку таланта">
        Поле **API Key** в окне подключения.
      </Step>

      <Step title="Нажмите «Подключить талант»">
        Проверьте в тест-чате вопросом про свободные даты.
      </Step>
    </Steps>

    <Warning>Для каждого объекта — свой экземпляр таланта и, как правило, свой ИИ-сотрудник. Один сотрудник с двумя PMS начнёт путать объекты.</Warning>
  </Accordion>

  <Accordion title="Что делать, если вашей PMS нет в списке">
    Напишите в [поддержку](/ru/guides/support) — каталог расширяется. Второй путь: подключить свой MCP-сервер через **Создать талант** — тип сервера SSE или Streamable HTTP, авторизация по API-ключу или Bearer-токену.
  </Accordion>

  <Accordion title="Сеть отелей: как развести объекты">
    На каждый отель — свой ИИ-сотрудник со своим PMS-талантом, своей [базой знаний](/ru/guides/knowledge) и своей [Персоной](/ru/guides/persona). Общий номер WhatsApp или один канал-агрегатор при этом использовать можно — разводятся именно сотрудники, а не каналы.

    Две PMS на одного сотрудника технически подключаются, но он начнёт путать объекты. Если объектов несколько — разводите их по сотрудникам.
  </Accordion>

  <Accordion title="Можно ли разрешить сотруднику оформлять брони самому">
    Да, если у таланта есть право на запись и это явно описано в [Персоне](/ru/guides/persona). Начинайте со сценария «черновик брони плюс подтверждение менеджера» и переходите к полной автоматике, когда диалоги вас устраивают.
  </Accordion>
</AccordionGroup>

После подключения PMS сотруднику нужны ещё три вещи: правило в [Персоне](/ru/guides/persona), когда идти в PMS; [канал](/ru/channels), чтобы разговаривать с гостем; [база знаний](/ru/guides/knowledge) с политикой отмены, завтраками и правилами — PMS отдаёт цифры по номерам, всё остальное берётся оттуда.

## Документы, платежи, базы данных

<AccordionGroup>
  <Accordion title="Как подключить Google Sheets, Drive, Calendar">
    Все сервисы Google подключаются входом через OAuth: нажмите карточку, войдите в Google-аккаунт и разрешите доступ. Права таланта равны правам этого аккаунта — заведите отдельный служебный, если не хотите открывать личный диск.

    Если календарей несколько — заведите на каждый своего ИИ-сотрудника: одному сотруднику один и тот же талант подключается только один раз.
  </Accordion>

  <Accordion title="Как подключить Notion">
    Подключение через OAuth. После входа отметьте в Notion те страницы и базы, к которым открываете доступ, — сотрудник увидит только их.
  </Accordion>

  <Accordion title="Как подключить Stripe и другие платежи">
    Stripe подключается API-ключом из панели Stripe: **Developers → API keys**. После подключения сотрудник умеет создавать платёжные ссылки, проверять оплату и оформлять возвраты.

    <Warning>Ключ с правом на списание — чувствительный доступ. Используйте ключ с минимально нужными правами и опишите в [Персоне](/ru/guides/persona) точные условия, при которых сотрудник создаёт ссылку на оплату.</Warning>
  </Accordion>

  <Accordion title="Как подключить рассылки: SendGrid, Amazon SES, Klaviyo">
    Все три подключаются API-ключом из личного кабинета сервиса. Домен отправителя должен быть подтверждён на стороне сервиса, иначе письма не уйдут.
  </Accordion>

  <Accordion title="Как подключить базу данных: PostgreSQL, MySQL, MongoDB, Supabase">
    Понадобятся адрес сервера, порт, имя базы, логин и пароль. Supabase подключается по URL проекта и сервисному ключу.

    <Warning>Дайте учётной записи доступ только на чтение, если сотрудник должен искать данные, а не менять их. Открытая база — самый дорогой способ ошибиться.</Warning>
  </Accordion>
</AccordionGroup>

## Работают без настройки

Эти таланты от AI TEXTURA включаются одной кнопкой — ни ключей, ни аккаунтов.

| Талант                         | Что делает                                                   |
| ------------------------------ | ------------------------------------------------------------ |
| **Делить абзацы на сообщения** | Разбивает длинный ответ на несколько сообщений в мессенджере |
| **Спам Фильтр**                | Отсеивает спам до того, как сотрудник начнёт отвечать        |
| **Лимит сообщений**            | Ограничивает число сообщений на одного клиента в день        |
| **Language Detect**            | Определяет язык входящего сообщения                          |
| **WebSearch**                  | Ищет актуальную информацию в интернете                       |
| **Geocode**                    | Превращает адрес в координаты и обратно                      |
| **Currency Exchange Rates**    | Отдаёт курсы валют                                           |

## Что дальше

<CardGroup cols={2}>
  <Card title="Таланты" icon="bolt" href="/ru/guides/talents">
    Общий порядок подключения и что делать, если талант не срабатывает
  </Card>

  <Card title="Персона" icon="brain" href="/ru/guides/persona">
    Где описать, когда сотрудник вызывает талант
  </Card>

  <Card title="Каналы" icon="comments" href="/ru/channels">
    Bitrix24 и amoCRM подключаются ещё и каналом
  </Card>

  <Card title="Поддержка" icon="life-ring" href="/ru/guides/support">
    Если сервис ведёт себя не так, как ожидалось
  </Card>
</CardGroup>