How to Enable Event Push

更新时间:
复制 MD 格式

The Event Push service sends events that you subscribe to in Digital Employee to a specified message queue. You can analyze this data to monitor activity in real time, which helps improve work efficiency and service quality. This topic explains how to enable and disable the Event Push service.

Prerequisites

Complete the following steps:

Important
  1. The serverless series of Message Queue for Apache RocketMQ 5.0 does not support VPC access in Digital Employee, because networks are not interoperable. You must use only the TCP public endpoint. Enable public network access before purchasing.imageimage

  2. Digital Employee supports public network access for the serverless series of Message Queue for Apache RocketMQ 5.0. If you select a region other than Shanghai when creating an instance, add the IP address 47.103.12.130 to your IP allowlist.image

Procedure

Step 1: Create a message queue instance in the Message Queue console

  1. Log on to the Message Queue console with your Alibaba Cloud account. When you log on for the first time, a prompt appears to activate the Message Queue service. Click Activate Now . For pricing details, see Billing overview.image

  2. Create a message queue instance.

    1. In the Message Queue console, in the navigation pane on the left, click Instances . Click Create Instance . Select version 4.0 or 5.0.image

    2. In the dialog box, enter your custom information. Click OK . For example, create a standard instance named test. You can view the instance ID and endpoint on the instance details page.

    3. When you use Message Queue, note these network access restrictions: Topics and Group IDs must be created in the same instance and in the same region to communicate. For more information about regions, see Regions and zones.image

  3. Create a topic in the new instance.

    1. Go to the instance details page. In the navigation pane on the left, click the Topics tab.

    2. On the Topics page, click Create Topic .

    3. Enter your custom information as prompted. Click OK .

      Delete topics that you no longer use. This helps avoid unnecessary charges. For topic resource fees, see Pricing.image

  4. Create a group in the message queue instance.

    1. In the navigation pane on the left, click the Groups tab.

    2. By default, the TCP protocol tab appears. Click Create Group on that tab.

    3. Enter your custom information as prompted. Click OK .

      image

      Note

      You can create groups only for the TCP protocol.

      Important

      The producer identity (GroupID) must start with GID_, GID-, PID_, or PID-.

      Otherwise, an error message is displayed.image

Step 2: Add the message queue instance to Digital Employee

  1. Log on to the Cloud Contact Center console. In the navigation pane on the left, click Instance Management – V2. Click the access point for your instance to open the instance console.

    image

  2. In the upper-right corner of the page, click the menu button. Then, go to the Digital Employee console. In the navigation pane on the left, click System administration .image

  3. On the Settings page, click the Event push tab. Click Manage .

  4. In the panel on the right, click Enable . Select the message queue version. Select the event types to push. Click OK .

    1. If you select RocketMQ 4.0 , enter the instance information: endpoint, topic, and producer identity (Group ID).image

    2. If you select RocketMQ 5.0 , enter the information: username, password, instance ID, endpoint, topic, and producer identity.image

      • image

        In the navigation pane on the left of the Message Queue instance list, click Access control . Then, click Intelligent Identity Recognition.

        • Username: Enter the username for your Message Queue service.

        • Password: Enter the password for your Message Queue service.

      • image

        • Instance ID: Enter the ID of your Message Queue for Apache RocketMQ 5.0 instance.

        • Topic: Enter the topic for your Message Queue service.

        • Producer identity: Enter the unique ID for your producer.

          Important

          The producer identity is the GroupID and must start with GID_, GID-, PID_, or PID- upon creation.

          Otherwise, an error message appears.image

      • image

        • Endpoint: Enter the access endpoint for your Message Queue service.

      Important

      If you change instance information in the Message Queue console—such as the endpoint, topic, or group—update the settings in the Digital Employee console.

  5. If you stop using a message queue instance, you must disable event push. In the Digital Employee console, go to the instance settings. Click the Disable Event Push button. In the confirmation dialog, click Disable.image