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

Voice

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

Setzen Sie Ihren Request an folgende URL ab:

https://gateway.sms77.io/api/voice

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

Benötigte Parameter

ParameterBeschreibungMögliche Werte
toEmpfängernummer
Möglich sind Nummern und Adressbucheinträge (nur Kontakte). Derzeit nur ein Empfänger je Aufruf möglich
0049171999999999
0171999999999
49171999999999
textTextnachricht, die vorgelesen werden soll, oder XML DatenMax 10.000 Zeichen

Optionale Parameter

ParameterBeschreibungMögliche Werte
xmlGibt an, ob die Variable text ein reiner Text, der vorgelesen werden soll, oder ein XML Format ist.1 = XML
0 = Text (Standard)
fromAbsenderkennung 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:

ParameterBeschreibung
idID des Voice Anrufs
callerIdDie gesetzte Anruferkennung
recipientEmpfängernummber
statusAktueller Status des Anrufs.

Mögliche Werte sind: completed, no-answer, failed, initiated, ringing, in-progress

durationSie erhalten die Dauer des Anrufs in Sekunden, wenn er abgeschlossen ist.
pricePerMinutePreis pro Minute in Euro.
Was this article helpful to you? Yes No
Menü