Коннекторы
Коннектор — канал вашей компании до внешней системы: почтовый ящик, SMS-шлюз, бот мессенджера. Через него письма и сообщения уходят клиентам от имени компании, а ответы возвращаются в раздел «Лиды».
Где искать и как устроен раздел
Откройте «Администрирование → Интеграции → Коннекторы». Карточки сгруппированы по типу канала.
| Тип | Что закрывает | Коннекторы |
|---|---|---|
| Почта | Письма клиентам и приём заявок с ящика компании | Почта компании |
| SMS-шлюзы | Короткие сообщения клиентам | sms.ru, smsc.ru, SMS Aero, SMS-шлюз (HTTP) |
| Мессенджеры | Уведомления клиентам и приём заявок ботом | Telegram, WhatsApp |
| Оборудование | Кассы, принтеры и весы на компьютерах сотрудников | Оборудование |
| Другие системы | Обмен с произвольной системой по HTTP | Внешняя система |
Внутри одного типа коннекторов может быть несколько, и они работают одновременно. Например, салон подключает Telegram для постоянных клиентов и WhatsApp для тех, кто пришёл с карт.
Как подключить канал
- Нажмите «Настроить» на карточке нужного коннектора.
- Заполните раздел «Подключение»: адрес сервера, логин, ключ шлюза или токен бота.
- Укажите адрес или номер в разделе «Проверка» и нажмите «Сохранить и проверить».
- Дождитесь сообщения «Проверка прошла». Карточка станет «Подключён».
Статус на карточке показывает, в каком состоянии канал:
| Статус | Что значит |
|---|---|
| Не настроен | Коннектора ещё нет |
| Не проверен | Настройки сохранены, но проверка не проходила |
| Подключён | Проверка прошла, сообщения уходят |
| Ошибка | Последняя отправка или проверка не удалась; причина видна на карточке |
Сообщения клиентам уходят только через включённый коннектор со статусом «Подключён». Если почта или SMS-шлюз заведены, но ни один из них не работает, вверху вкладки появляется предупреждение с перечнем каналов. Пока отправка клиентам включена, а рабочего коннектора нет, в отчётах горит сигнал «Каналы связи не работают».
Пароли, ключи и токены хранятся в зашифрованном виде и обратно не показываются. У сохранённого коннектора поле секрета подписано «Оставьте пустым, чтобы не менять».
Переключатель «Коннектор включён» гасит канал, не удаляя настройки: удобно на время смены тарифа у шлюза.
Как принимать заявки от клиентов
Коннектор работает в обе стороны. Включите «Принимать входящие» — и письмо на ящик компании или сообщение боту станет заявкой в разделе «Лиды»: с контактом, текстом и пометкой канала. Дальше заявка живёт по общим правилам Маркетинга: распределяется по менеджерам и конвертируется в клиента.
Входящие приходят двумя способами:
- Почта — раз в пять минут система читает новые письма. Письма не удаляются и не помечаются прочитанными, поэтому ящиком можно продолжать пользоваться как раньше. Первый опрос берёт письма за последние сутки, дальше — только новые.
- Мессенджеры и внешние системы — внешняя система сама шлёт сообщения на «Адрес для входящих». Он появляется в форме после сохранения коннектора, копируется кнопкой рядом и вставляется в настройки внешней системы. Адрес неугадываем, публиковать его не нужно.
Если внешняя система просит verify token, это последняя часть адреса — то, что стоит после последнего слэша.
Повторную доставку одного и того же сообщения система распознаёт: вторая заявка по нему не заводится.
Что происходит, когда канал сломался
Внешние сервисы иногда не отвечают, поэтому у каждого коннектора есть раздел «Повторы и оповещения».
- «Сколько попыток» — от 1 до 10, по умолчанию 5.
- «Пауза перед второй попыткой, сек» — по умолчанию 5. Каждая следующая пауза вдвое длиннее.
- «Писать администраторам, когда канал сломался» — по умолчанию включено. Письмо приходит не чаще раза в час, чтобы лежащий шлюз не завалил почту.
Например, при пяти попытках и паузе 5 секунд система пробует отправить сообщение через 5, 10, 20 и 40 секунд после первой неудачи. Если шлюз не ответил и на пятой, сообщение получает статус «Ошибка».
Что ушло и что пришло, видно в «Журнале обмена» — он открывается иконкой со списком на карточке коннектора. В журнале есть дата, направление, адрес, статус и число попыток. У неудачного исходящего сообщения появляется кнопка «Повторить». Журнал хранится 30 дней: это диагностика, а не архив переписки.
Настройки коннекторов
Дальше — что заполнять в каждом коннекторе и чем они отличаются.
Почта компании
Один коннектор закрывает оба направления: SMTP отправляет письма, IMAP забирает входящие.
В разделе «Подключение» заполните SMTP-хост, порт, логин, пароль и адрес отправителя. Порт 465 работает с TLS, 587 — со STARTTLS; шлюзы принимают также 25 и 2525. «Имя отправителя» — то, что клиент увидит вместо адреса: например, «Мастерская на Ленина».
Чтобы принимать письма, включите «Принимать входящие» и заполните IMAP-хост — без него приём не сохранится. Порт IMAP по умолчанию 993, папка — INBOX. Логин и пароль IMAP можно не заполнять: тогда берутся те же, что у SMTP.
Проверка открывает оба соединения и отправляет письмо на указанный адрес.
Письма из ящика мы читаем, но не трогаем: они не удаляются и не помечаются прочитанными — ящик остаётся вашим рабочим ящиком, а прогресс мы держим у себя. По этой же причине POP3 не поддерживается: там чтение разрушающее, письмо после загрузки исчезает с сервера. Всё, ради чего нужен POP3, закрывает IMAP.
Слишком большое письмо (больше 2 МБ) мы пропускаем и пишем об этом в журнал обмена — иначе один архив с фотографиями останавливал бы приём всей остальной почты.
Шлюз sms.ru
Нужен только api_id из личного кабинета sms.ru. «Имя отправителя» заполняйте, если оператор одобрил вам подпись; иначе оставьте пустым — сообщение уйдёт с общего номера.
Шлюз smsc.ru
Логин и пароль клиента из кабинета smsc.ru плюс необязательное имя отправителя.
SMS Aero
Учётная почта, на которую зарегистрирован кабинет, и API-ключ. «Подпись отправителя» обязательна и должна быть одобрена в кабинете SMS Aero; по умолчанию подставляется SMS Aero.
SMS-шлюз (HTTP)
Вариант для шлюза, которого нет в списке: вы сами описываете, каким запросом отправлять сообщение.
| Поле | Что указать |
|---|---|
| URL внешней системы | Адрес с плейсхолдерами {to}, {text}, {credential}, {sender} |
| Метод | GET или POST |
| Шаблон тела запроса | Только для POST; те же плейсхолдеры |
| Content-Type | Для POST; по умолчанию application/x-www-form-urlencoded |
| Авторизация | Без авторизации, Bearer-токен, Basic (user:pass) или заголовок с ключом |
| Ключ или пароль | Значение, которое подставится в {credential} и в авторизацию |
Например, https://gate.example.com/send?to={to}&text={text}&key={credential} отправит сообщение методом GET.
Проверка такого шлюза требует номер: убедиться в правильности реквизитов можно только реальной отправкой, и она стоит одну SMS.
Бот Telegram
Создайте бота у @BotFather и вставьте его токен в поле «Токен бота». «Чат по умолчанию» — куда слать уведомления, у которых нет явного получателя.
Токен бота вводится только здесь, одной настройкой на всю компанию. Инбокс мессенджера («Управление чатами → Каналы») берёт токен отсюда: после проверки коннектора его достаточно подключить кнопкой «Подключить», вводить токен второй раз не нужно.
У бота один адрес для входящих, поэтому переписку и заявки ведёт кто-то один:
- подключили инбокс — приём заявок самим коннектором выключается, и клиенты пишут в Мессенджер;
- хотите заявки в «Лидах» — отключите бота в «Управлении чатами» и включите «Принимать входящие» в коннекторе.
Смена токена гасит подключение инбокса: вебхук остался у прежнего бота. После смены токена подключите инбокс заново.
WhatsApp Cloud API
Понадобятся «Идентификатор номера» (Phone number ID) и permanent access token из кабинета Meta; версия API по умолчанию v21.0.
Чтобы принимать сообщения, вставьте «Адрес для входящих» в настройки приложения Meta, а в поле verify token — последнюю часть этого адреса.
Важное ограничение WhatsApp. Свободный текст Cloud API доставляет только в течение 24 часов после сообщения клиента. Вне этого окна пройдёт лишь шаблон, заранее утверждённый Meta, — произвольное уведомление вернётся ошибкой, даже если коннектор проверен и показывает «Подключён». Поэтому канал хорошо работает на ответы и подтверждения в живой переписке и не годится для холодных рассылок. Отправка по утверждённым шаблонам пока не поддерживается.
Оборудование
Полей у этого коннектора нет: кнопка «Настроить» открывает список агентов компании. Агент — программа на компьютере в точке, через которую работают касса, чековый принтер, весы и принтер этикеток. Как её поставить и привязать, описано в Интеграциях.
Внешняя система
Произвольный обмен по HTTP: исходящий вызов настраивается так же, как у SMS-шлюза, а входящие принимаются на «Адрес для входящих».
Во входящем запросе система понимает поля message, text или comment как текст обращения, phone или tel как телефон, email или mail как почту, name, fio или title как имя. Этого хватает, чтобы форма с чужого сайта складывала заявки в «Лиды».
Проверка ничего никому не отправляет: система убеждается, что адрес отвечает. Если исходящий URL не нужен, оставьте его пустым — коннектор будет работать только на приём.
Кто с этим работает
Раздел открыт администратору. Коннекторы — чувствительная настройка, поэтому их создание, изменение и удаление фиксируются в журнале действий.
Коротко
- Коннектор — канал компании: почта, SMS, мессенджер, оборудование или своя система.
- Сообщения уходят только через включённый коннектор со статусом «Подключён».
- Приём входящих превращает письма и сообщения в заявки раздела «Лиды».
- Повторы, письмо администраторам и журнал обмена настраиваются у каждого коннектора отдельно.
- Токен Telegram-бота задаётся один раз в коннекторе, инбокс мессенджера берёт его оттуда.
Связь с другими компонентами
- Интеграции — дополнения из каталога, ключи доступа и агент оборудования.
- Маркетинг — куда попадают принятые заявки.
- Мессенджер — переписка с клиентами в Telegram и WhatsApp.
- Автоматизация — правила, которые отправляют сообщения через эти каналы.