EchoAI

API Dokumentation

Beta

Die EchoAI API ermöglicht es, Analysen programmatisch zu erstellen, abzurufen und Transkripte weiterzuverarbeiten. Verfügbar ab dem Pro-Plan.

🔑Authentifizierung

Alle Anfragen sind POST an denselben Endpunkt. Der API Key wird im Request Body übergeben.

Endpunkt

https://base44.app/api/apps/69e9d55547aac817139252f2/functions/publicApi

Basis-Struktur

{
  "action": "create_analysis",
  "api_key": "echo_dein_api_key",
  ...parameter
}

Endpunkte

Parameter

action
string
required

"create_analysis"

api_key
string
required

Dein API Key

file_url
string
required

Öffentlich zugängliche URL zur MP3, MP4 oder M4A Datei

call_title
string

Titel des Calls (optional)

notes
string

Interne Notizen (optional)

Beispiel

curl -X POST https://base44.app/api/apps/69e9d55547aac817139252f2/functions/publicApi \
  -H "Content-Type: application/json" \
  -d '{
    "action": "create_analysis",
    "api_key": "echo_dein_api_key",
    "file_url": "https://example.com/recording.mp3",
    "call_title": "Max Müller – Erstgespräch"
  }'

Response

{
  "analysis_id": "abc123...",
  "status": "pending"
}
💡 Die Analyse startet asynchron. Nutze get_analysis um den Status zu prüfen, oder konfiguriere einen Webhook für automatische Benachrichtigungen.

Webhook — Abschluss-Benachrichtigung

Trage in deinem Profil → API Zugang eine Webhook-URL ein. EchoAI ruft diese URL automatisch auf, sobald eine Analyse abgeschlossen ist.

Payload (POST, JSON)

{
  "event": "analysis.completed",
  "analysis_id": "abc123...",
  "call_title": "Max Müller – Erstgespräch",
  "status": "completed",
  "pdf_url": "https://...",
  "transcript_url": "https://...",
  "audio_duration_minutes": 45,
  "sales_result": "Kein Verkaufsabschluss",
  "overall_score": 7.2,
  "closer_name": "Felix",
  "created_date": "2026-05-26T10:00:00Z"
}
⚠️ Antworte innerhalb von 5 Sekunden mit HTTP 2xx, sonst wird der Webhook als fehlgeschlagen gewertet. Verarbeitung asynchron empfohlen.

Fehlercodes

401
UnauthorizedAPI Key fehlt oder ist ungültig
403
ForbiddenPlan unterstützt keinen API-Zugang (mind. Pro erforderlich)
404
Not FoundAnalyse nicht gefunden oder kein Transkript verfügbar
429
Too Many RequestsMonatliches Analyse-Limit erreicht
400
Bad RequestPflichtparameter fehlen (z.B. file_url, analysis_id)