Начало работы

Быстрый старт

5 шагов — от регистрации до первой заявки в Telegram.

Шаг 1 — Создайте сайт

1

Зарегистрируйтесь на form-hook.com и войдите в дашборд.

2

Нажмите Добавить сайт. Укажите название и домен (example.com — без протокола).

3

Скопируйте siteKey — он понадобится на следующих шагах.

Шаг 2 — Подтвердите домен

Верификация подтверждает, что вы владеете доменом. Без неё endpoint не будет принимать заявки с вашего домена.

1

В настройках сайта → вкладка Верификация домена → нажмите Начать верификацию.

2

Добавьте TXT-запись в DNS вашего домена. Имя и значение записи показаны в интерфейсе.

3

Нажмите Проверить. DNS-распространение может занять до 24 часов.

Для локальной разработки верификация не обязательна. Добавьте http://localhost:PORT в список разрешённых доменов в настройках сайта.

Шаг 3 — Подключите Telegram

1

Добавьте @FormHookBot в ваш Telegram-чат или канал.

2

Узнайте chat_id: отправьте любое сообщение в чат, затем откройте https://api.telegram.org/bot<TOKEN>/getUpdates. Или используйте @userinfobot.

3

В настройках сайта → Каналы → добавьте Telegram-канал, укажите chat_id.

Шаг 4 — Вставьте код

Простейший вариант — декларативный режим SDK. Добавьте атрибут data-formhook к форме и подключите скрипт:

html
<form
  data-formhook
  data-sitekey="ВАШ_SITE_KEY"
  data-success-redirect="/thanks">

  <input name="name" placeholder="Имя" required />
  <input name="email" type="email" placeholder="Email" required />
  <textarea name="message" placeholder="Сообщение"></textarea>

  <!-- Капча (если включена в настройках сайта) -->
  <div class="formhook-captcha"></div>

  <button type="submit">Отправить</button>
</form>

<script src="https://app.form-hook.com/sdk/v3/loader.min.js" async defer></script>

Или используйте action="" без SDK:

html
<form
  method="post"
  action="https://app.form-hook.com/api/c1/sites/ВАШ_SITE_KEY/submissions">
  <input name="name" placeholder="Имя" required />
  <input name="email" type="email" placeholder="Email" required />
  <button type="submit">Отправить</button>
</form>

Шаг 5 — Отправьте тестовую заявку

Заполните форму на вашем сайте и отправьте. Проверьте:

  • Заявка появилась в дашборде FormHook → раздел Заявки
  • Пришло уведомление в Telegram
  • В delivery log — статус delivered

Если что-то не работает — смотрите Troubleshooting.

Хотите протестировать без сайта? Отправьте curl-запрос напрямую — см. API Reference.