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 tạo template trên portal

    Template có thể là một tin nhắn đơn (dùng cho broadcast campaign) hoặc một chuỗi câu hỏi và tin nhắn (dùng cho conversational campaign) được tạo để sử dụng trong Bulk campaign.
    Một conversation template có thể được tái sử dụng cho nhiều Bulk campaign, giúp tiết kiệm thời gian khi tạo chiến dịch.
    Hiện tại có một số loại template: Viber template, RCS template, Facebook template, và WhatsApp template.
    Create a template
    Broadcast template:
    Chọn Manage Template trên danh sách menu dropdown
    Click vào + New Template
    Chọn Official account liên kết với broadcast template bạn muốn tạo
    Kiểm tra các loại message bên dưới để hiểu tính năng của từng loại message
    Thiết lập Expire type: (không áp dụng cho Whatsapp template)
    Set by campaign: Broadcast template sẽ dựa theo cấu hình của từng campaign bạn tạo
    None: Không thiết lập thời gian hết hạn cho template
    Expire time: Thiết lập ngày và giờ hết hạn cụ thể → khi hết hạn, trạng thái của tất cả tin nhắn đang Sent sẽ chuyển thành Failed
    TTL: Chỉ định thời gian hết hạn cho template, ví dụ 1 giờ, 2 giờ, 1 ngày... → thời gian được tính từ lúc template được gửi
    Thiết lập Name cho template
    Screenshot 2026-03-02 at 13.55.04.png
    Conversation template:
    Đối với conversation template, không cần chọn Official account vì một conversation template có thể được dùng cho nhiều OA khác nhau (tất nhiên phải cùng channel).
    NoElementDescriptionReference URL/Input
    1NameTên template của bạnTest 1
    2TypeLoại templateBroadcast only: chỉ hiển thị broadcast [1 message] - Conversation: hiển thị conversation [nhiều message]
    3ChannelChọn channel bạn muốn gửi tin nhắnViber [Broadcast type only] - Viber bot [Conversation type only] - RCS - Facebook - Telegram - Whatsapp
    4DescriptionMô tả templateTest Whatsapp Message
    Click trực tiếp vào tên template để tạo flow câu hỏi (list câu hỏi)
    Click nút New message để bắt đầu
    Nhập thông tin cho template
    NoElementDescriptionReference URL/Input
    1Message IDDùng kết hợp với Message name để định danh Message. Rất quan trọng khi tạo flow câu hỏi/message. Người dùng sẽ sử dụng MessageID-Message name để chỉ định câu hỏi/message tiếp theo trong flow.Message ID : 1 - Message Name : Request basic info → Identifier của câu hỏi này sẽ là: 1-Request basic info
    2Message NameDùng kết hợp với Message ID để định danh message
    3TypeLoại message bạn muốn gửi đến khách hàngRich Card: tối đa 6 (không áp dụng cho Whatsapp) - Text - Picture - Video - File: pdf không áp dụng cho RCS - Whatsapp interactive (không áp dụng cho rcs hoặc viber)
    4Next Message Base OnThiết lập trigger cho message tiếp theoUser Answer - Script
    5Answer IDCấu hình biến để hiển thị ở câu hỏi/message tiếp theoVí dụ: đặt answer ID là 'name' - nếu khách nhập tên là John và ở câu sau bạn ghi: Name: {{name}} → hiển thị: Name: John
    6StatusThiết lập trạng thái câu hỏi/message để hệ thống nhận biết flowStart: câu hỏi đầu tiên - Normal: câu hỏi ở giữa - Complete: câu hỏi cuối - Error: hiển thị lỗi khi user nhập sai dữ liệu
    7Next QuestionSắp xếp câu hỏi/message tiếp theo trong flowVí dụ: 3-Accept
    8Add suggestionsThiết lập button cho messageLoại button: REPLY: đi tới message tiếp theo - DIAL: gọi số điện thoại trong Post back data - OPEN URL: mở URL trong Post back data
    9Add APITích hợp gọi API như GET hoặc POST tới hệ thống của bạn hoặc bên thứ 3
    10Is need replyNếu chọn, user phải trả lời trước khi chuyển sang message tiếp theo
    Screenshot 2026-03-02 at 13.53.44.png
    Modified at 2026-03-25 09:19:00
    Previous
    How to create a template on portal
    Next
    How to create a Whatsapp broadcast template on portal
    Built with