Changelog

Neue Endpunkte

ElevenAgents

• Wartemusik für Agent hochladen - POST /v1/convai/agents/{agent_id}/hold-audio
  • Akzeptiert die erforderliche hold_audio_file (binär) als Multipart-Formulardaten. Die Datei muss MP3 oder WAV sein und darf bis zu 40 MB bzw. 180 Sekunden umfassen.
  • Gibt die erforderliche agent_id (String) und hold_audio (AgentHoldAudioConfig) zurück. Das Wartemusik-Objekt erfordert audio_path, audio_url, original_filename (Strings), duration_secs (Zahl) und size_bytes (Ganzzahl).
• Wartemusik für Agent löschen - DELETE /v1/convai/agents/{agent_id}/hold-audio
  • Entfernt den benutzerdefinierten Clip, sodass wartende Anrufer den Standard-Warteton hören.
  • Gibt die erforderliche agent_id (String) zurück.

Aktualisierte Endpunkte

ElevenAgents

• Agent erstellen, Agent abrufen und Agent aktualisieren
  • Optionale platform_settings.queueing_config (AgentQueueingConfig) mit enabled (Boolean, Standardwert false) und wait_timeout_seconds (Ganzzahl, 1–1.800, Standardwert 180) hinzugefügt.
  • Antworten zur Warteschlangenkonfiguration enthalten schreibgeschützte nullable hold_audio (AgentHoldAudioConfig). Agent-Antworten enthalten außerdem optional default_hold_audio_url (String).
• Unterhaltung abrufen - GET /v1/convai/conversations/{conversation_id}
  • Metadaten enthalten zusätzlich optional nullable queue_wait_secs (Zahl). Die Wartezeit wird nicht in call_duration_secs und die abrechenbare Zeit einbezogen.
• Agent-Branch erstellen - POST /v1/convai/agents/{agent_id}/branches
  • Optionales include_draft (Boolean, Standardwert false) hinzugefügt. Bei true enthält ein vom Branch-Tipp erstellter Branch den Entwurfs-Prozedursatz des Aufrufers.
• Prozeduren auflisten sowie Endpunkte zum Erstellen, Abrufen und für Entwürfe von Prozeduren
  • Listenelemente enthalten zusätzlich optionale referenced_tool_ids, referenced_kb_ids, referenced_procedure_ids und referenced_dynamic_variables (String-Arrays).
  • Agent- und Merge-Vorschauantworten enthalten zusätzlich optionale procedures, eine nach Prozedur-ID sortierte Map.
• Testaufrufe auflisten - GET /v1/convai/test-invocations
  • Optionales nullable search (String) hinzugefügt, um Tests und Ordner nach Namen zu filtern.
• Tests für Agent ausführen und Testaufruf abrufen
  • Antworten für Test-Suite-Aufrufe und Unit-Test-Ausführungen enthalten zusätzlich optional nullable version_id (String) und optional ran_against_draft (Boolean, Standardwert false).
  • Aufrufzusammenfassungen enthalten außerdem optional runs_diverged_from_version (Boolean, Standardwert false).
• POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
  • Der Anfragetext enthält zusätzlich optionale nullable, abfragespezifische Überschreibungen für max_documents_length (Ganzzahl, 1–50.000) und max_retrieved_rag_chunks_count (Ganzzahl, 1–20).
• WhatsApp-Konto abrufen - GET /v1/convai/whatsapp-accounts/{phone_number_id}
  • Optionales account_type (WhatsAppAccountType, Standardwert cloud_api) hinzugefügt. Werte sind cloud_api und coexistence.
• Erwartete LLM-Nutzung berechnen - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
  • LLMUsageCalculatorLLMResponseModel enthält zusätzlich das erforderliche price_per_message (Zahl).

Musik

• MusicModelID enthält zusätzlich music_v2_5 für POST /v1/music/video-to-music, POST /v1/music/plan, Musik komponieren, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream, POST /v1/music/upload und POST /v1/music/finetunes.
• GenerationChunk.text erhöht maxLength von 6.000 auf 6.132 Zeichen für POST /v1/music/plan, POST /v1/music, POST /v1/music/detailed, POST /v1/music/detailed/stream, POST /v1/music/stream und POST /v1/music/upload. Abschnittsnamen können 1–100 Zeichen enthalten und Chunks können bis zu 30 Zeilen mit jeweils 200 Zeichen enthalten.

Schemaänderungen

ElevenAgents

• Echtzeit-Serverereignisse enthalten zusätzlich queue_status. Das erforderliche queue_status_event.status akzeptiert waiting, admitted oder timed_out; timed_out geht dem WebSocket-Schließcode 4300 voraus. Wartemusik trifft weiterhin als reguläre audio-Ereignisse ein.
• Die Aufzählung LLM enthält zusätzlich gemini-3.8-flash, einschließlich Überschreibungen für die Gesprächsinitiierung.
• Vereinigungen für System-Tool-Ergebnisse von Unterhaltungen enthalten zusätzlich start_procedure_success, start_procedure_error, end_procedure_success und end_procedure_error.
• FeaturesUsageCommonModel enthält zusätzlich optionale Feature-Status für freeform_procedure und structured_procedure.