flowchart LR
A[Яндекс.Формы] -->|POST JSON| B[form2telegram]
B -->|Telegram API| C[Telegram Chat]
style A fill:#fc0,stroke:#333
style B fill:#4a9eff,stroke:#333,color:#fff
style C fill:#0088cc,stroke:#333,color:#fff
Webhook-мост для пересылки данных из Яндекс.Форм в Telegram.
docker run -d \
-p 8080:8080 \
-e TELEGRAM_BOT_TOKEN=your_token \
-e TELEGRAM_CHAT_ID=your_chat_id \
ghcr.io/dapi/form2telegram:latestcp .env.example .env
# Отредактируйте .env файл
docker compose up -dexport TELEGRAM_BOT_TOKEN=your_token
export TELEGRAM_CHAT_ID=your_chat_id
go run main.goПринимает JSON от Яндекс.Форм:
{
"answers": [
{"key": "email", "value": "test@example.com"},
{"key": "Имя", "value": "Иван"}
]
}Ответы:
| Код | Описание |
|---|---|
| 200 | Сообщение отправлено в Telegram |
| 400 | Невалидный JSON |
| 405 | Метод не POST |
| 500 | Ошибка отправки в Telegram (сеть, неверный токен и т.д.) |
Health-check эндпоинт.
- Создайте форму в Яндекс.Формах
- Перейдите в «Интеграции» → «HTTP-запрос»
- Выберите «Запрос заданным методом», метод POST
- Укажите URL:
https://your-domain.com/yandex-form-webhook - В теле запроса укажите JSON с переменными формы
Документация:
- Автоматические действия — обзор интеграций
- HTTP-запросы — настройка webhook и структура данных
| Переменная | Обязательная | Описание |
|---|---|---|
TELEGRAM_BOT_TOKEN |
Да | Токен Telegram бота |
TELEGRAM_CHAT_ID |
Да | ID чата для отправки |
PORT |
Нет | Порт сервера (по умолчанию 8080) |
Данные формы отправляются в Markdown-формате:
*email:* test@example.com
*Имя:* Иван
*Телефон:* +7 999 123 45 67
Специальные символы Markdown (*, _) в значениях экранируются.
Сервис пишет логи в stdout:
2025/01/15 10:30:00 Starting server on :8080
2025/01/15 10:30:05 POST /yandex-form-webhook 45.123ms
2025/01/15 10:30:10 Failed to send message: send request: connection refused
Что логируется:
- Старт и остановка сервера
- Каждый HTTP-запрос (метод, путь, время выполнения)
- Ошибки парсинга JSON и отправки в Telegram