Skip to main content
Gobii can send and receive email using the default delivery provider. If you want an agent to use your own mailbox, configure SMTP (outbound) and IMAP (inbound) on the agent’s Email Settings page.

​
Where to configure

Open the Console and go to the agent:
  • Gobii Cloud: https://gobii.ai/console/agents/<agent_id>/email/
  • Self-hosted: http://localhost:8000/console/agents/<agent_id>/email/
If your agent does not have an email address yet, set one first. The Email Settings page will use that address as the From/To mailbox for custom SMTP/IMAP.

​
SMTP (outbound) fields

Required fields when outbound is enabled:
  • Host: SMTP server hostname
  • Port: Usually 587 (STARTTLS) or 465 (SSL)
  • Security: STARTTLS, SSL, or None
  • Auth mode: LOGIN, PLAIN, or None
  • Username: Full email address
  • Password: Mailbox password or app password

​
IMAP (inbound) fields

Required fields when inbound is enabled:
  • Host: IMAP server hostname
  • Port: Usually 993 (SSL) or 143 (STARTTLS)
  • Security: SSL, STARTTLS, or None
  • Username: Full email address
  • Password: Mailbox password or app password
  • Folder: Defaults to INBOX
Optional:
  • IMAP IDLE: Enables low-latency triggers when supported by your deployment.

​
Disable IMAP service (self-hosted)

The IMAP IDLE runner is optional. If you do not want low-latency IMAP IDLE triggers, do not run the imap-idlers service (compose profiles imap/email).

​
Example: Gmail

Use an app password if the account has 2FA enabled. SMTP (outbound):
  • Host: smtp.gmail.com
  • Port: 587
  • Security: STARTTLS
  • Auth: LOGIN
  • Username: your.name@gmail.com
  • Password: app_password
IMAP (inbound):
  • Host: imap.gmail.com
  • Port: 993
  • Security: SSL
  • Username: your.name@gmail.com
  • Password: app_password
  • Folder: INBOX

​
Example: Outlook (Office 365)

Make sure Authenticated SMTP is enabled for the mailbox. SMTP (outbound):
  • Host: smtp.office365.com
  • Port: 587
  • Security: STARTTLS
  • Auth: LOGIN
  • Username: your.name@company.com
  • Password: mailbox_password (or app password if required)
IMAP (inbound):
  • Host: outlook.office365.com
  • Port: 993
  • Security: SSL
  • Username: your.name@company.com
  • Password: mailbox_password (or app password if required)
  • Folder: INBOX

​
Test and save

After saving, use Test SMTP and Test IMAP from the Email Settings page to verify connectivity before enabling outbound or inbound.

​
Common issues

  • Auth errors: Use an app password and confirm SMTP auth is enabled for the mailbox.
  • No inbound messages: Ensure IMAP is enabled for the mailbox and the folder is correct.
  • Connection timeouts: Double-check the host, port, and security settings.