Skip to main content

Bắt đầu

Để vận hành qua BP OpenAPI, Doanh nghiệp cần đăng ký và xác thực Business Page (BP).

Trường hợp Doanh nghiệp chưa có BP, hãy bắt đầu bằng việc đăng ký và hoàn tất xác thực thông tin doanh nghiệp của mình hoặc được uỷ quyền quản lý.

👉 Liên hệ để sở hữu ngay Trang Doanh nghiệp miễn phí trên MoMo:

MoMo luôn từng ngày cải thiện để mang lại trải nghiệm tích hợp vận hành MoMo BP dễ dàng và an toàn nhất.

Trình tự để bắt đầu tích hợp BP OpenAPI

Vận hành MoMo BP bằng BP OpenAPI​

Doanh nghiệp cần tích hợp MoMo BP OpenAPI với hệ thống (server) của Doanh nghiệp thông qua tài khoản tích hợp được MoMo cung cấp.

MoMo cung cấp bộ Mã tương ứng với từng môi trường (gọi chung là bộ MoMo X-API-KEY).

  • Partner Id: Định danh duy nhất của Tài khoản đối tác của Doanh nghiệp
  • X-API-KEY: Dùng để định danh và cấp quyền truy cập tài nguyên MoMo BP

Doanh nghiệp cần lưu trữ bộ MoMo API-KEY này để xác thực tất cả các request khi gọi sang BP OpenAPI tương ứng với nhóm quyền được gán quản lý và khai thác thông tin BP.

Các nhóm quyền của hệ thống BP OpenAPI tương ứng với nhóm quyền được cấp cho Doanh nghiệp vào cổng thông tin Đối tác kinh doanh quản lý BP gồm: Quản lý & Thiết lập Trang, Đăng Bài viết, Gửi tin nhắn thông báo, Xem báo cáo, Chăm sóc khách hàng... Mỗi nhóm quyền sẽ được quy định các thao tác, tính năng trên BP.

Ngoài ra, MoMo hỗ trợ Doanh nghiệp đăng ký URL để ghi nhận các sự kiện khi có phát sinh tương tác giữa người dùng và BP trên MoMo, hoặc có các thông báo cập nhật từ Đội vận hành MoMo BP (tham khảo thêm Cách thức đăng ký nhận sự kiện từ MoMo).

Các nhóm quyền BP​

QuyềnAPI hỗ trợ
Quyền quản lý và thiết lập BP1. Lấy danh sách Trang đang quản lý
2. Xem thông tin trang
3. Thiết lập trang
Quyền quản lý nội dung1. Nội dung dạng Bài viết
2. Nội dung Xếp hạng (Rating) và Đánh giá Trang (Review)
Quyền gửi tin nhắn1. Đăng ký Template
2. Gửi tin nhắn CSKH đến tập khách hàng (Segmentation)
3. Gửi tin nhắn tự động theo điều kiện
4. Khởi tạo Tập khách hàng

Quy ước API​

HTTP Request:

URL Development: https://uat-business.momo.vn/api
URL Production: https://business.momo.vn/api
Content Type: application/json
Response Type: application/json


Ví dụ tích hợp​

HTTP Request

POST /v2/business-pages/123456/social/posts


Example request

curl --location 'https://uat-business.momo.vn/api/v2/business-pages/123456/social/posts' \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: PnMhYJeESFOwnUwCRwld213131231231UIqqeQCkxSGUqeQCkxSGUKwuabUoWCFMwGrMdq' \ --data '{ "oaId": 123456, "title": "test create merchant oa post v3 with image", "desc": "test create merchant oa post v3 with image", "ctaType": 1, "ctaLabel": "social feed test :))", "actionUrls": [ "https://mservice.feed" ], "imageUrls": [ "https://xwatch.vn/upload_images/images/2023/05/22/anh-meme-la-gi.jpg", "https://taimienphi.vn/tmp/cf/aut/cAjh-9tqD-cL5a-Jfhu-hinh-anh-meme-hai-huoc-1.jpg", "https://haycafe.vn/wp-content/uploads/2022/03/anh-meme-gau-truc.jpg" ] }'


ON THIS PAGE