2021-06-11 21:56:03 +03:00
|
|
|
|
# OLGram
|
|
|
|
|
|
|
2021-09-11 01:34:18 +03:00
|
|
|
|
[](https://github.com/civsocit/olgram/actions?workflow=Linter)
|
|
|
|
|
|
[](https://github.com/civsocit/olgram/actions?workflow=Deploy)
|
2021-09-22 21:34:15 +03:00
|
|
|
|
[](https://olgram.readthedocs.io)
|
|
|
|
|
|
|
|
|
|
|
|
[@olgram](https://t.me/olgrambot) - конструктор ботов обратной связи в Telegram
|
|
|
|
|
|
|
|
|
|
|
|
Документация: https://olgram.readthedocs.io
|
2021-09-11 01:26:22 +03:00
|
|
|
|
|
2021-09-16 03:20:31 +03:00
|
|
|
|
## Возможности и преимущества Olgram Bot
|
|
|
|
|
|
|
2021-09-16 03:32:52 +03:00
|
|
|
|
* **Общение с клиентами**. После подключения бота, вы сможете общаться с вашими пользователями бота через диалог с
|
|
|
|
|
|
ботом, либо подключенный отдельно чат, где может находиться ваш колл-центр.
|
|
|
|
|
|
* **Все типы сообщений**. Livegram боты поддерживают все типы сообщений — текст, фото, видео, голосовые сообщения и
|
|
|
|
|
|
стикеры.
|
2021-09-16 03:20:31 +03:00
|
|
|
|
* **Open-source**. В отличие от известного проекта Livegram код нашего конструктора полностью открыт.
|
|
|
|
|
|
* **Self-hosted**. Вы можете развернуть свой собственный конструктор, если не доверяете нашему.
|
2021-09-16 03:32:52 +03:00
|
|
|
|
* **Безопасность**. В отличие от Livegram, мы не храним сообщения, которые вы отправляете в бот. А наши сервера
|
|
|
|
|
|
располагаются в Германии, что делает проект неподконтрольным российским властям.
|
2021-09-16 03:20:31 +03:00
|
|
|
|
|
|
|
|
|
|
|
2021-09-16 03:32:52 +03:00
|
|
|
|
По любым вопросам, связанным с Olgram, пишите в наш бот обратной связи
|
|
|
|
|
|
[@civsocit_feedback_bot](https://t.me/civsocit_feedback_bot)
|
2021-09-16 03:20:31 +03:00
|
|
|
|
|
|
|
|
|
|
### Для разработчиков: сборка и запуск проекта
|
|
|
|
|
|
|
|
|
|
|
|
Вам потребуется собственный VPS или любой хост со статическим адресом или доменом.
|
2021-09-22 19:19:11 +03:00
|
|
|
|
* Создайте файл .env по образцу example.env. Вам нужно заполнить переменные:
|
2021-09-16 03:32:52 +03:00
|
|
|
|
* BOT_TOKEN - токен нового бота, получить у [@botfather](https://t.me/botfather)
|
2021-09-16 03:25:43 +03:00
|
|
|
|
* POSTGRES_PASSWORD - любой случайный пароль
|
|
|
|
|
|
* WEBHOOK_HOST - IP адрес или доменное имя сервера, на котором запускается проект
|
2021-09-16 03:20:31 +03:00
|
|
|
|
* Сохраните файл docker-compose.yaml и соберите его:
|
|
|
|
|
|
```
|
|
|
|
|
|
sudo docker-compose up -d
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
В docker-compose.yaml минимальная конфигурация. Для использования в серьёзных проектах мы советуем:
|
|
|
|
|
|
* Приобрести домен и настроить его на свой хост
|
2021-09-16 03:32:52 +03:00
|
|
|
|
* Наладить реверс-прокси и автоматическое обновление сертификатов - например, с помощью
|
|
|
|
|
|
[Traefik](https://github.com/traefik/traefik)
|
2021-09-16 03:20:31 +03:00
|
|
|
|
* Скрыть IP сервера с помощью [Cloudflire](https://www.cloudflare.com), чтобы пользователи ботов не могли найти IP адрес
|
|
|
|
|
|
хоста по Webhook бота.
|
|
|
|
|
|
|
|
|
|
|
|
Пример более сложной конфигурации есть в файле docker-compose-full.yaml
|
