VNA MMP API
    • Introduction
    • Giới thiệu
    • How to retrieve required IDs
    • Cách thức lấy các ID cần thiết
    • How to retrieve API key
    • Cách lấy API key
    • How to create a template on portal
    • Cách tạo template trên portal
    • How to create a Whatsapp broadcast template on portal
    • Cách tạo Whatsapp broadcast template trên portal
    • How to create a campaign on portal
    • Cách tạo campaign trên portal
    • How to configure webhook endpoint into Official account (Channel)
    • Cách cài đặt webhook endpoint trên Official account (Channel)
    • Webhook payload
    • Onboard
      • Onboard new Company and Company's Admin
        POST
      • Update company profile
        POST
      • Create a new API key
        POST
    • Channel
      • RCS
        • Create RCS Official account
        • Edit Channel RCS
        • Get Channel Rcs Status
        • Add Channel Test Number
        • Check Bulk Phones
        • Check capabilities of phone number
        • Request Verification Channel
      • ZALO
        • Check Zalo Channel Consent Status
        • Send Consent request
      • Get channel information
        GET
      • Get Channel Status
        GET
      • Broadcast Template Message
        POST
      • Send Conversation Message
        POST
      • Broadcast Message
        POST
    • Message
      • Get Message Status
        GET
    • Template
      • Create Template
      • Get Template By PublicId
      • Update Template
      • Get List Approved Template
      • Delete Template
    • Bulk Campaign
      • Get list bulk campaign
      • Send Bulk Campaign Broadcast
      • Send Bulk Contact Message
    • Channel Onboard
      • Generate token for onboarding Whatsapp
    • Billing CDR
      • Create billing request
      • Get billing request status
      • Download billing
    • Summary
      • Get Channel Summary
    • Partner
      • radica
        • Wecom
          • Get Wecom agent's customers
          • Sync Wecom agent's customers
          • Send messages to Wecom customers
          • Send messages to Wecom Customer Group
          • Get Wecom Message Status
    • Schemas
      • ChannelTestRequest
      • ChannelTestResponse
      • CheckPhoneCapabilitiesResponse
      • OnboardRequest
      • OnboardResponse
      • UpdateCompanyProfileRequest
      • UpdateCompanyProfileResponse
      • CreateAPIKeyRequest
      • CreateAPIKeyResponse
      • PartnerMessageType
      • MessageType
      • Status
      • TemplateStatus
      • TemplateMessage
      • BroadcastSubscriberMessage
      • BroadcastSubscriberGroupMessage
      • CreateOrEditChannelRequest
      • LaunchChannelRequest
      • LaunchChannelRequestIndonesia
      • LaunchChannelRequestIndia
      • CheckBulkPhonesRequest
      • SendMessageBroadcast
      • TextMessage
      • TextMessageWithAttachment
      • RichLink
      • ListPicker
      • QuickReply
      • FileMessage
      • SuggestionActionType
      • Suggestion
      • RichCard
      • RCSRichCard
      • ViberRichCard
      • ViberBotRichCard
      • FBWhatsappInteractiveHeaderText
      • FBWhatsappInteractiveHeaderMedia
      • FBWhatsappInteractive
      • FBWhatsappInteractiveButton
      • FBWhatsappInteractiveList
      • WhatsappFormCreateTemplateMessage
      • CreateFormTemplateMessage
      • ResponseCreateTemplateMessage
      • ResponseGetTemplate
      • ListSubscriberResponseMessage
      • BroadcastResponseMessage
      • ChannelResponse
      • ResponseMessage
      • ResponseStatusMessage
      • ResponseSummaryChannelRCS
      • BulkCampaignBroadcastRequest
      • BulkCampaignBroadcastRequestMessage
      • BulkCampaignSearchResponse
      • BulkCampaign
      • BulkCampaignStatus
      • BulkCampaignType
      • BulkCampaignBroadcastResponse
      • BulkCampaignContact
      • BulkCampaignConversationRequest
      • BulkCampaignConversationResponse
      • ChanelOnboardGenerateTokenRequest
      • ChanelOnboardGenerateTokenResponse
      • ErrorMessage
      • Application
      • PartnerEvent
      • ResponseChannelInfo
      • ResponseChannelRCSLaunchInfo
      • CheckBulkPhonesResponse
      • ResponseListApproveTemplate
      • RCSConversationParams
      • ViberBotConversationParams
      • ViberConversationParams
      • AppleConversationParams
      • WhatsappConversationParams
      • CommonGetChannelStatusResponse
      • WhatsappChannelStatusResponse
      • ChannelStatus
      • Attachment
      • AttachmentImage
      • AttachmentLink
      • AttachmentMiniProgram
      • AttachmentVideo
      • AttachmentFile
      • backgroundTask
      • ZaloRequestConsentRequest
      • ZaloCheckConsentResponse
      • ZaloRequestConsentResponse

    Cách cài đặt webhook endpoint trên Official account (Channel)

    Hướng dẫn này giải thích cách cấu hình Webhook Endpoint để hệ thống của bạn có thể nhận các sự kiện từ nền tảng. Các sự kiện này có thể bao gồm:
    Tin nhắn đến từ khách hàng
    Phản hồi của khách hàng (ví dụ: seen, read)
    Cập nhật kênh (thay đổi trạng thái)
    Cập nhật template (được duyệt hoặc bị từ chối)
    Các thông báo hệ thống khác
    Sau khi cấu hình, server của bạn sẽ tự động nhận các sự kiện này thông qua webhook URL.

    Steps to Configure Webhook#

    1.
    Mở trang Official Account management
    Truy cập URL sau:
    https://msh.lamhongquan.com/channel/oa
    2.
    Tuỳ chỉnh Official Account
    Click nút Edit Official Account.
    Screenshot 2026-03-11 at 14.19.36.png
    3.
    Vô hiệu hoá Internal Option
    Tắt tùy chọn Internal.
    4.
    Configure Webhook Endpoint
    Trong trường Webhook, nhập webhook endpoint URL của hệ thống bạn.
    Example:
    https://your-domain.com/webhook
    Hệ thống của bạn sẽ nhận các sự kiện từ nền tảng thông qua endpoint này.
    Screenshot 2026-03-11 at 14.42.00.png
    5.
    Choose Conversation Handling Option
    Nếu bạn muốn sử dụng cả portal và API để phản hồi khách hàng::
    Bật Internal Conversation
    Nếu bạn chỉ muốn sử dụng API để phản hồi khách hàng:
    Không bật Internal Conversation
    6.
    Save the Configuration
    Click Submit để lưu cấu hình.

    Result#

    Sau khi cấu hình:
    Hệ thống của bạn sẽ nhận webhook events khi:
    Customer Message Events
    Khách hàng gửi tin nhắn
    Khách hàng tương tác với button trong template message
    ....
    Message Status Events
    Tin nhắn được seen hoặc read
    Tin nhắn gửi thất bại
    ....
    Conversation Events
    Tạo conversation mới
    Conversation được mở lại
    Conversation được đóng
    Conversation được assign cho agent
    ...
    Channel Events
    Cập nhật cấu hình channel
    Channel được kết nối
    Channel bị ngắt kết nối
    Cập nhật trạng thái channel
    Channel token được refresh
    ....
    Templates Events
    Template gửi để phê duyệt
    Template được approve
    Template bị reject
    ....
    Webhook endpoint của bạn cần sẵn sàng để xử lý các sự kiện này.
    Webhook payload samples: https://mdoc.lamhongquan.com/webhook-response-2010246m0
    Modified at 2026-03-25 09:50:00
    Previous
    How to configure webhook endpoint into Official account (Channel)
    Next
    Webhook payload
    Built with