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.
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. |