Managing the Multimedia Library

Prerequisites

• To configure a card template for which a URL needs to be configured as a card option, an application for adding the URL to the address trustlist has been submitted to the system administrator and approved.
• Permissions on operations under the current menu that require separate configuration have been configured. For details about the operation permissions that can be configured separately, see Table 1.
• Permissions on operations under the WhatsApp menu controlled by separate permissions have been configured. For details about the operation permissions that can be configured separately, see Table 1.
• Before a WhatsApp template is created in the AICC, the template has been created by cooperating with Infobip, Gupshup, Cloud-API, and KooMessage.
• If the WhatsApp service provider is set to Twilio, the system parameter Twilio Content API service address has been set to the Twilio Content API service address connected to the AICC. The default value is https://content.twilio.com.

Context

After a version earlier than 23.100.0 is upgraded to the current version, the uploaded AAC file needs to be uploaded again. Otherwise, the old AAC file fails to be sent after the WhatsApp channel is connected to Infobip.

The multimedia file types supported by each channel are as follows.

Procedure

1. Sign in to the AICC as a tenant administrator and choose Configuration Center > Resource Management > Multimedia Library.
2. Configure the common phrase library.
   1. Click the Phrase tab and click to add a common phrase category and set the following parameters:
      • Category Name: Enter a maximum of 20 characters.
      • Organizational Structure: Select the OU created in Configuring OUs.
   2. Select the new category and click Create.

      Only one common phrase can be added at a time. A common phrase can contain a maximum of 500 characters. If there are multiple common phrases, click Create to add them one by one.

3. Configure the voice library, video library, image library, document library, and personalized emoji library. The following uses the voice library as an example.
   1. Click the Voice tab and click to add a voice category and set the following parameters:
      • Category Name: Enter a maximum of 20 characters.
      • Organizational Structure: Select the OU created in Configuring OUs.
   2. Select the new category and click Create.
   3. Set Name and click +Select File to select a local voice file in MP3, AAC, or M4A format.
   4. Click Save. The file is uploaded.
      You can perform the following operations on uploaded files:

      • : Enter the list mode and display data in a list. This button is available only for the video library, image library, and personalized emoji library.
      • : Enter the preview mode and display data on cards. This button is available only for the video library, image library, and personalized emoji library.
      • Click Play to play a voice file online.
      • Click Preview to preview a video or image file online.
      • Click Download to download an uploaded document online.
      • Click Edit to modify the description of an uploaded file.
      • Click Delete to delete an unnecessary multimedia file.
      • Click Release to publish an image, video, or voice file to the 5G VAS CSP. This button is not displayed in preview mode. The validity period of multimedia data published to the 5G platform is two months.
      • Click Release Result to view the result of releasing multimedia data to the 5G platform.
   5. Update a multimedia resource imported with the flow.
      

      • Only the voice library, video library, image library, and document library are involved.
      • Multimedia resources can be updated only once.
      1. Locate the resource whose Resource Status is Ineffective in the resource list.
      2. Click Edit in the Operation column.
      3. Upload the multimedia resource again.

         After the resource is uploaded, the resource status changes to Effective. In this case, the resource is available.

4. Configure the address library.
   1. Click the Address tab and click to add an address category and set the following parameters:
      • Category Name: Enter a maximum of 20 characters.
      • Organizational Structure: Select the OU created in Configuring OUs.
   2. Select the new category and click Create.
   3. Set Name, Longitude, and Latitude. The longitude ranges from –180 to 180 and can contain 0 to 6 decimal places. The latitude ranges from –90 to 90 and can contain 0 to 6 decimal places.
   4. Click Save. The address is configured.
      You can perform the following operations on uploaded addresses:

      • Click Edit to modify the description of an uploaded address.
      • Click Delete to delete an unnecessary address.

5. Configure rich texts or plain texts. The following uses rich texts as an example.
   1. Click the Rich Text tab and click to add a rich text category and set the following parameters:
      • Category Name: Enter a maximum of 20 characters.
      • Organizational Structure: Select the OU created in Configuring OUs.
   2. Select the new category and click Create.
   3. Set Name and Description, and enter the rich text content.
   4. Click Save. The rich text is configured.
      You can perform the following operations on created rich texts:

      • Click View to view a rich text.
      • Click Edit to modify a rich text.
      • Click Delete to delete an unnecessary rich text.

