#Уведомления о заявках
Заявка с формы всегда сохраняется в справочник «Заявки». Уведомление — сверх того: чтобы не проверять панель каждые полчаса.
Настройки → Настройки API → Уведомления о заявках.
| Поле | Что это |
|---|---|
| Токен бота | выдаёт @BotFather |
| Чат | -100… для группы или канала, @имя для публичного |
Это не тот же бот, что публикует записи в канал. Уведомления приходят в рабочую переписку, анонсы — на публику; путать их нельзя, поэтому и настройки разные. Второй бот описан на странице «Публикация записей».
#Как завести бота
- Написать
@BotFather, команда/newbot. - Придумать имя и адрес бота — в ответ придёт токен вида
123456789:AAF…. - Завести группу для заявок и добавить в неё бота.
- Узнать номер чата. Проще всего — добавить в группу
@getmyid_botили открытьhttps://api.telegram.org/bot<токен>/getUpdatesпосле любого сообщения в группе. - Вписать оба значения в панель и нажать «Проверить связь».
Для канала бот должен быть в нём администратором — иначе Telegram откажет.
#Что приходит в чат
| Событие | Сообщение |
|---|---|
| Заявка с формы | заголовок формы и все её заполненные поля |
| Заказ оплачен | номер заказа и сумма |
| Заявка не сохранилась | текст заявки и причина сбоя |
Последнее — страховка. Если база отказала, заявка всё равно уходит в чат: телефон клиента дороже стройности журнала.
Сбой отправки не влияет на ответ посетителю.
Заявка уже в базе, и недоступный Telegram — забота владельца сайта, а не человека, который заполнил форму. Ему в любом случае покажут «спасибо». Ошибка отправки пишется в журнал сервера.
По той же причине у запроса к Telegram стоит ограничение по времени: пять секунд на ответ, три на соединение. Без него недоступный Telegram подвешивал бы отправку формы целиком.
#Кто отправляет уведомления
| Источник | Настраивается |
|---|---|
| Форма из решения «Формы» | строкой telegram в действиях формы |
| Форма, встроенная в тему | всегда, отдельной настройки нет |
| Магазин: оплата заказа | всегда |
#Что чаще всего идёт не так
«Проверка проходит, заявки не приходят». Проверка говорит, что бот
жив и чат доступен. Она не говорит, что форма просит отправить
уведомление: у формы из конструктора нужна строка telegram в поле
«Действия после отправки».
«Bad Request: chat not found». Чат указан неверно либо бота не
добавили в группу. Номер группы начинается с -100, минус — часть
номера.
«Forbidden: bot is not a member of the channel chat». Для канала бота мало добавить — он должен быть администратором.
«Приходит „Заявка №417“ и больше ничего». Так выглядит уведомление, когда у справочника заявок нет заполненных полей, кроме номера. Проверьте, что поля формы совпадают по коду с полями справочника: то, чего в справочнике нет, ядро не запишет и в уведомление не поставит.