База знаний → Вебхук Тильды: настройка и что он присылает

Вебхук Тильды: настройка и что он присылает

Куда вписать адрес, что приходит в запросе и почему заявка иногда дублируется

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

Если что-то не так

Частые случаи

Можно ли отправлять в несколько мест сразу?

Тильда позволяет завести несколько приёмников и выбрать нужный в блоке формы. Если одну и ту же заявку нужно и в CRM, и в мессенджер, удобнее отправить её в один адрес, а уже оттуда разложить по сервисам — так не придётся настраивать каждую форму дважды.

Почему в CRM пусто, хотя форма отправляется?

Чаще всего дело в именах полей: в форме поле называется «Ваш телефон», а принимающая сторона ждёт phone. Посмотрите, что реально пришло, в журнале приёмника — у нас это видно в кабинете, поле за полем, вместе с ответом сервиса.

Тильда шлёт файлы из формы?

В запросе приходит ссылка на загруженный файл, а не сам файл. Ссылка живёт на стороне Тильды, и её нужно скачивать отдельно, если файл нужен в вашем сервисе.

Что делать, если приёмник временно недоступен?

Заявку это теряет: повторов всего два, и они идут подряд. Поэтому важно, чтобы приёмник отвечал всегда, а заявки сохранялись до попытки отправки в сервис — тогда после починки их можно отправить заново, ничего не потеряв.

Рядом