Page MenuHomePhabricator

D19986.id47713.diff
No OneTemporary

D19986.id47713.diff

diff --git a/src/docs/user/configuration/configuring_inbound_email.diviner b/src/docs/user/configuration/configuring_inbound_email.diviner
--- a/src/docs/user/configuration/configuring_inbound_email.diviner
+++ b/src/docs/user/configuration/configuring_inbound_email.diviner
@@ -15,34 +15,37 @@
**Creating Objects**: You can configure an address like `bugs@yourcompany.com`
to create new objects (like tasks) when users send email.
-In either case, users can interact with objects via `!commands` mail commands
-to apply a broader set of changes to objects (like adding subscribers, closing
-tasks, or changing priorities) beyond simply commenting.
+In either case, users can interact with objects via mail commands to apply a
+broader set of changes to objects beyond commenting. (For example, you can use
+`!close` to close a task or `!priority` to change task priority.)
To configure inbound mail, you will generally:
- Configure some mail domain to submit mail to Phabricator for processing.
- - For handling replies, set `metamta.reply-handler-domain` in configuration.
+ - For handling replies, set `metamta.reply-handler-domain` in your
+ configuration.
- For handling email that creates objects, configure inbound addresses in the
relevant application.
See below for details on each of these steps.
-Approaches
-==========
+Configuration Overview
+======================
-Inbound mail can be extremely difficult to configure correctly. This is doubly
-true if you use a local MTA.
+Usually, the most challenging part of configuring inbound mail is getting mail
+delivered to Phabricator for processing. This step can be made much easier if
+you use a third-party mail service which can submit mail to Phabricator via
+webhooks.
-There are a few approaches available:
+Some available approaches for delivering mail to Phabricator are:
| Receive Mail With | Setup | Cost | Notes |
|--------|-------|------|-------|
| Mailgun | Easy | Cheap | Recommended |
| Postmark | Easy | Cheap | Recommended |
| SendGrid | Easy | Cheap | |
-| Local MTA | Extremely Difficult | Free | Strongly discouraged! |
+| Local MTA | Difficult | Free | Discouraged |
The remainder of this document walks through configuring Phabricator to
receive mail, and then configuring your chosen transport to deliver mail
@@ -53,18 +56,20 @@
=========================
By default, Phabricator uses a `noreply@phabricator.example.com` email address
-as the "From" (configurable with `metamta.default-address`) and sets
-"Reply-To" to the user generating the email (e.g., by making a comment), if the
-mail was generated by a user action. This means that users can reply (or
-reply-all) to email to discuss changes, but the conversation won't be recorded
-in Phabricator and users will not be able to take actions like claiming tasks or
-requesting changes to revisions.
+as the "From" address when it sends mail. The exact address it uses can be
+configured with `metamta.default-address`.
+
+When a user takes an action that generates mail, Phabricator sets the
+"Reply-To" addresss for the mail to that user's name and address. This means
+that users can reply to email to discuss changes, but: the conversation won't
+be recorded in Phabricator; and users will not be able to use email commands
+to take actions or make edits.
To change this behavior so that users can interact with objects in Phabricator
over email, change the configuration key `metamta.reply-handler-domain` to some
domain you configure according to the instructions below, e.g.
-`phabricator.example.com`. Once you set this key, emails will use a
-'Reply-To' like `T123+273+af310f9220ad@phabricator.example.com`, which -- when
+`phabricator.example.com`. Once you set this key, email will use a
+"Reply-To" like `T123+273+af310f9220ad@phabricator.example.com`, which -- when
configured correctly, according to the instructions below -- will parse incoming
email and allow users to interact with Differential revisions, Maniphest tasks,
etc. over email.
@@ -82,8 +87,8 @@
==========================
You can set up application email addresses to allow users to create objects via
-email. For example, you could configure `bugs@phabricator.example.com` to creat
-a Maniphest task out of any email which is sent to it.
+email. For example, you could configure `bugs@phabricator.example.com` to
+create a Maniphest task out of any email which is sent to it.
You can find application email settings for each application at:
@@ -92,7 +97,7 @@
type=instructions, name="Select an Application" >
icon=cog, name=Configure}
-Not all application support creating objects via email.
+Not all applications support creating objects via email.
In some applications, including Maniphest, you can also configure Herald rules
with the `[ Content source ]` and/or `[ Receiving email address ]` fields to

File Metadata

Mime Type
text/plain
Expires
Tue, Mar 25, 1:06 AM (1 w, 6 d ago)
Storage Engine
blob
Storage Format
Encrypted (AES-256-CBC)
Storage Handle
7721071
Default Alt Text
D19986.id47713.diff (4 KB)

Event Timeline