Mesenjer
Contribution guidelines for this project
Platform Messenger Pendahuluan Memulai Penyiapan Webhook Penyiapan Aplikasi Panduan Memulai Kit Desain Platform Bot Sampel Pengiriman Pesan Webhook Webview Penemuan & Interaksi Kembali ID & Profil Pemrosesan Bahasa Alami (Natural Language Processing) Analytics & Feedback Ajukan Bot Anda! Pedoman Kebijakan & Penggunaan Referensi Sumber Daya Bermanfaat PERTANYAAN UMUM Catatan Perubahan Di Halaman Ini Menyiapkan Webhook Anda Webhook Anda adalah inti dari pengalaman Messenger Anda. Di sinilah kode Anda berada, dan di sinilah Anda akan menerima, memproses, dan mengirimkan pesan.
Di dalam panduan ini, Anda akan mempelajari cara menyiapkan webhook sederhana yang mendukung langkah-langkah verifikasi webhook yang diwajibkan Platform Messenger, serta cara menerima peristiwa webhook.
Untuk informasi selengkapnya tentang persyaratan dan peristiwa webhook, lihat Webhook.
Persyaratan -Agar dapat mengikuti panduan penyiapan webhook Anda, Anda hanya perlu memiliki komputer yang menginstal Node.js.
Untuk menjalankan webhook yang dapat menerima peristiwa webhook dari Platform Messenger, kode Anda harus di-hosting di server HTTPS publik yang memenuhi persyaratan berikut:
Dukungan HTTPS, Sertifikat yang ditandatangani sendiri tidak didukung Sertifikat SSL yang valid Port terbuka yang menerima permintaan GET dan POST Langkah-langkah Penyiapan Platform Messenger Bersifat Agnostik Bahasa Untuk mengikuti panduan ini, Anda perlu menginstal Node.js, tetapi Anda dapat menulis webhook Anda dalam bahasa server yang paling Anda sukai.
Sebelum Anda memulai, pastikan server Anda memenuhi semua persyaratan yang tercantum di atas.
- Buat proyek Node.js baru Jalankan yang berikut ini di baris perintah untuk membuat file dan dependensi yang diperlukan: mkdir messenger-webhook // Creates a project directory cd messenger-webhook // Navigates to the new directory touch index.js // Creates empty index.js file. npm init // Creates package.json. Accept default for all questions. npm install express body-parser --save // Installs the express.js http server framework module, // and then adds them to the dependencies section of package.json file. Jika semua berjalan lancar, maka direktori messenger-webhook Anda akan terlihat seperti ini: index.js node_modules package.json 2Buat server HTTP Tambahkan kode berikut ke index.js: 'use strict';
// Imports dependencies and set up http server const express = require('express'), bodyParser = require('body-parser'), app = express().use(bodyParser.json()); // creates express http server
// Sets server port and logs message on success app.listen(process.env.PORT || 1337, () => console.log('webhook is listening'));
Platform Messenger Pendahuluan Memulai Penyiapan Webhook Penyiapan Aplikasi Panduan Memulai Kit Desain Platform Bot Sampel Pengiriman Pesan Webhook Webview Penemuan & Interaksi Kembali ID & Profil Pemrosesan Bahasa Alami (Natural Language Processing) Analytics & Feedback Ajukan Bot Anda! Pedoman Kebijakan & Penggunaan Referensi Sumber Daya Bermanfaat PERTANYAAN UMUM Catatan Perubahan Di Halaman Ini Menyiapkan Webhook Anda Webhook Anda adalah inti dari pengalaman Messenger Anda. Di sinilah kode Anda berada, dan di sinilah Anda akan menerima, memproses, dan mengirimkan pesan.
Di dalam panduan ini, Anda akan mempelajari cara menyiapkan webhook sederhana yang mendukung langkah-langkah verifikasi webhook yang diwajibkan Platform Messenger, serta cara menerima peristiwa webhook.
Untuk informasi selengkapnya tentang persyaratan dan peristiwa webhook, lihat Webhook.
Persyaratan Agar dapat mengikuti panduan penyiapan webhook Anda, Anda hanya perlu memiliki komputer yang menginstal Node.js.
Untuk menjalankan webhook yang dapat menerima peristiwa webhook dari Platform Messenger, kode Anda harus di-hosting di server HTTPS publik yang memenuhi persyaratan berikut:
Dukungan HTTPS, Sertifikat yang ditandatangani sendiri tidak didukung Sertifikat SSL yang valid Port terbuka yang menerima permintaan GET dan POST Langkah-langkah Penyiapan Platform Messenger Bersifat Agnostik Bahasa Untuk mengikuti panduan ini, Anda perlu menginstal Node.js, tetapi Anda dapat menulis webhook Anda dalam bahasa server yang paling Anda sukai.
Sebelum Anda memulai, pastikan server Anda memenuhi semua persyaratan yang tercantum di atas.
-
Buat proyek Node.js baru Jalankan yang berikut ini di baris perintah untuk membuat file dan dependensi yang diperlukan: mkdir messenger-webhook // Creates a project directory cd messenger-webhook // Navigates to the new directory touch index.js // Creates empty index.js file. npm init // Creates package.json. Accept default for all questions. npm install express body-parser --save // Installs the express.js http server framework module, // and then adds them to the dependencies section of package.json file. Jika semua berjalan lancar, maka direktori messenger-webhook Anda akan terlihat seperti ini: index.js node_modules package.json
-
Buat server HTTP Tambahkan kode berikut ke index.js: 'use strict'; // Imports dependencies and set up http server const express = require('express'), bodyParser = require('body-parser'), app = express().use(bodyParser.json()); // creates express http server // Sets server port and logs message on success app.listen(process.env.PORT || 1337, () => console.log('webhook is listening')); Kode ini membuat server HTTP yang menampung permintaan di port default, maupun di port 1337 apabila tidak ada port default. Di panduan ini, kami menggunakan Express, sebuah a framework HTTP yang populer dan ringan, tetapi Anda dapat menggunakan framework apa pun yang Anda sukai untuk membuat webhook Anda.
3.Tambahkan endpoint webhook Anda
Tambahkan kode berikut ke index.js:
// Creates the endpoint for our webhook
app.post('/webhook', (req, res) => {
let body = req.body;
// Checks this is an event from a page subscription
if (body.object === 'page') {
// Iterates over each entry - there may be multiple if batched
body.entry.forEach(function(entry) {
// Gets the message. entry.messaging is an array, but
// will only ever contain one message, so we get index 0
let webhook_event = entry.messaging[0];
console.log(webhook_event);
});
// Returns a '200 OK' response to all requests
res.status(200).send('EVENT_RECEIVED');
} else { // Returns a '404 Not Found' if event is not from a page subscription res.sendStatus(404); }
});
Platform Messenger Pendahuluan Memulai Penyiapan Webhook Penyiapan Aplikasi Panduan Memulai Kit Desain Platform Bot Sampel Pengiriman Pesan Webhook Webview Penemuan & Interaksi Kembali ID & Profil Pemrosesan Bahasa Alami (Natural Language Processing) Analytics & Feedback Ajukan Bot Anda! Pedoman Kebijakan & Penggunaan Referensi Sumber Daya Bermanfaat PERTANYAAN UMUM Catatan Perubahan Di Halaman Ini Menyiapkan Webhook Anda Webhook Anda adalah inti dari pengalaman Messenger Anda. Di sinilah kode Anda berada, dan di sinilah Anda akan menerima, memproses, dan mengirimkan pesan.
Di dalam panduan ini, Anda akan mempelajari cara menyiapkan webhook sederhana yang mendukung langkah-langkah verifikasi webhook yang diwajibkan Platform Messenger, serta cara menerima peristiwa webhook.
Untuk informasi selengkapnya tentang persyaratan dan peristiwa webhook, lihat Webhook.
Persyaratan Agar dapat mengikuti panduan penyiapan webhook Anda, Anda hanya perlu memiliki komputer yang menginstal Node.js.
Untuk menjalankan webhook yang dapat menerima peristiwa webhook dari Platform Messenger, kode Anda harus di-hosting di server HTTPS publik yang memenuhi persyaratan berikut:
Dukungan HTTPS, Sertifikat yang ditandatangani sendiri tidak didukung Sertifikat SSL yang valid Port terbuka yang menerima permintaan GET dan POST Langkah-langkah Penyiapan Platform Messenger Bersifat Agnostik Bahasa Untuk mengikuti panduan ini, Anda perlu menginstal Node.js, tetapi Anda dapat menulis webhook Anda dalam bahasa server yang paling Anda sukai.
Sebelum Anda memulai, pastikan server Anda memenuhi semua persyaratan yang tercantum di atas.
1Buat proyek Node.js baru Jalankan yang berikut ini di baris perintah untuk membuat file dan dependensi yang diperlukan: mkdir messenger-webhook // Creates a project directory cd messenger-webhook // Navigates to the new directory touch index.js // Creates empty index.js file. npm init // Creates package.json. Accept default for all questions. npm install express body-parser --save // Installs the express.js http server framework module, // and then adds them to the dependencies section of package.json file. Jika semua berjalan lancar, maka direktori messenger-webhook Anda akan terlihat seperti ini: index.js node_modules package.json
2Buat server HTTP Tambahkan kode berikut ke index.js: 'use strict';// Imports dependencies and set up http server const express = require('express'), bodyParser = require('body-parser'), app = express().use(bodyParser.json()); // creates express http server
// Sets server port and logs message on success app.listen(process.env.PORT || 1337, () => console.log('webhook is listening')); Kode ini membuat server HTTP yang menampung permintaan di port default, maupun di port 1337 apabila tidak ada port default. Di panduan ini, kami menggunakan Express, sebuah a framework HTTP yang populer dan ringan, tetapi Anda dapat menggunakan framework apa pun yang Anda sukai untuk membuat webhook Anda. 3Tambahkan endpoint webhook Anda Tambahkan kode berikut ke index.js: // Creates the endpoint for our webhook app.post('/webhook', (req, res) => {
let body = req.body;
// Checks this is an event from a page subscription if (body.object === 'page') {// Iterates over each entry - there may be multiple if batched body.entry.forEach(function(entry) {// Gets the message. entry.messaging is an array, but // will only ever contain one message, so we get index 0 let webhook_event = entry.messaging[0]; console.log(webhook_event); }); // Returns a '200 OK' response to all requests res.status(200).send('EVENT_RECEIVED'); } else {// Returns a '404 Not Found' if event is not from a page subscription res.sendStatus(404); }});Kode ini membuat endpoint /webhook yang menerima permintaan POST, memastikan bahwa permintaan tersebut merupakan peristiwa webhook, lalu memasukkan pesannya. Endpoint ini adalah tempat Platform Messenger mengirimkan semua peristiwa webhook.
Perhatikan bahwa endpoint ini menghasilkan tanggapan 200OK, yang memberi tahu Platform Messenger bahwa peristiwa telah diterima dan tidak perlu dikirimkan ulang. Biasanya Anda tidak akan mengirimkan tanggapan ini hingga Anda telah selesai memproses peristiwa.
4Tambahkan verifikasi webhook Tambahkan kode berikut ke index.js:// Adds support for GET requests to our webhook app.get('/webhook', (req, res) => {// Your verify token. Should be a random string. let VERIFY_TOKEN = "<YOUR_VERIFY_TOKEN>" // Parse the query params let mode = req.query['hub.mode']; let token = req.query['hub.verify_token']; let challenge = req.query['hub.challenge'];// Checks if a token and mode is in the query string of the request if (mode && token) {// Checks the mode and token sent is correct if (mode === 'subscribe' && token === VERIFY_TOKEN) { // Responds with the challenge token from the request console.log('WEBHOOK_VERIFIED'); res.status(200).send(challenge); } else { // Responds with '403 Forbidden' if verify tokens do not match res.sendStatus(403);messenger-webhook