Skip to main content

​
Как это работает

Planfix — это не мессенджер. Клиент пишет вам в Telegram, WhatsApp, на почту или в чат на сайте, а Planfix превращает обращение в задачу и складывает переписку в её комментарии. Ответ сотрудника, написанный комментарием, Planfix отправляет клиенту обратно в тот же канал. ИИ-сотрудник встраивается в эту схему как обычный сотрудник Planfix:
1

Клиент пишет

Сообщение попадает в задачу Planfix новым комментарием.
2

Planfix зовёт AI Textura

Автоматический сценарий отправляет комментарий на адрес вебхука вашего канала.
3

ИИ отвечает

AI Textura добавляет в задачу ответный комментарий.
4

Planfix доставляет ответ

Клиент получает ответ там же, где написал — в Telegram, WhatsApp или на почте.
Отдельно подключать мессенджеры не нужно. Все каналы, уже заведённые в вашем Planfix, автоматически становятся доступны ИИ-сотруднику через один канал Planfix.

​
Что понадобится

Подключение выполняется в три шага и занимает около 15 минут. Порядок важен: адрес вебхука появляется только после сохранения канала, а без него не настроить сценарий.

​
Шаг 1. Создайте API-токен в Planfix

1

Откройте раздел API

В Planfix перейдите в Управление аккаунтом → Доступ к API → REST API.
2

Создайте новый ключ

Нажмите создание нового API-ключа и задайте ему понятное имя — например, «AI Textura».
3

Выдайте права (scope)

Токену нужны как минимум эти права:
4

Скопируйте токен

Сохраните его во временное место — он понадобится на следующем шаге.
API-токен даёт полный доступ к вашему аккаунту Planfix. Не пересылайте его в мессенджерах и не храните в общих документах. В AI Textura после сохранения токен скрывается и больше не показывается.

​
Шаг 2. Создайте канал в AI Textura

1

Откройте сотрудника

Перейдите в ИИ-сотрудники → выберите сотрудника → вкладка Канал → подвкладка Подключить новый.
2

Выберите Planfix

Найдите в списке платформ Planfix и нажмите Создать.
3

Заполните два обязательных поля

  • Домен — адрес аккаунта целиком, вместе с зоной: acc.planfix.ru. Можно вставить и со https:// — лишнее уберётся само.
  • API-токен — ключ из шага 1.
4

Нажмите «Подключить»

Канал сохранится, и AI Textura сгенерирует для него адрес вебхука — уникальный и секретный.
5

Скопируйте адрес вебхука

Откройте только что созданный канал во вкладке Подключённые. В поле Вебхук URL нажмите кнопку копирования. Этот адрес нужен на шаге 3.
Поле Вебхук URL пустует, пока канал не сохранён — так и должно быть. Адрес генерируется один раз при создании канала и дальше не меняется.
Адрес вебхука — это пароль. Кто угодно, зная его, сможет присылать вашему ИИ-сотруднику сообщения от имени клиентов. Не публикуйте его.

​
Шаг 3. Настройте автоматический сценарий в Planfix

Сценарий — это то, что заставляет Planfix звать AI Textura при каждом новом сообщении клиента.
1

Откройте сценарии

В Planfix перейдите в Управление аккаунтом → Автоматические сценарии и нажмите Новый сценарий.
2

Задайте событие

Событие, при котором будет запущен сценарий — Добавлен комментарий и задача соответствует условиям.
3

Задайте условия

Добавьте два условия и соедините их логикой 1 И 2:
  1. Автор комментария — контакт — чтобы бот отвечал только клиенту, а не на комментарии коллег.
  2. Исполнитель = ваш сотрудник-бот — чтобы бот работал только в тех задачах, которые ему поручены.
4

Добавьте действие «Послать HTTP-запрос»

В разделе Выполнить следующие операции выберите действие Послать HTTP-запрос и заполните:
  • Метод — POST
  • URL — адрес вебхука, скопированный на шаге 2
  • Тип — application/json
  • Содержимое запроса — переключите на вкладку ПАРАМЕТРАМИ (не «Текстом»)
  • Авторизация — Без авторизации
5

Добавьте параметры

Добавьте шесть параметров — имена слева должны совпадать буква в букву:
6

Сохраните сценарий

В блоке Уведомление об изменениях оставьте Уведомлять и сохраните.
Для contactId выбирайте именно «Номер» постановщика, а не «Идентификатор». «Идентификатор» возвращает другой, технический номер — с ним ответ не дойдёт до клиента в его мессенджер.
Чтобы каждая новая задача сразу попадала к ИИ, назначьте сотрудника-бота исполнителем по умолчанию в шаблоне задачи. Иначе исполнителя придётся ставить руками, и до этого момента сценарий не сработает.

​
Дополнительные поля: контекст из задачи

