Забурившись в гуиды я понял, что есть два решения данной проблемы, первый заключается в пробросе портов, а второй в использовании сторонних сервисов. Я решил не мучать себя и не разбираться в пробросе портов, поэтому второй вариант – мой выбор.

Так вот, углубившись по самое не могу в этот ваш интернет и языковые модельки я нашел сервис, который называется ngrok (ссылку не буду оставлять, без проблем самостоятельно найдете в интернете), который позволял для выбранного порта (3000, 8080, 8081 и т.д.) получить публичный url адрес. Ну и усе, теперь я могу этот публичный url адрес указывать где угодно и когда угодно, ведь я уже взрослый.

Давайте приведу непосредственно примеры использования функционала ngrok. Если вы создаете телеграм мини-приложение, как это сделал я, встроив чат-рулетку в тг  t.me/Socionyx_Bot/socionyx (это что, опять нативная интеграция? Затестите пацантре, норм получилось), вам для запуская приложения через бота, в настройках же бота, понадобится указать url адрес. Вы либо указываете url адрес, который приобрели у соответствующего провайдера за денежку (об этом я писал тутъ). Либо, как вы уже догадались, используете url от ngrok, для тестирования вашего приложения этого будет более чем достаточно. Еще один способ использования заключается в том, что кроме url ngrok позволяет сгенерировать вам ssh, который я использовал для удаленного доступа к своей raspberry pi (о чем я хочу рассказать в отдельном цикле статей).

Но, пришла беда, откуда не ждали. Сервис ngrok стал блокировать доступ с российских ip адресов, плак-плак.

Благо, альтернатива нашлась достаточно быстро и неожиданно, я всего лишь стал использовать старый советский…Visual Studio Code. Оказалось, что эта среда разработки позволяет также получать внешний url адрес для необходимым вам портов. В терминале выберите вкладку port, затем нажмите на Forwar a Port, после чего укажите необходимый для внешнего доступа порт.

После всех манипуляций вы без проблем сможете использовать url адрес из графы Forwarded Address для ваших темных делишек, хе-хе-хе (нет).

А на этом все, пасаны и пасанята, не забываем, у меня есть telegram канал t.me/socionyxchannel, где я пишу про будни разработчика.

1. Это телеграм-бот в котором текстовое или голосовое сообщение боту превращается в краткую осмысленную заметку или напоминание. Если сказать ему "Мне надо через час погулять собакой", то через час он вам пришлет напоминание "Погуляй с собакой" ( Можно сказать что нужно каждый день гулять собакой в 6 вечера и будет каждый вечер напоминать автоматом)

2. Дни рождения можно вписать туда родных и друзей - будет напоминать о них каждый год.

3. Утром присылает сводки по планам на день + прогноз погоды в вашем городе + дни рождения у кого в течении недели будут.

4. Список покупок можно создать просто написав ему (или сказав) что надо купить:
кило картошки, помидоры и что вам там надо. Создаст список который можно отмечать галочками ( со всеми параметрами к продукту)

5. Списком можно поделиться с мужем/женой и вы оба видите что кто купил и когда список был закрыт

Клевый же проектик вышел без лишних действий, бесплатный, хороший аналог тому что сейчас на рынке платное мировое так сказать.

Решил я с этим проектом в народ пойти - собрать себе так сказать обратную связь, популярность там все дела) Думал даже платные функции включить, зарабатывать. И мой наивный мир столкнулся с суровой реальностью.

В телеграм каналах (маленьких и по теме про ботов) - 2к пост

Статьи пишешь - пол года надо писать как чОрт, что бы люди увидели

ВК, Свой канал, Дзен че там еще надо - кому оно надо никто никуда не пойдет без раскрутки о чем вы. Как был я один подписчик - так им и остаюсь)

Пикабу (странно как-то для меня) стал давать мне по 20 пользователей за каждую статью ( совсем однотипную про бота с описаниями функций) По ниточке 400 человек собрал - пользуются пишут, красавчики.

