# 邮件
**HWH5.writeMail**
[支持版本\>=10.0.2](https://open.welink.huaweicloud.com/docs/#/990hh0/whokyc/fa5obu)
调起WeLink的发邮件界面，支持传递发件人及正文。
#### 请求参数
| **参数**                                    | **类型** | **必填** | **说明**     |
|:---|:---|:---|:---|
| extra_email                               | Array  | 是      | 收件人        |
| extra_subject                             | String | 是      | 主题         |
| extra_text                                | String | 是      | 内容         |
| action_send_oneboxlinks #fileExternalLink | String | 是      | 附件链接       |
| action_send_oneboxlinks #fileID           | String | 是      | 附件ID       |
| action_send_oneboxlinks #fileName         | String | 是      | 附件名称       |
| action_send_oneboxlinks #fileSize         | Number | 是      | 附件大小       |
| action_send_oneboxlinks #ownerID          | String | 是      | 附件所有人ID    |
| action_send_oneboxlinks #type             | String | 是      | 附件格式       |
| action_send_multiple                      | Array  | 否      | 多邮件附件      |
| action_send_oneboxlinks                   | Array  | 否      | 多个onebox附件 |
| extra_cc                                  | Array  | 否      | 抄送         |
| extra_bcc                                 | Array  | 否      | 密送         |
   
#### 返回结果
调起发送邮件页面。
#### 请求示例
- ES6版本
```
const emailParams = {
    'extra_email': ['aaaaaaa@xxx.com', 'bbbb@xxx.com'],
    'extra_cc': ['cccc@xxx.com', 'dddd@xxx.com'],
    'extra_bcc': ['eeee@xxx.com', 'ffff@xxx.com'],
    'extra_subject': '打开邮件UI界面',
    'extra_text': '测试{{ book.wema }}打开发送邮件见面~~祝大家工作愉快',
    'action_send_multiple': ['download/mdm_text.xlsx'],
    'action_send_oneboxlinks': [
      {
        fileExternalLink: 'http://www.aaa.com/bbb/aaaa',
        fileID: '540894',
        fileName: '测试文件.pdf',
        fileSize: 179891,
        ownerID: '16',
        type: 'pdf'
      }
    ]
  };
 
  HWH5.writeMail(JSON.stringify(emailParams)).then(_result => {
    console.log(_result);
  }).catch(error => {
    console.log('打开邮件页面发生异常', error);
  });
```
- ES5版本
```
var emailParams = {
    'extra_email': ['aaaaaaa@xxx.com', 'bbbb@xxx.com'],
    'extra_cc': ['cccc@xxx.com', 'dddd@xxx.com'],
    'extra_bcc': ['eeee@xxx.com', 'ffff@xxx.com'],
    'extra_subject': '打开邮件UI界面',
    'extra_text': '测试{{ book.wema }}打开发送邮件界面~~祝大家工作愉快',
    'action_send_multiple': ['download/mdm_text.xlsx'],
    'action_send_oneboxlinks': [
      {
        fileExternalLink: 'http://www.aaa.com/bbb/aaaa',
        fileID: '540894',
        fileName: '测试文件.pdf',
        fileSize: 179891,
        ownerID: '16',
        type: 'pdf'
      }
    ]
  };
  HWH5.writeMail(JSON.stringify(emailParams)).then(function (_result) {
    console.log(_result);
  }).catch(function (error) {
    console.log('打开邮件页面发生异常', error);
  });
```