Zum Inhalt springen
Voice LogicaVoice LogicaDocs
DE
App öffnen

API-Schlüssel

3 Min. Lesezeit
Als Markdown kopieren
Als Markdown ansehenDie rohe .md-Datei öffnen.md

API-Schlüssel sind programmatische Zugangsdaten für das Voice-Logica-API — jeder Schlüssel ist auf die Operationen beschränkt, die Sie erlauben, und kann auf eine einzelne IP-Adresse begrenzt werden. Derselbe Schlüssel meldet auch MCP-Clients (ChatGPT, Claude) an Ihrem Workspace an. Die Schlüssel finden Sie unter Team and access → API Keys.

Einen API-Schlüssel erstellen

Abschnitt betitelt „Einen API-Schlüssel erstellen“

  1. Öffnen Sie die Registerkarte API Keys

    Gehen Sie zu Team and access in der Account-Gruppe der Seitennavigation, wählen Sie die Registerkarte API Keys und klicken Sie auf “Api Key”.

    Registerkarte API Keys
    api-keys-0Expand

  2. Schlüssel benennen und IP einschränken

    Vergeben Sie einen aussagekräftigen Namen, der den Zweck widerspiegelt — “CRM Integration”, “Webhook Handler”, “Initiate Call”. Optional tragen Sie eine IP-Adresse ein, um Aufrufe auf eine Adresse zu beschränken; leer lassen erlaubt jede IP.

    Formular API-Schlüssel erstellen
    api-keys-1Expand

  3. Erlaubte Operationen wählen

    Unter API operation restrictions schalten Sie frei, welche Operationen der Schlüssel aufrufen darf. Die Operationen sind nach Bereichen gruppiert — Calls, Agents, VoIP & SIP, SMS, Workflows, MCP, Billing und Shopify. Lassen Sie alles aktiviert für Vollzugriff oder deaktivieren Sie, was der Schlüssel nicht braucht.

    API-Operationsbeschränkungen
    api-keys-2Expand

  4. Erstellen und Schlüssel kopieren

    Klicken Sie auf “Create API Key”. Der vollständige Schlüsselwert wird nur dieses eine Mal angezeigt — kopieren Sie ihn jetzt und bewahren Sie ihn sicher auf.

    API-Schlüssel erstellen
    api-keys-3Expand

Schlüssel verwalten

Abschnitt betitelt „Schlüssel verwalten“

Die API-Keys-Tabelle zeigt jeden Schlüssel mit Name, dem maskierten Schlüssel, zuletzt verwendet und erstellt am.

API-Schlüssel-Tabelle
api-keys-4Expand
  • Bearbeiten — Name, IP-Beschränkung und erlaubte Operationen aktualisieren. Der Schlüsselwert selbst wird nicht erneut angezeigt und lässt sich nicht ändern.
  • Löschen — entfernt den Schlüssel dauerhaft. Das lässt sich nicht rückgängig machen; jede Anwendung, die ihn nutzt, verliert sofort den Zugriff.

Ihren API-Schlüssel verwenden

Abschnitt betitelt „Ihren API-Schlüssel verwenden“

Authentifizieren Sie Anfragen, indem Sie den Schlüssel im Header x-api-key senden:

x-api-key: YOUR_API_KEY

Zum Beispiel einen ausgehenden AI-Anruf starten:

Terminal-Fenster
curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationNumber": "+302101234567",
    "agentId": "your-agent-id",
    "voipPhoneId": "your-voip-phone-id"
  }'

destinationNumber ist erforderlich; übergeben Sie agentId für ausgehende AI-Anrufe und entweder voipPhoneId oder sipTrunkId, um die ausgehende Leitung zu wählen. Die vollständige interaktive Referenz aller Endpunkte finden Sie unter api.voicelogica.ai/api-docs.

Fehlerbehebung

Abschnitt betitelt „Fehlerbehebung“
Meine Anfragen liefern 401 Unauthorized
  • Prüfen Sie, dass der Schlüssel im Header x-api-key gesendet wird — nicht als Bearer-Token.
  • Prüfen Sie, dass der Schlüssel nicht aus der Tabelle gelöscht wurde.
  • Hat der Schlüssel eine IP-Beschränkung, muss die Anfrage von genau dieser Adresse kommen.
Meine Anfragen liefern 403 Forbidden
  • Die Operationsbeschränkungen des Schlüssels enthalten den aufgerufenen Endpunkt nicht — bearbeiten Sie den Schlüssel und aktivieren Sie die passende Operationsgruppe.

Nächste Schritte

Abschnitt betitelt „Nächste Schritte“

Brauchen Sie Hilfe?

Abschnitt betitelt „Brauchen Sie Hilfe?“

Bei Problemen ist das Voice-Logica-Support-Team für Sie da:

E-MAIL
ENTWICKLER
API-REFERENZ