71 lines
2.0 KiB
Markdown
71 lines
2.0 KiB
Markdown
# MikoPBX Public SIP Telephony Bot
|
||
|
||
Telegram-бот для публичной SIP-телефонии на MikoPBX с полной синхронизацией.
|
||
|
||
## Авторизация в MikoPBX
|
||
|
||
Бот поддерживает **два способа** авторизации (приоритет — Bearer Token):
|
||
|
||
1. **Bearer Token** (рекомендуется) — самый стабильный
|
||
2. **Basic Auth** (fallback)
|
||
|
||
---
|
||
|
||
## Как создать Bearer Token в MikoPBX
|
||
|
||
1. Зайди в веб-интерфейс MikoPBX
|
||
2. Перейди в **Система → Права сотрудников**
|
||
3. Создай пользователя или открой существующего
|
||
4. В разделе **REST API** / **API Keys** создай токен
|
||
5. Скопируй токен и вставь в `.env`
|
||
|
||
---
|
||
|
||
## Настройка (.env)
|
||
|
||
```env
|
||
# MikoPBX
|
||
MIKOPBX_HOST=http://192.168.1.50:8081
|
||
|
||
# === Bearer Token (рекомендуется) ===
|
||
MIKOPBX_API_TOKEN=1bbb7b1357e8bdb0a933f054aedf3aa1f947f7237f3895a05fa29198a253f935
|
||
|
||
# Telegram
|
||
TELEGRAM_BOT_TOKEN=твой_токен
|
||
ADMIN_TELEGRAM_IDS=123456789,987654321
|
||
|
||
# SIP параметры
|
||
DEFAULT_SIP_SERVER=sip.tvoyserver.ru
|
||
DEFAULT_SIP_PORT=5060
|
||
DEFAULT_SIP_DOMAIN=sip.tvoyserver.ru
|
||
DEFAULT_SIP_TRANSPORT=UDP
|
||
DEFAULT_SIP_OUTBOUND_PROXY=
|
||
DEFAULT_SIP_STUN=
|
||
```
|
||
|
||
---
|
||
|
||
## Запуск
|
||
|
||
```bash
|
||
docker compose up -d --build
|
||
```
|
||
|
||
---
|
||
|
||
## Основные возможности
|
||
|
||
- Регистрация **ровно 7-значных** номеров
|
||
- Один номер на пользователя
|
||
- Выбор своего пароля при регистрации
|
||
- Полные параметры подключения (домен, outbound proxy, STUN и т.д.)
|
||
- **Привязка уже существующих номеров MikoPBX**
|
||
- Полная синхронизация (создание, смена номера/пароля, удаление)
|
||
|
||
---
|
||
|
||
## Логи
|
||
|
||
```bash
|
||
docker compose logs -f mikopbx-bot
|
||
``` |