Skip to main content

Mit unserer API entwickeln

Integrieren Sie identitycall.ai nahtlos.

Authentifizierung

  • -

    Authentifizieren Sie Anfragen über Bearer-Tokens. Alle API-Anfragen müssen den Header 'Authorization: Bearer <YOUR_API_KEY>' enthalten.

  • -

    Generieren und verwalten Sie API-Schlüssel über Ihr Konto-Dashboard. Die Schlüssel sind auf Ihr Konto beschränkt und sollten geheim gehalten werden.

Aufzeichnungen & Transkription

  • -

    POST /api/v1/public/recordings: Laden Sie Audiodateien (MP3, WAV, FLAC, M4A) bis zu 2GB hoch. Unterstützt multipart/form-data.

  • -

    GET /api/v1/public/recordings/{id}: Rufen Sie Status und Metadaten einer Aufzeichnung ab; GET /api/v1/public/recordings/{id}/audio_url liefert eine URL für die Audiowiedergabe.

  • -

    GET /api/v1/public/recordings/{id}/transcription: Rufen Sie das vollständige Transkript mit Sprecher-Diarisierung und Zeitstempeln ab.

  • -

    GET /api/v1/public/recordings: Listen Sie alle Aufzeichnungen auf; GET /api/v1/public/recordings/filters liefert die verfügbaren Filterwerte.

Projekte & Betreiber

  • -

    GET/POST /api/v1/public/projects: Listen, erstellen und verwalten Sie die Projekte, in denen Ihre Aufzeichnungen organisiert sind.

  • -

    GET/POST /api/v1/public/operators: Verwalten Sie Betreiber (Agenten) – die Personen, deren Anrufe Sie aufzeichnen und zuordnen.

  • -

    GET /api/v1/public/app/settings: Lesen Sie die Verarbeitungseinstellungen Ihres Kontos aus.

Analyseergebnisse

  • -

    GET /api/v1/public/recordings/{id}/results: Zielbewertungen, Kategorien, extrahierte Felder und Sprecheridentifikation für einen verarbeiteten Anruf.

  • -

    GET /api/v1/public/recordings/{id}/summary: Die KI-generierte Zusammenfassung des Gesprächs.

  • -

    Die Ergebnisse enthalten die Begründung hinter jeder Zielbewertung, sodass jede Zahl nachprüfbar ist.

Virtuelle Nummern & Telefonie

  • -

    GET /api/v1/public/virtual_numbers/available und POST /api/v1/public/virtual_numbers/purchase: Durchsuchen und kaufen Sie Telefonnummern.

  • -

    PATCH /api/v1/public/virtual_numbers/{id}: Konfigurieren Sie eine Nummer; fügen Sie Betreiber mit POST {id}/add_operator hinzu oder entfernen Sie sie mit DELETE {id}/remove_operator.

Webhooks & Ereignisse

  • -

    Erhalten Sie einen Echtzeit-Webhook 'recording.analyzed', sobald die Verarbeitung abgeschlossen ist, mit den von Ihnen gewählten Payload-Abschnitten: Metadaten, Zusammenfassung, Transkription, Ziele, Kategorien, extrahierte Daten.

  • -

    Webhooks werden als JSON-POST-Anfragen an den von Ihnen konfigurierten HTTPS-Endpunkt zugestellt.

Rate-Limits

  • -

    Die API-Rate-Limits sind an die Kontingente Ihres Abonnements gebunden.