Skip to Content

Подключение Planfix

Planfix хранит вместе контакты клиентов, задачи по разговорам, статусы и заметки. Например, агент может создать задачу по продажам для нового обращения и поддерживать краткое содержание разговора в актуальном состоянии.

Используйте платный аккаунт Planfix. Вам понадобится отдельное поле задачи типа Short text, которое не даёт создавать дубликаты задач; Versafy может создать его за вас, или вы можете создать его вручную. Поле Number нужно только для сумм заказов. Оба поля должны быть на Card выбранного объекта задачи и доступны для редактирования подключённому пользователю Planfix. Шаблон создания задачи необязателен; в старых аккаунтах вместо карточки объекта может использоваться его форма.

Versafy заранее выбирает поля и шаблоны по их типам и названиям, в том числе по русским названиям, таким как «Бюджет» и «Шаблон контакта». Проверьте выбор и при необходимости измените его; неоднозначные совпадения остаются невыбранными. Чтобы включить новое поле, откройте выбранный объект задачи в разделе Custom в Types of objects, затем Card. У записи Task в разделе System страницы Card нет.

Выбирайте Объект задачи (например, Сделка) отдельно от Шаблон создания задачи (необязательно). Объект определяет, где отображаются задачи и какие поля есть в их форме; шаблон лишь задаёт значения по умолчанию при создании. Оставьте для шаблона Не настроено, если у выбранного объекта нет подходящего шаблона. Проверьте выбранный объект и включите сопоставленные поля на его Card. Для получения списка объектов токену нужно разрешение object_readonly. Учебный шаблон не выбирается только потому, что он единственный.

Если Planfix предупреждает, что добавление поля внешнего ID удалит существующие поля объекта, отмените действие. В Account management → Custom fields → Task fields выберите поле внешнего ID и с помощью Transfer to field set перенесите его в Main. Затем добавьте его в Card выбранного объекта, не удаляя существующие поля, и повторите сохранение подключения.

Чтобы позже изменить сопоставления, откройте вкладку CRM агента → Сопоставление полей Planfix. Выберите объект задачи, поле внешнего ID, поле суммы, шаблоны задач и контактов и Сотрудник Planfix для новых задач. Нажмите Сохранить сопоставление; проверка настройки выполняется автоматически перед сохранением. Подключаться заново и вводить токен снова не нужно. Эти настройки действуют для каждого агента, использующего это подключение CRM, и требуют права управлять интеграциями. Обновить варианты загружает актуальные поля и сохранённый выбор.

При загрузке страница проверяет сохранённые сопоставления и показывает предупреждение, если выбранного поля нет в форме объекта или не прошла другая проверка настройки. Исправьте выбор и снова нажмите Сохранить сопоставление. Если поле суммы использовать нельзя, выберите Не настроено; суммы заказов не будут синхронизироваться, пока не выбрано корректное числовое поле.

Выберите сотрудника, который должен открывать новые задачи в Planfix. Versafy назначает новые задачи на этого сотрудника. Автоматическая проверка настройки убеждается, что выбранный сотрудник активен, поля внешнего ID и суммы доступны в форме выбранного объекта (или в форме старого шаблона), а шаблон принадлежит выбранному объекту. Она не проверяет сеанс вашего браузера и не создаёт задачу, поэтому после подключения откройте в Planfix только что синхронизированную задачу. Видимость контактов определяется отдельно правами шаблона контакта в Planfix; если контакты не открываются, проверьте эти права. Существующие задачи и контакты сохраняют текущий доступ.

Создайте и включите поля

Для ручного создания поля откройте в Planfix Account management → Custom fields → Task fields. Создайте поле Short text с отдельным названием, например Versafy external ID, в Main field set. Затем в Versafy нажмите Назад / обновить варианты и выберите его по названию. Не используйте повторно поле, в котором хранятся другие данные.

После автоматического или ручного создания выполните в Planfix следующие шаги: откройте Account management → Types of objects → Custom → выбранный объект → Card, добавьте поле внешнего ID из Main и сохраните, не удаляя существующие поля. Если вы используете числовое поле суммы, добавьте его в ту же Card. Затем откройте каждое поле в Account management → Custom fields → Task fields и предоставьте доступ view and edit пользователю Planfix, связанному с токеном REST. Это может быть другой человек, не тот сотрудник, который получает новые задачи. Автоматическое создание выбирает поле в Versafy, но добавление его в Card и предоставление доступа всегда выполняются вручную.

