VNA MMP API
    • Introduction
    • How to retrieve required IDs
    • How to retrieve API key
    • How to create a template on portal
    • How to create a Whatsapp broadcast template on portal
    • How to create a campaign on portal
    • How to configure webhook endpoint into 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
        POST
      • Get Template By PublicId
        GET
      • Update Template
        POST
      • Get List Approved Template
        GET
      • Delete Template
        DELETE
    • Bulk Campaign
      • Get list bulk campaign
        GET
      • Send Bulk Campaign Broadcast
        POST
      • Send Bulk Contact Message
        POST
    • 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

    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
    How to create a campaign on portal
    Next
    Webhook payload
    Built with