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

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

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

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

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

Краткое содержание

В этом руководстве рассматриваются следующие вопросы:

  • Включение основных настроек сайта для входящей почты
  • Настройка входящей почты для конкретных групп
  • Настройка входящей почты для конкретных категорий
  • Понимание поведения пересылаемых писем
  • Особые соображения для сайтов Discourse Hosted

Включение настроек сайта для входящей почты

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

  1. Перейдите в панель администратора вашего сайта
  2. В левой боковой панели нажмите Email (Почта), затем Settings (Настройки)
  3. Используйте поле фильтра для поиска каждой настройки и настройте их по мере необходимости

Вы также можете перейти напрямую по адресу /admin/config/email, чтобы получить доступ к этим настройкам.

email_in

Это главный переключатель функциональности входящей почты.

  • Метка: Enable email in (Включить входящую почту)
  • Описание: Позволяет создавать темы и сообщения в группах по электронной почте.
  • По умолчанию: Отключено

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

email_in_allowed_groups

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

  • Метка: Email in allowed groups (Группы, разрешенные для входящей почты)
  • Описание: Только пользователи из этих групп могут создавать темы или сообщения в группах по электронной почте. Оставьте пустым, чтобы разрешить всем пользователям.
  • По умолчанию: Пусто (разрешено всем пользователям)

Чтобы ограничить входящую почту конкретными группами (например, staff (персонал), moderators (модераторы)), введите названия групп, разделенные запятыми.

enable_staged_users

Эта настройка контролирует, будут ли пользователи, создающие темы по электронной почте, автоматически помещаться в стадию ожидания (требовать одобрения).

  • Метка: Enable staged users (Включить пользователей в стадии ожидания)
  • Описание: Если включено, пользователи, создающие темы по электронной почте, будут помещены в стадию ожидания и потребуют одобрения, прежде чем они смогут публиковать сообщения.
  • По умолчанию: Включено

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

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

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

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

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

Вы можете настроить группу для приема входящих писем, которые создают новые сообщения в группе. Это полезно для создания входящего почтового ящика группы, к которому можно получить доступ по электронной почте.

:information_source: Поле Incoming email (Входящая почта) появляется только если включена настройка сайта email_in и вы вошли как администратор.

  1. Перейдите на страницу групп (например, /g)
  2. Нажмите на название группы, которую хотите настроить
  3. Нажмите Manage (Управление), чтобы перейти на страницу управления группой
  4. Нажмите вкладку Interaction (Взаимодействие)
  5. Прокрутите вниз до раздела Incoming email (Входящая почта)
  6. Введите пользовательский адрес электронной почты для входящих писем в поле Custom incoming email address (Пользовательский адрес входящей почты)
  7. Отметьте флажок Accept emails from anonymous users with no accounts (Принимать письма от анонимных пользователей без учетных записей), если вы хотите разрешить пользователям без учетных записей отправлять письма в эту группу
  8. Нажмите Save (Сохранить), чтобы применить изменения

:information_source: Вы можете разделять несколько адресов электронной почты символом |. Например, group1@example.com|group2@example.com.

Видимость поля электронной почты группы

Поле Incoming email (Входящая почта) появляется только если:

  • Включена настройка сайта email_in
  • Вы вошли как администратор
  • Группа не является автоматической (системной) группой

Если поле не появляется, проверьте, включена ли настройка сайта email_in и вошли ли вы как администратор.

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

Вы можете настроить категорию для приема входящих писем, которые создают новые темы. Это полезно для создания категории, к которой можно получить доступ по электронной почте.

  1. Перейдите на страницу категории (например, /c/<category_slug>)
  2. Нажмите на иконку гаечного ключа :wrench:, чтобы редактировать категорию
  3. На странице редактирования категории нажмите переключатель Show Advanced (Показать расширенные настройки) в правом верхнем углу заголовка страницы
  4. Нажмите вкладку Settings (Настройки)
  5. Прокрутите вниз до раздела Email (Почта)
  6. Введите пользовательский адрес электронной почты для входящих писем в поле Custom incoming email address (Пользовательский адрес входящей почты)
  7. Отметьте флажок Accept emails from anonymous users with no accounts (Принимать письма от анонимных пользователей без учетных записей), если вы хотите разрешить пользователям без учетных записей отправлять письма в эту категорию
  8. Отметьте флажок Category mirrors a mailing list (Категория зеркалит рассылку), если категория связана с внешней рассылкой и все сообщения исходят из электронной почты
  9. Нажмите Save (Сохранить) в баннере внизу страницы, чтобы применить изменения

