Интеграция
Получение событий из Клиентикс CRM → Отправка e-mail через свой ящик
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
- Настройка отправки письма через свой почтовый ящик: подключение, получатели, тема, сообщение, HTML-версия и подстановка данных из сценария.
Отдельные инструкции: источник «Получение событий из Клиентикс CRM» · действие «Отправка e-mail через свой ящик»
Создание подключений
Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.
Подключение Яндекс Почты
Доступ в настройках Яндекс Почты
Перед подключением разрешите доступ почтовым программам в аккаунте Яндекса.
- Откройте Яндекс Почту и перейдите в настройки раздела «Почтовые программы».
- Включите галочку «С сервера imap.yandex.ru по протоколу IMAP».
- Убедитесь, что выбран способ авторизации «Пароли приложений и OAuth-токены».
- Нажмите «Сохранить».
Создание подключения
- В меню слева откройте «Подключения».
- Нажмите «+» и выберите тип «Яндекс Почта».
- При необходимости укажите «Название» подключения.
- Нажмите «Подключить».
Авторизация Яндекса
- Откроется страница авторизации Яндекса - войдите в нужный аккаунт.
- Подтвердите доступ приложению к отправке писем.
- После успешной авторизации вы вернётесь в сервис - подключение создастся автоматически.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «klientiks.ru» и нажмите кнопку «Выбрать».
Источник «klientiks.ru»
Клиентикс CRM отправляет события на webhook URL. Создайте обработчик в eventHandlers и укажите URL источника.
URL вебхука
- Выберите нужный тип источника и нажмите «Выбрать».
- Нажмите «Сохранить».
- Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.
Обработчик в Клиентикс
- В Клиентикс CRM откройте
https://klientiks.ru/clientix/admin/eventHandlers. - Создайте или отредактируйте обработчик нужного события.
- Вставьте скопированный URL источника.
- Сохраните обработчик событий.
Действие «Отправить e-mail через свой ящик»
Письмо отправляется с адреса, указанного в подключении «Электронная почта». В форме действия вы выберете это подключение, зададите получателей, тему и текст, подставив данные из предыдущих шагов сценария.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Подключение
- В поле «Подключение» выберите ранее созданное подключение типа «Электронная почта», через которое будет отправляться письмо.
Адрес и получатели
- В поле «От (имя)» при необходимости укажите отображаемое имя отправителя, например «Отдел продаж». Сам email-адрес задаётся в подключении и в действии не меняется.
- В поле «Получатель» укажите один или несколько адресов. Чтобы подставить адрес из данных сценария, выберите переменную в панели справа и вставьте её в поле.
- При необходимости заполните «Копия», «Скрытая копия» и «Обратный адрес» - в каждом поле можно указать один или несколько адресов.
Тема и содержание
- В поле «Тема» задайте заголовок письма - текстом или с переменными из панели справа.
- В поле «Сообщение» соберите основной текст письма из текста и данных предыдущих шагов.
- Если нужна HTML-разметка, заполните «HTML-версия». Если поле пустое, получатели увидят только текст из «Сообщения».
Сохранение
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».
