# Yeastar S-серия + amoCRM Финальный шаг: свяжем АТС Yeastar и аккаунт amoCRM в **сервисе Callbee**. После этого в amoCRM начнут всплывать карточки звонков, сохраняться записи и автоматически создаваться контакты и сделки. > [!CAUTION] Предварительный чек-лист > Убедитесь что вы выполнили всё из этого списка — мастер запросит все эти данные подряд: > 1. [Настройка AMI](/setup/yeastar/ami-setup/) — пользователь + пароль + белый список IP > 2. Публикация записей — [API](/setup/yeastar/api-setup/) для S50/S100/S300 **или** [FTP](/setup/yeastar/ftp-setup/) для S20 > 3. [Сетевые настройки](/setup/yeastar/network/) — проброс портов 5038 + 8088 (или 21 + 35000–35999) > 4. [Установка виджета в amoCRM](/quickstart/install-app/) — виджет включён для нужных пользователей > [!WARNING] amoCRM требует HTTPS для записей > Если используете API с HTTP, записи загрузятся в Callbee, но amoCRM **не сможет их прикрепить** в карточку. Для amoCRM обязательно: **валидный SSL-сертификат** на вашем внешнем домене АТС (Let's Encrypt или коммерческий CA). Самоподписанные не принимаются. ## Что понадобится заранее | | | |---|---| | **Адрес amoCRM** | например `mycompany.amocrm.ru` (без `https://`) | | **Внешний адрес АТС** | публичный IP или DDNS, например `pbx.company.ru` | | **AMI логин/пароль** | из [настройки AMI](/setup/yeastar/ami-setup/) | | **API или FTP логин/пароль** | из публикации записей | | **«Игнорируемые транки»** | список номеров, которые не логировать | | **Регион и часовой пояс** | для умной маршрутизации и рабочего времени | --- ## Шаг 1. Создайте сервис в личном кабинете Войдите в [my.callbee.io](https://my.callbee.io) → раздел **Integrations** → кнопка **«Create»** справа сверху. ![Запустите установщик](../img/create-callbee.png) Откроется мастер **«Create Integration»** из **5 шагов**. ## Шаг 2. CRM & PBX — выбор системы ![Шаг 1: CRM и PBX](../img/amo-mycallbee-step1-s.png) Заполните поля: | Поле | Значение | |---|---| | **CRM SYSTEM** | `AMOCRM` | | **AMOCRM DOMAIN** | адрес вашего аккаунта, например `mycompany.amocrm.ru` | | **PBX** | `YEASTAR` | | **YEASTAR** | `S-Series` | Нажмите **«Continue»**. > [!NOTE] Разные зоны amoCRM > amoCRM работает на доменах `.amocrm.ru` (Россия), `.amocrm.com` (международный) и `.kommo.com` (новый бренд Kommo). Указывайте **точный домен** как он открывается в браузере. ## Шаг 3. AMI — подключение к АТС ![Шаг 2: AMI](../img/amo-mycallbee-step2-s.png) | Поле | Значение | Пример | |---|---|---| | **AMI HOST** | адрес АТС + порт через `:` | `pbx.company.ru:5038` | | **AMI USERNAME** | логин из [Шага 3 настройки AMI](/setup/yeastar/ami-setup/#шаг-3-включите-ami-и-задайте-учётные-данные) | `crm-to-callbee` | | **AMI SECRET** | пароль из той же страницы | `••••••••••••` | Нажмите **«Continue»**. > [!TIP] Проверка AMI заранее > Перед этим шагом — сделайте `nc -vz pbx.company.ru 5038` с компьютера в публичной сети. Если `succeeded` — мастер пройдёт. Если нет — [сетевые настройки](/setup/yeastar/network/). ## Шаг 4. YEASTAR — публикация записей Выберите свой вариант — API (новые модели) или FTP (только S20). +++ API (S50 / S100 / S300) ![Шаг 3: API](../img/amo-mycallbee-step3-api-s.png) 1. Включите переключатель **«FTP / API»** в положение **API** (синий) | Поле | Значение | Пример | |---|---|---| | **Протокол** (dropdown) | для amoCRM — **только `https://`** | `https://` | | **API HOST** | адрес АТС + порт 8088 | `pbx.company.ru:8088` | | **API USERNAME** | логин из [настройки API](/setup/yeastar/api-setup/) | `support` | | **API SECRET** | пароль из той же страницы | `••••••••••••` | | **IGNORE TRUNKS** | номера через пробел, которые не фиксировать | `+37533xxxxxxx +37544xxxxxxx` | 2. Нажмите **«Continue»** > [!WARNING] Только HTTPS для amoCRM > amoCRM отвергает HTTP-ссылки на записи. Если у вашей АТС нет валидного сертификата — настройте [публикацию записей через внешний Caddy](/setup/freepbx/recording-publish/#вариант-2-https-рекомендуется-для-всех-crm) и указывайте его адрес здесь. +++ FTP (только S20) ![Шаг 3: FTP](../img/amo-mycallbee-step3-ftp-s.png) > [!WARNING] FTP + amoCRM — только через HTTPS-шлюз > Прямой FTP Yeastar S20 не подходит amoCRM — она не принимает `ftp://` ссылки. Нужно настроить **HTTPS-прокси** над FTP (Caddy/nginx), который будет отдавать записи клиенту по `https://`, а внутри скачивать их с АТС по FTP. Обратитесь в поддержку [support@callbee.io](mailto:support@callbee.io) — поможем настроить. Если схема с HTTPS-прокси готова, оставьте переключатель **«FTP / API»** в положении **FTP** и заполните: | Поле | Значение | Пример | |---|---|---| | **FTP HOST** | адрес АТС + порт 21 | `pbx.company.ru:21` | | **FTP USERNAME** | фиксированное `support` | `support` | | **FTP SECRET** | пароль SSH из [настройки FTP](/setup/yeastar/ftp-setup/) | `••••••••••••` | | **FTP PATH** | путь к записям на АТС | `/ftp_media/mmc/autorecords/` | | **IGNORE TRUNKS** | номера через пробел | `+37533xxxxxxx` | Нажмите **«Continue»**. +++ > [!NOTE] Что такое IGNORE TRUNKS > Если у вас есть **служебные** или **тестовые** транки (номер техподдержки оператора, внутренний IVR-робот, аналитический пул) — звонки с/на них не попадут в amoCRM. Формат: список номеров через пробел. ## Шаг 5. MAIN LINE — правила работы со сделками ![Шаг 4: Main Line для amoCRM](../img/amo-mycallbee-step4-s.png) Это самый **концептуальный** шаг — здесь решаете, **как amoCRM реагирует на звонки**. ### OUTGOING CALL (исходящие звонки) Dropdown — какую сущность создавать при звонке на незнакомый номер: | Значение | Что происходит | |---|---| | **None** | Ничего не создавать, только зафиксировать факт звонка | | **Unsorted** | Создать запись в разделе **«Неразобранное»** для последующей обработки | | **Contact** ✓ рекомендуется | Сразу создать **контакт** в каталоге | | **Contact + Lead** | Создать контакт **и** сделку | ### INCOMING CALL (входящие звонки) Аналогичный dropdown для входящих звонков. ### UNSORTED during a phone call Toggle. Если включён — при **входящем** звонке с неизвестного номера всплывает форма **«Неразобранное»** прямо во время разговора. Менеджер может сразу занести данные клиента. Полезно в продажах. ### FIND IN UNSORTED Toggle. Если включён — при звонке Callbee ищет контакт сначала в обычных контактах, **а потом** в разделе «Неразобранное». Если выключен — ищет только в обычных. Полезно если у вас много пропущенных из незнакомых номеров, которые ещё не оформлены в контакты. > [!TIP] Рекомендуемый старт > - **Исходящие**: `Contact` — менеджер часто звонит новым, и контакт сразу должен быть в базе > - **Входящие**: `Unsorted` — чтобы не засорять каталог случайными входящими (ошибки номера, прозвон ботов) > - **UNSORTED during call**: ON — ускоряет оформление клиента > - **FIND IN UNSORTED**: OFF — если включили Unsorted только-что Нажмите **«Continue»**. ## Шаг 6. REGION — регион и часовой пояс ![Шаг 5: Region](../img/amo-mycallbee-step5-s.png) | Поле | Значение | |---|---| | **REGION** | `BY` (Беларусь), `RU` (Россия), `KZ` (Казахстан) или `NL` (Нидерланды) | | **TIME ZONE** | часовой пояс вашего офиса, например `Europe/Minsk GMT+3:00` | > [!CAUTION] Почему это критично > Регион определяет правила парсинга номеров (код страны, формат мобильных/стационарных) и рабочее время. Ошибка — и номера в CRM появятся в неверном формате, поиск контактов по номеру работать не будет. Нажмите **«Create»**. --- ## После создания сервиса Вы попадёте на страницу сервиса — статус должен быть **Active** (зелёный). Если **Error** — смотрите раздел ниже. ### Проверка 1. Совершите **тестовый звонок** с мобильного телефона на рабочий номер 2. В amoCRM у ответственного всплывёт **уведомление** о звонке 3. В разделе **Неразобранное** (или в **Контактах**) появится новая запись 4. После завершения — в карточке будет **запись разговора** (иконка play) 5. Кликните на номер телефона в любой карточке контакта — Callbee инициирует исходящий звонок ### Если что-то не работает | Проблема | Куда смотреть | |---|---| | Статус **Error: AMI auth** | неправильный пароль AMI — [ami-setup.md](/setup/yeastar/ami-setup/) | | Статус **Error: connection refused** | порт 5038 не проброшен — [network.md](/setup/yeastar/network/) | | Карточки всплывают, но без записей | amoCRM получила HTTP-ссылку — перенастройте на HTTPS | | «Не удалось загрузить запись» в карточке | SSL-сертификат самоподписанный или истёк — проверьте через [SSL Labs](https://www.ssllabs.com/ssltest/) | | Контакты создаются, но дубликаты | Выключите OUTGOING CALL = Contact и используйте Unsorted с FIND IN UNSORTED = ON | | Звонок идёт не ответственному | Виджет в amoCRM выключен у этого сотрудника — проверьте в настройках интеграций | --- ## Что дальше - **Добавьте линии** — если у вас несколько городских номеров, в разделе сервиса → **Lines** → **Add Line** - **Сопоставьте пользователей** Yeastar ↔ amoCRM — [config/users](/config/users/) - **Настройте правила создания сделок** — [config/lead-rules](/config/lead-rules/) - **Настройки «Неразобранное»** — в amoCRM → **Настройки → Интеграции → Callbee** — можно указать воронку, пайплайн, ответственного > [!SUCCESS] Поздравляем! > Сервис Callbee для Yeastar S + amoCRM активен. Теперь все звонки автоматически попадают в amoCRM с записями, а умная обработка входящих не пропустит ни одного потенциального клиента.