Интеграция и подключение Email

Интеграция Gmail

OAuth-подключение и настройка

Workify предоставляет бесшовную интеграцию Gmail через аутентификацию Google OAuth:

Процесс подключения Gmail:

OAuth-авторизация: Инициируйте подключение через поток Google OAuth
Предоставление разрешений: Предоставьте необходимые разрешения для доступа к email и отправки
Управление токенами: Безопасное хранение токенов доступа и обновления
Проверка аккаунта: Проверьте владение email-аккаунтом и его действительность
Подтверждение интеграции: Получите подтверждение успешного подключения Gmail

Конфигурация OAuth:

Тип доступа: Офлайн-доступ для непрерывной функциональности email
Выбор аккаунта: Запрос на выбор аккаунта во время аутентификации
Поток согласия: Полный поток согласия, обеспечивающий правильное предоставление разрешений
Управление состоянием: Безопасная обработка параметра состояния для валидации обратного вызова

Необходимые разрешения:

Gmail Compose: Разрешение на создание и составление email-сообщений
Gmail Send: Разрешение на отправку email через подключенный аккаунт Gmail
Gmail Read Only: Разрешение на чтение входящих email для синхронизации
Calendar Events: Разрешение на управление событиями календаря (для интеграции встреч)
Calendar Read Only: Разрешение на чтение информации календаря

Функциональность Gmail API

Интеграция Gmail использует Gmail API Google для комплексного управления email:

Возможности отправки Email:

Создание сообщений: Создавайте правильно отформатированные сообщения Gmail с HTML-контентом
Кодирование темы: UTF-8 base64 кодирование для международных строк темы
MIME-форматирование: Правильные заголовки MIME-Version и Content-Type для совместимости email
Передача сообщений: Отправляйте email через Gmail API с правильной аутентификацией

Форматирование сообщений:

Поддержка HTML-контента: Полный HTML-контент email с богатым форматированием
Кодирование символов: UTF-8 кодирование для поддержки международных символов
Заголовки Email: Правильные заголовки From, To, Subject и MIME
Кодирование передачи контента: Quoted-printable кодирование для надежной доставки

Управление токенами:

Валидация токенов доступа: Автоматическая валидация истечения токенов доступа
Обработка токенов обновления: Автоматическое обновление токенов при истечении токенов доступа
Обновления токенов: Бесшовные обновления токенов без вмешательства пользователя
Обработка ошибок: Комплексная обработка ошибок для истекших или недействительных токенов

Управление аккаунтами Gmail

Аккаунты Gmail эффективно управляются в рамках командных структур:

Организация аккаунтов:

Управление на основе команд: Аккаунты Gmail организованы по командам для правильного контроля доступа
Связь с пользователем: Каждый аккаунт Gmail связан с конкретным пользователем
Поддержка нескольких аккаунтов: Пользователи могут подключать несколько аккаунтов Gmail
Идентификация провайдера: Четкая идентификация Google как email-провайдера

Хранение аккаунтов:

Безопасное хранение токенов: Токены доступа и обновления хранятся безопасно
Запись Email-адресов: Подключенные адреса Gmail хранятся для идентификации
Отслеживание статуса аккаунта: Мониторинг статуса подключения аккаунта и его действительности
Управление состояниями ошибок: Отслеживание и управление истечением токенов и состояниями ошибок

Интеграция Microsoft/Outlook

Подключение Microsoft Graph API

Workify поддерживает интеграцию Microsoft 365 и Outlook через Microsoft Graph API:

Процесс подключения Microsoft:

OAuth-редирект: Перенаправление к конечной точке авторизации Microsoft OAuth
Авторизация области: Запрос необходимых разрешений для доступа к email и календарю
Выбор аккаунта: Запрос на выбор аккаунта Microsoft
Обмен токенов: Обмен кода авторизации на токены доступа и обновления
Создание аккаунта: Создание записи UserMailbox с учетными данными Microsoft

Конфигурация Microsoft OAuth:

Выбор провайдера: Идентификация и конфигурация провайдера Microsoft
Запрос аккаунта: Запрос на выбор аккаунта для сценариев с несколькими аккаунтами
Тип ответа: Поток кода авторизации для безопасного обмена токенов
Офлайн-доступ: Офлайн-доступ для непрерывной функциональности

Необходимые области Microsoft:

Офлайн-доступ: Разрешение на возможности обновления офлайн-токенов
User.Read: Разрешение на чтение базовой информации профиля пользователя
Mail.Read: Разрешение на чтение email из подключенного аккаунта Microsoft
Mail.Send: Разрешение на отправку email через Microsoft Graph API
Calendars.ReadWrite: Разрешение на управление событиями календаря и встречами

Управление аккаунтами Microsoft

Аккаунты Microsoft бесшовно интегрированы с платформой:

Интеграция аккаунтов:

Аутентификация без состояния: Поток OAuth без состояния для безопасной аутентификации
Извлечение информации пользователя: Извлечение email и информации пользователя из ответа Microsoft
Хранение аккаунтов: Хранение токенов доступа, токенов обновления и email-адресов
Связь с командой: Связывание аккаунтов Microsoft с соответствующими командами и пользователями

Поддержка провайдера Microsoft:

Идентификация провайдера: Четкая идентификация Microsoft как email-провайдера
Отображение аккаунта: Правильные отображаемые имена и идентификация для аккаунтов Microsoft
Управление токенами: Безопасное хранение и управление токенами аутентификации Microsoft
Обработка ошибок: Комплексное логирование и обработка ошибок для аутентификации Microsoft

Управление Email-аккаунтами