Сижу мечтаю, что из моих 400 пользователей авось кто-то кому-то покажет бота и полетят пользователи) Жду еще)

Откинул я идею с монетизации - сделал в боте кнопку просто "Получить VIP" просто кнопкой которая просто дает VIP. Решил просто ну пусть идут пусть пользуются люди.

Да, я плачу за бота деньги, плачу Яндексу за распознавание текста, китайцам плачу за ИИ, хостингу плачу за бота, плачу за домен, за админку ну тысячи полторы в месяц выходит на сегодня.

Я просто расстроен немного тем, что люди визжат от откровенного шлак-контента и их создатели зарабатывают на этих людях. Показывают понты народу и получают еще больше восторга и реклам. Все довольны? Или я старый и тупой скуф, который наивняком пришел тут жаловаться.

Я приглашаю всех бесплатно пойти и посмотреть мою маленькую домашнюю теплую идею, которая сделана для ваш, для меня, для моей жены даже в большей степени, что бы я увидел как людям еще не пофиг на что то адекватное. Платить ни за что вам не придется. Донаты да сделал, скидывали немного, на хостинг все положил с запасом.

Спасибо. Писал сам, от души из головы как думаю.

Прошло уже несколько месяцев с последнего обновления, и бот за это время получил вдвое больше звёзд на GitHub, что очень мотивирует продолжать развитие и поддержку проекта.

За последний месяц ко мне поступило несколько запросов расширить функционал бота за счёт подключения новых источников трафика. Изначально я думал добавить интеграции с популярными мессенджерами, такими как WhatsApp или Viber. Но в итоге решил, что в первую очередь стоит реализовать API, чтобы вы сами могли подключать любые свои источники.

В этой статье расскажу о новом API для подключения внешних источников — живых чатов, CRM и других систем, а также о других важных обновлениях и планах на будущее.

Предисловие

Для тех, кто не знаком с проектом: TG Support Bot — это бот на Laravel, который объединяет клиентов и менеджеров через Telegram и ВКонтакте, скрывая личные аккаунты и маршрутизируя общение через темы в Telegram-группе.

https://github.com/prog-time/tg-support-bot

Пользователь пишет боту, сообщение автоматически пересылается в выделенную тему для менеджеров, а их ответы возвращаются обратно от имени бота — так сохраняется приватность и удобство общения.

Буду благодарен, если вы поддержите мой проект ⭐ на GitHub!

Руководство по установки

Я записал видео-инструкцию для установки данного решения на VPS с предустановленным Docker Compose.

Youtube - https://youtu.be/yNiNtFWOF2w

Rutube - https://rutube.ru/video/bdd0cc5ab4e13530fd7e0c2413931211/

ВК Видео - https://vkvideo.ru/video-141526561_456239132

Обратная связь

Для улучшения коммуникации с пользователями, я создал группу в Telegram, в которой вы можете задавать свои вопросы и писать предложения по расширению функционала.

https://t.me/pt_tg_support

Также сюда будут публиковаться новости по выпуску обновлений.

API — не альтернатива мессенджерам, а универсальный инструмент

Хочу сразу уточнить: разработка API не заменяет расширение списка поддерживаемых мессенджеров и соцсетей. Я продолжаю работать над интеграциями с ними и буду добавлять новые источники трафика.

Однако API необходим для подключения кастомных источников — живых чатов, CRM-систем, форм на сайте и других нестандартных каналов.

Что входит в первую версию API?

В API реализованы базовые маршруты для работы с сообщениями:

• GET api/external/messages — получение списка сообщений с возможностью фильтрации

• GET api/external/messages/{id_message} — получение конкретного сообщения по ID

• POST api/external/messages — отправка нового сообщения

• PUT api/external/messages — изменение существующего сообщения

• DELETE api/external/messages — удаление сообщения

Для работы с API необходимо создать пользователя и сгенерировать для него API-токен. Рекомендую создавать отдельного пользователя под каждый источник.

Создать пользователя и токен можно командой:

Также нужно прикрепить к источнику ресурс, куда будут поступать сообщения от обработчика.

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

