Главная / Справка / Сценарии / Общие компоненты: SMS, почта, мессенджеры

Общие компоненты: SMS, почта, мессенджеры

Компоненты этой группы отправляют и принимают сообщения по внешним каналам: SMS, электронная почта, мессенджеры. Сюда же отнесён запрос к веб-сервису 1С.

SMS

Четыре компонента работают с SMS-сервисом, указанным в общих настройках комплекса.

Отправка одного SMS

Свойство	Описание
Номер	Номер адресата.
Текст	Текст сообщения.
Подставляемый номер	Номер, от которого осуществляется доставка.
Push Id	Код отправленного сообщения — понадобится для последующего запроса отчёта о доставке.
Ожидание доставки	Да / нет.
Таймаут ожидания	Только при ожидании доставки.
Переход, доставлено	После успешной отправки; при включённом ожидании — если сообщение доставлено до истечения таймаута.
Переход, не доставлено	Только при ожидании доставки: сообщение отправлено, но за отведённое время не доставлено.
Переход, ошибка	Сервис недоступен или вернул ошибку.

Сохраняйте Push Id Ожидание доставки останавливает сценарий. Часто разумнее отправить сообщение без ожидания, сохранить Push Id и проверить статус позже — отдельным служебным сценарием через компонент «Получение статуса отправленного SMS».

Получение первого SMS

Запрашивает у сервиса первое сообщение из очереди входящих и заполняет переменные сценария.

Свойство	Описание
Номер отправителя	Переменная для номера отправителя.
Текст	Переменная для текста сообщения.
Номер адресата	Переменная для номера, на который сообщение было отправлено.
Переход, получено	Сообщение есть и получено успешно.
Переход, сообщений нет	Входящих сообщений на сервере нет.
Переход, ошибка	Сервис недоступен или вернул ошибку.

Получение статуса отправленного SMS

Свойство	Описание
Push Id	Код отправленного сообщения.
Переход, доставлено	Сообщение уже доставлено.
Переход, не доставлено	Сообщение ещё не доставлено.
Переход, неудача	Сервис недоступен или вернул ошибку.

Запрос баланса SMS

Свойство	Описание
Количество	Переменная, куда вернётся количество оставшихся оплаченных сообщений.
Переход	Запрос отработан.
Переход, ошибка	Сервис недоступен или вернул ошибку.

Отправка одного Email

Порт 25, а не 465 Свойство «SSL-авторизация» включает протокол StartTLS: соединение сначала устанавливается по незащищённому порту, а затем шифруется. Это не то же самое, что SSL, где соединение с самого начала идёт по защищённому порту. Поэтому в свойстве «Порт почтового сервера» в большинстве случаев следует указывать 25, а не 465.

Свойство	Описание
Почтовый сервер	Согласно общим настройкам — SMTP-сервер из общих настроек комплекса. SMTP — отдельный сервер, настраиваемый в самом компоненте.
Адрес почтового сервера, Порт	Адрес и порт SMTP-сервера.
Логин, Пароль	Учётная запись на почтовом сервере.
SSL-авторизация	«Да», если сервер этого требует. См. предупреждение выше.
Кому	Получатели. Несколько адресов перечисляются через запятую; для версий ниже 2.9 — через точку с запятой.
От кого	Отправитель. Ряд серверов требует явного указания адреса — тогда свойство должно быть вычислено к моменту передачи управления компоненту. Допустима строка вида `username <адрес@домен>`.
Тема	Тема сообщения.
Формат	Текст или HTML.
Содержание письма	Текстовая часть сообщения.
Кодировка	UTF-8, UTF-7, Windows-1251, KOI8-R, текущая кодовая страница Windows, указанная кодовая страница Windows.
Кодовая страница Windows	Числовой аргумент; доступен при выборе «Указанная кодовая страница Windows».
Вложение 1 … 5	Абсолютный путь к прикрепляемому файлу. Каждое следующее поле появляется только после заполнения предыдущего.
Уведомлять об ошибках	Выбор пользователей, которым уйдут уведомления об ошибках отправки.
Переход	Сообщение успешно отправлено.
Переход, неудача	SMTP-сервер вернул ошибку.

Про «Уведомлять об ошибках» Свойство есть у всех компонентов отправки и приёма сообщений. Оно нужно в отладочных целях в первые дни работы новых проектов: пока настройки сервера, портов и учётных записей не устоялись, ошибки видны сразу, а не только в журнале.

Получение первого Email

Принимает сообщение с указанного почтового ящика.

Свойство	Описание
Почтовый сервер	Согласно общим настройкам; POP3; IMAP4.
Адрес почтового сервера, Порт	Стандартный порт POP — 110, IMAP — 143.
Логин, Пароль	Учётная запись на сервере.
SSL-авторизация	«Да», если сервер этого требует.
MessageId	Переменная для идентификатора сообщения.
Кому, От кого, Тема	Переменные для получателей, отправителей и темы.
Предпочитаемый тип контента	Для разделов `multipart/alternative`. По умолчанию `text/plain`; допустимы `text/html`, `text/xml`, `text/rtf`, `text/richtext`. Дублирующие альтернативные блоки игнорируются.
Текст письма, часть 2, часть 3	Переменные для текста; вторая и третья части используются для multipart-сообщений.
IMAP каталог	Только для IMAP. По умолчанию стандартный каталог входящей почты `Inbox`.
IMAP-запрос	Только для IMAP. Критерии выбора сообщения из каталога; по умолчанию `ALL` — все письма. Синтаксис описан в RFC 2060.
Принимать только заголовки	Да / нет. При «да» тело сообщения и вложения с сервера не скачиваются.
Удалять с сервера	Да / нет.
Сохранять вложения	Нет; в указанную папку; в папку по умолчанию — каталог из общих настроек, раздел «Настройки e-mail».
Папка для вложений	Только при сохранении в указанную папку. Абсолютный или относительный путь; файлы сохраняются с исходными именами.
Путь к папке для вложений в переменную	Только при сохранении в папку по умолчанию. Переменная, куда попадёт путь из общих настроек.
Уведомлять об ошибках	Выбор пользователей-получателей уведомлений.
Переход, получено	Сообщение успешно получено.
Переход, не получено	Сообщения нет, но и ошибки не было. См. ниже.
Переход, неудача	Сервер POP3 или IMAP4 вернул ошибку.

