After a Service ID is approved, you still need to adjust the destination countries or regions of your messages, suspend or resume the service as your business requires, and receive message status and user messages in time. This topic describes how to manage the Service ID of a Viber sender account in Alibaba Cloud Chat App Message Service, including how to apply for a Service ID, apply to change message destinations, apply for service suspension or resumption, track the review progress of your applications, and configure webhooks.
Before you begin
Before you perform the operations that are described in this topic, complete the steps in Create Viber send account.
Service ID overview
A Service ID is the unique identifier that is generated after you register a Viber Business Account and Viber approves it.
Your application is submitted to Viber for review. Make sure that all the information that you provide is accurate.
The review usually takes 3 to 5 business days.
You cannot create message templates or send messages until the application is approved.
Apply to change destinations
To add or remove the destination countries or regions of your messages, submit a destination change request. Before you submit the request, note the following review rules.
Viber reviews every change request, and the new destination configuration takes effect only after the request is approved.
Messages to your existing destinations are not affected while the request is under review.
Procedure
On the Service Number Management page, click Change Destination.
In the dialog box, select the destination countries or regions that you want to send messages to.
Click OK to submit the change request.
Track the review progress in the Application Status column of the application record list.
Apply for service suspension
If you do not need the Viber service temporarily, apply for suspension. Before you submit the application, note the following deadline and billing rules.
The suspension date is in Greenwich Mean Time (GMT).
Suspension applications for the current month are no longer accepted after the 25th of that month.
Billing stops starting from the month after the suspension date. The actual suspension time depends on when Viber approves the application.
Procedure
On the Service Number Management page, click Apply for Suspension.
In the dialog box, select the suspension date and enter the reason for the application.
Click OK to submit the application.
Track the review progress in the Application Status column of the application record list.
Apply for service resumption
When the service is suspended, apply for resumption to use it again. Before you submit the application, note the following date and billing rules.
The resumption date is in GMT.
Billing starts when the resumption date is reached. The actual resumption time depends on when Viber approves the application.
Procedure
On the Service Number Management page, click Apply for Resumption.
In the dialog box, select the resumption date: resume immediately or resume on a specified date.
Click OK to submit the application.
Track the review progress in the Application Status column of the application record list.
Configure webhooks
Webhooks deliver notifications such as message status receipts, mobile-originated messages (MO messages) from users, and template review results to your system in real time. Two delivery methods are available: HTTP callbacks use the callback URLs that you provide, and message queue monitoring uses the message queue addresses that the system assigns. You configure and save both methods in the same dialog box, and you can enable them at the same time.
Configure HTTP callbacks
On the Service Number Management page, click Phone Number Webhook Settings.
In the configuration dialog box, turn on HTTP Protocol.
Configure the following callback URLs. All of them are required when the HTTP protocol is enabled.
Status Report Callback URL: Enter the callback URL for status reports.
MO Message Callback URL: Enter the callback URL for MO messages.
Template Review Webhook Address: Enter the callback URL for template review results.
Configure message queue monitoring
In the webhook configuration dialog box, turn on Message Queue Monitoring.
The system automatically assigns the following message queue addresses. The addresses are read-only and can be copied.
Message Receipt Queue: Displays the message queue address for status receipts.
MO Message Queue: Displays the message queue address for MO messages.
Template Review Message Queue: Displays the message queue address for template review.
To copy an address, click the copy icon on the right of the address. The console then displays the message Copied.
Click Confirm to save the webhook settings. The dialog box closes, and the console displays the message Updated.
View application records
The application record list at the bottom of the Service Number Management page records your Service ID applications, destination change requests, and service suspension and resumption applications. Check the Application Status column to learn the current review result. The following table describes the columns in the list.
Column | Description |
Business Account Name | The name of the Business Account in the application. |
Application Type | The type of the application, such as a Service ID application, a destination change, or a service suspension. |
Service ID | The Service ID that is generated after the application is approved. |
Enterprise Registration Country/Region | The country or region where the company is registered. |
Message Destination Country | The destination countries or regions that are configured for messages. |
Application Time | The time when the application was submitted. |
Application Status | The current review status, such as approved, under review, or rejected. |
Review Time | The time when the review was completed. |
Actions | The operations that are available for the record, such as view details and edit. |
What to do next
After your Service ID application is approved, you can perform the following operations: