2024-04-30 21:51:09 +02:00
|
|
|
# Message a channel by email
|
2017-01-06 23:17:54 +01:00
|
|
|
|
2021-05-14 22:25:28 +02:00
|
|
|
!!! tip ""
|
2021-09-10 00:44:29 +02:00
|
|
|
|
2021-05-14 22:25:28 +02:00
|
|
|
This feature is not available on self-hosted Zulip servers where
|
|
|
|
the [incoming email gateway][email-gateway] has not been
|
|
|
|
configured by a system administrator.
|
2023-03-23 05:32:39 +01:00
|
|
|
[email-gateway]: https://zulip.readthedocs.io/en/stable/production/email-gateway.html
|
2021-05-14 22:25:28 +02:00
|
|
|
|
2024-04-30 21:51:09 +02:00
|
|
|
You can send emails to Zulip channels. This can be useful:
|
2019-08-03 21:25:36 +02:00
|
|
|
|
|
|
|
* If you have an email that you want to discuss on Zulip
|
|
|
|
|
|
|
|
* For mirroring mailing list traffic
|
|
|
|
|
|
|
|
* For integrating a third-party app that can send emails, but which does not
|
|
|
|
easily lend itself to a more direct integration
|
|
|
|
|
|
|
|
If you're planning on doing this in an automated way, and have some
|
|
|
|
programming experience, another option is to use our [send message
|
|
|
|
API](/api/send-message).
|
2017-01-06 23:17:54 +01:00
|
|
|
|
2024-04-30 21:51:09 +02:00
|
|
|
### Message a channel by email
|
2019-03-30 19:00:24 +01:00
|
|
|
|
2019-02-13 21:24:15 +01:00
|
|
|
{start_tabs}
|
|
|
|
|
2024-05-02 17:46:14 +02:00
|
|
|
{relative|gear|channel-settings}
|
2017-01-06 23:17:54 +01:00
|
|
|
|
2024-04-30 21:51:09 +02:00
|
|
|
1. Select a channel.
|
2017-01-06 23:17:54 +01:00
|
|
|
|
2024-04-30 21:57:47 +02:00
|
|
|
{!select-channel-view-general.md!}
|
2022-03-21 13:09:47 +01:00
|
|
|
|
2022-11-22 06:26:46 +01:00
|
|
|
1. Click **Generate email address** under **Email address**.
|
|
|
|
|
|
|
|
1. Toggle the configuration options as desired.
|
|
|
|
|
2024-04-30 21:51:09 +02:00
|
|
|
1. Click **Copy address** to add the channel email address to your clipboard.
|
2017-01-06 23:17:54 +01:00
|
|
|
|
2019-08-03 21:25:36 +02:00
|
|
|
1. Send an email to that address.
|
2018-03-05 15:58:47 +01:00
|
|
|
|
2019-03-30 19:00:24 +01:00
|
|
|
{end_tabs}
|
|
|
|
|
|
|
|
The email subject will become the Zulip topic, and the email body will
|
|
|
|
become the Zulip message.
|
2019-08-03 21:25:36 +02:00
|
|
|
|
|
|
|
Note that it may take up to one minute for the message to show
|
|
|
|
up in Zulip.
|
|
|
|
|
|
|
|
## Configuration options
|
|
|
|
|
|
|
|
The options below control which parts of the email are included in the
|
2022-11-22 06:26:46 +01:00
|
|
|
Zulip message.
|
2019-08-03 21:25:36 +02:00
|
|
|
|
2022-11-22 06:26:46 +01:00
|
|
|
* **The sender's email address**: Adds `From: <Sender email address>` to
|
2019-08-03 21:25:36 +02:00
|
|
|
the top of the Zulip message.
|
|
|
|
|
2022-11-22 06:26:46 +01:00
|
|
|
* **Email footers**: By default, Zulip tries to automatically remove some footer
|
|
|
|
text (like signatures). With this option enabled, Zulip will include all footers.
|
2019-08-03 21:25:36 +02:00
|
|
|
|
2022-11-22 06:26:46 +01:00
|
|
|
* **Quoted original email**: In many email clients, when you reply to a message
|
2024-07-04 12:10:19 +02:00
|
|
|
(e.g., a message notification email), a copy of the original message is
|
2019-08-03 21:25:36 +02:00
|
|
|
automatically added to the bottom of your reply. By default, Zulip tries
|
2022-11-22 06:26:46 +01:00
|
|
|
to remove that copied message. With this option enabled, Zulip will include it.
|
2020-01-15 16:28:46 +01:00
|
|
|
|
2022-11-22 06:26:46 +01:00
|
|
|
* **Use html encoding**: The body of an email is typically encoded using
|
2020-01-15 16:28:46 +01:00
|
|
|
one or both of two common formats: plain text (`text/plain`) and
|
|
|
|
HTML (`text/html`). Zulip supports constructing the Zulip message
|
2020-08-11 01:47:49 +02:00
|
|
|
content using either (converting HTML to Markdown for the HTML
|
2020-01-15 16:28:46 +01:00
|
|
|
format). By default, Zulip will prefer using the plain text version
|
|
|
|
of an email over the converted HTML version if both are present.
|
2022-11-22 06:26:46 +01:00
|
|
|
Enabling this option overrides that behavior to prefer the HTML version
|
2020-01-15 16:28:46 +01:00
|
|
|
instead.
|
|
|
|
|
2021-07-14 08:28:01 +02:00
|
|
|
## Related articles
|
|
|
|
|
|
|
|
* [Using Zulip via email](/help/using-zulip-via-email)
|