与 Twilio 集成
标签页
PlatoForms 可以为您的表单发送短信(SMS):提交通知、邀请、文档请求、续订和工作流程任务。默认情况下,它们通过 PlatoForms SMS 发送,费用从您的积分余额中扣除,并使用固定文本。如果您有 Twilio 账户,可以连接它,通过 您自己的 Twilio 发送这些短信。
PlatoForms SMS 或您自己的 Twilio
| PlatoForms SMS | 您自己的 Twilio | |
|---|---|---|
| 发送者 | PlatoForms 发送者 | 您的 Twilio 消息服务:您的电话号码或发送者 ID |
| 费用 | 从您的 PlatoForms 积分余额中支付 | 由 Twilio 向您的账户计费。不使用 PlatoForms 积分 |
| 国家 | PlatoForms SMS 支持的国家 | 您的 Twilio 账户可以发送短信的任何国家 |
| 消息文本 | 由 PlatoForms 固定 | 您编写它,使用变量如收件人姓名和链接 |
| 新账户批准 | 一次性批准 | 不需要 |
没有 Twilio 账户?您不需要一个:PlatoForms SMS 无需任何设置即可发送您的短信,美国或加拿大的企业可以在那里注册以发送美国号码。查看 发送短信 (SMS)。这两个服务是独立的:在 PlatoForms 注册不会改变您的 Twilio 账户可以发送的内容。
您为 您的团队连接一次 Twilio。之后,您可以在每个发送短信的地方选择服务,因此一个表单可以使用您的 Twilio,而另一个则保持在 PlatoForms SMS 上。
开始之前:您需要从 Twilio 获取的内容
在 Twilio 控制台中收集这些信息:
-
一个带有发送者的消息服务。 转到 Messaging > Services,打开或创建一个服务,并将电话号码或字母数字发送者 ID 添加到其发送者池中。复制 Messaging Service SID(以
MG开头)。 -
您的账户 SID(以
AC开头),显示在 账户信息 下。 -
一个标准 API 密钥。 转到 Account > API keys & tokens,创建一个 Standard 密钥,并复制其 SID(以
SK开头)和其 secret。Twilio 仅显示一次 secret。将区域选择器保留在默认的 United States (US1)。区域不限制您可以发送短信的国家。
使用 API 密钥,永远不要使用您的 Twilio Auth Token。API 密钥可以单独撤销,而不会影响 Twilio 账户中的其他内容。
要向美国号码发送短信,Twilio 要求消息服务具有注册的 A2P 10DLC 活动或经过验证的免费号码。其他国家有自己的发送者规则,许多接受字母数字发送者 ID。查看 Twilio 对您发送短信的国家的指南。
连接您的 Twilio 账户
-
在 仪表板 上,将鼠标悬停在任何表单上,点击右上角的 设置(齿轮图标),然后点击 管理表单。
-
在左侧边栏,点击 集成。
-
找到 Twilio 卡并点击 连接。短信发送 页面将在新的浏览器标签中打开,位于 您自己的 Twilio 标签上。
Note连接是为您的整个团队进行的,所以您只需在任何表单中执行一次。您也可以从 计划和账单 > 积分余额 打开页面:在 SMS 消息 旁边点击 短信设置,然后点击 您自己的 Twilio 标签。
-
在 连接您的 Twilio 下,输入 Account SID、Messaging Service SID、API Key SID 和 API key secret,然后点击 连接。
PlatoForms 使用这些凭据检查账户、消息服务及其发送者。没有发送任何内容。API 密钥 secret 以加密形式存储。
-
当检查通过时,您自己的 Twilio 显示 已连接,并显示您的消息服务的号码或发送者 ID。
-
(可选)在 发送测试短信 下,输入一个手机号码并点击 发送测试短信 以确认交付。Twilio 向您收取此短信的费用。
为表单的短信使用您的 Twilio
连接 Twilio 本身不会改变任何东西。每个 SMS 部分将继续使用 PlatoForms SMS,直到您切换它。
-
打开您要更改的 SMS 设置,例如 管理表单 > 邀请 或 管理表单 > 通知,并开启 SMS。
-
选择 您自己的 Twilio。
-
编写短信。点击 插入 旁边的变量以添加它。手机显示内容 预览消息并显示示例值,并告诉您其长度以及它作为多少条短信发送。
-
保存您的更改。
您可以在以下每个地方做出此选择:
| 位置 | 哪些短信 |
|---|---|
| 通知 | 表单提交时发送的短信 |
| 邀请 | 邀请及其提醒 |
| 文档请求 | 文档链接、提醒和新上传请求 |
| 续订 | 续订通知 |
| 工作流程步骤通知 | 工作流程任务发送的短信 |
您自己的短信规则
- 短信最多可达 320 个字符。长消息将作为多条短信发送;预览显示有多少条。
- 仅使用为该短信提供的变量。短信中包含链接的地方(邀请、文档请求、续订和工作流程任务),必须包含
{{ link }}。 - PlatoForms 在每条短信中添加退订行:“回复 STOP 以退订。”当发送者是电话号码时,或当发送者是字母数字发送者 ID 时,添加退订链接,字母数字发送者 ID 无法接收回复。如果您的消息服务同时具有这两者,Twilio 在国家允许的情况下使用字母数字发送者 ID(除美国和加拿大外的所有地方),因此这些短信以退订链接结尾。
- 保存时检查短信。请求密码、付款详情或个人信息的短信不被接受。
- 仅向同意接收您短信的人发送短信。每天每个收件人和每个表单的限制仍然适用,以保护您发送短信的人。
| 变量 | 插入内容 | 可用于 |
|---|---|---|
{{ team }} |
您的团队名称 | 每条短信 |
{{ form }} |
表单名称 | 每条短信 |
{{ name }} |
收件人的名字 | 邀请 |
{{ link }} |
收件人打开的链接 | 邀请、文档请求、续订、工作流程步骤 |
{{ workflow }}, {{ step }} |
工作流程名称和步骤名称 | 工作流程步骤 |
{{ item }}, {{ expires }} |
文档名称及其到期日期 | 续订 |
计费和使用
- 通过您的 Twilio 发送的短信由 Twilio 向您的账户计费。PlatoForms 不对此收费,也不使用您的积分余额。
- 它们仍然显示在 使用情况 页面下的 SMS 中,费用为 $0.00。
- 留在 PlatoForms SMS 上的部分照常工作,并从您的积分余额中支付。
更换 API 密钥或断开连接
- 更换密钥: 在 Twilio 中创建一个新 API 密钥,打开 短信发送 页面(点击 Twilio 卡上的 配置),并在 重新连接您的 Twilio 下输入密钥。
- 断开连接: 点击 断开您的 Twilio。API 密钥 secret 从 PlatoForms 中移除。设置为 您自己的 Twilio 的部分返回到 PlatoForms SMS,并使用标准文本。您的选择和短信被保留,并在您重新连接时再次使用。
- 需要注意: 如果 Twilio 停止接受密钥,例如在您撤销它之后,连接显示 需要注意,团队所有者会收到电子邮件。在您重新连接之前,这些部分使用 PlatoForms SMS,这需要您的余额中的积分。
故障排除
| 您看到的 | 该怎么做 |
|---|---|
| “此消息服务没有发送者。” | 在 Twilio 中,将电话号码或字母数字发送者 ID 添加到服务的发送者池中,然后再次连接 |
| 短信未发送到美国号码 | 为消息服务注册 A2P 10DLC 活动,或使用经过验证的免费号码 |
| “请先连接您的 Twilio 账户。” | 在选择 您自己的 Twilio 之前,在 短信发送 页面连接 Twilio |
| “此短信未被接受。” | 删除请求密码、付款详情或个人信息的措辞 |
| 设置为 您自己的 Twilio 的部分使用您的积分余额 | 您的 Twilio 已断开连接或需要注意。在 您自己的 Twilio 标签上重新连接它 |
| “此消息服务没有已注册的美国发送者” | 在您的 Twilio 控制台中注册 A2P 10DLC 活动或验证免费号码。在 PlatoForms SMS 下注册您的业务无法解决此问题 |