Via the Voice Api of sms77 you can issue calls to certain phone numbers. The simplest way is to specify a text which is read to the recipient via our Text-to-Speech Gateway. For advanced applications, you have the option of sending the text in XML format. For this use our markup language VoiceML77 (more soon).
Please use the following URL for your request:
https://gateway.sms77.io/api/voice
In addition to authentication, the following parameters are required:
Required parameters
| Parameter | Description | Possible values |
|---|---|---|
to | Recipient number Allowed are numbers and address entries (contacts only). Currently just one recipient per call is possible. | 0049171999999999017199999999949171999999999 |
text | Text message to be read or XML data | Max 10,000 characters |
Optional parameters
| Parameter | Description | Possible values |
|---|---|---|
xml | Specifies whether the text variable is a plain text to be read, or an XML format. | 1 = XML0 = text (default) |
from | Caller ID. Please use only verified sender IDs, one of your virtual inbound numbers or one of our shared virtual numbers. | 491771783130 |
Example
https://gateway.sms77.io/api/voice?p=api-key&to=49171999999999&text=This+text+is+read.
The phone number +49171999999999 is called and This text is read. is announced on the phone.
Our Voice Gateway can be expanded individually – e.g. with interactive menus, MP3s can be played and much more. Contact us for your specific requirements!
Webhooks
Setup a webhook in your account settings to receive realtime status updates of your call.
We will send the following parameters to your callback URL:
| Parameter | Description |
|---|---|
id | ID of the Voice Call |
callerId | Sent caller ID |
recipient | Recipient number |
status | Current status of the call. Possible values are: completed, no-answer, failed, initiated, ringing, in-progress |
duration | You will get the duration of the call in seconds when it is completed. |
pricePerMinute | Price per minute in Euro. |
