Техническая документация

Подключите заявки с сайта к боту в MAX

Готовая схема интеграции для HTML-форм, JavaScript, CMS и CRM. Создайте форму в боте, получите ключ и отправляйте обращения единым POST-запросом.

Начать подключение Смотреть видео
POST /api/send.php 
{
  "form_key": "YOUR_FORM_KEY",
  "comment": "Хочу консультацию"
}
Заявка доставлена в MAX
Быстрый старт

Три шага до первой заявки

01

Создайте форму в боте

В MAX отправьте команду /form Название формы. Бот вернёт уникальный form_key и ссылку Webhook.

02

Отправьте POST-запрос

Передайте данные формы на endpoint ниже. Обязательное поле только одно: form_key. Имя, телефон и email можно не указывать.

03

Проверьте заявку в MAX

Бот покажет заявку команде, а ответ API вернёт success: true.

Endpoint

Адрес для отправки

Принимает данные формы в JSON или обычном формате HTML-формы.

https://n.vlkstudio.ru/api/send.php
Примеры запросов

Выберите подходящий способ

HTML

Обычная форма

<form action="https://n.vlkstudio.ru/api/send.php" method="post">
    <input type="hidden" name="form_key" value="ВАШ_FORM_KEY">
    <textarea name="comment" placeholder="Текст заявки"></textarea>
    <button type="submit">Отправить</button>
</form>
JS

JavaScript / JSON

fetch('https://n.vlkstudio.ru/api/send.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        form_key: 'ВАШ_FORM_KEY',
        text: 'Хочу консультацию по разработке сайта.'
    })
})
    .then((response) => response.json())
    .then((result) => console.log(result));
Поля заявки

Какие данные можно отправлять

Поле Назначение
form_keyОбязательный ключ формы из команды /form.
nameИмя клиента или заголовок заявки.
phoneТелефон для связи.
emailEmail клиента.
messagecommentcommentsquestiontextсообщениекомментарийСвободный текст заявки. Можно отправить без name, phone и email; он будет доставлен в MAX дословно.
utm_sourceЛюбые UTM-метки и технические поля можно передавать дополнительно.
200

Успешный ответ

{
    "success": true,
    "lead": {
        "id": "L-1"
    }
}
?

Если заявка не отправляется

  • Проверьте, что form_key скопирован полностью.
  • Отправляйте запрос методом POST.
  • Для JSON укажите заголовок Content-Type: application/json.
  • Откройте в боте команду /forms и убедитесь, что форма существует.
Нужна наглядная инструкция?

Посмотрите настройку бота по шагам

Открыть видеоинструкцию Вернуться на главную