Интеграции и внешние сервисы

Работа с компонентом Email в Afina

Интеграция Email Component — центральный хаб автоматизации входящих сообщений в Afina. Это то место, где каждое подключение, поиск сообщения и правило извлечения находят свой дом. Пользователь получает удобный опыт настройки почтового ящика через IMAP, передачи учётных данных в Afina и запуска скриптов, которые читают сообщения, реагируют на события и обновляют операторов в реальном времени. Кроме того, интеграция обеспечивает надёжное управление email-адресами, паролями приложений, именами хостов, портами, правилами поиска и данными сообщений, привязанными к каждому скрипту.

Когда ящик загружен в систему, раздел отображает всю конфигурацию целиком. Главное удобство: пользователь может отслеживать подключённые ящики, за секунды находить любого нужного получателя по тегам и запускать чтения сразу по многим скриптам в один клик.

Преимущества персонального компонента Email

Через переменную __setting__email__ доступен широкий перечень типов сообщений под любую бизнес-задачу.
Пользователи могут настраивать, какие ящики питают какие скрипты, через корректную настройку IMAP.
Сценарии автоматизации без труда обращаются к сообщению через сохранённую переменную интеграции.
Интеграция поддерживает как одиночные чтения, так и полноценные потоки переписки в любой момент.
Любой пользователь получает удобный опыт построения автоматизации вокруг входящих сообщений с уникальной конфигурацией ящика.

После сохранения ящика свежесозданная интеграция встаёт в общий список записей в разделе «Settings». С этого момента пользователь может связывать сообщения со скриптами, редактировать правила уведомлений, привязывать ящик к пайплайну, помечать старые ящики на чистку, цеплять нужные учётные данные к рабочему процессу и отправлять интеграцию в задачи автоматизации. Таким образом, каждый только что созданный ящик становится сразу готовым к работе.

Настройка ящика через IMAP

Использовать поток чтения входящих в Afina есть масса причин. Во-первых, он обеспечивает блестящую скорость для свежих интеграций. Затем пользователь может сместить фокус на надёжность уже подготовленных данных сообщений. Поток отлично подходит для быстрой раскрутки персональной привязки ящика, развёртывания большого пакета уведомлений сразу или восстановления известной рабочей мессенджинговой настройки после изменений в системе.

Кроме того, кнопка Check connection внутри панели интеграции даёт бесперебойный доступ к проверке учётных данных. Пользователь выбирает адрес и пароль и отправляет оба значения в соответствующие слоты. Остальное платформа берёт на себя.

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

Привязка поисков в Afina

Под разные бизнес-задачи доступны разные сценарии подключения. Пользователи могут подкидывать ящик по одному за раз или ротировать целую пачку учётных данных при изменениях в каталоге. Для рутинной чистки достаточно отметить нужные строки в списке переменных через чекбоксы. Сама опция ротации находится внутри списка глобальных переменных в верхней части раздела «Settings».

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

С другой стороны, удаление — не всегда правильный шаг. Многие пользователи предпочитают сохранить старый ящик, перевесить ему тег, поменять список учётных данных или переключить ящик на свежий адрес. Плюс в том, что ящик просто остаётся на скамейке запасных, и никакие данные не уходят навсегда.

Хранение извлечённых значений

Каждый компонент Email в Afina способен нести объёмную нагрузку учётных данных. Эти данные ровно то, к чему обращаются скрипты и задачи автоматизации во время выполнения. К примеру, учётные данные ящика, идентификаторы хоста, теги получателей, варианты поиска, резервные адреса и любые другие параметры, которые у каждого ящика должны выглядеть по-своему.

Самое ценное в этой функциональности — переиспользуемость. Одни учётные данные можно применять везде с одинаково стабильными результатами. Каждый скрипт подставляет своё значение, когда вызов доходит до шага мессенджинга. Вместо клонирования учётных данных под каждый скрипт пользователь просто грамотно готовит переменную. Таким образом, автоматизация становится гибче.

Кроме того, Afina предлагает два формата хранения учётных данных: стандартный и зашифрованный. Зашифрованные учётные данные предназначены для чувствительной информации, которую не стоит держать в открытом виде. Например, API-токены, пароли приложений, коды восстановления и любые другие конфиденциальные значения, которые пользователь хочет держать в безопасности.

Оба вида учётных данных следуют шаблону именования __setting__email__ и попадают в скрипты через конструкцию глобальной переменной. Функция безупречна для подвязки сотни скриптов к одному и тому же ящику за один заход. Этим возможности не ограничиваются. Пользователи могут привязывать переменную к плановым окнам ротации или сохранять снапшот перед серьёзными изменениями.