Интеграция Planfix с сайтом или CRM
Интеграция Planfix с сайтом или CRM соединяет входящую заявку с фактической работой команды. Planfix поддерживает REST API в формате JSON, входящие вебхуки и исходящие HTTP-запросы из автоматических сценариев. Вебхук умеет создавать или изменять задачи и добавлять контакты, а REST API работает с контактами, задачами, комментариями, файлами, аналитиками, справочниками, проектами и отчётами в пределах выданных прав.
Мы связываем форму сайта или объект CRM с шаблоном Planfix и сохраняем идентификаторы обеих систем. Новая заявка создаёт либо находит контакт, формирует задачу, подставляет тему, услугу, адрес, сумму, источник и назначает сотрудника. Изменение статуса может обновить сделку CRM или клиентский экран сайта, комментарий передаётся с автором и временем, а файл прикладывается к нужной карточке.
Токен получает только необходимые scope: например, чтение и создание контактов, задач, комментариев и файлов. Planfix может вернуть код 202, когда изменение задачи поставлено во внутреннюю очередь; обработчик сохраняет такой результат как принятый и позднее сверяет фактическое состояние.
Исходящие POST-запросы Planfix выполняет последовательно и повторяет после неуспешного ответа, поэтому принимающий сервер быстро подтверждает событие и обрабатывает его через собственную очередь. Итогом становится единый маршрут заявки, где сотрудники работают в Planfix, а сайт или CRM получают актуальный результат.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Заявка приходит с сайта, а координатор вручную создаёт контакт и задачу Planfix и переносит приложенные файлы.
- Продажи работают в CRM, исполнители — в Planfix, поэтому статус заказа уточняется в чатах и созвонах.
- Комментарии клиента и команды хранятся в разных карточках, а связь между сделкой и задачей приходится искать по названию.
- Автоматический сценарий повторно отправляет событие после ошибки, и во второй системе появляется дублирующая запись.
Что именно мы сделаем
Описываем путь заявки, шаблоны Planfix, роли, статусы и данные, которые должны видеть сайт или CRM.
Проверяем тариф, создаём интеграцию и выдаём токену только необходимые права на контакты, задачи и файлы.
Сопоставляем идентификаторы, контакты, задачи, комментарии, сроки, исполнителей и пользовательские поля.
Настраиваем REST API, вебхуки, исходящие HTTP-запросы, очередь, повторы, защиту от дублей и журнал.
Проводим создание и обновление контрольных карточек и передаём карту обмена и инструкцию сопровождения.
Что входит в стоимость
59 900 ₽ за всю работу
Выбираем рабочий процесс между Planfix и сайтом либо CRM, составляем карту контактов, задач, комментариев, файлов и пользовательских полей. Настраиваем REST API, входящий вебхук и исходящие HTTP-запросы в подходящей комбинации, добавляем авторизацию с минимальными правами, двусторонние статусы, защиту от повторов, очередь и журнал. Небольшие связанные уточнения карточек и маршрутов включаем в итог после согласования.
Что будет готово
Передадим вам
- Рабочая интеграция Planfix с сайтом или CRM для выбранного маршрута заявок и статусов.
- Карта контактов, задач, комментариев, файлов, пользовательских полей и идентификаторов двух систем.
- Вебхуки и API-обработчик с минимальными правами, очередью, повторами, защитой от дублей и журналом.
- Протокол контрольных сценариев и инструкция по токену, шаблонам, статусам и дальнейшим изменениям.
Перед сдачей проверим
- Контрольная заявка создаёт или находит контакт и формирует одну задачу Planfix по правильному шаблону с нужными полями.
- Изменение выбранного статуса, комментарий и файл отображаются во второй системе с правильной связью и временем.
- Повтор события сохраняет одну пару карточек, а временная ошибка проходит очередь и отражается в техническом журнале.
- Токен ограничен необходимыми scope, секрет отсутствует в браузере, а сотрудник видит только разрешённые ему данные.
Как это выглядит на практике
Заказ с сайта становится задачей производства и возвращает статус клиенту
- 01
Клиент отправляет заявку с услугой, адресом, сроком и файлом, а сайт передаёт данные защищённому обработчику.
- 02
Интеграция находит контакт и создаёт задачу Planfix по производственному шаблону с назначенным координатором.
- 03
Исполнитель меняет статус и добавляет комментарий, автоматический сценарий передаёт обновление на сайт или в CRM.
- 04
Клиентский интерфейс показывает актуальный этап, а журнал связывает оба объекта и все попытки доставки.
Что понадобится для работы
От вас
- Доступ администратора к Planfix, платный или премиум-тариф и тестовый токен с выбранными scope.
- Доступ к тестовому сайту или CRM, документация API и описание карточек, полей, статусов и пользователей.
- Шаблоны задач, примеры контактов, комментариев, файлов и сценариев перехода между рабочими этапами.
- Владелец процесса, который подтвердит систему-источник, правила поиска контактов, назначения и обработки ошибок.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 56 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Каким способом сайт подключается к Planfix?
Для простой заявки используем входящий вебхук с настроенной операцией. Когда нужен поиск объектов, работа с комментариями, файлами и обратными статусами, подключаем REST API и исходящие HTTP-запросы.
На каком тарифе работает REST API Planfix?
Официальная документация указывает доступность REST API в платных или премиум-аккаунтах. Перед началом проверяем тариф, фактические методы и права конкретного аккаунта.
Какие сущности можно связать с CRM?
Обычно связываем контакты и компании, задачи, комментарии, файлы, статусы, проекты и пользовательские поля. Нужный состав выбираем по рабочему процессу и возможностям API клиента.
Можно передавать статусы из Planfix обратно на сайт?
Да. Автоматический сценарий отправляет HTTP-запрос при выбранном событии, а сайт обновляет связанную запись по устойчивому идентификатору и показывает разрешённый клиенту статус.
Что означает ответ 202 при обновлении задачи?
Planfix может принять изменение во внутреннюю очередь, если задача занята параллельной операцией. Интеграция сохраняет ответ как принятый и затем проверяет фактическое состояние задачи.
Как обрабатываются повторные HTTP-запросы?
Событие получает ключ из источника, типа и идентификатора объекта. Повтор находит существующую связь, обновляет журнал и сохраняет единственный контакт, задачу или сделку.
Можно перенести существующие записи?
Да. Готовим таблицу соответствий, импортируем контакты и задачи партиями и сохраняем внешние ID. Контрольная выборка проверяет связи, поля, комментарии и файлы до основного переноса.
Как проверяется готовая интеграция?
Проходим создание заявки, поиск контакта, задачу по шаблону, комментарий, файл, обратный статус, повтор и временную ошибку. Результаты фиксируем в протоколе и сверяем в обеих системах.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Интеграция Pyrus с сайтом или CRM
Связать Pyrus с сайтом или CRM
- 02Интеграция Planfix с сайтом или CRM
Настроить рабочий обмен Planfix с сайтом или CRM
- 03Интеграция двух систем по API и webhook
Расширить обмен между двумя системами по API и webhook