6. Configure a card template.

   Click the Card Template tab. The template list page is displayed.

   • Configure a WhatsApp template message.
     

     Only Twilio template messages can be created in the AICC and synchronized to the Twilio. For details, see the following configuration description.

     1. Choose WhatsApp Template Message and click Create.
     2. Click Create. The Create WhatsApp Template Message page is displayed.

        If you have created a template on the Configuration Center > Resource Management > WhatsApp Template page, you can directly go to 6.g.

     3. Set the following parameters:
        • Template Name and Template Description: Customize the values.

          If the service provider of the selected WhatsApp template channel is infobip, gupshup, cloud-api, or KooMessage, the value of Template Name must be the same as that provided by the service provider.

        • Business Solution Provider: The options are as follows:
          • KooMessage
          • Twilio
          • cloud-api
          • gupshup
          • infobip
          • other
        • Organization Unit: Select the OU created in Configuring OUs.
        • Template Channel: Select the WhatsApp channel configured on the Channel Configuration page. For details about how to configure the WhatsApp channel, see Configuring the WhatsApp Channel.
        • Template ID: If this parameter is left empty, add a template ID. Otherwise, set it to the ID of an existing template in the Twilio, which can be obtained from Develop > Messaging > Content Template Builder > name/Template SID. This parameter is displayed only when the WhatsApp service provider is Twilio.
        • MessagingServiceSid
          • If the service provider of the selected WhatsApp template channel is Twilio, obtain the parameter from the Twilio from Develop > Messaging > Service > Sid.
          • If the service provider of the selected WhatsApp template channel is gupshup, set this parameter to the ID of the template created in the Gupshup.

          Language: Select the language of the template.

        • Template availability times per day: Customize the number of times the template can be sent in a day. If the value is exceeded, the template message fails to be sent.
        • Template Content: Configure the template content as required, including Header, body, footer, and buttons. The value must be consistent with the content of Infobip or Gupshup templates provided by the channel supplier.
     4. Click Save to return to the WhatsApp template message configuration page.
     5. (Required only for Twilio) Choose Configuration Center > Resource Management > WhatsApp Template, find the WhatsApp template created in 6.c, and click Submit. Wait for the template to be approved by the Twilio. The template status changes to Passed.
     6. Select a data record of the Template Name column, that is, a WhatsApp template.

        For WhatsApp templates whose Business Solution Provider is set to Twilio, the value of Template Status must be Passed.

     7. Set the following parameters:
        • Template Message Name and Description: Customize the values.
        • Intelligent Robot: Select the intelligent robot configured in Configuring an Intelligent Robot and process the reply of the template message.

          The priority of the intelligent robot is higher than that of the access robot configured in the channel.

        • Template Name: Select the WhatsApp template created in 6.b.

          After a WhatsApp template is selected, other parameters are automatically filled in with the data of the WhatsApp template.

     8. Click Save.
   • Create an interactive WhatsApp message.
     1. Click the Card Template tab. The template list page is displayed.
     2. Choose WhatsApp Interactive Messages and click Create. The WhatsApp configuration page is displayed.
     3. Configure basic information.
        • Using an existing template in the Twilio
          • Message Name and Business Solution Provider: Customize the values.
          • Organization Unit: Select the OU created in Configuring OUs.
          • Channel and Language: Select a WhatsApp channel and a language from the drop-down lists.
          • Unique ID of a template: Enter the corresponding message template SID in the Twilio.
          • MessagingServiceSid: Enter the value of messagingServiceSid obtained on the Develop > Messaging > Service > Sid page in the Twilio.
          • Set other parameters consistent with those configured in the Twilio.
        • Create an interactive message in the AICC.
          • Customize Message Name and Description.
          • Set Business Solution Provider. The options are as follows:
            • infobip
            • Twilio
            • gupshup
            • KooMessage
            • cloud-api
            • other
          • Customize Unique ID of a template. This parameter is displayed when Business Solution Provider is set to Twilio.
          • Organization Unit: Select the OU created in Configuring OUs.
          • Set Message Type. The options are as follows:
            • Button Message
            • List Message
     4. Set parameters in the Template Content area.
        • Customize body and footer.
        • Set Header. This parameter is displayed when Business Solution Provider is set to infobip.
          • When Message Type is set to Button Message, select None, Text, Image, Video, or Attachments.

            If Text is selected, you need to set Header Content.

            If you select Image, Video, or Attachments, you also need to select a multimedia resource. Click to select a media resource of the corresponding type from the multimedia library.

          • When Message Type is set to List Message, set Header Content.
        • Customize body.
        • Set footer. This parameter is displayed when Business Solution Provider is set to infobip.
        • Set Button (mandatory when Message Type is set to Button Message).

          Click Create to create a button. A maximum of three buttons can be created.

        • Set List (mandatory when Message Type is set to List Message).
          1. Enter a list title.
          2. Click Create to create a list group. A maximum of 10 groups can be added to a list.
          3. Enter a group title and click to expand the group.
          4. Click Create to create a group option. A maximum of 10 options can be added to a group.
     5. Click Save. The interactive WhatsApp message is created.
   • Configure a web card.
     1. Choose WebCard and click Create.
     2. Set the following card template parameters:
        • name: Customize the value.
        • template type: The options are as follows:
          • Common type: If this option is selected, you need to set the following parameters:
            • title and Description: Customize the values.
            • Media Type: The options are IMAGE, Address, and VIDEO.
            • Multimedia Resource: Select a multimedia resource of the corresponding type.
            • linking: Enter a URL for customers to click to go to the specified page.
              

              HTTP requests have security risks. HTTPS is recommended.

          • Card Options
        • Organization Unit: Select the OU created in Configuring OUs.
     3. Select a card display style. Value options:
        • transverse
        • longitudinal
     4. Add card options.
        

        When Card display style is set to transverse, a maximum of 15 card options can be added. When Card display style is set to longitudinal, a maximum of five card options can be added.

        1. Click Add Card Options.
        2. Set the following parameters:
           • Image property: Select an image resource configured in 3.
           • Card display text: Enter a maximum of 32 characters. The value cannot contain the following special characters: <>'"/\
           • Option Type: The options are as follows:
             • reply
             • linking
           • select content
             • When Option Type is set to reply, the value can contain a maximum of 256 characters and cannot contain the following special characters: <>'"/\
             • When Option Type is set to linking, the value must start with http or https.
               

               HTTP has security risks. Exercise caution when using it. You are advised to use HTTPS, which is more secure.

     5. Click Save. The web card template is configured.