Zum Inhalt springen
DE
App öffnen

For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/de/getting-started/api-keys.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.

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.

  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

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.

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.

Warum liefern meine API-Anfragen den Fehler 401 Unauthorized?

Senden Sie den API-Schlüssel im Header x-api-key, nicht als Bearer-Token. Prüfen Sie außerdem, dass der Schlüssel nicht aus der Tabelle API Keys gelöscht wurde. Hat der Schlüssel eine IP-Beschränkung, muss die Anfrage genau von dieser Adresse kommen.

Warum liefern meine API-Anfragen den Fehler 403 Forbidden?

Die Operationsbeschränkungen des API-Schlüssels enthalten den aufgerufenen Endpunkt nicht. Bearbeiten Sie den Schlüssel und aktivieren Sie die passende Operationsgruppe.

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