Демо-работа (концепт, не клиентский проект)
Интеграции и вебхукиК портфолио

Заявка с сайта сразу в Telegram и в таблицу

Маленький сервер принимает данные формы (вебхук), проверяет их, пишет строку в CSV и присылает уведомление в Telegram. Так же связываются сайты, CRM, таблицы и боты.

Честно: это демо-концепт, не клиентский проект. Код проверен локальным тестом с подменённой отправкой в Telegram (4 теста проходят). Реальная отправка в Telegram с настоящим токеном в этой работе не проверялась, токенов и ключей в файлах нет.

Как это работает

Схема: форма сайта, вебхук-сервер, Telegram и CSV Форма на сайте отправляет JSON на вебхук-сервер. Сервер проверяет данные, записывает строку в CSV-файл и отправляет сообщение через Telegram Bot API в чат владельца. Форма на сайте имя, телефон, текст POST JSON Вебхук-сервер Python, http.server секрет, проверка полей, лимит размера Telegram Bot API сообщение владельцу leads.csv строка в таблицу

На узком экране схему можно прокрутить в стороны. То же словами:

  1. Форма на сайте отправляет данные (JSON) на адрес вебхука.
  2. Сервер проверяет секрет, размер и обязательные поля.
  3. Сервер дописывает строку в файл leads.csv.
  4. Сервер отправляет сообщение владельцу через 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 или база данных. Это согласуется под задачу.