Настройка входящей почты для создания новых тем или групповых сообщений

:bookmark: Это руководство объясняет, как настроить входящие письма для создания новых тем или групповых сообщений в Discourse, включая конфигурацию настроек сайта и специфических настроек категорий или групп.

:person_raising_hand: Требуемый уровень пользователя: Администратор

Это руководство охватывает:

  • Включение и настройку входящих писем
  • Выбор между категорией и группой для входящих писем
  • Настройку входящих писем для группы
  • Настройку входящих писем для категории
  • Решение о том, как обрабатываются пересланные письма

:information_source: Если вы уже настроили ответ по электронной почте или используете тарифный план хостинга, который предварительно настраивает ваши входящие письма, вы готовы приступить к настройке создания новой темы по электронной почте.

Настройка параметров сайта

Чтобы включить входящие письма, необходимо настроить три основных параметра сайта:

  1. email_in: Этот параметр должен быть включен для работы входящих писем.
  2. email_in_allowed_groups: Пользователи должны состоять хотя бы в одной из групп, указанных в этом списке, чтобы отправлять письма в Discourse. По умолчанию сюда входят администраторы, модераторы и пользователи с уровнем доверия 2.
  3. enable_staged_users: Этот параметр позволяет создавать временных пользователей для неизвестных адресов электронной почты.

:warning: Для сайтов, размещенных на платформе Discourse, параметр enable_staged_users отключен и скрыт во время пробного периода для предотвращения злоупотреблений. После начала подписки параметр становится видимым. Чтобы запросить его включение во время пробного периода, свяжитесь с team@discourse.org.

Чтобы настроить эти параметры:

  1. Перейдите в панель администратора вашего сайта.
  2. Перейдите в раздел Настройки.
  3. Найдите каждый параметр и настройте его по мере необходимости.

:information_source: Временные пользователи — это специальные учетные записи в Discourse, создаваемые для поддержки входящих писем от любых лиц. Они имеют ограниченный функционал:

  • Их нельзя упомянуть или найти через поиск
  • Они не получают дайджесты
  • Они могут быть уведомлены и отвечать только на темы, которые они создали или в которые были приглашены
  • Если они создадут учетную запись, используя тот же адрес электронной почты, они будут повышены до статуса обычного пользователя

Выбор между категориями и группами

Определите, хотите ли вы, чтобы входящие письма создавали темы в категории или сообщения в группе.

Использование группы

Преимущества использования группы:

  • Полезно для настройки рабочего процесса, похожего на службу поддержки
  • Создает сообщение, отправляемое всем участникам группы
  • Сообщения отображаются в разделе /my/messages
  • Любой может отправить письмо в группу
  • Любой участник группы может читать, отвечать, удалять или архивировать сообщение
  • Каждый участник группы имеет собственное состояние отслеживания прочтения

Использование категории

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

  • Имитирует рассылку
  • Создает тему в указанной категории
  • Любой, у кого есть доступ к категории, может читать и отвечать через веб-интерфейс или по электронной почте
  • Учитывает настройки безопасности категории
  • Учитывает параметр сайта email_in_allowed_groups
  • Позволяет отключать создание временных пользователей для каждой категории отдельно

Настройка входящих писем для группы

Чтобы настроить входящие письма для группы:

  1. Перейдите на страницу Группы в главном меню.

  2. Нажмите на название группы (или создайте новую группу).

  3. Для новой группы найдите поле «Пользовательский адрес входящей электронной почты» в нижней части формы.

  4. Для существующей группы перейдите на вкладку Управление, затем в левом меню выберите Взаимодействие.

  5. Введите адрес (адреса) электронной почты, который вы хотите связать с группой (несколько адресов разделяйте символом |).

  6. Нажмите Сохранить, чтобы применить изменения.

:warning: Для сайтов, размещенных на платформе Discourse, см. дополнительные инструкции ниже.

Настройка входящих писем для категории

Чтобы настроить входящие письма для категории:

  1. Перейдите на страницу категории (например, /c/<slug_категории>).

  2. Нажмите кнопку :wrench: гаечный ключ, чтобы отредактировать категорию.
    Кнопка редактирования категории

  3. На странице редактирования категории перейдите на вкладку Настройки.

  4. Найдите поля «Принимать письма от анонимных пользователей без учетных записей» и «Пользовательский адрес входящей электронной почты».

  5. Включите опцию «Принимать письма от анонимных пользователей без учетных записей», если вы хотите создавать временных пользователей для неизвестных адресов электронной почты.

  6. Введите адрес (адреса) электронной почты, который вы хотите связать с категорией.

  7. Нажмите Сохранить категорию, чтобы применить изменения.

