Ravi Email — Send
Compose new emails, reply to existing ones, or forward them from your Ravi email address.
Writing quality matters. Before drafting email content, see the ravi-email-writing skill for subject lines, HTML formatting, tone, and anti-spam best practices.
Resolving Recipients by Name
If you have the recipient's name but not their email address (e.g. "email Alice"), use ravi-contacts first:
CODEBLOCK0
Compose a new email
CODEBLOCK1
Arguments:
- -
--to (required): Recipient email address - INLINECODE1 (required): Email subject line
- INLINECODE2 (required): Email body (HTML supported — use tags like
<p>, <h2>, <ul> for formatting)
Example with HTML formatting:
CODEBLOCK2
Reply to an email
CODEBLOCK3
Forward an email
CODEBLOCK4
Arguments:
- -
--to (required): Recipient email address - INLINECODE7 (required): Email body (HTML supported)
Rate Limits
Email sending is rate-limited per user account:
- - 60 emails/hour and 500 emails/day
On hitting a rate limit, you'll get a 429 response with a retry_after_seconds value. Wait that many seconds before retrying.
Best practices for agents:
- - Avoid tight loops of email sends — batch work where possible
- On 429: parse
retry_after_seconds from the response body, wait, then retry - For bulk operations, add a 1-2 second delay between sends
Important Notes
- - HTML email bodies — the
--body argument accepts HTML. Use tags for formatting: <p>, <h2>, <ul>, <a href="...">. No <html> or <body> wrapper needed. See ravi-email-writing for templates and anti-spam rules. - Subject for replies/forwards — reply and forward commands auto-derive the subject from the original message (prepending
Re: or Fwd:). No need to pass --subject.
Full API Reference
For complete endpoint details, request/response schemas, and parameters: Messages | Attachments
Related Skills
- - ravi-contacts — Look up a person's email address by name before sending
- ravi-email-writing — Subject lines, HTML templates, tone, and anti-spam best practices
- ravi-inbox — Read incoming email before replying or forwarding
- ravi-identity — Get your email address and identity name for signatures
- ravi-feedback — Report deliverability issues or suggest email feature improvements
Ravi 邮件 — 发送
从您的 Ravi 邮箱地址撰写新邮件、回复现有邮件或转发邮件。
写作质量至关重要。 在起草邮件内容之前，请参阅 ravi-email-writing 技能，了解主题行、HTML 格式、语气和反垃圾邮件最佳实践。
按姓名解析收件人
如果您知道收件人的姓名但不知道其邮箱地址（例如给 Alice 发邮件），请先使用 ravi-contacts：
bash
按姓名搜索联系人
ravi contacts search Alice
→ 返回匹配结果，包含邮箱、电话、显示名称
如果只有一个匹配项 → 使用结果中的邮箱地址
如果有多个匹配项 → 与用户确认他们指的是哪个 Alice
如果没有匹配项 → 直接向用户询问邮箱地址
撰写新邮件
bash
ravi email compose --to recipient@example.com --subject 主题 --body
HTML 内容
参数：
- - --to（必填）：收件人邮箱地址
- --subject（必填）：邮件主题行
- --body（必填）：邮件正文（支持 HTML — 使用
、
、
带 HTML 格式的示例：
bash
ravi email compose \
--to user@example.com \
--subject 月度报告 \
--body
月度报告
主要发现：
回复邮件
bash
仅回复发件人
ravi email reply
--body 回复内容
回复所有收件人（全部回复）
ravi email reply-all --body 回复内容
转发邮件
bash
ravi email forward --to recipient@example.com --body 仅供参考 — 请见下文。
参数：
- - --to（必填）：收件人邮箱地址
- --body（必填）：邮件正文（支持 HTML）
速率限制
每个用户账户的邮件发送有速率限制：
- - 每小时 60 封邮件 和 每天 500 封邮件
达到速率限制时，您将收到 429 响应，其中包含 retryafterseconds 值。请等待相应秒数后再重试。
代理的最佳实践：
- - 避免密集循环发送邮件 — 尽可能批量处理
- 遇到 429：从响应体中解析 retryafterseconds，等待，然后重试
- 对于批量操作，在每次发送之间添加 1-2 秒的延迟
重要说明
- - HTML 邮件正文 — --body 参数接受 HTML。使用标签进行格式化：
、
- 回复/转发的主题 — 回复和转发命令会自动从原始邮件中派生主题（添加 Re: 或 Fwd: 前缀）。无需传递 --subject。
完整 API 参考
有关完整的端点详情、请求/响应模式和参数： 消息 | 附件
相关技能
- - ravi-contacts — 在发送前按姓名查找某人的邮箱地址
- ravi-email-writing — 主题行、HTML 模板、语气和反垃圾邮件最佳实践
- ravi-inbox — 在回复或转发前阅读收到的邮件
- ravi-identity — 获取您的邮箱地址和身份名称用于签名
- ravi-feedback — 报告送达问题或建议邮件功能改进
