如何安装和配置 Charket SMS – Charket

Charket SMS 是一款将 Salesforce CRM 与短信服务集成在一起的 AppExchange 应用程序，通过 Charket SMS，用户可以在 Salesforce 系统中向中国大陆以及国际手机号码发送验证码短信、通知短信、营销短信。

为了符合中国大陆的短信使用合规要求，Charket 并不直接提供短信发送服务，用户需自行购买短信供应商提供的相应短信套餐。目前，Charket 支持腾讯云作为短信服务提供商。使用 Charket SMS 的用户，首先需要购买和开通腾讯云的短信服务，相应产品内容及价格请参考：https://cloud.tencent.com/product/sms。相应短信发送服务的费用由用户与腾讯云完成结算，和 Charket 并不产生关联。Charket 会陆续支持更多的短信服务提供商。

安装 Charket SMS

因为 Charket SMS 是一个二代 Package，所以在 Salesforce 中安装 Charket SMS 时，需要按照先 Charket Base，再 Charket SMS，最后 SMS Service Provider 的安装顺序进行安装。

在安装时，点击链接后，需要选择 Admin Only。

Charket Base: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t10000000PZhiAAG

Charket SMS: https://login.salesforce.com/packaging/installPackage.apexp?p0=

04t10000000PYw5AAG

SMS Service Provider: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t10000000PYwAAAW

Note：下载安装完成后，在 Setup 里给相关 Users 添加以下权限：

1. 管理和使用 Charket SMS 所有功能的用户

Charket SMS - Admin

Charket SMS Providers - User

2. 仅使用查看短信功能的用户：

Charket SMS - User

3. 创建 Remote Site

在 Setup 中搜索 Remote Site Settings，点击 New Remote Site，输入 Remote Site Name，然后将 "https://sms.tencentcloudapi.com" 复制到 Remote Site URL 中，点击 Save。

配置腾讯云

1. 配置用户账号

在 Salesforce 中配置 Charket SMS，首先需要在腾讯云创建相关的用户并为其配置短信权限。

管理员需要前往腾讯云的用户列表中创建一个用户。

创建完成后，在用户列表中点击用户到详情页面，在 API 秘钥中可以查看 Access Key ID、Access Key Secret 等信息。然后点击权限并且给 User 分配 QcloudSMSFullAccess 权限。

2. 创建应用

在腾讯云短信页面，在应用管理中点击应用列表创建一个应用后，会得到 SMS SDK App ID 等信息。

3. 创建签名

用户需在腾讯云创建短信签名，等审核通过后就可以使用该签名。

4. 开启拉取短信下发状态接口

4.1 国内账户开通方式

拉取短信下发状态的接口需要在腾讯云后台联系腾讯云短信小助手开通。开启之后，发送的短信才可以获取最新的状态。如果有多个使用的 SDK App Id，每个都要开通，每个都是独立的。

在在线支持的聊天框发送开启拉取短信下发状态接口后，会自动返回联系腾讯云技术顾问的提示。

点击后，在输入框输入短信 SMS，选择后点击下一步：选择问题类型；

然后选择 API 或 SDK 问题，输入描述问题后，输入 SDKAPPID(点击链接查看)，点击接入人工，然后输入”申请开通 SDKAppId 为 xxx 应用的拉取短信下发状态“。

4.2 国际账户开通方式

客户需要用当前使用应用的 SDK App Id 去找腾讯客服开通拉取短信下发状态接口，如果有多个使用的 SDK App Id，则每个都需要开通，每个都是独立的。

1）登录到腾讯云：https://console.intl.cloud.tencent.com/

2）在腾讯云点击 Ticket

3）选择 Submit a Ticket

4）选择 Account Center

5）选择 Access Management

6）联系短信客服开通 拉取短信下发状态 接口

Priority = Urgent
Problem Description: ”申请开通 SDKAppId 为 xxx 应用的拉取短信下发状态“
Mobile: 填写自己的电话号码
Reminder: Anytime

7）点击 Submit 提交

配置在 Salesforce 发送短信

腾讯云配置完成后，用户登陆 Salesforce 网页，从 App Launcher 中进入到 Charket SMS 页面。

配置 Record Types

1. 在 SMS Service Provider 对象中，为 Txn Cloud Record Type 分配 Page Layout

a. 点击 Object Manager，搜索 SMS Service Provider；

b. 在 Page Layout 列表右上角点击 Page Layout Assignment;

c. 点击 Edit Assignment, 选中 Txn Cloud;

d. 在 Page Layout To Use 下拉框中选择新建的 Page Layout, 然后点击 Save。

e. 移除 Template Status。点击 Record Type -> Txn Cloud -> Data To Be Pushed, 将 Template Status 移动到 Available Values 中。

2.在 SMS Template 对象中，为 Txn Cloud Record Type 分配 Page Layout