:information_source: Вы можете разделять несколько адресов электронной почты символом |. Например, category1@example.com|category2@example.com.

Пользовательский адрес входящей почты

Введите пользовательский адрес электронной почты, который будет использоваться для создания новых тем в этой категории. Например, support@example.com.

Принимать письма от анонимных пользователей без учетных записей

Если включено, пользователи, у которых нет учетной записи на вашем сайте Discourse, могут отправлять письма в эту категорию для создания новых тем. Эти пользователи будут автоматически созданы как пользователи в стадии ожидания (если включено enable_staged_users) или как активные пользователи (если enable_staged_users отключено).

Категория зеркалит рассылку

Включите это, если категория связана с внешней рассылкой и все сообщения исходят из электронной почты. Если включено:

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

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

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

Когда пользователи пересылают письма в Discourse, пересылаемое содержимое обрабатывается в соответствии с настройкой сайта forwarded_emails_behaviour. Эта настройка контролирует, как обрабатываются и отображаются пересылаемые письма в Discourse.

Настройка forwarded_emails_behaviour имеет три варианта:

  • Hide (Скрыть): Пересылаемое содержимое скрыто из сообщения. Видно только содержимое оригинального письма.
  • Quote (Цитата): Пересылаемое содержимое цитируется внизу сообщения, аналогично тому, как почтовые клиенты обрабатывают пересылаемые сообщения.
  • Create replies (Создать ответы): Для каждого пересылаемого письма создается новый ответ, а не новая тема.

Чтобы настроить эту настройку:

  1. Перейдите в панель администратора вашего сайта
  2. В левой боковой панели нажмите Email (Почта), затем Settings (Настройки)
  3. Используйте поле фильтра для поиска forwarded_emails_behaviour
  4. Выберите нужный вариант из выпадающего меню
  5. Нажмите Save (Сохранить), чтобы применить изменения

:information_source: Настройка forwarded_emails_behaviour применяется ко всем входящим письмам, независимо от того, отправлены ли они в группу или категорию.

Особые инструкции для сайтов Discourse Hosted

Если вы используете хостинг Discourse, вам нужно включить флажок «Accept incoming emails sent to» (Принимать входящие письма, отправленные на) в разделе «Accept incoming emails» (Принимать входящие письма) настроек почты:

  1. Перейдите в панель администратора вашего сайта
  2. В левой боковой панели нажмите Email (Почта), затем Settings (Настройки)
  3. Прокрутите вниз до раздела «Accept incoming emails» (Принимать входящие письма)
  4. Отметьте флажок Accept incoming emails sent to (Принимать входящие письма, отправленные на)
  5. Нажмите Save (Сохранить), чтобы применить изменения

Сайты Discourse Hosted используют специальный домен электронной почты для входящих писем ({YOUR_PREFIX}.discoursemail.com). Любой из следующих форматов может быть использован для адреса входящей почты:

  • {ANYTHING}@{YOUR_PREFIX}.discoursemail.com — где:
    • {ANYTHING} — это пользовательский адрес электронной почты, который вы настраиваете
    • {YOUR_PREFIX} — это уникальный префикс, назначенный вашему сайту. Он должен совпадать с предложенным первым набором символов перед знаком +, как показано в настройке Accept incoming emails sent to
  • {YOUR_PREFIX}+{ANYTHING}@discoursemail.com

Кроме того, если вы являетесь клиентом хостинга и хотите использовать действительно уникальный адрес электронной почты, который не соответствует ни одному из вышеуказанных форматов, вы можете сделать это, настроив адрес электронной почты через стороннего провайдера электронной почты и переслав все письма, полученные на этот адрес, на ваш сайт. Вы должны включить опцию Accept incoming emails sent to (Принимать входящие письма, отправленные на) и использовать адрес электронной почты, указанный ниже этой опции, в качестве адреса для пересылки.

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

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?