Заявка с сайта сразу в Telegram и в таблицу
Маленький сервер принимает данные формы (вебхук), проверяет их, пишет строку в CSV и присылает уведомление в Telegram. Так же связываются сайты, CRM, таблицы и боты.
Честно: это демо-концепт, не клиентский проект. Код проверен локальным тестом с подменённой отправкой в Telegram (4 теста проходят). Реальная отправка в Telegram с настоящим токеном в этой работе не проверялась, токенов и ключей в файлах нет.
Как это работает
На узком экране схему можно прокрутить в стороны. То же словами:
- Форма на сайте отправляет данные (JSON) на адрес вебхука.
- Сервер проверяет секрет, размер и обязательные поля.
- Сервер дописывает строку в файл leads.csv.
- Сервер отправляет сообщение владельцу через Telegram Bot API.
Пример данных
Контакты ниже заменены плейсхолдерами: настоящих данных в демо нет.
1. Запрос с сайта (JSON)
POST /webhook
X-Webhook-Secret: <секрет из настроек>
{
"name": "Анна",
"phone": "[ТЕЛЕФОН]",
"message": "Хочу записаться на консультацию",
"source": "landing"
}2. Сообщение в Telegram
Новая заявка Имя: Анна Телефон: [ТЕЛЕФОН] Сообщение: Хочу записаться на консультацию Источник: landing
3. Строка в CSV
received_at,name,phone,email,message,source <дата-время>,Анна,[ТЕЛЕФОН],,Хочу записаться на консультацию,landing
Код и запуск
Файлы: webhook_to_telegram.py (сервер, только стандартная библиотека Python) и test_webhook.py (локальная проверка без сети).
set TELEGRAM_BOT_TOKEN=... # токен из @BotFather set TELEGRAM_CHAT_ID=... # куда слать уведомления set WEBHOOK_SECRET=... # необязательно, но рекомендуется python webhook_to_telegram.py python test_webhook.py # проверка с заглушкой Telegram
Что заложено в код
- Настройки только из переменных окружения, в файлах нет токенов.
- Проверка секрета в заголовке, лимит размера запроса 16 КБ, проверка обязательных полей.
- Защита CSV от формул Excel (ячейки, начинающиеся с =, +, -, @).
- Если Telegram недоступен, заявка всё равно сохраняется в CSV, а ответ сообщает об этом.
- В журнал не пишутся тексты заявок и токен.
В боевом проекте сервер ставится за HTTPS (обратный прокси), а вместо CSV могут быть Google Таблицы, CRM или база данных. Это согласуется под задачу.