Updated on 2023-09-20 GMT+08:00

How Do I Enable Message Push?

Prerequisites

To use the message push function, you need to prepare a message push API. For details about the API specifications, see Message Push Interface Specifications. After the API is developed, you need to submit an application to the system administrator to add the message push address ({baseUrl}/webhooks/v1/messages) to the address trustlist.

If {baseUrl} is an HTTPS URL, you also need to prepare an authentication certificate. Only a JKS, DER, or PEM certificate is supported.

If two-way authentication is enabled for the message push address, you also need to prepare the identity certificate of the current system.

Context

  • Only the web and WhatsApp channels support message push.
  • If the message push key provided by the message pusher is changed, you need to modify the key in the AICC by referring to the following procedure. Enter the new message push key.

Procedure

  1. (Optional) If {baseUrl} is an HTTPS URL, upload the push address trust certificate and system identity certificate.

    1. Choose Configuration Center > System Management > Certificate.
    2. Click New and set the certificate code and password as prompted.
    3. Select the type of the certificate to be uploaded.
    4. Click , select the trust certificate and identity certificate from the local PC, and click Open.
    5. Click Complete.

  2. Go to the web channel configuration page.
  3. Click to enable Message Push.
  4. Enter the prepared message push address, which is {baseUrl}.
  5. Upload the certificates.

    1. (Optional) Click Trust certificate and select the certificate uploaded in Step 1.
    2. (Optional) Click Identity certificate and select the certificate uploaded in Step 1.

  6. Enter the message push key provided by the message pusher. The key is a string of 43 characters, including only letters and digits.
  7. Click Save And Proceed To The Next Step to complete the configuration.