:warning: Для сайтов, размещенных на платформе Discourse, см. дополнительные инструкции ниже.

Поведение пересланных писем

Вы можете определить, как пересланные письма будут отображаться в Discourse, используя параметр сайта forwarded_emails_behaviour, который имеет следующие варианты:

  • hide (скрыть) — будет создана новая тема или личное сообщение, где пересланный текст включен как скрытый текст, который можно развернуть для просмотра.
  • quote (цитировать) — будет создана новая тема или личное сообщение, где пересланный текст включен как цитата.
  • create replies (создать ответы) — будет создана новая тема или личное сообщение, автором которых является оригинальный отправитель. Ответы будут созданы авторами участников переписки. Если учетные записи пользователей, соответствующие адресам электронной почты отправителей, еще не существуют, они будут созданы как временные учетные записи.

Специальные инструкции для сайтов на платформе Discourse

Клиенты Discourse должны использовать следующие форматы для своего адреса входящей электронной почты:

  • {ЛЮБОЕ_СЛОВО}@{ВАШ_ПРЕФИКС}.discoursemail.com
  • {ВАШ_ПРЕФИКС}+{ЛЮБОЕ_СЛОВО}@discoursemail.com
  • {ЛЮБОЕ_СЛОВО}@{ВАШ_ДОМЕН_САЙТА}

Где:

  • Слово ЛЮБОЕ_СЛОВО можно заменить любым набором символов, разрешенных в стандартном адресе электронной почты.
  • Фраза ВАШ_ПРЕФИКС соответствует предложенному набору первых символов перед знаком +, который отображается в настройке «Принимать входящие письма, отправленные на».
    См. скриншот

  • Фраза ВАШ_ДОМЕН_САЙТА соответствует доменному имени, которое люди используют для доступа к вашему сайту (без протокола https://).
  • Все фигурные скобки удаляются.

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

Дополнительные ресурсы

50 лайков
Understanding email in functionality
Troubleshoot reply by email
Good use cases for groups (to better understand groups vs categories)
Post without signup?
Setting an incoming e-mail address for the staff group
When site require approvals for users, email replies do not get sent to staged users
How to configure group email address
Receiving emails into Discourse messages. Can this be done?
Use Discourse as a Private Support/Ticket System
Configuring alternative incoming email address for hosted account
Start Discourse by Mail
Using discourse to manage support emails: receive and reply
How do I set up group email addresses?
Creating a staged user with an API call
Good guide on how to use discourse via email
Start Topic via E-Mail with different domain
Utilising email support for reporting from grafana
Category configuration option : mirrors a mailing list
Discourse will not accept forwarded email but successfully sends and an error message to the original sender?
Changing email subject line should start a new topic
Can Discourse accept attachments when using emails to create new category topics?
Implementing KCS
Use aliases in iRedMail for categories with incoming email feature enabled
What is the "Custom incoming email address"?
Preferred communication channel for accessibility for blind readers?
Trying to setup direct delivery of incoming email and new topic by email
Can I start a new topic by sending an email message?
Canonical doc on using discourse via email for end-users?
"Email in allowed groups" setting is too permissive
Error adding a backup email address: address already in use by a staged user
Find the reply key for a specific topic. Rails console magic?
Allowing email from a stranger because I trust them. How?
Can’t set email-in for existing group?
Query about creating topics in a category using email
Use Discourse as a Private Support/Ticket System
What exact email address do I use for “Custom Incoming email address”?
Contact Form
How to configure Discourse to receive email from Mailgun?
Can an admin create a staged user?
Simple sensor-driven notifications in Discourse via Webhooks or MQTT?
Configuring Incoming Email to Create Category Topics or Group Messages
Configuring Incoming Email to Create Category Topics or Group Messages
Setting up a support inbox
Category configuration option : mirrors a mailing list
[PAID] Auto create new topic when I publish a video on YouTube
Who is Discobot?
Configuring incoming email to create new topics with email forwarding?
Anonymous form that creates a topic
How to go about hosting a design contest?
Can I start a new topic by sending an email message?
Can I start a new topic by sending an email message?
Can’t set email-in for existing group?
Can’t set email-in for existing group?
Discourse 1.9.0.beta15 Release Notes
Registering unregistered users on first email a la mailman?
Private support categories: staged users can email in, but not registered users
Creating a topic via email without write access to the category?
What is a staged user?
New group PM from email
How to create topics from a custom email address?