Gateway

  2. Home
  4. Gateway
  6. HTTP API
  8. Voice

Voice

Setzen Sie über die Voice Api von sms77 einen Anruf an eine bestimmte Rufnummer per API ab. In der einfachsten Variante können Sie einen Text angeben, der dann über unser Text-To-Speech Gateway beim Empfänger vorgelesen wird. Für erweiterte Anwendungen haben Sie die Möglichkeit, den Text im XML Format zu senden.

Setzen Sie Ihre Anfragen an folgende Adresse ab:
https://gateway.sms77.io/api/voice

Zusätzlich zur Authentifizierung senden Sie dabei bitte folgende Parameter:

Benötigte Parameter
Parameter Beschreibung Mögliche Werte
to Empfängernummer
Möglich sind Nummern und Adressbucheinträge (nur Kontakte). Derzeit nur ein Empfänger je Aufruf möglich		 0049171999999999
0171999999999
49171999999999
text Textnachricht, die vorgelesen werden soll, oder XML Daten Max 10.000 Zeichen

Optionale Parameter
Parameter Beschreibung Mögliche Werte
debug Wenn aktiviert, werden keine Anrufe getätigt. Sinnvoll, um zu testen, ob die API ansprechbar ist. 0 = Nein (Standard)
1 = Ja
xml Gibt an, ob die Variable text ein reiner Text ist, der vorgelesen werden soll, oder ein XML Format ist. 0 = Text (Standard)
1 = XML
from Absenderkennung des Anrufs. Bitte verwenden Sie hier nur verifizierte Absenderkennungen, eine Ihrer virtuellen Inboundnummern oder eine unserer geteilten virtuellen Rufnummern. 491771783130

Beispiel

https://gateway.sms77.io/api/voice?p=api-key&to=49171999999999&text=Dieser+Text+wird+vorgelesen.

Die Rufnummer +49171999999999 wird angerufen und es wird Dieser Text wird vorgelesen. am Telefon angesagt.

Unser Voice Gateway lässt sich nach belieben erweitern – z.B. mit interaktiven Menüs, MP3s können abgespielt werden uvm. Sprechen Sie uns an für Ihre individuellen Anforderungen!

Webhooks

Richten Sie in Ihren Accounteinstellungen einen Webhook ein, um Statusaktualisierungen Ihres Anrufs in Echtzeit zu erhalten.

Wir senden die folgenden Parameter an Ihre Callback-URL:

Parameter Beschreibung
id ID des Voice Anrufs
callerId Die gesetzte Anruferkennung
recipient Empfängernummber
status Aktueller Status des Anrufs.

Mögliche Werte sind: completed, no-answer, failed, initiated, ringing, in-progress
duration Sie erhalten die Dauer des Anrufs in Sekunden, wenn er abgeschlossen ist.
pricePerMinute Preis pro Minute in Euro.