Trassir: настройка уведомлений в Telegram/WhatsApp через вебхуки

Trassir: настройка уведомлений в Telegram и WhatsApp через вебхуки

Коротко: если камера или регистратор на Trassir фиксирует событие (движение, периметр, триггер датчика), система может отправить уведомление в мессенджер. Ниже — практическое руководство для владельцев домов, магазинов и монтажников: как быстро настроить отправку сообщений в Telegram и варианты для WhatsApp, типичные проблемы и рабочие примеры запросов.

Что такое вебхук в Trassir и зачем он нужен

Вебхук — это HTTP-запрос, который Trassir отправляет при событии. В теле или в URL можно передать текст, ссылку на снимок и параметры камеры. Это простой способ интеграции с внешними сервисами — мессенджерами, шлюзами SMS, системами автоматики.

Коротко о вариантах интеграции

- Telegram — проще всего. Бесплатно, позволяет отправлять текст и фото (через URL или файлом). - WhatsApp — официальная API требует проверки бизнеса и шаблонов; есть платные шлюзы (Twilio, 360dialog и др.), которые упрощают задачу за деньги. - Промежуточный вариант — использовать облачный шлюз/скрипт, который принимает вебхук от Trassir и уже сам вызывает Telegram/WhatsApp API.

Настройка Telegram: шаги и примеры

1. Создать бота через BotFather в Telegram и получить токен. 2. Получить chat_id — отправьте сообщение боту и затем вызовите:

https://api.telegram.org/bot/getUpdates

или используйте бота @userinfobot. 3. В Trassir: в событии добавьте действие «HTTP-запрос» (или Webhook). Укажите метод GET или POST и URL. Примеры: Отправить текстовое уведомление:

GET https://api.telegram.org/bot/sendMessage?chat_id=&text=Alarm%20from%20Camera%20%camera%

Отправить фото по URL (если снимок доступен извне):

GET https://api.telegram.org/bot/sendPhoto?chat_id=&photo=&caption=Alarm%20%camera%

Примечания:

Telegram должна иметь доступ к URL снимка. Если ваш Trassir за NAT и снимок недоступен из интернета, Telegram не сможет его загрузить.

Если Trassir умеет передавать файл в теле (multipart) — можно отправлять photo как файл, но чаще хватает прямой ссылки. Для стабильной работы используйте HTTPS и проверьте сертификат.

WhatsApp: реалии и варианты

- Официальный путь — WhatsApp Cloud API (Meta). Требует Business Manager, подтверждения компании и настройки шаблонов для исходящих уведомлений. Запросы идут в HTTPS с Bearer-токеном и JSON-телом. Пример упрощённого запроса:

POST https://graph.facebook.com/v15.0/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <token>
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "79991234567",
  "type": "text",
  "text": {"body": "Тревога на камере 1"}
}

- Быстрый практический путь — платные шлюзы (Twilio, 360dialog, WATI и др.). Они принимают вебхук от Trassir и сами общаются с WhatsApp. Минус — стоимость и доверие к провайдеру. Плюс — меньше настроек и нет необходимости проверять бизнес.

Схема работы и типичные проблемы

Схема (упрощённо): Trassir (событие) → webhook (HTTP request) → Telegram API / шлюз → получатель Типичные проблемы и решения: - Снимок недоступен внешне — сделать проброс порта/облачный доступ или отправлять ссылку на облако Trassir. - Токен/пароль в URL — храните аккуратно, используйте HTTPS. - Ограничения WhatsApp (шаблоны) — для массовых алертов выбирайте шлюз. - Задержки — следите за временем ответа сервера; используйте асинхронные шлюзы, если много событий.

Технические примеры параметров Trassir

В Trassir можно подставлять макропеременные, например: %camera%, %event_time%, %snapshot_url%. Пример составления URL:

https://api.telegram.org/bot/sendPhoto?chat_id=&photo=%snapshot_url%&caption=Alarm%20%camera%20%event_time%

Если %snapshot_url% динамический и требует авторизации, Telegram не сможет получить снимок. Вариант — настроить временный публичный URL через облачный сервер или сделать промежуточный скрипт, который скачает и перешлёт изображение.

Сравнение: Telegram vs WhatsApp

Критерий	Telegram	WhatsApp
Стоимость	Бесплатно	Часто платно (шлюзы) / требует регистрации
Сложность настройки	Низкая	Средняя—высокая
Отправка фото	Да (по URL или файлом)	Да, но через API/шлюз
Требование к публичности снимков	Да, если по URL	Да / зависит от шлюза
Надёжность при массовых событиях	Хорошая	Лучше через платный шлюз

Безопасность и закон

- Не публикуйте токены в открытых логах. - Храните лог запросов локально ограниченное время. - Уведомления о видеонаблюдении должны соответствовать местному законодательству о приватности. Если система фиксирует общественные зоны, пометьте это визуально и документально.

Примеры сценариев использования

- Дом: движение у входа — фото в Telegram, короткая запись на облако. - Магазин: сработал датчик двери после закрытия — срочное уведомление менеджеру и запись по расписанию. - Офис: многокамерные оповещения в общий чат с указанием камеры и времени.

Чек‑лист перед запуском

• Есть ли токен бота (Telegram) или доступ к WhatsApp API?
• Chat_id получен и проверен (отправлено тестовое сообщение)?
• Снимки доступны по публичному HTTPS или есть промежуточный сервер?
• Trassir корректно подставляет макропеременные (%camera%, %snapshot_url%)?
• Проверено время реакции и дубликаты уведомлений?
• Хранение и защита токенов настроены?

Если вы планируете подключать камеры и монтировать систему, можно доверить это профессионалам — монтаж, прокладка сетей и настройка доступа часто решают проблему с публичными URL и стабильностью уведомлений. Поддержку и установку оборудования предлагает сервис профессионального монтажа: https://y-ss.ru/uslugi/ustanovka-kamer-i-sistem-videonablyudeniya-v-sankt-peterburge-i-leningradskoy-oblast Небольшая финальная мысль: для большинства задач Telegram — это быстрый и надёжный старт. Для массовых уведомлений и интеграций с корпоративными CRM имеет смысл рассмотреть платные шлюзы WhatsApp или настройку собственного промежуточного сервера, который примет вебхук от Trassir и уже сам выполняет всю авторизацию и пересылку сообщений.