a. 点击 Object Manager，搜索 SMS Template；

b. 在 Page Layout 列表右上角点击 Page Layout Assignment;

c. 点击 Edit Assignment, 选中 Txn Cloud;

d. 在 Page Layout To Use 下拉框中选择新建的 Page Layout, 然后点击 Save。

配置 SMS Service Providers

点击进入 SMS Service Providers 添加腾讯云账户相关信息。用户在此填入腾讯云账户的 Access Key ID、Access Key Secret、SMS SDK App ID 等信息。

其中：

Access Key ID：User 的 SecretId

Access Key Secret: User 的 SecretKey

SMS API Endpoint : https://sms.tencentcloudapi.com

SMS SDK App ID: 创建应用的 ID

Max Template Length: 提供商对短信内容设置的最大字符数

Data Center Region：只有使用腾讯云提供商的客户才需要对该字段赋值。有两种选择：

国际版的腾讯云，选择 Singapore
国内腾讯云，可以根据地域来选择 Beijing，Guangzhou 或 Nanjing。

Data To Be Pulled: 整点中执行 job 时主动拉取。

Message Delievery Statuses: 将发送成功的短信状态更新为 Successful。
Inbound Messages: 拉取短信回复的消息。
Template Statuses: 拉取 SMS Template 在腾讯云的审核结果。
用户可以调用 apex 接口来扩展自己的业务需求, 在 Setup -> Apex Class -> cksp_TxnCloudInboundSmsHandler, 可以在 custom logic 部分实现自己的业务需求。比如：在拉取到客户回复的消息后，会触发 bot 等。

Data To Be Pushed: 实时拉取消息。

Message Delivery Statuses: 短信发送成功后将状态更新为 Successful。
Inbound Messages: 用户回复短信消息后，会实时拉取到 Salesforce 中。

点击 Save。

配置 Webhook

在 Provider 页面的 Data To Be Pushed 中，选择 Message Delievery Statuses 和 Inbound Messages 到 chosen 中。
选择 site 后，url 和 token 自动加载到页面上。
拼接 URL：url/messageDeliveryStatuses/token/，将拼接完成的 url 保存到腾讯云的应用管理 -> 基础配置 -> 短信状态回调配置中。
拼接 URL：url/inboundMessages/token/，将拼接完成的 url 保存到腾讯云的通用管理 -> 回复回调配置中。

配置 SMS Signatures

用户首先需要在腾讯云完成短信签名的提交审核，审核通过后，在 Charket SMS Signatures 中填写在腾讯云创建的短信签名名称，并关联创建的 SMS Service Provider。签名将显示在所发送短信消息的开头。

配置 SMS Templates

点击进入 SMS Templates 创建个性化短信模板。Charket 目前支持发送三种类型的短信：验证码短信、通知短信、营销短信。

1. 验证码短信

三种短信类型中，只有验证码短信需设置有效时间。

验证码短信支持中国内地、中国香港/澳门/台湾及国际手机号码。如需向中国香港/澳门/台湾及国际手机号码发送短信，需选中 International SMS。

在 Template Content 中填入短信模板的详细内容，在 Merge Field 中勾选 Verification Code。模板创建完成后点击保存。

创建完成的模板将出现在 SMS Templates 列表中，初始状态为 Pending。约 2 个小时左右，根据腾讯云的审核结果，状态将更新为 Approved 或者 Rejected。审核通过的验证码显示为 Approved，内容不可继续编辑。显示 Pending/Rejected 的模板内容仍可继续编辑，直至审核通过。

2. 通知短信

通知短信可在 Contents 中随意指定 Merge Field。

3. 营销短信

同样，营销短信也可以根据所发送的内容和对象，个性化设置 Merge Field。

发送短信

1. 可以通过 Charket Form 或 Apex 来发送验证码

Note：使用 Charket Form 发送验证码必须要安装 Charket package。

2. 通过 Process Builder/Flow/Apex 发送通知或营销短信

Charket SMS 提供了一个 Apex action，可以通过Process Builder/Flow 调用来发送短信。

Note:

Field	Type	Value	描述	必填/可选
SMS Template ID	ID	SMS Template ID	短信模板 ID	必填
Mobile Number	String	Mobile Number	手机号码	必填
SMS Signature ID	ID	SMS Signature ID	短信签名 ID	发送国内短信必填
Current Object ID	Field Reference	[Contact].Id	设置自动 Merge 当前对象的数据	可选
Contact/Lead ID	Field Reference	[Contact].Id	发送短信通知后创建的SMS Messages 中是否关联Contact/Lead	可选

查看和跟踪数据

发送完成后，可以在 SMS Messages 中查看和跟踪发送短信的数据，包括是否发送成功、短信详情，以及更多其他相关联的数据。