以下是在 Mailsoftly 中创建工作流程的示例方法和说明。
1 – 在 Mailsoftly 中创建 Webhook 端点
您必须首先单击 设置 ,然后选择左侧导航栏底部的 图标 公司设置 访问公司设置的选项。
导航到相关部分后,有两个部分值得关注: API 密钥 和 Webhook 端点。
API 密钥部分包含我们的应用程序识别来自外部源的传入请求以进行身份验证所需的密钥。
另一方面,Webhook 端点是一个捕获点,我们将使用它来确保传入的 Webhook 请求到达我们并可用。 让我们首先单击 Webhook 端点 部分并继续创建端点。
当我们访问Webhook端点页面时,如果我们已经创建了Webhook端点,我们将看到它们的列表,并且在右上角会有一个 创建新端点 创建新的 webhook 端点。 现在让我们创建一个新端点。 因此,我们点击按钮 创建新端点 按钮。
当我们单击此按钮时,将自动创建一个具有唯一名称的端点。 现在让我们更改此名称以便更好记住。 通过单击带下划线的端点名称,我们可以在打开的字段中对其进行编辑。 作为例子,我们修改为 端点示例。
2 – 创建用于访问 Webhook 的 API 密钥
现在我们已经创建了一个端点,这意味着我们有了一个可以接收请求的点。 但是,为了使这些传入请求与我们相关联,我们需要一个密钥。 如果没有此 API 密钥,则无法执行身份验证。 现在让我们创建一个 API 密钥。 为此,请单击按钮 API 密钥 左侧部分。
如果您已离开此页面,您可以通过以下方式访问 API 密钥部分 设置 > 公司设置 > API 密钥。
导航到 API 密钥页面后,让我们使用以下命令创建一个新的 API 密钥 创建访问密钥 按钮位于右上角。
重要的: 当我们点击 创建访问密钥 按钮,将打开一个窗口,向我们显示我们的 API 密钥 一次 这样我们就可以复制。 出于安全原因,我们稍后将无法查看此密钥。
单击后,请务必在安全的地方记下您的 API 密钥。
3 – 向另一个应用程序提供信息,该应用程序将向 Mailsoftly 发送信息
要接收来自另一个应用程序的 Webhook 请求,我们可能需要向该应用程序提供 API 密钥和 Webhook 端点地址。 此时,传达如下信息是正确的:
时期:https://app.mailsoftly.com/catch/1/1(例子)
API密钥: aF3D9Dq3************************(例子)
关于第三方应用程序的注意事项:仅在以下情况下才接受 Webhook 请求 工作 请求和 API 密钥必须包含在 你头脑里 名称下传入请求的部分 授权。
上面提供了示例通信和示例数据。
请确保您发送的信息与您创建的端点地址匹配,并且您的 API 密钥正确。
笔记:可以使用一个 API 密钥激活端点,但多个 API 密钥也可以验证同一端点,反之亦然。
因此,如果您创建了多个 API 密钥并拥有多个 Webhook 端点,则每个端点都可以进行身份验证并被另一个端点使用。 您不需要拥有单个 API 密钥或使用单个 Webhook。
4 – 为未来传入的 webhook 请求创建工作流程
此时,当我们确定可以开始接收 Webhook 请求时(在本例中,当第三方应用程序确认其已进行必要的设置时),我们需要配置如何处理传入请求。
我们通过自动化的小元素来管理传入的请求 工作流程要创建工作流程,我们首先单击 工作流程 左侧导航部分并导航到我们可以管理工作流程的页面。
到达相关页面后,我们点击 创建端点工作流程 位于右上角。 单击后,在打开的窗口中,选择我们在“选择端点”部分中配置的 Webhook 端点。
例如,我们将其名称更改为“Sample Endpoint”。 那么让我们做出这样的选择。
做出选择后,我们点击 创建工作流程 在窗口的右下角。 这将带我们进入编辑器,为所选端点创建工作流程。 感谢这个向导,我们将能够对传入的数据执行所需的操作。
5 – 配置数据捕获和工作流程操作
在编辑器中,我们将看到初始屏幕。 在这里,我们可以管理触发器(在我们的例子中是 Webhook)和后续操作。 每个工作流都与一个触发器(或多个触发器)一起工作,并开始按顺序处理传入数据的添加操作。 让我们看看如何做到这一点。 当我们单击“触发器”部分时,右侧会打开一个面板。
右侧面板包含使用示例和有关传入请求的信息。
如果我们用来发送 Webhook 请求的应用程序具有 Webhook 测试接口,我们可以使用该信息向我们发送测试请求。
现在让我们看看如何执行这些步骤。
6 – 接收来自第三方应用程序的请求
要接收来自第三方应用程序的 Webhook 请求,一旦第三方应用程序团队配置了 Webhook 设置,我们就会像普通客户端一样导航到我们自己的第三方应用程序页面,并创建一个将触发 Webhook 的操作。
创建约会后,如果所有步骤均正确(端点 URL、API 密钥和第三方应用程序 Webhook 设置),我们应该已收到请求。 此时我们点击右侧面板中的“我发送了请求”按钮来检查请求是否已收到。
如果成功收到请求,我们会看到绿色的 DATA FOUND 消息,然后我们可以单击按钮 查看捕获的数据 按钮查看接收到的数据。 这使我们能够了解收到的数据是否是我们所期望的。
如果过程中出现问题,数据无法到达端点(此问题可能是由于 webhook 配置、信息不正确或网络错误),按钮颜色会变为红色,我们会看到消息 重新开始。
在这种情况下,通常表示由于上述原因之一而发生错误,但请求仍然可能需要几分钟才能到达目的地。
在此过程中,我们可以使用RETRY按钮再次检查数据。
7 – 确定行动
配置触发器后,我们现在可以配置操作。
这使我们能够确定可以对传入数据采取哪些操作并创建工作流程。
为此,我们单击 添加事件 按钮位于左侧触发器下方。
当我们点击 添加事件 按钮,将创建一个新的事件框,我们将看到 选择一个事件 里面。
要选择操作,请单击标记为 选择一个事件 并关注右侧面板以创建工作流程。
在右侧面板中 活动详情 部分,让我们从标题为的下拉列表中选择事件类型 选择事件类型 以下。
目前,仅 运行任务 可以选择。 现在让我们继续这个选择。
然后,从随后的下拉列表中,我们可以选择所需的操作。
在此示例中,由于我们要创建企业邮箱草稿,因此我们选择了选项 创建草稿 选项。
选择所需的操作后,系统将提示我们在下面输入该操作的必要信息。
如果您没有设计模板,可以点击 按钮 创建一个新的 链接以在新选项卡中访问相关页面。
创建设计后,您可以返回到此选项卡并使用框右侧的刷新按钮来更新您的设计池并使您的设计模板可供选择。
为了确保所选模板是正确的,您可以打开一个窗口来预览设计 显示所选型号 按钮。
重要的提示:使用 自定义字段如上例图所示,您需要以 Mailsoftly 的自定义字段占位符格式编写模板设计,即 {(custom_field_name)}。
例如,如果您想使用人名作为可自定义字段,您可以将其格式设置为:Hello,{(first_name)}。
无论文本内容如何,Mailsoftly 都会将此格式中包含的任何文本解释为自定义字段,并允许您在该字段中输入数据。
如果所选模板不包含此格式的文本, 您将无法使用个性化功能。
做出所需的选择后,我们通过单击按钮继续下一步,即数据匹配/定制 更新 按钮。
在本部分中,我们将被要求将企业邮箱模板中的自定义字段与我们收到的 Webhook 数据中的字段进行匹配。
进行这些匹配并确保正确选择后 主题 和 联系企业邮箱地址我们点击 整理信件 按钮。
这使我们能够将传入数据放置在我们创建的企业邮箱中的正确位置。
提醒: 这 联系企业邮箱地址 该字段可以与 webhook 数据关联,但您也可以单击 手动输入 手动输入企业邮箱地址。
但是,如果您输入手动地址,则处理 Webhook 请求所产生的所有企业邮箱活动都将发送给一个人。 因此,我们通常建议对用于通知的工作流程执行此操作。
8 – 恭喜
恭喜你! 您现在可以单击 保存工作流程 右上角的按钮可保存您的工作流程。
您可以在以下位置找到由保存的工作流程创建或发送的企业邮箱营销活动和联系人: 工作流程 左侧导航部分。
单击您的工作流程将其打开,您将能够在 相关活动 和 相关联系人 顶部的选项卡。
从那里,您可以发送或查看所需的营销活动。
Leave A Comment