Процесс довольно простой:

1. На вашей стороне генерируется уникальный ID пользователя — это может быть хэш ключ или любой уникальный идентификатор.

2. При отправке сообщения в тело запроса передаются: ID пользователя, код источника, текст сообщения и, при необходимости, файлы.

3. Система идентифицирует пользователя или создаёт новую запись, если это первое сообщение от него.

4. Сообщение из вашего источника направляется в Telegram-группу поддержки.

Менеджеры в группе, как и раньше, могут отвечать любыми типами сообщений. Текст отправляется как текст, остальные — конвертируются в файлы. В названии темы указывается ID клиента и источник сообщения.

Таким образом, вы легко сможете подключить практически любой внешний источник к вашему боту.

Подробная инструкция по работе с API уже есть в разделе wiki на GitHub.

Добавлены новые консольные команды

Я добавил несколько полезных консольных команд.

php artisan telegram:set-webhook

Artisan команда, которая производит подключения хука бота к вашему проекту. Ранее это делалось через отправку запроса в telegram или по специальной ссылке, а теперь это можно сделать запустив команду в консоле.

php artisan app:generate-token

Команда, которая генерирует токен для подключения к API вашего бота. Вы можете подключить неограниченное количество источников графика и для каждого создать уникальный токен.

Swagger для API

Для API был разработан генератор swagger документа.

Ранее я хотел использовать готовое решение для генерации swagger документации, но большинство решений очень сильно нагромождают код. Поэтому я решил написать собственный генератор, который собирает документацию.

Принцип прост! Вы описываете документацию по частям в resources/swagger. Важно граматно подходить к именованию файлов и компонентов.

После создания структуры, вы запускаете artisan команду и документация собирается в единый документ.

На выходе вы получаете 2 версии документации

1. В формате json, которую можно использовать для нейросетей или программ

2. В формате Swagger-ui для просмотра в браузере

Мелкие доработки

• Улучшено логирование ошибок — все логи теперь доступны в Grafana;

• Исправил баги, о которых вы писали в Issues;

• Добавил контейнер redisinsight для просмотра Redis данных через WEB интерфейс;

• Переписал инструкции для подключения и настройки бота;

Спасибо всем за поддержку и обратную связь! Продолжаю работать над улучшениями и буду рад новым предложениям и вопросам.

Если нужно, могу помочь с примерами использования API или подсказать, как правильно настроить интеграцию.

• Пересылаешь сообщение от жены: "Купи, пожалуйста, хлеб, молоко, сметану и корм коту". Бот видит ключевое слово "купи", понимает, что это список покупок, и формирует его в виде удобного чек-листа. Если список общий (например, со второй половинкой), то когда один вычеркивает пункт, он вычеркивается у всех.

• Просто пишешь мысль: "Идея для стартапа: доставка горячих пельменей дронами". Он сохраняет это как обычную заметку.

Короче, получился такой внешний жесткий диск для мозга.

Недавно допилил еще пару фич. Во-первых, прикрутил погоду к утренней сводке (для тех, кто пользуется расширенной версией). Теперь я знаю, надевать шорты или валенки, просто взглянув на план дел.

А во-вторых, добавил немного фана. Если написать боту "мне скучно", он не пытается это сохранить, а включает режим саркастичного помощника и выдает какую-нибудь дичь, чтобы поднять настроение. Вчера он предложил мне провести фотосессию для моего кактуса в стиле "нуар". Я на полном серьезе потратил на это 15 минут.

Зачем я это все пишу?

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

Бот бесплатный, но с лимитами, чтобы я не улетел в трубу, оплачивая API. Для тех, кому нужно больше, есть VIP, который пока что можно получить просто нажав на кнопку в главном меню

Всем спасибо, кто дочитал

з.ы. Бот называется VoiceNote AI у него и сайт есть и сейчас я уже завершаю работу над веб-зеркалом для бота и мобильным приложением. Пикабушники очень хорошо помогли развить проект. Спасибо за каждый переход, за каждую нажатую кнопку.