Ein Anrufknopf auf Ihrer Website, beantwortet vom Agenten

Ein WebRTC-Client lässt einen Besucher den Agenten aus dem Browser anrufen. Ihr Backend fragt die Plattform nach einem temporären Passwort, gibt es an die Seite weiter, und die Seite startet den Anruf mit einem Skript. Der geheime Schlüssel erreicht den Browser nie.

Client anlegen

Unter Telefonie › WebRTC-Clients wählen Sie den Agenten und listen die Domains auf, auf denen der Knopf verwendet wird, mit localhost für lokale Tests. Sie erhalten den Client-Namen (wc_…) und einen geheimen Schlüssel (wk_…), der nur einmal angezeigt wird.

1. Ihr Backend fragt nach einem temporären Passwort

Das Passwort gilt 60 Sekunden und für einen Anruf.

curl -X POST https://developers.swissai.dev/api/webrtc/token \
  -H "X-Api-Key: wk_ihr_geheimer_schluessel" \
  -H "Content-Type: application/json" \
  -d '{"client": "wc_3f9a1c2b7d4e", "identity": "visitor-1842"}'

// 200
{ "wss": "wss://pbx.swissai.dev:8089", "domain": "pbx.swissai.dev",
  "user": "w4c1f09ab37de5521", "pass": "…", "target": "sip:ag_7f3a2b91@pbx.swissai.dev", "expires_in": 60 }

2. Die Seite startet den Anruf

Laden Sie das Skript und übergeben Sie ihm die Antwort unverändert. onState erhält connecting, calling, connected und idle; onError den Grund, wenn der Anruf nicht starten kann.

<button id="call">Rufen Sie uns an</button>
<script src="https://developers.swissai.dev/js/call.js"></script>
<script>
document.getElementById('call').onclick = async () => {
  const params = await (await fetch('/call-token', { method: 'POST' })).json(); // Ihr Backend
  SwissCall.start(params, { onState: s => console.log(s), onError: m => alert(m) });
};
</script>

Derselbe Agent, dieselben Tools, auch als Text

Der Agent hinter dem Knopf ist derselbe, der ans Telefon geht, mit seinem Prompt und seinen Tools. Mit demselben Client-Namen und Schlüssel kann Ihr Backend ihm auch Textnachrichten über die Chat-API senden und mit GetCalls die Anrufe und Kosten des Kunden lesen. Beide Aufrufe lassen sich im Testbereich des Dashboards ausprobieren, mit Code zum Kopieren.

Verwandte Seiten

• Eine SIP-URI für jeden Sprachagenten
• Tools: der Agent ruft Ihre HTTP-Endpunkte auf
• Kundenservice der ersten Stufe am Telefon, beantwortet von einem KI-Agenten