【开发工具】开发计划-快速入门

前言 #

ManyChat应用程序是连接ManyChat和第三方工具的一种方式。

它需要了解以下内容：

• API认证
• API调用
• JSON格式

如果您有开发经验，则本文和提供的示例可以用作构建第一个ManyChat应用程序的综合指南。

对于没有开发经验的客户，ManyChat当前不提供任何教育支持，但是您可能会发现以下有用的资源：

• 与邮递员进行身份验证和拨打电话
• W3Schools的JSON定义
• JSON路径查找器

让我们概述一下ManyChat Application的工作方式。应用程序由名称，描述和JSON组成。

应用程序名称和应用程序描述是不言自明的，请参考所附的图像：它显示了安装后应用程序名称如何导入到操作列表中：

JSON是ManyChat应用程序的核心概念，它指定了集成的详细信息。然后，ManyChat会对此规范进行内省，以找出您的应用程序具有的功能，并将JSON转换为最终用户的本机UI元素。

一个典型的应用程序包含：

• auth -如果您将ManyChat连接到的平台需要授权，请设置此阻止并将其指定为 "auth": null
• actions -每个应用程序应至少包含1个动作
• sources-这是可选的。您可以根据需要为操作中使用的变量设置源。

这是ManyChat如何识别动作标题和描述的简要概述：

让我们更深入地研究细节，并逐步学习如何开发自己的应用程序。

步骤1：建立应用程序 #

让我们创建一个简单的示例应用程序，该应用程序在给定范围内生成一个随机数。

检查以下先决条件：

• https://csrng.net/documentation/csrng-lite/将用作API
• 我们希望最终用户将使用漫游器字段指定范围

请按照以下步骤创建应用：

• 转到应用程序，然后单击“ +新应用程序”按钮
• 完成以下字段：
  • 应用名称：随机数应用
  • 应用说明：最佳随机数生成应用
  • 应用程序JSON（如果您想尝试该应用程序，请参考Glitch项目-使用app_for_copy.json，因为它不包含注释，当前的应用程序JSON字段仅接受不带注释的JSON）： 

    

  • 点击“创建应用程序”按钮

以下是ManyChat如何导入此数据的一些示例：

表单JSON→表单用户界面：

通过表单捕获的数据用于请求：

对应：

步骤2：安装应用程序 #

• 单击三点菜单下的“安装”按钮
• 选择您要应用此账户并完成安装。

步骤3：测试应用程序 #

• 转到“流”构建器，然后在“动作”列表中选择您的应用
• 设置动作 

• 像下面的例子一样建立一个新的流程：

• 预览您的流程：

  

步骤4：与客户共享应用程序 #

准备好应用程序后，您可以获取链接以共享它。

• 转到应用程序
• 单击三点菜单
• 单击复制链接按钮

链接已复制到剪贴板中，可以共享。

仔细共享以下链接：

1. 拥有此链接的每个人都可以安装您的应用。此链接可以无限次使用。链接无法撤销。生成并共享这些链接后，即可安装您的应用。
2. 安装了您的应用的每个人都会立即收到应用更新。目前，我们仅支持一个版本-‘dev’。因此，当您确定更改兼容且不会中断流程时，请将更改应用于应用程序JSON。

在我们进行版本控制以获取更安全的更新时，我们建议创建两个应用程序：

• 内部-为了测试更新，请勿共享此应用程序的链接
• 外部-要在测试后应用更新，请共享此应用程序的链接

如何使用身份验证块 #

随机数API不需要API密钥，但是许多其他API都需要。

为了使用这些API创建连接，您可以设置一个auth块。

前提条件：

• 在此处创建账户： https://tastedive.com/account/api_access
• 在此处查看API文档：   https://tastedive.com/read/api

让我们尝试创建一个需要API密钥的应用，然后将其用作查询参数：

这是完整的代码示例： 

如何使用有效载荷 #

一些API端点需要有效负载。

要使JSON在这些情况下有效，您可以添加payload {}如下所示。有效负载的值可以从传递forms [[]]。

在这种情况下，我们在Pipedrive CRM中创建了一条记录。API端点需要带有名称和电子邮件的有效负载。最终用户配置操作时，他们选择名称和电子邮件的自定义字段。然后，ManyChat触发添加到针对与自定义字段关联的每个订户值特定的有效负载的操作。

这是Glitch链接，请随时使用此项目作为示例：   

在某些情况下，无需传递有效负载的动态值。所以它看起来像这样：

每次处理动作时，我们都会将相同的有效负载传递给指定的URL。

如何使用来源 #

枚举：静态 #

因为random-number-app-v1我们使用了用户通过自定义字段提供的“最小值”和“最大值”字段。

如果我们想提供自己的价值，则可以利用这一sources概念。

请参考故障示例，并检查forms和sources块的注释：

这是ManyChat处理此数据的方式：

枚举：rpc #

因为similar-to-music-app我们使用自定义字段作为q参数。

使用enum:rpc我们可以提供该API中的音乐家和乐队的列表。查看此Glitch项目，以了解如何将enum:rpc源添加到您的App：  

这是一个已实现的代码示例：

摘要 #

1. 浏览本文档和Glitch项目以了解如何使App JSON用于不同目的
2. 单击“混音以编辑”以使用我们的示例制作自己的应用
3. 复制JSON并将其粘贴到ManyChat应用程序中
4. 安装您的应用程序以通过自己的集成获得更多结果
5. 与客户共享您的应用以赢得荣誉