1. Home
  2. Gateway
  3. HTTP Api
  4. Voice

Voice

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.
0049171999999999
0171999999999
49171999999999
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 = XML
0 = 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.
Was this article helpful to you? Yes No 1
Menu