Подключение и проверка

Чтобы подготовить токен, откройте в Planfix Account management → API Access → REST API, создайте или отредактируйте токен и добавьте области доступа, показанные в Versafy в разделе Allowed Scopes. В форме подключения введите URL учётной записи Planfix и Токен REST API, затем выполните шаги ниже.

  1. Выберите Planfix в окне подключения CRM.
  2. В разделе Необходимые разрешения API предоставьте в Planfix перечисленные разрешения времени выполнения. Добавьте custom_field_add, если хотите, чтобы Versafy создал поле внешнего ID; при выборе существующего поля оно необязательно. Копировать всё включает его.
  3. Введите данные подключения и нажмите Продолжить, чтобы загрузить доступные поля и шаблоны. Выберите своё отдельное Поле внешнего идентификатора по названию; не выбирайте поле, используемое для других данных.
  4. Если нужно новое поле, выберите Создать новое… в выпадающем списке Поле внешнего идентификатора. Это создаст и выберет отдельное поле в Main field set. Перед подключением добавьте это поле в Object form задачи и предоставьте подключённому пользователю право редактирования. Если создание не удалось, во всплывающем окне объясняется, как выдать разрешения или создать поле вручную, после чего обновите варианты. Существующие задачи не изменяются и не сопоставляются автоматически; синхронизация записей, уже введённых вручную, может создать дубликаты.
  5. Открывайте Дополнительные настройки только при необходимости: выберите Поле суммы (необязательно) для сумм заказов и добавьте это числовое поле в Card выбранного объекта. Оставьте Не настроено, если вы не синхронизируете суммы заказов. Шаблон создания задачи выбирайте только если он принадлежит выбранному объекту; шаблоны контактов отдельные. Загрузка вариантов не создаёт записей и не сохраняет подключение.
  6. Выберите Сотрудник Planfix для новых задач, затем нажмите Подключить Planfix. Если проверка настройки сообщает о проблеме с полем, шаблоном или сотрудником, устраните её и повторите попытку. Затем выберите процесс и статус на вкладке CRM агента. Замена учётных данных выполняется теми же шагами; перед сохранением заново выберите нужные сопоставления.

Стандартный процесс может отображаться по числовому ID. Поддерживаются обновление контактов, редактируемые заметки о разговорах и суммы заказов. Чат CRM, загрузка файлов, теги, повторное использование существующей открытой задачи и встроенные поля доставки недоступны. Для обычной работы разрешения на создание полей не нужны. Если доступ отклонён, проверьте и форму объекта, и права подключённого пользователя на редактирование полей.

Чтобы выбрать, кто будет указан автором новых комментариев в Planfix, откройте Дополнительные настройки → Автор комментариев (необязательно) при настройке подключения. Также Автор комментариев (необязательно) можно изменить в разделе CRM → Сопоставление полей Planfix агента без повторного подключения. Пользователь API-токена оставляет автором владельца токена. Выбор другого сотрудника не меняет назначение задачи, а у существующих комментариев автор остаётся прежним. Эта настройка общая для всех агентов, использующих подключение.

Этапы задач

Выбранный Объект задачи определяет доступные этапы Planfix. Versafy показывает название этого объекта как процесс; статусы несвязанного учебного шаблона не используются. После смены объекта проверьте процесс и статус на вкладке CRM агента.

Для инструментов смены этапа откройте Инструменты приложения CRM на вкладке AI-ответ агента, нажмите Обновить схему, затем Настроить разрешенные этапы. Просмотрите этапы и сохраните те, которые агенту можно использовать. Обновление автоматически не разрешает новые этапы.

Если нужного этапа, например On hold, нет, добавьте его в Planfix в Account management → Types of objects → Custom → ваш объект → Status set → Add status to set и настройте допустимые переходы. Затем обновите этапы в Versafy и разрешите этот этап. Агент не может перевести задачу в статус, которого нет в её объекте, и не подменяет результат другим.

Обновлено