mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 13:33:24 +00:00
db0cbcbdf5
The current help center renders it correctly somehow but the new help center needs it to be outisde the tip.
85 lines
3.0 KiB
Markdown
85 lines
3.0 KiB
Markdown
# Message a channel by email
|
|
|
|
!!! tip ""
|
|
|
|
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.
|
|
|
|
[email-gateway]: https://zulip.readthedocs.io/en/stable/production/email-gateway.html
|
|
|
|
You can send emails to Zulip channels. This can be useful:
|
|
|
|
* 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).
|
|
|
|
### Message a channel by email
|
|
|
|
{start_tabs}
|
|
|
|
{relative|gear|channel-settings}
|
|
|
|
1. Select a channel.
|
|
|
|
{!select-channel-view-general.md!}
|
|
|
|
1. Under **Channel details**, click **Generate email address**.
|
|
|
|
1. Select **Who should be the sender of the Zulip messages for this email
|
|
address**.
|
|
|
|
1. Toggle the configuration options as desired.
|
|
|
|
1. Click **Copy address** to add the channel email address to your clipboard.
|
|
|
|
1. Send an email to that address.
|
|
|
|
{end_tabs}
|
|
|
|
The email subject will become the Zulip topic, and the email body will
|
|
become the Zulip message.
|
|
|
|
Note that it may take up to one minute for the message to show
|
|
up in Zulip.
|
|
|
|
## Configuration options
|
|
|
|
You can configure **who should be the sender of the Zulip messages** for the
|
|
generated email address, with the following options:
|
|
|
|
* **Email Gateway bot**: This option makes it easy to see that the message
|
|
was sent via email.
|
|
* **You**: Messages will look the same as messages you send from the Zulip UI.
|
|
* [Any bot you own](/help/view-your-bots)
|
|
|
|
The following options control which parts of the email are included in the
|
|
Zulip message.
|
|
|
|
* **The sender's email address**: Adds `From: <Sender email address>` to
|
|
the top of the Zulip message.
|
|
* **Email footers**: By default, Zulip tries to automatically remove some footer
|
|
text (like signatures). With this option enabled, Zulip will include all footers.
|
|
* **Quoted original email**: In many email clients, when you reply to a message
|
|
(e.g., a message notification email), a copy of the original message is
|
|
automatically added to the bottom of your reply. By default, Zulip tries
|
|
to remove that copied message. With this option enabled, Zulip will include it.
|
|
* **Use html encoding**: The body of an email is typically encoded using
|
|
one or both of two common formats: plain text (`text/plain`) and
|
|
HTML (`text/html`). Zulip supports constructing the Zulip message
|
|
content using either (converting HTML to Markdown for the HTML
|
|
format). By default, Zulip will prefer using the plain text version
|
|
of an email over the converted HTML version if both are present.
|
|
Enabling this option overrides that behavior to prefer the HTML version
|
|
instead.
|
|
|
|
## Related articles
|
|
|
|
* [Using Zulip via email](/help/using-zulip-via-email)
|
|
* [Bots overview](/help/bots-overview)
|