Connect email (SMTP/IMAP) to HabariChat

Connecting email lets HabariChat send (SMTP) and receive (IMAP) messages from your mailbox, so email conversations sit alongside your chat channels in one inbox.

Connect your mailbox

HabariChat works with any email account that supports SMTP and IMAP, Gmail, Outlook, Yahoo, or your own custom domain. You enable access with your provider, then enter the outgoing and incoming server details on the connect form.

The Email (SMTP/IMAP) connect dialog in HabariChat, listing what to gather before connecting any email address using custom SMTP/IMAP settings
The Email (SMTP/IMAP) connect dialog — works with Gmail, Outlook, and custom domains; you'll enter your server details on the next step.
Prerequisites
  • An email account with SMTP/IMAP access enabled.
  • Your server details (host and port) for both SMTP and IMAP.
  • An app password if two-factor authentication is turned on.

Steps

  1. Enable SMTP/IMAP with your provider:
    • Gmail: turn on IMAP under Settings, and generate an app password if you use two-factor.
    • Outlook: enable IMAP under Mail sync settings.
    • Yahoo: generate an app password under account security.
  2. Go to Inboxes → + Connect New Channel and select Custom Email (SMTP).
  3. Fill in the SMTP (outgoing) tab: server, port, email, password, and TLS/SSL.
  4. Fill in the IMAP (incoming) tab: server, port, email, password, and SSL.
  5. Click Connect. HabariChat verifies the credentials and creates the inbox.
The Connect Email form in HabariChat showing the SMTP (Outgoing) and IMAP (Incoming) tabs, common provider settings, and fields for server, port, email address, password and a Use secure connection toggle
The SMTP / IMAP settings form — it shows common provider settings, then you fill in the server, port, email, and app password on each tab.

Common server settings

ProviderSMTP (outgoing)IMAP (incoming)
Gmailsmtp.gmail.com, port 587 (TLS) or 465 (SSL)imap.gmail.com, port 993 (SSL)
Outlooksmtp-mail.outlook.com, port 587 (TLS)outlook.office365.com, port 993 (SSL)
Yahoosmtp.mail.yahoo.com, port 587 (TLS)imap.mail.yahoo.com, port 993 (SSL)

Troubleshooting

IssueWhat to do
Authentication failedUse an app password if two-factor is on.
Connection refusedCheck the server hostname and port.
SSL/TLS errorToggle the secure-connection checkbox.
Gmail "less secure app" errorUse an app password instead of your account password.
IMAP not workingConfirm IMAP is enabled with your provider.

Common questions

Which email providers work with HabariChat?

Any provider that supports SMTP and IMAP works, including Gmail, Outlook, Yahoo, and custom domain mailboxes. You enter the outgoing (SMTP) and incoming (IMAP) server details on the connect form.

Do I need an app password to connect email?

If two-factor authentication is turned on for your mailbox, yes. Generate an app password with your provider and use it instead of your normal account password. For Gmail this is at myaccount.google.com/apppasswords.

What are the correct SMTP and IMAP settings for Gmail?

For Gmail use smtp.gmail.com on port 587 (TLS) or 465 (SSL) for outgoing, and imap.gmail.com on port 993 (SSL) for incoming. Make sure IMAP is enabled in Gmail settings first.