SMS - Get started
API Documentation
API Swagger Documentation is available here :
URL & Base URI
Vortext API base path is located at :
https://vortext.cloud.cegedim.com for services hosted in cegedim.cloud datacenters.
https://messages.cloud.cegedim.com for 3rd party applications reaching Vortext on the internet.
All methods are relative to this URL.
For example if you want to get status of vortext, you have to use:
Security
HTTPS Protocol
All requests to Vortext API is made by HTTP protocol, using TLSv1 transport encryption.
Authentication
As for now, basic authentication is used for every request made to Vortext service. Each request is completely stateless, so you can use Vortext service with a simple line of curl. If you don’t know about basic authentication, it only needs a http request header 'Authorization' :
The credential used if username:password encoded in base 64. Most of libraries will simply let you provide username and password.
HTTP Request and Responses format : json
This API is aimed primarily to handle json messages in http request and response bodies.
HTTP Request format
Use Content-Type: application/json header to let Vortext service know your request body format.
HTTP Response format
Use Accept: application/json header to let Vortext service which format do you want for body response.
Date/Time format
As json doesn’t support natively Date/Time, all parameters tagged as Date in this API are string with ISO8601 format :
where Z is timezone (like +0200).
Examples : 2016-06-01T12:27:19.000+0200.
For query parameters, don’t forget to url encode these parameters.
Sender Name
You can customize sender name of SMS, instead of a classic number such as "30180". To do so, please make a request in ITCare to our team by requesting this feature to be setup.
Once your account configured, all SMS sent will be with this sender name. As per now, it is not possible to have multiple sender name per account.
PUSH responses
It is possible to receive PUSH responses (https REST call) as soon as a customer makes a response to a previously sent SMS. To activate this features, please make a request in ITCare to our team .
Here is the specifications of outbound request you will receive once activated :
Protocol | https |
URL | <yours> |
HTTP method | POST |
Authentication | None |
Content-Type | application/json |
Message Body | { "response": { "content": "Response of your customer", "answeredAt" : "2020-02-12T13:00:00.000+0000" }, "message": { }} |
Limits
You can set limits to avoid multiple calls / bad loops and prevent some flooding :
total SMS sent by minute
total SMS sent by hour
total SMS sent by day
To activate this features, please make a request in ITCare to our team.
Last updated