Modifica le impostazioni

PATCH https://app.sendapp.ai/api/voice/config

Cambia le impostazioni della Voice AI di un assistente, come la pagina Voice AI. Manda solo i campi che cambiano: quelli che non mandi restano come sono. Vale dalle chiamate successive.

Si controllano solo i campi che invii: un campo che non mandi resta com'è. Un campo inviato vuoto apposta, per esempio "language": "", risponde 422.

Sono modificabili solo questi campi: qualsiasi altro campo (per esempio la registrazione o i dati della linea) risponde 422.

Con il piano scaduto la modifica è rifiutata con 403 e code: plan_expired. Limite: 30 modifiche al minuto per chiave.

Errori comuni: 401 chiave API mancante o sbagliata — 403 piano senza accesso API o senza Voice AI, app Voice AI spenta, account sospeso — 404 chiamata o assistente che non esiste o non è tuo — 422 parametri non validi — 429 troppe richieste: riprova dopo i secondi indicati in Retry-After.

Parametri

8 · 2 obbligatori

apikey obbligatorio

La tua API Key (anche header X-API-Key).

assistant_id obbligatorio

L'assistente (assistant_id da Elenco assistenti vocali).

language opzionale

Lingua: it, en, es, fr, de, pt.

voice_id opzionale

La voce (come in voice_id delle impostazioni).

voice_label opzionale

Il nome mostrato per la voce.

first_message opzionale

Cosa dice l'assistente quando risponde (massimo 500 caratteri).

system_prompt opzionale

Le istruzioni per l'assistente al telefono (massimo 4000 caratteri).

greet_caller_by_name opzionale

true per salutare per nome chi è già nei contatti.

Serve aiuto con l'integrazione? info@sendapp.live

curl -X PATCH 'https://app.sendapp.ai/api/voice/config?assistant_id=YOUR_ACCOUNT_TOKEN' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "first_message": "Studio Rossi, buongiorno! Come posso aiutarla?", "greet_caller_by_name": true }'

<?php $ch = curl_init('https://app.sendapp.ai/api/voice/config?assistant_id=YOUR_ACCOUNT_TOKEN'); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => 'PATCH', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['language' => 'en']), ]); $res = json_decode(curl_exec($ch), true); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/voice/config?assistant_id=YOUR_ACCOUNT_TOKEN', { method: 'PATCH', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ first_message: 'Studio Rossi, buongiorno!' }) }); console.log(await res.json());

{ "status": "success", "config": { "assistant_id": "YOUR_ACCOUNT_TOKEN", "assistant_name": "Studio Dentistico Rossi", "language": "it", "voice_id": "it-IT-Chirp3-HD-Aoede", "voice_label": "Aoede", "first_message": "Studio Rossi, buongiorno! Come posso aiutarla?", "system_prompt": "Sei l'assistente telefonico dello studio...", "greet_caller_by_name": true, "recording_enabled": true, "ai_mode": "always", "phone_number": "+390212345678", "updated_at": "2026-11-05T09:30:02Z" } }

{ "status": "error", "message": "These fields cannot be changed through the API: recording_enabled. Allowed: language, voice_id, voice_label, first_message, system_prompt, greet_caller_by_name." }