教程：手把手教你构建一个基本的 Facebook 聊天机器人

Question

首先是桌面软件产品，接着，一切都被搬到了网上。然后，基于电子邮件，甚至基于短信的产品出现了。软件界面的最新热潮是通讯机器人，而可以肯定的是，Facebook 拥有最大的聊天平台。

在本教程中，我将向你展示如何 在 Python 中构建你自己的 Facebook Messenger 聊天机器人 。我们会使用 Flask 进行一些基本的 web 请求处理，然后我们将部署该应用到 Heroku。

让我们开始吧。

第一步，创建一个可用的网络挂接端点 (Working Webhook Endpoint)

很快，我们将开始进行发送和接收消息，但首先，你需要一个可用的端点，它返回一个 200 响应码，然后回显一些信息，以与 Facebook 验证你的机器人。

首先， git clone我为这个项目建立的 Github 仓库 :

git clone git@github.com:hartleybrody/fb-messenger-bot.git

然后， cd 进去，安装 python 依赖：

mkvirtualenv test-bot

pip install -r requirements.txt

为简单起见，我们将部署它到 Heroku，但你也可以部署这个 Flask web 应用程序到任何你可以访问的服务器上。

假设你已经安装了 Heroku CLI Toolbelt ，那么你可以运行

heroku create

从而安装你的新应用。

我们还使用 Heroku 对 Procfile 的协定，以告诉它如何运行这个应用，但是你可以在自己的服务器上，在一个或多个 gunicorn 进程前面使用一些诸如 nginx 的应用，来设置它。

要验证 Heroku 能够在你的机器上本地运行，使用下面命令启动你的本地服务器：

heroku local

然后，在你的浏览器中访问 http://localhost:5000/ ，接着，你应该会看到“Hello world”。

用 Ctrl+C 命令杀掉本地服务器。要部署这个端点到 Heroku

git push heroku master

然后在你的浏览器中打开它

heroku open

现在，你就有了一个“可用的”网络挂接网址，你可以用来设置你的机器人。确保你从浏览器捕获到完整的 https://*.herokuapp.com URL，因为我们稍后将会需要它。

第二步：创建一个 Facebook Page

如果你还没有，那么需要 创建一个 Facebook Page 。Facebook Page 是你的机器人的“身份证”，包括当有人在 Facebook Messenger 和它聊天时出现的名字和头像。

如果你只是为你的机器人创建了一个虚设的，那么它叫啥名字或者你如何对其进行分类都没有啥关系。你可以跳过大多数的设置步骤。

为了与机器人交流，人么将需要通过你的 Page，这个我们稍后将会看到。

第三步：创建一个 Facebook App

转至 Facebook 开发者快速入门页面 ，然后点击右上角的“Skip and Create App ID”。接着为你的机器人创建一个新的 Facebook App，并为你的机器人填写名字、目录和联系电子邮箱信息。

下一页，你将在右上角看到你新的 App ID。向下滚动，然后点击 Messenger 旁边的“Get Started”。

第四步：设置你的 Messaging App

现在，你位于你的 Facebook App 的 Messenger 设置页面。这里，你需要填些东西，以便让你的聊天机器人连接到我们之前设置的 Heroku 端点。

生成一个 Page Access Token

使用之前创建的 Page（或现有的 Page），点击通过验证流程，接着你会收到一个应用的 Page Access Token。

点击 Page Access Token，将其复制到剪贴板。你需要将其设为 Heroku 应用的环境变量。在命令行中，在你克隆应用的同个文件夹下，运行：

heroku config:add PAGE_ACCESS_TOKEN={{your_page_token_here}}

每当你尝试发送一个信息或回复别人时，这个 token 将被用来验证你的请求。

设置网络挂接

当你设置你的网络挂接时，你将需要一点信息：

• Callback URL – 我们之前设置的 Heroku (或其他的) URL。
• Verification Token – 将会发送给你的机器人的一个秘密值，以验证请求是来自于 Facebook 的。不管你在这里设置了什么值，确保你使用了 heroku config:add VERIFY_TOKEN= 将其添加到了 Heroku 环境 using
• Subscription Fields – 这个告诉 Facebook，你关心并且想要通知到你的网络挂接的消息事件是啥。如果你不确定，只需要以“messages,”开头，因为稍后你可以修改它

当你配置好网络挂接后，需要订阅你想要接收邮件通知的特定页面。

一旦你已经获取了 Page Access Token，并设置好了网络挂接，确保你在 Heroku 应用中设置了 PAGE_ACCESS_TOKEN 和 VERIFY_TOKEN 配置的值，这样你就可以很好地完成工作了！

第五步：开始与你的机器人聊天

转到你创建的 Facebook Page，然后点击“Message”按钮，这个按钮挨着“Like”按钮，在页面顶部附近。这应该会在你的页面上打开一个消息面板。

开始发送你的 Page 消息，然后这个机器人应该会回复！

要看看发生了啥，检查应用的日志：

