#Вебхуки заявок
Вебхук принимает обращения из формы Tilda и создаёт лиды в DOMO. Откройте Настройки → Расширения и настройки Вебхуки заявок. Они доступны с правом управления вебхуками заявок или расширениями.
Для формы, которую вы собираете непосредственно в DOMO и размещаете на сайте, используйте Формы заявок. Подключение Telegram для личных уведомлений настраивается отдельно в профиле.
#Создать подключение
Нажмите Создать. Провайдер Tilda уже выбран и не редактируется.
Заполните обязательное Название, например «Заявки с лендинга». Выберите обязательные Доску лидов и Колонку для новых лидов. При смене доски заново укажите рабочую колонку.
В Ответственных лицах выберите сотрудников, которым нужно разбирать эти заявки. Они будут назначены в новых лидах. Для приёма обращений включите Активен у подключения и само расширение Вебхуки заявок.
Шаблон заголовка лида необязателен. Например, Сайт: {name|phone|Новая заявка} подставит имя, при его отсутствии — телефон, а затем запасной текст. Если шаблон пустой, используется название вебхука.
После первого сохранения в блоке Настройка в Tilda появится WEBHOOK URL. Этот адрес относится к конкретному подключению вашей компании.
#Сопоставить поля
Контакты распознаются по ключам name, email и phone. Для обычных полей Tilda Name, Email и Phone отдельное сопоставление не требуется.
Если внешняя форма использует другие ключи, добавьте строки в Сопоставление полей:
| Внешний ключ | Ключ после сопоставления |
|---|---|
client_name |
name |
client_phone |
phone |
client_email |
email |
request_text |
comment |
Это вымышленные примеры: в первом столбце укажите точный ключ, который действительно отправляет ваша форма. Сопоставление переименовывает ключ, сохраняя значение. Дополнительные непустые текстовые данные попадут в заявку, даже если не используются как контакт.
#Передать настройки в Tilda
Скопируйте WEBHOOK URL из сохранённого подключения. В настройках отправки формы на стороне Tilda нужны этот адрес и параметры из блока Настройка в Tilda:
| Поле DOMO | Что передать в настройку формы |
|---|---|
| WEBHOOK URL | Адрес приёма заявок без добавления ключа в строку URL |
| API METHOD | HEADER либо POST |
| API NAME | Для HEADER — X-Webhook-Token, для POST — webhook_token |
| API KEY | Ключ из этого подключения |
Выбор API METHOD помогает скопировать подходящее API NAME; способ передачи задаётся в отправляющей форме. При HEADER ключ передают в заголовке запроса, при POST — в поле отправляемых данных. Передача ключа через параметры URL не поддерживается.
API KEY даёт возможность отправлять заявки в компанию. Передавайте его только сотруднику, который настраивает подключение; не размещайте ключ в открытом тексте страницы или публичной инструкции.
#Проверить поступление заявки
Отправьте из подключённой формы одну пробную заявку с вымышленным именем и согласованными тестовыми контактами. Если настройщик проверяет ответ запроса, успешный результат — 200 и сообщение Вебхук принят.
В Лидах откройте выбранную доску и колонку. Найдите пробное обращение и проверьте заголовок, имя, телефон, email, дополнительные ответы и ответственных. Запрос может создать лид без контакта, поэтому одного появления карточки недостаточно для проверки сопоставления.
Переключатель Активен разрешает приём, но не подтверждает, что внешняя форма настроена правильно. После изменения адреса, ключа или полей повторите пробную отправку.
#Приостановить или сменить ключ
Выключите Активен, чтобы временно прекратить приём через одно подключение. Чтобы остановить все вебхуки компании, выключите расширение Вебхуки заявок в Расширениях. Настройки сохранятся; повторное включение возобновит приём у активных подключений. Изменение доски и колонки применяется к следующим заявкам; существующие лиды остаются на своих местах.
Для замены ключа нажмите Сгенерировать новый API KEY, сохраните подключение и передайте новый ключ в настройки формы.
После сохранения нового ключа старый перестаёт подходить. Согласуйте замену с настройщиком формы: до обновления внешней настройки новые обращения не будут приниматься. Сразу после замены отправьте пробную заявку.
#Если заявка не пришла
| Результат проверки | Что проверить |
|---|---|
| 401, «Коннектор не найден или недоступен» | Включён ли Активен, совпадает ли API KEY, верны ли API METHOD и API NAME |
| 404 | Полностью ли скопирован WEBHOOK URL, сохранено ли подключение, используется ли адрес нужной компании |
| 422, ошибка данных или назначения | Передаёт ли форма непустые данные; выбраны ли доступные доска и рабочая колонка |
| 503, расширение неактивно или недоступно | Включено ли расширение Вебхуки заявок; если включено, передайте ошибку администратору |
| 429 | Слишком частые запросы: дождитесь снятия ограничения и повторите проверку |
| 500, ошибка обработки | Проверьте, не создан ли лид, и передайте администратору время, адрес подключения и текст ошибки |
| Лид появился без имени, телефона или email | Точные внешние ключи и их сопоставление с name, phone, email |
Если одновременно переданы заголовок и POST-поле с ключом, используется заголовок. Удалите старое значение из заголовка, если настройщик перешёл на передачу через POST.