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
    • Email APIs
    • Onboard
      • Onboard new Company and Company's Admin
        POST
      • Update company profile
        POST
      • Create a new API key
        POST
    • Channel
      • ZALO
        • Check Zalo Channel Consent Status
        • Send Consent request
      • Get channel information
        GET
      • Get Channel Status
        GET
      • Send Conversation Message
        POST
      • Broadcast Message
        POST
    • Email
      • Send Mail
        POST
      • Get Batch Email Status
        POST
    • Message
      • Get Message Status
    • 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
    • Summary
      • Get Channel Summary
    • Schemas
      • ChannelTestRequest
      • EmailStatus
      • 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

    How to configure webhook endpoint into Official account (Channel)

    This guide explains how to configure a Webhook Endpoint so your system can receive events from the platform. These events may include:
    Incoming messages from customers
    Customer reactions (e.g., seen, read)
    Channel updates (status changes)
    Template updates (approval or rejection)
    Other system notifications
    Once configured, your server will automatically receive these events via the webhook URL.

    Steps to Configure Webhook#

    1.
    Open the Official Account management page
    Go to the following URL:
    https://msh.lamhongquan.com/channel/oa
    2.
    Edit the Official Account
    Click the Edit Official Account button.
    Screenshot 2026-03-11 at 14.19.36.png
    3.
    Disable Internal Option
    Turn off the Internal option.
    4.
    Configure Webhook Endpoint
    In the Webhook field, enter your system’s webhook endpoint URL.
    Example:
    https://your-domain.com/webhook
    Your system will receive events from the platform through this endpoint.
    Screenshot 2026-03-11 at 14.42.00.png
    5.
    Choose Conversation Handling Option
    If you want to use both the portal and API to respond to customers:
    Enable Internal Conversation
    If you want to use API only to respond to customers:
    Do not enable Internal Conversation
    6.
    Save the Configuration
    Click Submit to save the settings.

    Result#

    After configuration:
    Your system will receive webhook events whenever:
    Customer Message Events
    A customer sends a message
    Customer interacts with a template message button
    ....
    Message Status Events
    A message is seen or read
    Message failed to send
    ....
    Conversation Events
    New conversation created
    Conversation reopened
    Conversation closed
    Conversation assigned to an agent
    ...
    Channel Events
    Channel configuration updated
    Channel connected
    Channel disconnected
    Channel status updated
    Channel token refreshed
    ....
    Templates Events
    Template submitted for approval
    Template approved
    Template rejected
    ....
    Your webhook endpoint should be ready to handle these incoming events.
    Webhook payload samples: https://mdoc.lamhongquan.com/webhook-response-2010246m0
    Modified at 2026-03-11 07:51:01
    Previous
    Cách tạo campaign trên portal
    Next
    Cách cài đặt webhook endpoint trên Official account (Channel)
    Built with