From 0b1d6bfa167d8ee22fa5f718a91bfbcbfbcdb407 Mon Sep 17 00:00:00 2001 From: Robert Hillis Date: Wed, 5 Jul 2023 02:41:57 -0400 Subject: [PATCH] Clarify IMAP character set (#27163) * Clarify IMAP character set * typo * Apply suggestions from code review * Update source/_integrations/imap.markdown * Tiny tweak * Fix parser context switching --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Franck Nijhof --- source/_integrations/imap.markdown | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/source/_integrations/imap.markdown b/source/_integrations/imap.markdown index 389a8360733..8188f2a32b4 100644 --- a/source/_integrations/imap.markdown +++ b/source/_integrations/imap.markdown @@ -41,15 +41,22 @@ By default, this integration will count unread emails. By configuring the search * `FROM`, `TO`, `SUBJECT` to find emails in a folder (see [IMAP RFC for all standard options](https://tools.ietf.org/html/rfc3501#section-6.4.4)) * [Gmail's IMAP extensions](https://developers.google.com/gmail/imap/imap-extensions) allow raw Gmail searches, like `X-GM-RAW "in: inbox older_than:7d"` to show emails older than one week in your inbox. Note that raw Gmail searches will ignore your folder configuration and search all emails in your account! + ### Selecting a charset supported by the imap server -Below is an example for setting up the integration to connect to your Microsoft 365 account that requires `US_ASCII` as charset: +Below is an example for setting up the integration to connect to your Microsoft 365 account that requires `US-ASCII` as charset: - Server: `outlook.office365.com` - Port: `993` - Username: Your full email address - Password: Your password - Charset: `US-ASCII` +
+ +Yahoo also requires the character set `US-ASCII`. + +
+ ### Selecting an alternate SSL cipher list or disable SSL verification (advanced mode) If the default IMAP server settings do not work, you might try to set an alternate SLL cipher list. @@ -67,6 +74,7 @@ The SSL cipher list and verify SSL are advanced settings. The options are availa Email providers may limit the number of reported emails. The number may be less than the limit (10,000 at least for Yahoo) even if you set the `IMAP search` to reduce the number of results. If you are not getting expected events and cleaning your Inbox or the configured folder is not desired, set up an email filter for the specific sender to go into a new folder. Then create a new config entry or modify the existing one with the desired folder. + ### Using events When a new message arrives that meets the search criteria the `imap` integration will send a custom [event](/docs/automation/trigger/#event-trigger) that can be used to trigger an automation.