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/
- You would then need to wait for your company our yourself to be verified by Tencent Cloud.
- Once verified you can go ahead and create a project under "Products" → "Communication" → "Short Message Service". This will enable you to use the Tencent Cloud platform to send SMS messages. Please note that the below screenshots are from the international version of Tencent Cloud. The Chinese web page could differ.
- Please make sure you that your "Project" would be for messaging to mainland China. At this stage you'll obtain your unique "SDK AppID" and "APP Key" you would need to enter it later onto AMPAREX to further configure the SMS interface there.
- The next step is to create your SMS message template on Tencent Cloud. You would need to create your SMS Signature as well as this is what would be displayed on the recipient phone when an SMS message gets sent to your patient(s).
the sample template could look like the below:
The same template would look like the below on AMPAREX.
Codeblock | ||
---|---|---|
| ||
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