Когда срабатывает «не получено» Это не ошибка, а нормальный исход:

на POP3-сервере нет сообщений;
на IMAP4-сервере нет сообщений в заданном каталоге;
на IMAP4-сервере нет сообщений, удовлетворяющих заданным критериям.

Служебный сценарий, опрашивающий ящик по расписанию, должен по этой ветке просто завершаться, а не сигналить о сбое.

Сообщения IM: ICQ и Jabber

Два компонента — отправка и приём — работают через пул подключений. Любое обращение к аккаунту помещает созданное подключение в пул, где оно поддерживается заданное время; время задаётся в разделах «Общие настройки. ICQ-сервис» и «Общие настройки. Jabber-сервис». Каждое следующее обращение берёт подключение из пула и продлевает срок его жизни.

Зачем пул Аккаунт отключается по таймауту, при ошибке сервера или при выгрузке серверного приложения. Именно этот механизм защищает комплекс от ошибки «Превышен лимит подключений»: для каждого аккаунта держится ровно одно подключение. Для Jabber-аккаунтов подключения с разными настройками держатся отдельно, даже если JID совпадает.

Отправка сообщения IM

Свойство	Описание
Протокол	ICQ или Jabber.
Прокси-сервер	Не использовать; Согласно общим настройкам; HTTPS; SOCKS5.
Адрес и Порт прокси-сервера	Стандартный порт SOCKS5 — 1080, HTTPS — 8080.
Авторизация на прокси	«Да», если сервер этого требует.
Учётная запись	Использовать общую — из общих настроек комплекса; Настроить — параметрами ниже.
Адрес и Порт jabber-сервера	Только для протокола Jabber.
UIN / Jabber ID, Пароль	Учётная запись отправителя.
Таймаут ожидания соединения	В миллисекундах. Сценарий приостанавливается, пока не установится соединение либо не истечёт таймаут.
Таймаут отправки сообщения	Задержка в миллисекундах перед отправкой.
UIN / JID получателя	Несколько адресатов перечисляются через запятую.
Текст сообщения	Аргумент с текстом.
Уведомлять об ошибках	Выбор пользователей-получателей уведомлений.
Переход / Переход, неудача	Успешная отправка либо ошибка сервера.

Приём первого сообщения IM

Свойство	Описание
Протокол	ICQ или Jabber.
Настройки прокси	Форма настроек подключения к прокси-серверу.
Настройки учётной записи	Учётная запись получателя: UIN для ICQ либо JID и параметры сервера для Jabber.
UIN / JID	Переменная, куда сохранится аккаунт отправителя.
Таймаут ожидания соединения	В миллисекундах.
Таймаут получения сообщения	Задержка в миллисекундах перед получением. Если на этот аккаунт сообщения уже приходили раньше, таймаут игнорируется, а переменные заполняются значениями из пула сервера состояний.
Текст сообщения	Переменная для текста полученного сообщения.
Уведомлять об ошибках	Выбор пользователей-получателей уведомлений.
Переход	Сообщение успешно получено.
Переход, сообщений нет	Новых сообщений не обнаружено.
Переход, неудача	Сервер вернул ошибку.

Запрос к веб-сервису 1С

Выполняет запрос к веб-сервису 1С, зарегистрированному в общих настройках или в самом компоненте. Тело запроса пишется на языке 1С.

Нужна интеграционная лицензия Без неё компонент не появится в редакторе сценариев вовсе.

Свойство	Описание
Запрос	Тело запроса на языке 1С.
Параметры веб-сервиса	Брать из общих настроек либо задать в компоненте — тогда появляются поля URI, логина и пароля.
URI, Логин, Пароль	Доступны только при настройке параметров в самом компоненте.
Режим запроса	Асинхронно без ожидания; ожидание ответа; ожидание ответа с таймаутом.
Таймаут, с	Только для режима ожидания с таймаутом.
Сохранять значения первой строки	Да / нет. Сохранять ли значения первой строки вернувшегося набора данных в переменные сценария, сопоставляя их имена с названиями столбцов.
Результат CSV в переменную	Переменная для результата в формате CSV.
Результат XML в переменную	Переменная для результата в формате XML.
Переход	Работа завершена удачно.
Переход, таймаут	Работа завершена по таймауту.
Переход, неудача	Веб-сервер вернул ошибку или задан неверно.

Компонент, которого больше нет

«Определить группу клиента» Компонент проверял принадлежность контакта — определившегося номера, почтового адреса или произвольного аргумента — указанной группе клиентов: так разделяли обработку звонков VIP-клиентов, контактов из чёрного списка и личных контактов.

Начиная с версии 2.11.3.150320 он перенесён в компонент «Статус объекта»: тип объекта «Контакт», функция «Проверить группу». В старых сценариях компонент ещё может встретиться.