Интеграция HTML-формы и Calltouch

В отчёте «Заявки» Calltouch появляется обращение: название формы из настройки, имя, телефон в виде 7XXXXXXXXXX.

Из настройки интеграции: subject, requestNumber.

Запрос в Calltouch: POST https://api.calltouch.ru/calls-service/RestAPI/requests/51234/register/.

<form action="https://woove.ru/hook/html/<ваш ключ>" method="POST">
  <input name="Name" placeholder="Имя">
  <input name="Phone" type="tel" placeholder="Телефон">
  <input name="Email" type="email" placeholder="Почта">
  <textarea name="Comment" placeholder="Комментарий"></textarea>
  <input type="hidden" name="ct_session_id" value=""><!-- значение куки ct_session_id -->
  <input type="hidden" name="_redirect" value="https://ваш-сайт.ru/spasibo">
  <input name="_gotcha" style="display:none" tabindex="-1" autocomplete="off">
  <button>Отправить</button>
</form>

1. Доступ в Calltouch

   Номер сайта в личном кабинете Calltouch. Ключ не нужен.

   • Личный кабинет Calltouch → настройки сайта → номер сайта (site id)
   • Ключ доступа не нужен: для создания заявок Calltouch его не требует
   • Убедитесь, что в настройках проекта включена передача данных по API, иначе запросы будут отклоняться
   • Добавьте в форму скрытое поле со значением куки ct_session_id — по нему заявка склеится с рекламным визитом
   • Проверочного вызова у Calltouch нет: любой запрос к этому адресу создаёт настоящую заявку. Поэтому проверяйте пробной заявкой со своей формы, пока включён черновой режим

   Где взять доступ к Calltouch

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

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

3. Отправка из HTML-формы

   • В теге form укажите action="адрес вебхука из кабинета" и method="POST".
   • Назовите поля name="Name", name="Phone", name="Email", name="Comment" или впишите свои имена в «Поля формы».
   • Добавьте скрытое поле _redirect с адресом страницы «спасибо», после отправки посетитель попадёт туда. Без него откроется страница благодарности Woove.

   Браузер отправляет форму как application/x-www-form-urlencoded. Скрипты и библиотеки не нужны. Служебные поля управляют поведением и в заявку не попадают. Файлы не принимаются: enctype="multipart/form-data" форме не ставьте. Тело запроса ограничено 256 КБ.

   • _redirect: полный адрес страницы «спасибо»: после отправки браузер уходит туда
   • _gotcha: ловушка для роботов: если поле заполнено, заявка не создаётся

   Ловушку _gotcha спрячьте стилями: люди её не видят, роботы заполняют.

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

   • <input type="hidden" name="ct_session_id" value=""><!-- значение куки ct_session_id -->

4. Поля формы

   Любые другие поля тоже приходят и видны в заявке.

   Менять ничего не нужно: имена полей совпадают с теми, что Woove ждёт по умолчанию.

5. Проверка

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

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