|
1 | | -# Direct Reply [Email] |
| 1 | +# Direct Email reply |
2 | 2 |
|
3 | 3 | ## Introduction |
4 | 4 |
|
5 | | -Enabling this feature will allow your users to reply to chat messages by directly replying to email notifications they receive. We are using [subaddressing](https://en.wikipedia.org/wiki/Email_address#Subaddressing) for this feature. |
| 5 | +Enable this feature to allow users to reply to chat messages by directly replying to email notifications they receive. We currently use [subaddressing](https://en.wikipedia.org/wiki/Email_address#Subaddressing) for this feature. |
6 | 6 |
|
7 | | -## Setup credentials |
| 7 | +## Set up credentials |
8 | 8 |
|
9 | | -Go to Administration settings -> Email -> Direct Reply. |
| 9 | +Go to `Administration settings > Email > Direct reply`. |
10 | 10 |
|
11 | | -Enter: |
| 11 | +After that: |
12 | 12 |
|
13 | | -- select email server's protocol (`IMAP` or `POP`) |
14 | | -- your email server's host name (e.g. `imap.example.com` or `pop.example.com`) |
| 13 | +- select the email server protocol (`IMAP` or `POP`) |
| 14 | +- your email server host name (e.g. `imap.example.com` or `pop.example.com`) |
15 | 15 | - the port (143 or 993 for IMAP and 110 or 995 for POP) |
16 | 16 | - ignore TLS `true` if port 143 or 110 |
17 | 17 | - email check frequency (in minutes) if POP server (>=2) |
18 | | -- delete intercepted emails: select/keep `true` if you don't want to keep copy of email messages (in case IMAP server), recommended. |
19 | | -- Separator (default & recommended) is the character separating base & tag part of email. e.g. `base+tag@domain` (separator: +). [More info here](https://en.wikipedia.org/wiki/Email_address#Subaddressing) |
| 18 | +- delete intercepted emails. We recommend to select/keep `true` if you don't want to keep copy of email messages, in case IMAP server. |
| 19 | +- a separator (default and recommended) is the character separating base and tag part of the email. E.g.: `base+tag@domain` (separator: +). [More info here](https://en.wikipedia.org/wiki/Email_address#Subaddressing) |
20 | 20 | - your credentials (Username & password) |
21 | 21 |
|
22 | | - Once filled, click "Save changes". |
| 22 | + Once filled, click **Save changes**. |
23 | 23 |
|
24 | | -## Example Settings |
| 24 | +## Example settings |
25 | 25 |
|
26 | | -### IMAP Settings |
| 26 | +### IMAP settings |
27 | 27 |
|
28 | 28 |  |
29 | 29 |
|
30 | | -### POP3 Settings |
| 30 | +### POP3 settings |
31 | 31 |
|
32 | | -Make sure your **POP3** server **doesn't** keep **copy** of the emails, otherwise it would be treated as new message every time. |
| 32 | +Make sure your **POP3** server keeps keep **no** copy of emails, otherwise it is treated as a new message every time. |
33 | 33 |
|
34 | 34 |  |
35 | 35 |
|
36 | | -Now you can reply chat messages via email. It supports full formatting like inline, multiline, bold, italics etc. |
| 36 | +Now, you can reply chat messages via email. It supports full formatting like inline, multiline, bold, italics etc. |
37 | 37 |
|
38 | | -### Switching from IMAP to POP |
| 38 | +### Switch from IMAP to POP |
39 | 39 |
|
40 | | -- Before switching from IMAP to POP over **same** __email address__, you __must__ **empty all the folders**. Failing to delete all emails would result into **duplicate** messages, as all those messages in POP would be treated as new messages. |
| 40 | +- Before you switch from IMAP to POP over the same email address, you must empty all the folders. Keeping all emails results in duplicate messages, because all those messages in POP are treated as new messages. |
41 | 41 |
|
42 | 42 | ## Note |
43 | 43 |
|
44 | | -- As par now, emails only in **English** language are supported or at least quote `On <date>, <author> wrote:` is in English. |
| 44 | +- Currently, only emails in English are supported, or at least the quote `On <date>, <author> wrote:` is in English. |
45 | 45 |
|
46 | | -Email body in languages **other than English** may also work until and unless `On <date>, <author> wrote:` is in English or copy of **older email** is **removed** manually. |
| 46 | +An Email body in languages other than English may also work until and unless `On <date>, <author> wrote:` is in English or a copy of older email is removed manually. |
47 | 47 |
|
48 | | -- Only **text** messages will be supported, attachments are not supported yet. |
| 48 | +- Only text messages are supported; attachments are not supported yet. |
49 | 49 |
|
50 | | -## Known Issues |
| 50 | +## Known issues |
51 | 51 |
|
52 | | -### Quoted Headers |
| 52 | +### Quoted headers |
53 | 53 |
|
54 | | -Quoted headers aren't picked up if the email client breaks it up into multiple |
55 | | -lines. GMail breaks up any lines over 80 characters for you. |
| 54 | +Quoted headers aren't picked up if the email client breaks it up into multiple lines. |
| 55 | + |
| 56 | +GMail breaks up any lines over 80 characters for you. |
56 | 57 |
|
57 | 58 | ``` |
58 | 59 | On <date>, <author> |
59 | 60 | wrote: |
60 | 61 | > blah |
61 | 62 | ``` |
62 | 63 |
|
63 | | -Not to mention that we're searching for "on" and "wrote". It won't work |
64 | | -with other languages. |
| 64 | +Not to mention that we are searching for `on` and `wrote`. It doesn't work with other languages. |
65 | 65 |
|
66 | | -Possible solution: While replying, remove everything else than your actual message. |
| 66 | +**Possible solution**: while replying, remove everything else than your actual message. |
67 | 67 |
|
68 | | -### Weird Signatures |
| 68 | +### Weird signatures |
69 | 69 |
|
70 | | -Lines starting with `-` or `_` sometimes mark the beginning of |
71 | | -signatures: |
| 70 | +Lines starting with `-` or `_` sometimes mark the beginning of signatures: |
72 | 71 |
|
73 | 72 | ``` |
74 | 73 | Hello |
|
77 | 76 | Rick |
78 | 77 | ``` |
79 | 78 |
|
80 | | -Not everyone follows this convention: |
| 79 | +But some users change this convention: |
81 | 80 |
|
82 | 81 | ``` |
83 | 82 | Hello |
|
93 | 92 |
|
94 | 93 | ## Problem? |
95 | 94 |
|
96 | | -Your message wasn't posted? Or got `Invalid Email.` in Admin console? |
97 | | -This most likely means that email format was not as we expected it to be. |
98 | | -There is a possibility that you were blocked or message/room was deleted. |
| 95 | +Your message wasn't posted? Did you get an `Invalid Email` in the `Admin` console? |
| 96 | +This most likely means that the email format was not as expected. |
| 97 | +Maybe you were blocked or the message/room was deleted. |
0 commit comments