# Руководство по продажам и запуску BoxDialer для ваших клиентов

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

---

## 📋 1. Что такое BoxDialer? (Характеристики и Выгоды)

**BoxDialer** — это готовая программа для отделов продаж и колл-центров, которая увеличивает количество звонков менеджеров в **3 раза** и снижает расходы на телефонию.

### Ключевые возможности:
*   **Умный автообзвон (Progressive Dialer)**: Программа сама набирает номера клиентов из базы по очереди. Менеджер не тратит время на ручной набор цифр и ожидание гудков. Он начинает говорить только тогда, когда клиент уже снял трубку.
*   **Детектор автоответчиков (AMD)**: Система мгновенно распознает голосовую почту, автоответчики сотовых операторов или сигналы «занято» и сбрасывает их. Менеджеры общаются только с живыми людьми.
*   **ИИ-Робот на первой линии**: Робот может сам совершить первый звонок, вежливо рассказать про акцию/услугу, выслушать клиента и, если клиент сказал «Да, мне интересно», робот мгновенно переведет звонок на живого оператора.
*   **Встроенный телефон в браузере (WebRTC)**: Оператору не нужно покупать физические IP-телефоны или устанавливать сложные программы на компьютер. Он просто заходит на сайт через браузер Chrome, надевает наушники с микрофоном и работает.
*   **Полная приватность**: Вся база клиентов, история разговоров и записи звонков хранятся только на сервере клиента. Никаких утечек баз данных в облако сторонних сервисов.

---

## 🛠️ 2. Что нужно клиенту для запуска системы в его компании?

Чтобы система заработала, клиенту необходимы всего 4 вещи:

1.  **SIP-транк (Линия связи)**:
    *   Это обычный виртуальный номер телефона, который подключается напрямую через встроенную интеграцию (API).
    *   Провайдер выдает клиенту 3 параметра: **Адрес сервера (Host)**, **Логин (Username)** и **Пароль (Password)**.
2.  **База контактов**:
    *   Обычный файл Excel (.xlsx) или CSV со списком клиентов. Обязательно должна быть колонка с номерами телефонов.
3.  **Рабочие места операторов**:
    *   Компьютер или ноутбук с выходом в интернет.
    *   Гарнитура (наушники с микрофоном) для качественного звука.
    *   Браузер Google Chrome или Яндекс.Браузер.
4.  **Сервер для установки (VPS)**:
    *   Виртуальный сервер (аренда стоит 1500–2500 рублей в месяц). Если клиент берет бесплатный тест, этот сервер предоставляете вы (подробнее ниже).

---

## 🚀 3. Как дать продукт на бесплатный тест? (Схема продаж с нулевым трением)

Не предлагайте клиенту устанавливать программу на его сервер для теста — это сложно и отпугнет его. Используйте схему **«Быстрый старт на вашем сервере»**:

```mermaid
sequenceDiagram
    participant Client as Клиент (Бизнес)
    participant You as Вы (Ваш VPS сервер)
    participant Provider as Провайдер связи клиента

    Client->>You: Передает SIP-данные своего номера телефона
    You->>You: Прописывает SIP-данные в настройки Asterisk
    Client->>You: Передает Excel-файл с тестовой базой (20-50 контактов)
    You->>You: Создает Кампанию и загружает Excel в админку
    You->>Client: Выдает ссылку, логин и пароль для оператора
    Client->>You: Оператор заходит на сайт, надевает наушники
    You->>You: Запуск обзвона. Клиент тестирует систему бесплатно!
```

### Пошаговый план бесплатного теста для клиента:
1.  **Шаг 1**: Клиент подключает виртуальный номер телефона и получает реквизиты подключения (Host, Login, Password).
2.  **Шаг 2**: Вы прописываете этот номер в конфигурационный файл Asterisk на **вашем VPS** (в файл `pjsip.conf`).
3.  **Шаг 3**: Вы заходите в админку BoxDialer на вашем сервере, создаете под клиента отдельную Кампанию обзвона и загружаете его тестовый Excel-файл.
4.  **Шаг 4**: Вы создаете учетную запись оператора (например, `operator_client1`) и отправляете клиенту ссылку на вашу админку, логин и пароль.
5.  **Шаг 5**: Оператор клиента заходит по ссылке, авторизуется, нажимает кнопку **«Готов»**. Вы запускаете кампанию. Система начинает звонить от лица клиента по его базе, отсеивая автоответчики и переводя живых клиентов на оператора.

*Результат*: Клиент за 15 минут видит систему в действии, не потратив ни копейки на установку, и сразу понимает ценность продукта.

---

## ⚙️ 4. Как настраивать телефонию (Инструкция для настройки связи)

Настройка телефонии сводится к связыванию Asterisk с SIP-провайдером клиента.

### Шаг 1. Где прописывать настройки?
Откройте файл конфигурации телефонии по пути: [G:\boxdialer\asterisk\config\pjsip.conf](file:///G:/boxdialer/asterisk/config/pjsip.conf).

### Шаг 2. Как заполнить шаблон?
В самом низу файла найдите закомментированный блок и замените его на реальные данные провайдера клиента.

**Пример настройки для SIP-провайдера:**

```ini
; 1. Регистрация на сервере провайдера (чтобы АТС знала куда слать звонки)
[trunk-provider]
type=registration
transport=transport-udp
outbound_auth=auth-provider
server_uri=sip:sip.your-provider.ru
client_uri=sip:00012345@sip.your-provider.ru

; 2. Авторизационные данные (логин и пароль)
[auth-provider]
type=auth
auth_type=userpass
username=00012345           ; SIP-логин клиента
password=SuperSecurePass123 ; SIP-пароль клиента

; 3. Описание точки подключения для исходящей связи
[trunk-endpoint]
type=endpoint
context=from-trunk
transport=transport-udp
disallow=all
allow=alaw,ulaw
outbound_auth=auth-provider
aors=aor-provider

[aor-provider]
type=aor
contact=sip:sip.your-provider.ru
```

После сохранения файла нужно применить настройки в Asterisk командой:
`docker exec -it boxdialer-asterisk asterisk -rx "pjsip reload"` (или просто перезапустить контейнеры).

---

## 🖥️ 5. Пошаговый запуск в компании клиента (При покупке «Коробки»)

Когда клиент протестировал продукт и готов купить «Коробку» навсегда:

1.  **Покупка сервера**: Клиент регистрируется на любом хостинге (например: *Reg.ru, Beget, TimeWeb*) и арендует виртуальный сервер (VPS) на Ubuntu 22.04 LTS.
2.  **Установка Docker**: Вы заходите на сервер клиента по SSH и устанавливаете Docker одной стандартной командой.
3.  **Перенос файлов**: Вы копируете папку `boxdialer` на сервер клиента.
4.  **Ввод API ключа**: В файле `.env` прописываете API ключ OpenRouter (для работы ИИ-робота).
5.  **Настройка SIP-транка**: В файле `pjsip.conf` прописываете SIP-номер клиента (как описано в разделе 4).
6.  **Запуск**: Запускаете систему командой `docker-compose up -d --build`.
7.  **Сдача работы**: Передаете клиенту ссылку на его личный сервер, логины и пароли для входа. Система готова к многолетней работе без каких-либо абонентских плат за софт.
