Skip to content

About

Принимать webhook-запросы от Яндекс.Форм и пересылать данные в Telegram-чат

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

form2telegram

Test Release

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
Loading

Webhook-мост для пересылки данных из Яндекс.Форм в Telegram.

Быстрый старт

Docker (готовый образ)

docker run -d \
  -p 8080:8080 \
  -e TELEGRAM_BOT_TOKEN=your_token \
  -e TELEGRAM_CHAT_ID=your_chat_id \
  ghcr.io/dapi/form2telegram:latest

Docker Compose

cp .env.example .env
# Отредактируйте .env файл

docker compose up -d

Локально

export TELEGRAM_BOT_TOKEN=your_token
export TELEGRAM_CHAT_ID=your_chat_id
go run main.go

API

POST /yandex-form-webhook

Принимает JSON от Яндекс.Форм:

{
  "answers": [
    {"key": "email", "value": "test@example.com"},
    {"key": "Имя", "value": "Иван"}
  ]
}

Ответы:

Код Описание
200 Сообщение отправлено в Telegram
400 Невалидный JSON
405 Метод не POST
500 Ошибка отправки в Telegram (сеть, неверный токен и т.д.)

GET /health

Health-check эндпоинт.

Настройка Яндекс.Форм

  1. Создайте форму в Яндекс.Формах
  2. Перейдите в «Интеграции» → «HTTP-запрос»
  3. Выберите «Запрос заданным методом», метод POST
  4. Укажите URL: https://your-domain.com/yandex-form-webhook
  5. В теле запроса укажите JSON с переменными формы

Документация:

Переменные окружения

Переменная Обязательная Описание
TELEGRAM_BOT_TOKEN Да Токен Telegram бота
TELEGRAM_CHAT_ID Да ID чата для отправки
PORT Нет Порт сервера (по умолчанию 8080)

Формат сообщения в Telegram

Данные формы отправляются в 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

About

Принимать webhook-запросы от Яндекс.Форм и пересылать данные в Telegram-чат

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages