|
| 1 | +--- |
| 2 | +title: Sim Mailer |
| 3 | +description: Send emails to your workspace and let Sim handle them as tasks. |
| 4 | +--- |
| 5 | + |
| 6 | +import { Callout } from 'fumadocs-ui/components/callout' |
| 7 | +import { FAQ } from '@/components/ui/faq' |
| 8 | + |
| 9 | +Sim Mailer gives your workspace a dedicated email address. Forward or send emails to it and Sim will process them as tasks — reading the subject, body, and any attachments, then replying to the thread with the result. |
| 10 | + |
| 11 | +This means you can interact with Sim directly from your email client without switching apps. |
| 12 | + |
| 13 | +## Getting Started |
| 14 | + |
| 15 | +1. Navigate to **Settings** → **Inbox** |
| 16 | +2. Toggle the inbox on |
| 17 | +3. Optionally choose a custom address prefix (e.g., `acme` → `acme@mothership.sim.ai`) |
| 18 | +4. Copy your inbox address and start sending emails |
| 19 | + |
| 20 | +If you skip the custom prefix, one is generated automatically. |
| 21 | + |
| 22 | +<Callout type="info"> |
| 23 | + Changing your address creates a new inbox. The old address stops working immediately. |
| 24 | +</Callout> |
| 25 | + |
| 26 | +## What You Can Send |
| 27 | + |
| 28 | +Write your email like you would to a colleague. The subject and body become the task prompt. |
| 29 | + |
| 30 | +**Attachments are fully supported.** Images, PDFs, and documents (up to 10 MB each) are read by Sim and displayed inline in the conversation — image attachments show as previews, just like when you upload them directly in the chat. |
| 31 | + |
| 32 | +| Good email | Why it works | |
| 33 | +|------------|-------------| |
| 34 | +| "Summarize the attached PDF and list action items" | Clear task with an attachment | |
| 35 | +| "What's in this image?" with a photo attached | Sim reads and describes the image | |
| 36 | +| "Draft a reply to this forwarded thread" | Uses the email body as context | |
| 37 | + |
| 38 | +## Allowed Senders |
| 39 | + |
| 40 | +Only authorized senders can create tasks. Emails from anyone else are automatically rejected. |
| 41 | + |
| 42 | +- **Workspace members** are allowed by default — no setup needed |
| 43 | +- **External senders** can be added manually with an optional label for easy identification |
| 44 | + |
| 45 | +Manage your allowed senders list in **Settings** → **Inbox** → **Allowed Senders**. |
| 46 | + |
| 47 | +## Tracking Tasks |
| 48 | + |
| 49 | +Every email becomes a task you can track in **Settings** → **Inbox**: |
| 50 | + |
| 51 | +- **Search** by subject, sender, or body content |
| 52 | +- **Filter** by status to find what you need |
| 53 | +- **Click** any completed or failed task to jump to the full conversation |
| 54 | + |
| 55 | +### Task Statuses |
| 56 | + |
| 57 | +| Status | Meaning | |
| 58 | +|--------|---------| |
| 59 | +| **Received** | Email accepted, queued for processing | |
| 60 | +| **Processing** | Sim is actively working on it | |
| 61 | +| **Completed** | Done — the result was sent as an email reply | |
| 62 | +| **Failed** | Something went wrong during execution | |
| 63 | +| **Rejected** | Email blocked (sender not allowed, automated sender, or rate limit exceeded) | |
| 64 | + |
| 65 | +## Conversations |
| 66 | + |
| 67 | +Each email task creates a conversation in your workspace. You can continue the conversation from the Sim chat interface, and any follow-up emails in the same thread are linked to the same conversation. |
| 68 | + |
| 69 | +<FAQ items={[ |
| 70 | + { question: "Can I use my own email domain?", answer: "Not currently. All inbox addresses use the @mothership.sim.ai domain. You can customize the prefix (e.g., acme@mothership.sim.ai) but not the domain itself." }, |
| 71 | + { question: "What happens if I send from an unauthorized email?", answer: "The email is automatically rejected. Only workspace members and manually added external senders can create tasks." }, |
| 72 | + { question: "Is there a size limit for attachments?", answer: "Yes, each attachment can be up to 10 MB. Images, PDFs, and common document formats are supported." }, |
| 73 | + { question: "Can I reply to Sim's email responses?", answer: "Yes. Replies in the same email thread are linked to the original conversation, so you can continue the interaction from your email client." }, |
| 74 | + { question: "How long does it take to process an email?", answer: "Most emails are processed within a few seconds. Emails with large attachments or complex tasks may take slightly longer." }, |
| 75 | + { question: "Can multiple people in my workspace use the same inbox?", answer: "Yes. All workspace members can send to the shared inbox address. Each email creates its own task and conversation." }, |
| 76 | +]} /> |
0 commit comments