Интеграция 1С-Битрикс и Планадо

В Планадо создаётся наряд: клиент с именем и фамилией (имя делим по первому пробелу), адрес работ одной строкой.

Из настройки интеграции: scheduled_duration.minutes.

Запрос в Планадо: POST https://api.planado.ru/v2/jobs.

<script src="https://woove.ru/connect.js" data-hook="<ваш ключ>"></script>
<!-- форма компонента form.result.new: тегу form добавлен data-woove -->
<form name="SIMPLE_FORM_1" data-woove="Вызов мастера">
  <input type="text" name="form_text_1">  <!-- Имя -->
  <input type="text" name="form_text_2" required>  <!-- Телефон -->
  <input type="text" name="form_email_3">  <!-- Почта -->
  <textarea name="form_textarea_4"></textarea>  <!-- Комментарий -->
  <input type="text" name="form_text_9">  <!-- Адрес -->
  <input type="date" name="form_date_5">  <!-- Дата -->
  <input type="text" name="form_text_6">  <!-- Время -->
  <input type="submit" name="web_form_submit" value="Отправить">
</form>

1. Доступ в Планадо

   Ключ API Планадо из раздела «Настройки → Интеграции».

   • Кабинет Планадо → Настройки → Интеграции → API
   • Если поле с ключом пустое, нажмите кнопку обновления рядом с ним — ключ создастся
   • Шаблон наряда указывается его uuid. Нажмите «Проверить ключ» на вкладке «Настройка»: мы покажем до пяти шаблонов с uuid
   • Участок пишется названием, как он называется в Планадо
   • API включено начиная с тарифа «Про»; на младших тарифах ключ не выдаётся

   Где взять доступ к Планадо

2. Интеграция в кабинете

   В кабинете откройте «Connect» и подключите Планадо. На вкладке «Настройка» в поле «Источник заявок» выберите «1С-Битрикс» и скопируйте ключ из поля «Ключ для скрипта». Там же заполните блок «Доступ».

3. Отправка из 1С-Битрикс

   • Веб-формы Битрикса не отправляют вебхуки. Подключите скрипт Woove в шаблоне сайта перед </body> и добавьте формам атрибут data-woove.
   • Другой способ: обработчик события формы OnAfterResultAdd, который отправляет POST на https://woove.ru/hook/bitrix/<ваш ключ> с полями формы.
   • Для CRM-форм Битрикс24 настройте робота «Отправить вебхук» на https://woove.ru/hook/bitrix/<ваш ключ>.

   Скрипт Woove перехватывает отправку формы и отменяет обычную. Если результат нужен и в Битриксе, отправляйте заявку на стороне сервера. Серверный путь: обработчик события OnAfterResultAdd модуля «Веб-формы» отправляет POST на адрес вебхука. Заявка сохраняется в Битриксе и уходит в Woove. Сайты на Битриксе часто работают в кодировке windows-1251. При отправке из PHP переведите значения в UTF-8 через iconv, иначе текст придёт нечитаемым. Скрипт Woove отправляет JSON в UTF-8 независимо от кодировки страницы.

   Формы компонента main.feedback уходят через AJAX. Там штатная обработка сохраняется: заявка попадёт и в Битрикс, и в Woove.

   Для Планадо добавьте в веб-форму:

   • вопрос «Адрес»: поле придёт с именем вида form_text_N
   • вопрос «Дата»: поле придёт с именем вида form_date_N
   • вопрос «Время»: поле придёт с именем вида form_text_N

4. Поля формы

   На вкладке «Настройка» в блоке «Поля формы» впишите:

   • «Имя»: form_text_1
   • «Телефон»: form_text_2
   • «Почта»: form_email_3
   • «Комментарий»: form_textarea_4
   • «Адрес работ»: form_text_9
   • «Дата»: form_date_5
   • «Время»: form_text_6

   Номер в имени поля свой у каждой формы: откройте страницу с формой и посмотрите атрибут name у поля в коде.

5. Проверка

   Отправьте веб-форму на сайте. На вкладке «Заявки» у неё будет статус «Черновик» и то, что уйдёт в Планадо. Затем выключите «Черновой режим» на вкладке «Настройка».

   1С-Битрикс и Woove Connect: заявки с форм в CRM и мессенджеры