# Публикация записей разговоров через FTP (Yeastar S20) У **Yeastar S20** нет HTTP API — в отличие от старших моделей, записи разговоров оттуда нужно забирать через **FTP**. Callbee подключается к АТС по FTP (порт 21), забирает аудиофайлы из `/ftp_media/mmc/autorecords/` и передаёт их в CRM. > [!CAUTION] Только для S20 > На моделях **S50, S100, S300** используйте [HTTP API](/setup/yeastar/api-setup/) — он быстрее, безопаснее и не требует FTP. ## Что понадобится | | | |---|---| | **Веб-доступ к АТС** | обычно `https://` | | **Учётная запись администратора** | с правом изменения системных настроек | | **Статический IP или проброс портов** | порт **21/TCP** и **passive-range** должны быть виден Callbee | | **FTP-клиент для проверки** | FileZilla, Cyberduck или `lftp` в терминале | > [!CAUTION] Нет встроенного whitelist для FTP > В отличие от AMI, в настройках FTP-доступа **нет поля «Разрешённые IP/Маска»**. Защита по IP делается **на уровне роутера**: пробросьте порт **21/TCP** и passive-диапазон на локальный IP АТС, ограничьте источник [IP-адресами Callbee](/ip-addresses/). Без этого FTP будет открыт всему интернету — а там логин `support` общеизвестен. --- ## Шаг 1. Включите FTP-доступ к записям Перейдите в **Настройки → Система → Хранилища данных → Файловое хранилище**. В блоке **«Доступ по FTP»** поставьте галочку **«Активировать FTP доступ»** и нажмите **«Сохранить»**. ![Активация FTP в разделе Хранилища данных](../img/amo-ftp-activate-s.png) > [!NOTE] «Общий доступ к файлам» — не то же самое > Блок ниже (с полями «Имя файла», «Логин», «Пароль», логин `share`) — это **Samba/CIFS** для подключения АТС как сетевого диска в Windows. Для Callbee он **не нужен** — не включайте его и не путайте с FTP. ## Шаг 2. Включите FTP-сервис и получите пароль FTP использует те же учётные данные, что и **SSH**: - **Логин:** `support` (фиксированный, не меняется) - **Пароль:** тот же что у SSH-пользователя `support` Перейдите в **Настройки → Система → Безопасность → Сетевые службы**. 1. Поставьте галочку **«Включить SSH»** — раздел с паролем откроется 2. Поставьте галочку **«Включить FTP»** — стрелка на скриншоте ниже 3. Скопируйте **«Пароль SSH по умолчанию»** из появившегося окна ![Включение FTP и получение пароля SSH](../img/amo-ftp-pass-s.png) > [!WARNING] Пароль показывается только один раз > Yeastar показывает пароль `IV-kRD0_` (в вашем случае будет другой) только в этом окне. После нажатия **«OK»** пароль нельзя будет увидеть. Если забыли — нажмите **«Создать»** для генерации нового (старый перестанет работать). > > **Сохраните пароль сразу** в менеджере паролей. Этот же пароль понадобится: > - в личном кабинете Callbee (при создании сервиса) > - при подключении к SSH для диагностики > - при ручной проверке FTP через FileZilla ## Шаг 3. Смените стандартный пароль (рекомендуется) Пароль SSH/FTP по умолчанию генерируется один раз при первом включении и дальше не меняется **самостоятельно**. Если АТС стояла у вас давно — пароль мог утечь (логи, старый админ, скриншоты в чатах). Нажмите **«Создать»** рядом с полем пароля — Yeastar сгенерирует новый случайный пароль. Обязательно его сохраните. > [!TIP] Когда менять пароль > - **Перед первой интеграцией** с Callbee > - После **увольнения админа**, знавшего пароль > - Каждые **6 месяцев** в рамках security-гигиены ## Шаг 4. Откройте порт 21 на роутере Пробросьте на роутере: | Параметр | Значение | |---|---| | **Внешний порт** | `21` | | **Внутренний IP** | адрес Yeastar S20 в локальной сети | | **Внутренний порт** | `21` | | **Протокол** | TCP | | **Источник** | [IP-адреса Callbee](/ip-addresses/) | > [!WARNING] Passive FTP: нужен диапазон портов > FTP работает в двух режимах: **active** (сервер сам инициирует data-соединение) и **passive** (клиент инициирует по случайному порту). Callbee использует **passive** — это требует дополнительного диапазона портов. > > Yeastar S20 по умолчанию использует диапазон **`35000–35999`** для passive. Пробросьте этот диапазон на роутере (TCP) в дополнение к порту 21. Без этого списание файлов зависнет после успешной авторизации. ## Шаг 5. Проверьте FTP На компьютере в той же сети (или с пробросом портов) выполните: ```bash lftp -u support,ВАШ_ПАРОЛЬ ``` Внутри `lftp`: ``` ls cd /ftp_media/mmc/autorecords ls ``` Вы должны увидеть структуру с папками по годам/месяцам и файлами `.wav` — это записи разговоров. Через FileZilla: 1. **Хост:** `` или ваш домен 2. **Протокол:** FTP (обычный, не SFTP) 3. **Тип входа:** Обычный 4. **Пользователь:** `support` 5. **Пароль:** тот что из [Шага 2](#шаг-2-включите-ftp-сервис-и-получите-пароль) 6. Перейдите в `/ftp_media/mmc/autorecords/` — должны быть папки с записями --- ## Частые проблемы **FileZilla: «Connection established, waiting for welcome message...» и висит** Проблема в passive-режиме — диапазон `35000–35999` не проброшен на роутере. Вернитесь к [Шагу 4](#шаг-4-откройте-порт-21-на-роутере). **`530 Login incorrect`** Пароль неверный или был пересоздан через **«Создать»**. Снова нажмите **«Создать»** в настройках и используйте новый пароль. **`550 Failed to change directory`** при `cd /ftp_media/mmc/autorecords` Пользователь `support` не имеет прав на папку с записями. Это бывает после обновления прошивки — зайдите по SSH и проверьте права: ```bash ssh support@ ls -la /ftp_media/mmc/autorecords/ ``` Если владелец не `support` — [напишите в поддержку](mailto:support@callbee.io). **Записи есть в АТС, но Callbee их не скачивает** Проверьте что в личном кабинете Callbee: 1. **Протокол** установлен как FTP (не SFTP) 2. **Порт** 21 (не 22) 3. **Путь к записям** `/ftp_media/mmc/autorecords` (без слеша в конце) **FTP работает, но очень медленно** Yeastar S20 — аппаратно слабая АТС. Если в системе много одновременных записей на скачивание — включите [ротацию записей](https://docs.yeastar.com/) в настройках АТС или перейдите на HTTPS-публикацию через промежуточный сервер. **«Включить FTP» перестаёт работать после обновления прошивки** Некоторые минорные версии прошивки Yeastar сбрасывают флаг «Включить FTP». После каждого обновления проверяйте, что галочка установлена. **SSH работает, FTP — нет** Галочка **«Включить FTP»** не установлена. SSH и FTP включаются отдельно, несмотря на общий пароль. --- > [!SUCCESS] FTP настроен! > Переходите к [сетевым настройкам](/setup/yeastar/network/) — проверим что все порты видны снаружи и правильно настроен firewall.