{"info":{"_postman_id":"43108656-e001-4b8e-99c9-57c52c49b9ec","name":"API_BotBanHang","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"8752962","collectionId":"43108656-e001-4b8e-99c9-57c52c49b9ec","publishedId":"SVmqz1BB","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2019-09-10T08:05:59.000Z"},"item":[{"name":"1. Gửi văn bản","id":"e70076be-6514-4448-a5e3-f2d0ae48bba7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\"text\": \"Chào mừng bạn đến với Bot Bán Hàng!\"},\n {\"text\": \"Chúng tôi có thể giúp gì cho bạn?\"}\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"e70076be-6514-4448-a5e3-f2d0ae48bba7"},{"name":"2. Gửi hình ảnh","id":"3883d13a-a80b-439c-baf2-4a127d186ebe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\n \"attachment\": {\n \"type\": \"image\",\n \"payload\": {\n \"url\": \"https://botbanhang.vn/images/logo.png\"\n }\n }\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Sử dụng mẫu này để gửi tập tin hình ảnh. Messenger hỗ trợ hình ảnh JPG, PNG và GIF. Nếu bạn gặp sự cố với hình ảnh GIF, vui lòng thử giảm kích thước tệp.

Sử dụng mẫu này để gửi các tập tin video. Messenger hỗ trợ video MP4, có dung lượng lên tới 25MB.

\n","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"e09c4c5f-bede-4e53-8dad-bb5e45f5a464"},{"name":"3. Gửi video - Phần 2","id":"705f2438-f5c2-4c2e-85aa-2827620e621b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\n \"attachment\": {\n \"type\": \"template\",\n \"payload\": {\n \"template_type\": \"media\",\n \"elements\": [\n {\n \"media_type\": \"video\",\n \"url\": \"https://www.facebook.com/unofficial.abio/videos/2593801767328577/\",\n \"buttons\": [\n {\n \"title\": \"Truy cập Bot Bán Hàng!\",\n \"type\": \"web_url\",\n \"url\": \"https://botbanhang.vn/\"\n }\n ]\n }\n ]\n }\n },\n \"quick_replies\": [\n {\n \"title\": \"Tuyệt!\",\n \"set_attributes\": {\n \"feedback\": \"Cool!\"\n }\n },\n {\n \"title\": \"Không hay!\",\n \"set_attributes\": {\n \"feedback\": \"Not good!\"\n }\n }\n ]\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Bạn cũng có thể trực tiếp sử dụng Bài đăng trên Facebook với phương tiện truyền thông thay vì tải lên thủ công

Sử dụng mẫu này để gửi tập tin âm thanh. Messenger hỗ trợ âm thanh MP3, OGG, WAV, có dung lượng lên tới 25MB.

Sử dụng mẫu này để gửi bất kỳ tệp nào khác, không lớn hơn 25 MB.

\n","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"3491ed70-2cac-46a7-a0f4-d47f41caa855"},{"name":"6. Gửi thẻ ảnh ngang","id":"51ff7faa-3da6-4c7b-b2cd-cc3d117d74a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\n \"attachment\":{\n \"type\":\"template\",\n \"payload\":{\n \"template_type\":\"generic\",\n \"image_aspect_ratio\": \"square\",\n \"elements\":[\n {\n \"title\":\"ÁO PHÔNG NAM DÀI TAY\",\n \"image_url\":\"https://canifa.s3.amazonaws.com/media/catalog/product/8/t/8tl18w007-sb505-34.jpg\",\n \"subtitle\":\"Size: M\",\n \"buttons\":[\n {\n \"type\":\"web_url\",\n \"url\":\"https://botbanhang.vn\",\n \"title\":\"Xem chi tiết\"\n }\n ]\n },\n {\n \"title\":\"ÁO PHÔNG NAM DÀI TAY\",\n \"image_url\":\"https://canifa.s3.amazonaws.com/media/catalog/product/8/t/8tl18w007-sb505-33-.jpg\",\n \"subtitle\":\"Size: L\",\n \"default_action\": {\n \"type\": \"web_url\",\n \"url\": \"https://botbanhang.vn\",\n \"messenger_extensions\": true\n },\n \"buttons\":[\n {\n \"type\":\"web_url\",\n \"url\":\"https://botbanhang.vn\",\n \"title\":\"Xem chi tiết\"\n }\n ]\n }\n ]\n }\n }\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Sử dụng mẫu này để gửi một bộ sưu tập cuộn ngang. Mỗi mục bao gồm một tệp đính kèm hình ảnh, mô tả ngắn và các nút để yêu cầu người dùng bấm vào.

\n","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"51ff7faa-3da6-4c7b-b2cd-cc3d117d74a7"},{"name":"7. Nút bấm - Phần 1","id":"98b2e60b-c6df-4229-9eea-314dc3c52738","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\n \"attachment\": {\n \"type\": \"template\",\n \"payload\": {\n \"template_type\": \"button\",\n \"text\": \"Hello!\",\n \"buttons\": [\n {\n \"type\": \"show_block\",\n \"block_names\": [\"ID Kịch bản\"],\n \"title\": \"Hiện kịch bản\"\n },\n {\n \"type\": \"web_url\",\n \"url\": \"https://botbanhang.vn\",\n \"title\": \"Truy cập Website\"\n },\n {\n \"url\": \"https://fb.com/groups/botbanhang\",\n \"type\":\"web_url\",\n \"title\":\"Tham gia cộng đồng\"\n }\n ]\n }\n }\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Sử dụng JSON này để thêm các nút vào câu trả lời của bạn. Bạn có thể đặt các nút để liên kết đến một kịch bản khác, mở trang web hoặc gửi yêu cầu api khác. Mỗi tin nhắn được giới hạn 3 nút bấm.

\n","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"98b2e60b-c6df-4229-9eea-314dc3c52738"},{"name":"7. Nút bấm - Phần 2","id":"b0ea8150-d427-494d-9936-248eff489609","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"messages\":[\n {\n \"attachment\":{\n \"type\":\"template\",\n \"payload\":{\n \"template_type\":\"generic\",\n \"elements\":[\n {\n \"title\":\"Thông tin liên lạc\",\n \"image_url\":\"https://ayokaflowers.com/wp-content/uploads/2017/08/contact-us.png\",\n \"subtitle\":\"Hãy liên hệ chúng tôi để được trợ giúp!\",\n \"buttons\":[\n {\n \"type\":\"phone_number\",\n \"phone_number\":\"+84763874340\",\n \"title\":\"Gọi\"\n }\n ]\n }\n ]\n }\n }\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Bạn cũng có thể sử dụng nút Gọi, nút này quay số điện thoại khi nghe

\n","urlObject":{"protocol":"https","path":["v1.3","public","json"],"host":["api","botbanhang","vn"],"query":[{"key":"access_token","value":"accessToken"},{"key":"psid","value":"ClientID"}],"variable":[]}},"response":[],"_postman_id":"b0ea8150-d427-494d-9936-248eff489609"},{"name":"8. Trả lời nhanh - Phần 1","id":"9375c7aa-6c7a-47e7-95b4-516e71a4e8e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"messages\": [\n {\n \"text\": \"Bạn có muốn tiếp tục sử dụng sản phẩm Bot Bán Hàng?\",\n \"quick_replies\": [\n \t{\n \"title\":\"Có!\",\n \"block_names\": [\"ID kịch bản 1\"]\n },\n {\n \"title\":\"Không!\",\n \"block_names\": [\"ID kịch bản 2\", \"ID kịch bản 3\"]\n },\n {\n \"title\":\"Đang xem xét...\",\n \"url\": \"http://www.mocky.io/v2/5d761dc33200002d0029789b\",\n \"type\":\"json_plugin_url\"\n }\n ]\n }\n ]\n}"},"url":"https://api.botbanhang.vn/v1.3/public/json?access_token=accessToken&psid=ClientID","description":"

Sử dụng JSON này để thêm trả lời nhanh cho câu trả lời của bạn. Mỗi tin nhắn được giới hạn 11 mục Trả lời nhanh

Bạn cũng có thể lưu attribute (thuộc tính) từ tùy chọn của người dùng. Ví dụ nếu người dùng bấm vào Sữa thì sẽ lưu milk vào attribute drink, còn nếu người dùng bấm vào Cà phê thì sẽ lưu coffee vào attribute drink

Sử dụng JSON này để đặt thuộc tính người dùng mà không cần người dùng bấm vào bất kỳ nút nào.

Sử dụng JSON này để đặt thuộc tính người dùng kèm theo tin nhắn (văn bản, hình ảnh...)

Bạn có thể chuyển hướng người dùng đến một kịch bản hoặc đến một chuỗi các kịch bản - không cần hành động của người dùng