Skip to main content

Email

The Email Channel reads one mailbox through IMAP and sends through SMTP. Anyy uses verified TLS, the mailbox INBOX, IMAP port 993, and SMTP submission port 465.

What You Need​

  • the full email address;
  • IMAP server hostname;
  • SMTP server hostname; and
  • a password or app password accepted by both services.

This profile follows the TLS guidance in RFC 8314.

Connect in Dashboard​

  1. Open Dashboard → Channel → Add.
  2. Choose Email; the default entry uses IMAP and SMTP over TLS.
  3. Enter the mailbox address, IMAP host, and SMTP host.
  4. Enter the password or provider-issued app password.
  5. Save the connection, then review access with the CLI wizard below.

The default account ID is mailbox.

Prefer an app password

When the mail provider supports app-specific passwords, use one instead of the primary account password. It is easier to revoke without disrupting the whole account.

Access Policy​

Email supports open, allowlist, or disabled direct-message policy. Sender pairing is not available for this profile.

open is the default. Run the interactive anyy setup channel wizard and choose Email to change it; the Dashboard credential form does not contain a policy control. Current Email setup actions do not expose allowlist-entry editing. An existing matching list can restrict access, but choosing allowlist does not populate it. Use disabled to stop inbound access; see the shared setup limits.

How Messages Flow​

The resident Gateway watches INBOX for new messages, resolves the sender under the configured policy, and creates a Channel conversation. Outbound replies use the same configured mailbox through SMTP. The route carries the inbound Message-ID or In-Reply-To as reply context; messages from one address do not necessarily share one Anyy Session. The IMAP UID cursor is retained across normal reconnects.

Anyy requires both receive and send authentication to pass before the connection is healthy.

Verify the Connection​

anyy channel doctor email
anyy channel reload

Send a plain-text test message from an allowed address, then verify both receipt and reply.

Troubleshooting​

ProblemCheck
Authentication failsApp password, provider IMAP/SMTP enablement, and account security policy
Receive works but send failsSMTP hostname, port 465 availability, and submission permission
Send works but receive failsIMAP hostname, port 993, and INBOX access
Sender is ignoredDM policy and allowlist entry
TLS validation failsCorrect hostnames and trusted server certificates; do not disable verification