客户端 API/网页应用/小程序API/开放接口/邮件/mailto
# mailto(Object object)

调用系统发送邮件，调用邮件程序后会立即返回结果。后续登录账户、切换账户、发送、编辑、取消、失败等流程不会有回调。

## 支持说明

应用能力 | Android | iOS | PC | 预览效果
---|---|---|---|---
小程序 | V2.2.0+ | V2.2.0+ | **X** | 预览
网页应用 | V3.44+ | V3.44+ | **X** | 预览

## 输入
继承[标准对象输入](https://open.larksuite.com/document/uYjL24iN/ukzNy4SO3IjL5cjM)，扩展属性描述：

名称 | 数据类型 | 必填 | 默认值 | 描述
---|---|---|---|---
to | string[] | 否 | &nbsp; | 收件人邮箱列表<br>**示例值**：["test@gmail.com"]
cc | string[] | 否 | &nbsp; | 抄送邮箱列表<br>**示例值**：["test.cc@gmail.com", "test.cc2@gmail.com"]
bcc | string[] | 否 | &nbsp; | 密送邮箱列表<br>**示例值**：["test.bcc@gmail.com"]
subject | string | 否 | &nbsp; | 主题<br>**示例值**：测试
body | string | 否 | &nbsp; | 邮件内容<br>**示例值**：测试

## 输出

继承[标准对象输出](https://open.larksuite.com/document/uYjL24iN/ukzNy4SO3IjL5cjM#8c92acb8)，无扩展属性

## 示例代码

```js
tt.mailto({
    to: [
        "test@gmail.com"
    ],
    cc: [
        "test.cc@gmail.com",
        "test.cc2@gmail.com"
    ],
    bcc: [
        "test.bcc@gmail.com"
    ],
    subject: "测试",
    body: "测试",
    success(res) {
      console.log(JSON.stringify(res));
    },
    fail(res) {
      console.log(`mailto fail: ${JSON.stringify(res)}`);
    }
});
```

`success`返回对象示例：
```json
{
    "errMsg": "mailto:ok"
}
```