Вебхук Тильды
Куда вписать адрес, что приходит в запросе и почему бывают дубли
Что такое вебхук формы
Вебхук (webhook) — это адрес, на который сайт отправляет данные заполненной формы сразу после нажатия кнопки. Тильда шлёт POST-запрос с полями формы. Принимающая сторона разбирает их и создаёт заявку в CRM, задачу или бронь.
Где вписать адрес
Настройки сайта → «Формы» → «Webhook». Адрес указывается один раз на сайт, а в блоке формы выбирается нужный приёмник. Если приёмников несколько, у каждого свой адрес: заявки с разных страниц можно развести по разным сервисам.
Что придёт в запросе
Все поля формы под именами из настроек блока: name, phone, email и ваши собственные вроде date или comment. Тильда добавляет служебные поля: formid (идентификатор формы), formname и tranid (номер отправки). Имена полей задаёте вы: если поле называется «Телефон» кириллицей, так оно и придёт.
Проверка без реального клиента
Рядом с полем вебхука есть кнопка проверки: Тильда отправляет тестовый запрос с полем test. Приёмник должен ответить за пять секунд, иначе Тильда посчитает попытку неудачной и повторит отправку ещё до двух раз. Поэтому приёмник отвечает сразу, а долгую работу делает после ответа.
Почему заявка иногда приходит дважды
Из-за этих повторов. Если приёмник ответил медленно, Тильда шлёт запрос заново, и в CRM появляются две одинаковые заявки. У каждой отправки есть tranid: повтор с тем же номером мы отбрасываем, и дубли до вашего сервиса не доходят.
Обязательные требования
Адрес должен быть на https и отвечать кодом 200. Самоподписанные сертификаты и адреса на http Тильда не примет. Если сервер лежит, заявка не встаёт в очередь и не дойдёт совсем, поэтому приёмник должен быть доступен постоянно.
Если не работает
Можно ли отправлять в несколько мест сразу
Тильда позволяет завести несколько приёмников и выбрать нужный в блоке формы. Если заявка нужна и в CRM, и в мессенджере, отправьте её на один адрес, а оттуда разложите по сервисам. Тогда каждую форму не придётся настраивать дважды.
В CRM пусто, хотя форма отправляется
Чаще всего дело в именах полей: в форме поле называется «Ваш телефон», а приёмник ждёт phone. Посмотрите в журнале приёмника, что пришло. В нашем кабинете это видно поле за полем, вместе с ответом сервиса.
Шлёт ли Тильда файлы из формы
В запросе приходит ссылка на загруженный файл. Сам файл лежит на стороне Тильды: если он нужен в вашем сервисе, его скачивают отдельно.
Приёмник временно недоступен
Заявка теряется: повторов всего два, и они идут подряд. Поэтому приёмник должен отвечать всегда, а заявки сохраняться до попытки отправки в сервис. Тогда после починки их отправляют заново.