Tencent Cloud SMS gateway interface (China only).
In order to use Tencent Cloud to send SMS messages from AMPAREX the following settings are necessary.
Please note that you have to apply the settings on both AMPAREX and Tencent Cloud.
1. Tencent Cloud setup
- Create your Tencent Cloud account on https://cloud.tencent.com/
- Let your company our yourself be verified by Tencent Cloud.
- Create a project under "Products" → "Communication" → "Short Message Service"
- Create your "Project" to use for messaging to mainland China. Please note that you'll obtain your unique "SDK AppID" and "APP Key" you would need to enter onto AMPAREX to configure the SMS interface.
- Create your SMS message template on Tencent Cloud. You would need your SMS Signature, too as this is what would be displayed on the recipient phone.
The same template would look like the below on AMPAREX.
TemplateID: 351713 Params: [ <span placeholder="true">/appointment/startdate</span>, <span placeholder="true">/appointment/starttime</span>, <span placeholder="true">login/staff/fullname</span> ] Text: We are looking forward to seeing you <span placeholder="true">/appointment/startdate</span> at <span placeholder="true">/appointment/starttime</span> o'clock! Best regards <span placeholder="true">login/staff/fullname</span>
Please note that on AMPAREX you would still need the fully functional AMPAREX placeholders in order to add customer related info onto your SMS message. At the same time on Tencent Cloud AMPAREX placeholders would need to be replaced by numbers placed in the curly brackets {1}.
Please also note the template formatting on AMPAREX. It has to follow the pattern shown above starting with the TemplateID. The placeholders need to be separated by commas in order to work. The numbers in the curly bracket on Tencent Cloud must follow the order of placeholders on AMPAREX.
The text of your SMS message will come from the Tencent Cloud template. We only display it on AMPAREX to visualise it.
- After editing and saving your SMS template will be pending Tencent Cloud approval. From our experience it can take up to a few hours.
1. Settings on AMPAREX
Configuration
| Branch | You can limit the service to a certain branch only. |
| PC/workstation | You can limit the service to a certain computer only. If no computer is selected, each computer may use the service. |
| Utilisation | |
| Start | You can specifying a start date for the selected interface to start automatically. With no date selected the interface is ready for use straight away. |
SMS Details
| User name | You will receive it from the provider. It will be called “SDK AppID”. |
| Sender | Here you can specify the sender’s name. This what the SMS recipient will see displayed on his/her smartphone. Please clarify the usage of special characters with the Tencent Cloud support. |
| Proxy Server | The provider’s unique URL. This is already selected for you because it's always the same for a selected provider. |
| Check login data | Pressing this button sends a query to your SMS API provider to check if the credentials you’ve entered are correct. |
| Password | Will be communicated to you by the service provider and it called "App Key" here. |
| Country code | Please select 86 valid for People's Republic of China. |
2. SMS API on Tencent Cloud
Tencent Cloud has 4 main SMS service areas which contain different APIs. We currently use those marked in bold.
- SMS text message APIs
- Send single SMS message with specified template
- Send bulk SMS messages with specified template
- SMS message delivery status notification
- SMS message reply
- Pull SMS message status
- Pull SMS message status of a single mobile number
- Template APIs
- Add SMS message template
- Modify SMS message template
- Delete SMS message template
- Query SMS message template status
- Signature APIs
- Add SMS signature
- Modify SMS signature
- Delete SMS signature
- Query SMS signature status
- Statistics APIs
- Delivery statistics
- Report statistics