Кроме шести обязательных параметров вы можете передать ИИ-сотруднику любые поля задачи — город, номер договора, тариф, тему обращения. Он получит их вместе с сообщением и будет учитывать в ответе. Добавьте в тот же список параметров ещё строки — имя придумываете сами, оно и станет подписью для ИИ:
Называйте параметры человеческим языком — ИИ читает именно эти подписи. Номер договора понятнее, чем contract_no.
Ограничения: не больше 15 дополнительных полей, длина названия — до 60 символов, длина значения — до 300 символов. Пустые поля не передаются.

​
Настройки канала

Откройте канал во вкладке Подключённые, чтобы изменить его настройки.

​
Режим заметки

Включите «Посылать ответ как заметку», если хотите сначала посмотреть, что отвечает ИИ, и не показывать это клиенту. Ответы будут появляться в задаче скрытыми комментариями — с замочком, видимыми только вашим сотрудникам.
Удобный способ обкатать нового сотрудника на реальных обращениях без риска. Когда ответы устроят — выключите переключатель, и ИИ начнёт отвечать клиентам напрямую.

​
Передача оператору

Если включить «Разрешить передачу оператору», ИИ сможет сам позвать живого сотрудника. Происходит это так:
  1. ИИ пишет клиенту, что подключает коллегу.
  2. В задачу добавляется скрытая заметка с кратким пересказом разговора — чтобы сотрудник не перечитывал всю переписку.
  3. Задача переназначается на того, кто указан в поле «Назначить на».
  4. Бот перестаёт отвечать — сценарий больше не срабатывает, потому что исполнитель уже не он.

​
Когда передавать

Поле «Когда передавать оператору» заполняется обычными словами, без всякого синтаксиса. Например:
Если оставить поле пустым, сработают стандартные случаи: клиент прямо просит человека, ИИ не может решить вопрос, речь о возврате или претензии.
Передача оператору выключена по умолчанию — включайте её осознанно. Если поле «Назначить на» не заполнено, задача останется без исполнителя: бот с неё уйдёт, но конкретного сотрудника система не назначит.

​
Вложения

Если в сценарии передан параметр fileIds, ИИ-сотрудник получает файлы, которые клиент приложил к комментарию:
Обрабатывается до 3 файлов на один комментарий, размер каждого — до 15 МБ.

​
Проверьте, что всё работает

1

Создайте задачу

В Planfix создайте задачу и назначьте исполнителем сотрудника-бота.
2

Напишите от лица клиента

Добавьте комментарий от контакта — или попросите клиента написать в подключённый канал.
3

Дождитесь ответа

В течение нескольких секунд в задаче появится комментарий от ИИ-сотрудника.
4

Проверьте доставку

Убедитесь, что ответ ушёл клиенту в его мессенджер — если, конечно, не включён режим заметки.

​
Частые вопросы

Так и задумано. Токен даёт полный доступ к аккаунту Planfix, поэтому после сохранения мы его больше не показываем — даже вам. Канал при этом работает: токен хранится и используется. Заполняйте поле, только если хотите заменить ключ на новый.
Список сотрудников приходит из Planfix, и для запроса нужен токен — а он, как описано выше, в форме не показывается. Вставьте токен в поле ещё раз, список подгрузится, выберите сотрудника и сохраните.
По порядку: (1) исполнитель задачи — сотрудник-бот, указанный в условиях сценария; (2) комментарий написан контактом, а не сотрудником — на коллег сценарий не реагирует намеренно; (3) сценарий включён, а в действии указан правильный адрес вебхука; (4) канал в AI Textura активен и сотрудник в статусе «Active»; (5) рабочее расписание сотрудника позволяет ему отвечать сейчас.
Токену не хватает прав. Вернитесь в Управление аккаунтом → Доступ к API и выдайте ключу все шесть прав: comment_add, contact_readonly, file_add, file_readonly, task_update, user_readonly.
Почти всегда причина в параметре contactId: в сценарии выбрано «Идентификатор» вместо «Номер». Замените значение на {{Задача.Постановщик.Номер}}. Вторая возможная причина — включён режим «Посылать ответ как заметку»: тогда ответ виден только сотрудникам.
Нет. Во-первых, условие сценария «Автор комментария — контакт» отсекает комментарии бота. Во-вторых, Planfix не запускает сценарии для комментариев, добавленных через API. В-третьих, AI Textura отбрасывает повторы по номеру комментария. Три независимые защиты.
Да. Каждый аккаунт — отдельный канал со своим доменом, токеном и адресом вебхука. Помните правило: один канал привязывается к одному ИИ-сотруднику.
Отключённый канал перестаёт принимать сообщения — Planfix продолжит слать запросы, но ответов не будет. Если нужно временно вернуть переписку живым сотрудникам, лучше выключить ИИ-сотрудника, а не канал: тогда история диалогов сохранится.

​
Что дальше

Каналы

Все способы подключить клиентов к ИИ-сотруднику

Bitrix24

Другая система с подключением по вебхуку

amoCRM

Подключение CRM по OAuth

Уведомления

Сообщение вам, когда клиент зовёт человека