Управление несколькими подключенными аккаунтами

Workify поддерживает несколько подключений email-аккаунтов на пользователя и команду:

Поддержка нескольких аккаунтов:

Разнообразие провайдеров: Поддержка как Google, так и Microsoft email-провайдеров
Командная организация: Email-аккаунты организованы по командам с правильным контролем доступа
Назначение пользователя: Каждый email-аккаунт связан с конкретными пользователями
Идентификация аккаунта: Четкая идентификация провайдеров аккаунтов и email-адресов

Функции управления аккаунтами:

Создание аккаунтов: Легкое создание новых подключений email-аккаунтов
Обновления аккаунтов: Обновление существующих учетных данных и токенов аккаунтов
Обновление аккаунтов: Обновление истекших токенов для продолжения функциональности
Отображение аккаунтов: Удобное отображение подключенных email-аккаунтов

Управление провайдерами:

Интеграция Google: Полные возможности управления аккаунтами Google/Gmail
Интеграция Microsoft: Полное управление аккаунтами Microsoft/Outlook
Выбор провайдера: Легкий выбор между поддерживаемыми email-провайдерами
Единый интерфейс: Согласованный интерфейс независимо от email-провайдера

Хранение и безопасность Email-аккаунтов

Email-аккаунты хранятся безопасно с комплексными мерами безопасности:

Безопасное хранение:

Шифрование токенов: Безопасное хранение токенов доступа и обновления
Изоляция команд: Email-аккаунты изолированы по командам для безопасности
Связь с пользователем: Аккаунты правильно связаны с авторизованными пользователями
Отслеживание провайдера: Четкое отслеживание email-провайдера для каждого аккаунта

Валидация аккаунтов:

Валидация токенов: Регулярная валидация сохраненных токенов аутентификации
Управление истечением: Автоматическая обработка истечения токенов
Отслеживание состояний ошибок: Отслеживание и управление состояниями ошибок аккаунтов
Статус подключения: Мониторинг статуса подключения для всех email-аккаунтов

Отправка Email

Отправка через подключенные аккаунты

Подключенные email-аккаунты позволяют напрямую отправлять email через внешних провайдеров:

Отправка Gmail:

Интеграция API: Отправляйте email напрямую через Gmail API
Аутентификация: Используйте сохраненные токены доступа для аутентифицированной отправки
Форматирование сообщений: Правильное форматирование сообщений для совместимости с Gmail
Подтверждение доставки: Получайте подтверждение успешной доставки email

Процесс отправки:

Выбор аккаунта: Выбирайте из доступных подключенных email-аккаунтов
Подготовка сообщений: Подготавливайте сообщения с правильным форматированием и заголовками
Аутентификация: Аутентифицируйтесь, используя сохраненные учетные данные аккаунта
Отслеживание доставки: Отслеживайте статус отправки email и результаты

Составление Email:

HTML-контент: Поддержка богатого HTML-контента email
Обработка темы: Правильное кодирование и форматирование строки темы
Управление получателями: Обработка одного и нескольких получателей
Обработка ошибок: Комплексная обработка ошибок для сбоев отправки

Управление исходящими Email

Исходящие email отслеживаются и управляются комплексно:

Отслеживание статуса Email:

Состояния статуса: Отслеживание статуса email (отправлено, не удалось, в очереди, черновик)
Подтверждение доставки: Запись успешной доставки email
Логирование ошибок: Логирование и отслеживание ошибок отправки email
Обновления статуса: Обновления статуса исходящих email в реальном времени

Функции исходящих Email:

Связь с UserMailbox: Связывание исходящих email с конкретными подключенными аккаунтами
Отслеживание получателей: Отслеживание получателей email и адресов доставки
Запись темы: Запись тем email для справки и отслеживания
Управление контентом: Управление контентом и форматированием email

Синхронизация Email

Обработка входящих Email

Workify автоматически обрабатывает входящие email из подключенных аккаунтов:

Автоматическое получение Email:

Запланированная обработка: Регулярное получение входящих email из подключенных аккаунтов
Сопоставление контактов: Сопоставление входящих email с существующими контактами в системе
Предотвращение дубликатов: Предотвращение дублирования обработки и хранения email
Извлечение сообщений: Извлечение темы, контента и метаданных email

Рабочий процесс обработки Email:

Сканирование аккаунтов: Сканирование подключенных аккаунтов Gmail на новые сообщения
Идентификация контактов: Идентификация email от известных контактов
Проверка дубликатов: Проверка существующих email для предотвращения дубликатов
Создание активности: Создание записей активности контактов для новых email
Хранение Email: Хранение деталей и контента входящих email

Интеграция активности контактов

Входящие email интегрированы с отслеживанием активности контактов:

Запись активности:

Связь с контактами: Связывание входящих email с конкретными контактами
Тип активности: Запись email как активности контактов с правильной типизацией
Интеграция временной шкалы: Включение email в временную шкалу активности контактов
Атрибуция пользователя: Связывание активности email с соответствующими пользователями

Функции активности Email:

Отслеживание темы: Запись тем email для справки по активности
Контент сообщений: Хранение контента сообщений email для просмотра
Связывание контактов: Прямые ссылки между email и записями контактов
История активности: Полная история email-коммуникаций на контакт

Преимущества синхронизации:

Единая коммуникация: Все email-коммуникации централизованы в записях контактов
Временная шкала активности: Хронологическая временная шкала всех взаимодействий с контактами
Видимость команды: Командная видимость email-коммуникаций
Контекст контактов: Полный контекст email-коммуникаций для каждого контакта