heroku logs -t

你应该会看到每当一个新消息发送到你的 Page 机器人时，Facebook 发送给你的端点的 POST 数据。

这里是当我发送“does this work?”给我的机器人时，我获得的一个样例 JSON POST 体

       {
            "object":"page",
            "entry":[
                {
                    "messaging":[
                        {
                            "message":{
                                "text":"does this work?",
                                "seq":20,
                                "mid":"mid.1466015596912:7348aba4de4cfddf91"
                            },
                            "timestamp":1466015596919,
                            "sender":{
                                "id":"885721401551027"
                            },
                            "recipient":{
                                "id":"260317677677806"
                            }
                        }
                    ],
                    "time":1466015596947,
                    "id":"260317677677806"
                }
            ]
        }

默认情况下，机器人应该回复“got it, thanks!”

第六步：定制机器人的行为

这里就是我们最后开始深入代码之处。

其实消息机器人只有两个关键部分：接收和发送消息

接收信息

app.py 的第 24 行起，在我们的 webhook() 视图函数中 ，我们开始处理传入的消息。

首先，每当触发了一个新的消息事件，通常是当有人发送一条消息到我们的 Page 上，我们就加载从 Facebook 发送给网络挂接的 JSON POST 数据

然后我们遍历每一项 - 在我的测试经验中，一次只有发送一项给网络挂接。

然后，我们循环每个消息事件。这里，可能有几种消息事件。

在第 4 步，我们告诉 Facebook 我们想要通知我们的网络挂接的消息类型。如果你遵循了我的建议，那么我们的终端将只能收到“message”事 件，但我们也可以接收到传送确认，选择项(Ele 注：原文是 optins，私以为笔误) 和回传（参见后述）。我适当地留下了一些用于检测其他类型的消息事 件的代码，但我实际上并不处理它们。

对大多数应用程序最有用的的消息事件将是“message”事件，这意味着有人给你的 Page 发送新的消息。我写了一些基本的代码来​​处理这种事件，解析出发送者的 ID，并简单地回应他们。

发送信息

为了发送一个简单的短信，你只需要两件事情：

• 收件人的 Facebook ID
• 你想要发送的消息文本

我创建了一个简单的 send_message() 函数，它自动匹配 Facebook API，然后发送那些消息。

记得吗，请求是使用我们在第四步获取的 PAGE_ACCESS_TOKEN 环境变量来进行验证的。

你还可以发送许多更为复杂的消息类型，包括内容包含图片和按钮的消息。 关于那些消息的更多信息，点击这里 。

需要注意的是，在消息中发送一个“postback”按钮的能力。这些基本上是这样的按钮，当用户按下时，它会发送一个回发消息事件到你的网络挂接。

这基本上允许用户在你的应用程序中，同时在 Facebook Messenger 里“按下按钮”。你可以将其用于下订单，确认请求或很多其他的事情。

每当用户点击一个回发按钮，就会通知你的网络挂接，并可以执行任何种类的必要的后续操作。

第七步：提交应用进行审查

当你测试你的机器人时，只有你和其他 Page 管理员可以直接与机器人发消息。在你的机器人对世界开放，准备好与任何人聊天之前，必须要经过一个审查程序。

Facebook 的似乎会在他们的审查过程中非常透彻地检查你的应用，而且有充分理由。消息机器人的代码运行在自己服务器上，并可能在 Facebook 不知道的情况下随时更改。

他们似乎在努力确保你是一个好人，而不是提交一个简单的虚拟应用程序以获得批准，然后在一段时间后将其修改成某些垃圾邮件机器人。

显然，如果你这样做，他们仍然可以撤销你的 API 访问令牌，但他们宁愿让 Messenger 平台上不存在任何滥用。

回到我们在第 4 步使用的 Messenger App Settings 页面。向下滚动到“App Review for Messenger”，并点击“Request Permissions.”。

请求你需要的全新，然后你就会被带到“Review Status”页面。此页面需要大量的信息，以确保开发人员不会滥用平台。

它需要你

• 选中几个复选框，确认你已经阅读他们的政策和指导方针
• 保证你不会参与到来路不明的出站消息
• 描述你将如何通过你的机器人与用户交互
• 提供一个审查小组可以用来与你的机器人进行互动的测试用户
• 上传你通过 Messenger 与你的机器人交互的截屏
• 有隐私权保护政策
• 验证你对机器人的解释和设置的对用户的期望

在这个页面上，你也可以要求被授予获取用户额外信息的权限，例如他们的电子邮件或个人资料信息。

然后它将走到 Facebook 审查小组核准，然后授予你对 Messenger platform 的完全访问。 这里是关于审批流程的更多信息。

---

即使你不打算一路经历审查程序，希望你已经学到了一两件有关如何为 Facebook Messenger 构建一个简单的聊天机器人。在这里，检出我的代码 。

原文： Facebook Messenger Bot Tutorial: Step-by-Step Instructions for Building a Basic Facebook Chat Bot