Zum Inhalt springen

SayWordy für Entwickler

Andere Sprachen.
Eine Verbindung.

Fügen Sie übersetzte Telefonate zu Ihrem Produkt hinzu. Prüfen Sie den Tarif, verbinden Sie zwei Personen und verfolgen Sie das Gespräch mit einem Prepaid-Guthaben.

Telefon-zu-Telefon-Anrufe · Unterstützte US-Ziele · Server-seitige API

01AngebotPreis prüfen
02VerbindenAnnehmen, dann wählen
03ÜbersetzenAnruf folgen

Ein unkomplizierter Anfang

Angebot. Anruf. Im Bilde bleiben.

Behalte die Keys auf deinem Server.
Deine Nutzer behalten die volle Kontrolle über jeden Anruf.

curl https://saywordy.com/api/v1/quotes \
  -H "Authorization: Bearer $SayWordy_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "you": {"phoneNumber": "+12025550101", "language": "en", "voice": "female"},
      "them": {"phoneNumber": "+12025550102", "language": "es", "voice": "male"},
      "recording": false,
      "hearOriginal": true
    }
  }'

Die Beispieltelefonnummern sind für die Dokumentation reserviert. Ersetzen Sie diese nur, wenn Sie einen echten, kostenpflichtigen Anruf tätigen möchten. Verwenden Sie einen Testschlüssel für simulierte Anfragen. Der Testmodus wählt niemals Nummern an und belastet nicht Ihr Guthaben. Ein Angebot startet niemals automatisch einen Anruf.

Flow ausprobieren

Eine Vorschau, ohne dass das Telefon klingelt.

Führen Sie dieses lokale Beispiel aus, um zu sehen, wie eine Preisprüfung funktioniert. Es wird ein fiktiver Satz von 30 Credits verwendet und es erfolgen keine API-Anfragen, Nachschläge oder Telefonanrufe.

Ihr Beispielzitat wird hier erscheinen.

Kein API-Key erforderlich.

Keys mit Grenzen.

Erstellen Sie eingeschränkte Keys mit einem Ausgabenlimit. Entziehen Sie den Zugriff über Ihr Konto. Platzieren Sie niemals einen Secret Key im Browser- oder Mobile-Client-Code.

Eine einzige Quelle der Wahrheit.

Das akzeptierte Server-Angebot legt den Anrufpreis fest. Die verbundenen Sekunden werden von derselben Wallet abgezogen, die Sie auf SayWordy verwenden.

Basiert auf gegenseitigem Einverständnis.

Beide Teilnehmer müssen zustimmen, bevor die Verbindung hergestellt wird. Die Aufzeichnung ist optional und erfordert die Zustimmung beider Personen. Bei einem fehlgeschlagenen Setup wird keine Gesprächsgebühr erhoben.

Was Sie von der API erwarten können

Authentifizierung
Authorization: Bearer YOUR_KEY. Keys sind auf ihren Workspace und autorisierte Anrufe beschränkt.
Angebote
Prüfen Sie beide Nummern vor dem Anruf. Ein Angebot enthält dessen Ablaufdatum und den Tarif. Geänderte Nummern oder abgelaufene Angebote erfordern eine neue Prüfung.
Wiederholungsversuche
Verwenden Sie für jeden beabsichtigten Anruf einen eindeutigen Idempotenz-Schlüssel und verwenden Sie diesen Schlüssel erneut, wenn Sie dieselbe Anfrage wiederholen.
Nutzung
Beide Telefonverbindungen und die Übersetzung sind im akzeptierten Minutentarif enthalten. Die Abrechnung erfolgt über die verbundenen Sekunden und Bruchteile von Guthaben.
Verfügbarkeit
Der Zugang hängt von Ihrem Konto, den konfigurierten Routen und dem verfügbaren Guthaben ab. Unbekannte, Premium- und nicht unterstützte Ziele können nicht angerufen werden.

Wohin wir als Nächstes wollen

Ein Wallet. Mehr Möglichkeiten, sich zu verbinden.

Direkte Browser- und Native-App-Anrufe sowie Video- und Meeting-Integrationen stehen auf unserer Roadmap. Sie sind derzeit über diese API nicht verfügbar.

Preise entdecken