Modifier les réglages

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

Modifie les réglages de la Voice AI d'un assistant, comme la page Voice AI. Envoyez seulement les champs qui changent : ceux que vous n'envoyez pas restent tels quels. S'applique dès les appels suivants.

Seuls les champs envoyés sont contrôlés : un champ que vous n'envoyez pas reste tel quel. Un champ envoyé vide exprès, par exemple "language": "", répond 422.

Seuls ces champs sont modifiables : tout autre champ (par exemple l'enregistrement ou les données de la ligne) répond 422.

Avec un forfait expiré la modification est refusée avec 403 et code: plan_expired. Limite : 30 modifications par minute et par clé.

Erreurs courantes : 401 clé API absente ou erronée — 403 forfait sans accès API ou sans Voice AI, app Voice AI désactivée, compte suspendu — 404 appel ou assistant inexistant ou qui n'est pas à vous — 422 paramètres non valides — 429 trop de requêtes : réessayez après les secondes indiquées dans Retry-After.

Paramètres

8 · 2 obligatoires

apikey obligatoire

Votre API Key (l'en-tête X-API-Key fonctionne aussi).

assistant_id obligatoire

L'assistant (assistant_id de Liste des assistants vocaux).

language facultatif

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

voice_id facultatif

La voix (comme dans voice_id des réglages).

voice_label facultatif

Le nom affiché pour la voix.

first_message facultatif

Ce que dit l'assistant quand il répond (500 caractères maximum).

system_prompt facultatif

Les instructions pour l'assistant téléphonique (4000 caractères maximum).

greet_caller_by_name facultatif

true pour saluer par son nom un appelant déjà dans les contacts.

Besoin d'aide pour l'intégration ? 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." }