21/09/2018, 08:23

Hướng dẫn làm Facebook fanpage chatbot với NodeJS

Giới thiệu Hiện nay thì có rất nhiều thư viện hỗ trợ việc tạo bot chat cho facebook, nhưng nếu chỉ luôn dùng các thư viện đó thì chúng ta sẽ không hiểu được nhiều. Nên trong bài viết này mình sẽ hướng dẫn cách tạo một chatbot cho facebook đơn giản nhất. Bài viết mình hướng dẫn tạo bot cho ...

Giới thiệu

Hiện nay thì có rất nhiều thư viện hỗ trợ việc tạo bot chat cho facebook, nhưng nếu chỉ luôn dùng các thư viện đó thì chúng ta sẽ không hiểu được nhiều. Nên trong bài viết này mình sẽ hướng dẫn cách tạo một chatbot cho facebook đơn giản nhất. Bài viết mình hướng dẫn tạo bot cho fanpage.

Cách hoạt động

Dựa vào sơ đồ miêu tả hoạt động ở trên chúng ta có thể thấy BOT hoạt động như sau:

Đầu tiên khi có người gửi tin nhắn đến bot trên messenger, tin nhắn sẽ đến facebook developer và sau đó đến server bot của chúng ta để ta tiếp tục xử lý.
Sau khi xử lý xong, server bot sẽ trả lại tin nhắn cho người dùng thông qua api của Facebook. Và người dùng sẽ nhận lại được tin nhắn phản hồi của bot.

Các bước để tạo chat bot

Yêu cầu cần thiết

Cài cài đặt NodeJS và npm (quản lý các package).
Tài khoản fb, fb developer.
Tài khoản heroku để delpoy server bot lên internet.
Phần mềm để soạn code (VS Code, Sublimetext, ...).

Bước 1:

Vào facebook và tạo trang một fanpage.

Chọn mục đích của fanpage. Và đặt tên cho fanpage.

Giao diện sau khi tạo được một fanpage

Bước 2:

Đăng ký tài khoản facebook developer và tạo một ứng dụng

Điền tên và địa chỉ email liên lạc và bấm Create App ID
Sau khi tạo được một App trên Facebook
Tiếp theo chúng ta cần liên kết app này đến fanpage vừa tạo lúc nãy.
Tìm phần Token Generation và chọn fanpage vừa tạo. Cần phải xác minh tài khoản để có thể thêm fanpage vào. Sau đó mình sẽ nhận được một token. Token này cần để bot có thể truy cập truy vào fanpage. Vậy là chúng ta đã kết nối được app của facebook developer đến fanpage. Các thứ còn lại là chúng ta cần tạo một server BOT và kết nối đến app này.

Bước 3: Đây là bước tạo server bot. Server này sẽ xử lý các tin nhắn của người dùng gửi đến và sẽ quyết định phản hồi lại. Phần này yêu cầu bạn phải biết về nodejs cũng như npm để có thể viết được server bot.

Tạo một thư mục để chứa source code và khởi tạo project.

mkdir chatbot
cd chatbot
npm init

Nhập các thông tin cần thiết như: Tên project, người tạo, ...

Tạo file server.js (file này dùng để chạy server nodejs).
Thêm các pagekage cần thiết npm install --save body-parser config express request
File server.js như sau:

const APP_SECRET = 'you app_secret';
const VALIDATION_TOKEN = 'TokenTuyChon';
const PAGE_ACCESS_TOKEN = 'your page_access_token';

var http = require('http');
var bodyParser = require('body-parser');
var express = require('express');

var app = express();
app.use(bodyParser.urlencoded({
  extended: false
}));
var server = http.createServer(app);
var request = require("request");

app.get('/', (req, res) => {
  res.send("Home page. Server running okay.");
});

app.get('/webhook', function(req, res) { // Đây là path để validate tooken bên app facebook gửi qua
  if (req.query['hub.verify_token'] === VALIDATION_TOKEN) {
    res.send(req.query['hub.challenge']);
  }
  res.send('Error, wrong validation token');
});

app.post('/webhook', function(req, res) { // Phần sử lý tin nhắn của người dùng gửi đến
  var entries = req.body.entry;
  for (var entry of entries) {
    var messaging = entry.messaging;
    for (var message of messaging) {
      var senderId = message.sender.id;
      if (message.message) {
        if (message.message.text) {
          var text = message.message.text;
          sendMessage(senderId, "Hello!! I'm a bot. Your message: " + text);
        }
      }
    }
  }
  res.status(200).send("OK");
});

// Đây là function dùng api của facebook để gửi tin nhắn
function sendMessage(senderId, message) {
  request({
    url: 'https://graph.facebook.com/v2.6/me/messages',
    qs: {
      access_token: PAGE_ACCESS_TOKEN,
    },
    method: 'POST',
    json: {
      recipient: {
        id: senderId
      },
      message: {
        text: message
      },
    }
  });
}

app.set('port', process.env.PORT || 5000);
app.set('ip', process.env.IP || "0.0.0.0");

server.listen(app.get('port'), app.get('ip'), function() {
  console.log("Chat bot server listening at %s:%d ", app.get('ip'), app.get('port'));
});

Ở đây cần có APP_SECRET, VALIDATION_TOKEN, PAGE_ACCESS_TOKEN. Chúng ta lấy các token này ở đâu

APP_SECRET chúng ta lấy ở đây

VALIDATION_TOKEN: Đây là token tùy chọn, do mình đặt để xác thực các ứng dụng khi gửi tin nhắn đến server bot
PAGE_ACCESS_TOKEN: Để lấy token này chúng ta quay lại chỗ kết nối app trên facebook developer với fanpage. Bạn sẽ thấy token này.

OK. Vậy bây giờ đã chúng ta đã có phần server bot, nhưng vẫn chưa kết nối đến app facebook. Chúng ta cần deploy lên host. Trong bài viết này mình sử dụng host free có hỗ trợ nodejs của heroku. Host này sẽ sleep nếu sau 2h không có tương tác và sẽ tự động wake up nếu có tin nhắn gửi đến.

Bước 4: Deploy code lên host heroku

Vào trang heroku. Và tạo một app.
Add heroku git vào project.

git init
git remote add heroku https://git.heroku.com/chatbot-facebook-test.git

Push code lên herroku

git add .
git commit -m "My Code"
git push heroku master

Đây là log sau khi đã deploy code thành công. Trong phần log này mình sẽ thấy host của mình là https://chatbot-facebook-test.herokuapp.com/

Vậy là code của chúng ta đã được deploy lên host. Tiếp theo chúng ta sẽ kết nối server bot với app facebook.

Bước 5: Kết nối app facebook đến server bot của mình

Vào ứng dụng trong facebook developer. Chọn phần:
Sau điền địa chỉ của server bot và token của server bot. Và phần Subscription Fields chọn messagesmessages, messaging_postback, messamessagin_optins để server bot có quyền đọc, gửi lại tin nhắn cho người dùng.
Tiếp theo đăng ký webhook này cho fanpage tạo ở trên.