Troubleshooting common setup issues
Email to my address doesn't arrive at all
Mail routing is DNS, separate from your website. Check, in order:
- MX records point at your mailbox provider (not your web server). A common
mistake is entering a mail host without a trailing dot, so the DNS host appends
your domain (e.g.
mx.provider.com.yourdomain.com) — add the trailing dot. - SPF is a single record. If more than one system sends for your domain (e.g.
a mailbox provider plus a transactional sender), merge their
include:values into onev=spf1 … ~allrecord — never publish two. - Domain is verified/active at the mailbox provider, not just "pending".
- No server filter is silently dropping it. Some providers reject or file suspected spam without a bounce, so it can vanish with no error.
Mail arrives but no task is created
- The assistant mailbox must be linked to the connector (Connections → Assistant mailboxes). If nothing is linked, the connector fetches mail but there's no route to turn it into tasks. The guided Support setup links this for you automatically.
- If the sender isn't a workspace member, the mailbox must have "Accept email from anyone" turned on; otherwise non-member mail is quarantined.
- Check the IMAP folder on the connector matches the folder your filter files the mail into.
"Temporary authentication failure" when connecting IMAP
Usually rate-limiting after repeated failed logins — wait a few minutes and retry with the correct password. If your provider blocks IMAP when 2FA is on, use an app-specific password if it offers one for mail, or the main account password.
Drafts/answers aren't generated
An AI provider must be configured (Settings → AI). Without it, classification and knowledge answering can't run. Configure Mistral or an OpenAI-compatible endpoint and re-run.
A trial mailbox can't send replies
Some mailbox providers restrict trial accounts to internal sending only. Activate (pay for) the account before expecting outbound replies to external customers.