npm 包 salesforce-email 使用教程

Salesforce 是一款业界著名的企业级 CRM 软件，其邮件功能十分强大。然而，有时候我们需要在自己的网站或者应用程序中使用 Salesforce 的邮件功能。这时候，就可以使用 npm 包 salesforce-email。

本文将详细介绍如何使用 npm 包 salesforce-email，包括如何安装、如何配置以及如何使用。

安装

使用 npm 包 salesforce-email 首先需要安装它。在命令行中执行以下命令：

npm install salesforce-email

安装完成后，即可在项目中使用这个包。

配置

在开始使用 npm 包 salesforce-email 之前，需要对其进行配置。以下是配置的步骤：

1. 登录 Salesforce，进入 Setup 页面。
2. 在左侧导航栏中选择 Email -> Organization-Wide Email Addresses。
3. 创建一个新的 Organization-Wide Email Address。需要设置以下信息：
   • Email Address：选择一个合适的邮件地址。
   • Display Name：设置显示名。
   • Access Level：选择 All Email。
   • Allow All Profiles to Use this From Address：勾选。
4. 在左侧导航栏中选择 Email -> Email Services。
5. 创建一个新的 Email Service。需要设置以下信息：
   • Email Service Name：设置一个名称。
   • Email Address：选择刚刚创建的 Organization-Wide Email Address。
   • Email Service Address：选择一个自定义的地址。例如，如果你的 Salesforce 实例为 example.my.salesforce.com，那么这个地址可以设置为 myemail@example.my.salesforce.com。
   • Apex Class：选择 EmailToCase。
   • Ensure Enable On-Demand Service Checkbox is Checked：勾选。

完成上述步骤后，即可进行下一步的配置。

在项目中添加以下代码：

const salesforceEmail = require('salesforce-email');

salesforceEmail.config({
  username: '<Salesforce用户名>',
  password: '<Salesforce密码>',
  token: '<Salesforce秘钥>',
  email: 'myemail@mydomain.com', // 配置自定义的 Email Service 地址
});

使用

salesforce-email 提供了多个方法，可以帮助我们使用 Salesforce 的邮件功能。以下是常用的方法：

send

send 方法可以发送一封邮件。以下是示例代码：

-- -------------------- ---- -------
---------------
  -------
    --- ------------------------
    -------- ----- -------
    ----- ----- -- - ---- -------
  --
  -------- -- -
    ------------------ --------
  --
  ------------ -- -
    -------------------
  ---

list

list 方法可以列出邮件。以下是示例代码：

salesforceEmail
  .list()
  .then((emails) => {
    console.log(emails);
  })
  .catch((err) => {
    console.error(err);
  });

get

get 方法可以获取一封邮件的详细信息。以下是示例代码：

salesforceEmail
  .get('emailId')
  .then((email) => {
    console.log(email);
  })
  .catch((err) => {
    console.error(err);
  });

delete

delete 方法可以删除一封邮件。以下是示例代码：

salesforceEmail
  .delete('emailId')
  .then(() => {
    console.log('Email deleted.');
  })
  .catch((err) => {
    console.error(err);
  });

总结

本文介绍了如何使用 npm 包 salesforce-email，包括安装、配置以及使用。通过使用 salesforce-email，我们可以方便地在自己的网站或者应用程序中使用 Salesforce 的邮件功能。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066b5651ab1864dac66c01