olgram/README.md

45 lines
3.4 KiB
Markdown
Raw Normal View History

2021-06-11 21:56:03 +03:00
# OLGram
2021-09-16 03:20:31 +03:00
[@olgram](https://t.me/olgrambot) - конструктор ботов обратной связи в Telegram
2021-06-11 21:56:03 +03:00
2021-09-11 01:34:18 +03:00
[![Static Analysis Status](https://github.com/civsocit/olgram/workflows/Linter/badge.svg)](https://github.com/civsocit/olgram/actions?workflow=Linter)
[![Deploy Status](https://github.com/civsocit/olgram/workflows/Deploy/badge.svg)](https://github.com/civsocit/olgram/actions?workflow=Deploy)
2021-09-11 01:26:22 +03:00
2021-09-16 03:20:31 +03:00
![Logo](media/logo1_big.png)
2021-06-11 21:56:03 +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 или любой хост со статическим адресом или доменом.
* Создайте файл .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