## 它是什么 将您的 Aftership 账户与Botpress Bot 连接起来的绝佳集成。实时跟踪货物,并在发生更新时直接通过机器人通知用户。 ## 工作原理 启用集成后,将使用提供的 "API Key "为您的 Aftership 账户配置Webhook 订阅。只要快件的跟踪状态发生重大变化,webhook 就会向集成发送更新。 跟踪货件 "操作可用于启动货件跟踪。它需要一个 "跟踪号码",并利用 Aftership 的 API 获取和监控快件状态,在跟踪数据中嵌入一个唯一的 "对话 ID"。然后,该 Id 将用于触发对话中的 "Aftership 事件",使您的机器人能够响应货运更新。 对话 ID "是每个对话的唯一标识符。您可以在此字段中输入 `` 来嵌入您的 ID。在接收发货更新时,您可以在 "发货事件触发器 "的 "高级选项""对话 ID "字段中使用 ``。这将把更新导向相应的对话。 您可以在 Simply Great Bots Git 页面上查看完整的集成代码:[Aftership Repo](https://github.com/SimplyGreatBots/aftership) ### Aftership 设置 #### 前提条件 您必须拥有 Aftership Pro 计划或更高版本,才能接收webhook 事件跟踪。 #### 获取 API 密钥 1.进入 [Aftership 管理控制面板](https://admin.aftership.com/)。 2.导航至 "开发人员"->"API 密钥"。 3.点击 "创建 API 密钥",为密钥命名,然后选择 "保存"。 4.4. 将您的 API 密钥复制并粘贴到安全的地方,在Botpress 设置时会用到它。 ####Webhook 和秘密 1.导航至 [Tracking Dashboard -> Notifications -> Webhooks](https://admin.aftership.com/notifications/webhooks#)。 2.复制您的Webhook 保密信息并粘贴到安全的地方。在Botpress 设置过程中,您将需要使用该密码。 3.单击 "添加Webhook"。 4.将webhook 版本设置为默认的 "传统"。 5.将Botpress Aftership 集成中的Webhook URL 粘贴到 `Webhook URL` 字段。 6.保存webhook 设置。 ###Botpress 设置 1.从 Aftership 设置中复制并粘贴您的 Aftership API 密钥到 "API 密钥 "字段。 2.从 Aftership 设置中复制并粘贴您的 `Webhook Secret` 到您的 `Secret` 字段。