yourang.ai Logo
Zurück zur Plattform
Dokumentation
Erste Schritte
  • Was die Plattform ist
  • Erster Zugang
  • Plattform-Übersicht
  • Schnellglossar
Dashboard-Assistent
  • Was der Dashboard-Assistent ist
  • Wie du ihn verwendest
  • Was er kann
  • Sicherheit und Datenschutz
  • Tarife und Nutzungslimits
Sprachagent
  • Grundkonfiguration
  • Stimmen und Sprache
  • Anweisungen
  • Prompt-Token
  • Erweiterte Einstellungen
  • Bewertungskriterien
  • Test und Playground
  • Anweisungen aktualisieren
  • External Tools
  • Vordefinierte Tools
  • MCP-Server
Angebotene Modelle
  • Was Modelle sind und warum sie wichtig sind
  • Sprachmodelle
  • KI-Modelle
  • Die richtige Kombination wählen
Dokumente und Wissensdatenbank
  • Was die Wissensdatenbank ist
  • Dokumente hochladen und verwalten
  • Wie die Suche während eines Anrufs funktioniert
  • Best Practices
Anrufe
  • Anrufhistorie
  • Transkripte und Zusammenfassungen
  • Audioaufzeichnungen
  • Filter und Suche
  • Datenexport
Anrufweiterleitung
  • Wann und warum einen Anruf weiterleiten
  • Abteilungen
  • Systemtools
  • KI außerhalb der Geschäftszeiten
  • Routing-Regeln
  • Operator-App (iOS / Android)
WhatsApp
  • WhatsApp Business in yourang.ai
  • Chat in Echtzeit
  • Automatisierungen
  • Genehmigte Vorlagen
  • WhatsApp-Kontakte und -Listen
  • WhatsApp-KI-Agenten
Aktionen und Kampagnen
  • Was Aktionen sind
  • SMS-Kampagnen
  • E-Mail-Kampagnen
  • Planung und Batch-Versand
Buchungen
  • Kalenderansicht
  • Verfügbarkeitsregeln
  • Bestätigungen und Erinnerungen
  • Änderungen und Stornierungen
Kontakte
  • Kundenadressbuch
  • Import aus CSV
  • Listen und Segmente
  • Benutzerdefinierte Felder
Shop und Katalog
  • Der Shop in yourang.ai
  • Produkt- und Dienstleistungskatalog
  • Bestellverwaltung
  • OCR und Preislistenimport
Integrationen
  • Apple Calendar verbinden
  • HubSpot verbinden
  • Überblick über Integrationen
  • Kalender
  • WhatsApp
  • SMS und E-Mail
  • Verwaltungssoftware und PMS
  • Ausgehende Webhooks
Workflows
  • Was Workflows sind
  • Knoten und Blöcke
  • Trigger und Webhooks
  • Praktische Beispiele
Call Center und Dialer
  • Was das yourang.ai Call Center leistet
  • Outbound-Kampagnen
  • Menschliche Agenten
  • Kontaktlisten und Live-Sync
  • Agentenpanel
Externe APIs und Entwickler
  • yourang.ai für Entwickler
  • API-Schlüssel und Authentifizierung
  • Wichtigste Endpunkte
  • Eingehende Webhooks
Anwendungsfälle
  • Hotels und Beherbergungsbetriebe
  • Restaurant
  • B&B und Kurzzeitvermietungen
  • Kosmetikstudio und Spa
  • Reisebüro
Preise und Pläne
  • Wie das Pricing funktioniert
  • Die Abonnementpläne
  • Wallet und Guthaben
  • Verbrauch und Rechnungen
  • Plan ändern, pausieren oder kündigen
Verwaltung
  • Konto und Organisation
  • Rechnungsstellung und Abonnement
  • Team und Rollen
  • Sicherheit und Datenschutz
  • Benachrichtigungen
Geschäftsinformationen
  • Geschäftsdetails
  • Standort und Adresse
  • Öffnungszeiten
  • KI-Assistent-Zeiten
  • Abteilungen und Team
Ressourcen
  • Häufig gestellte Fragen
  • Vollständiges Glossar
  • Support
Dokumentation›Externe APIs und Entwickler›API-Schlüssel und Authentifizierung

Externe APIs und Entwickler

API-Schlüssel und Authentifizierung

API-Schlüssel sicher generieren, verwenden und widerrufen.

Die Authentifizierung bei der externen API erfolgt über API-Schlüssel (API Keys), die sich von den Benutzeranmeldedaten unterscheiden. Ein Schlüssel identifiziert eine Organisation und hat spezifische Berechtigungen.

Einen Schlüssel generieren

  1. 1

    Öffnen Sie das API-Panel

    Gehen Sie zu Administration → API. Nur Benutzer mit der Rolle Owner oder Admin können Schlüssel verwalten.

  2. 2

    Erstellen Sie einen neuen Schlüssel

    Vergeben Sie einen aussagekräftigen Namen (z. B. 'PMS Produktion', 'Zapier Dev') und wählen Sie die Berechtigungsstufe.

  3. 3

    Kopieren Sie den Wert sofort

    Der Schlüssel wird nur einmal angezeigt. Bewahren Sie ihn sicher auf: Passwort-Manager, Vault, Umgebungsvariable. yourang.ai speichert nur den Hash und kann ihn Ihnen nicht erneut zeigen.

  4. 4

    Konfigurieren Sie das externe System

    Fügen Sie den Schlüssel in das System ein, das die API aufrufen soll. Der Testaufruf bestätigt, dass alles funktioniert.

Berechtigungsstufen

  • Read. Nur Lesen: Kontakte, Bestellungen, Anrufe, Statistiken. Ideal für Dashboards, Berichte, Pull-Synchronisationen.
  • Write. Lesen + Erstellen/Ändern von Daten: Kontakte hinzufügen, Bestellungen erfassen, Buchungen erstellen. Für bidirektionale Integrationen.
  • Write + ausgehende Anrufe. Beinhaltet die Möglichkeit, Outbound-Anrufe auszulösen. Es ist die mächtigste Berechtigung, die nur vertrauenswürdigen Systemen zugewiesen werden sollte.

Den Schlüssel verwenden

Jede Anfrage enthält den Schlüssel im HTTP-Header Authorization als Bearer-Token. Beispiel: Authorization: Bearer yr_live_abc123. Die API validiert den Schlüssel, identifiziert die Organisation und wendet die Berechtigungen an, bevor die Anfrage verarbeitet wird.

Rotation und Widerruf

Best Practice: Rotieren Sie die Schlüssel mindestens einmal im Jahr oder jedes Mal, wenn sich das Personal, das sie verwaltet, ändert. Der Widerruf ist sofort: Mit Klick auf 'widerrufen' funktioniert der Schlüssel sofort nicht mehr. Erstellen Sie immer einen neuen Schlüssel, bevor Sie den alten widerrufen, um Serviceunterbrechungen zu vermeiden.

Niemals Schlüssel im Client

API-Schlüssel dürfen nicht in öffentlichem JavaScript-Code, kompilierten Mobil-Apps oder öffentlichen Git-Repositories erscheinen. Sie leben nur serverseitig. Wenn Sie eine Kompromittierung vermuten: sofort widerrufen und untersuchen.
Entwickler-Portal öffnen
API-Konsole, Anfrage-Logs, OpenAPI durchsuchbar.
Zur API-Übersicht
REST-Endpoints, Authentifizierung, praktische Beispiele.

War diese Seite hilfreich?

Zurückyourang.ai für EntwicklerWeiterWichtigste Endpunkte