Cambiar los ajustes

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

Cambia los ajustes de Voice AI de un asistente, como la página Voice AI. Envía solo los campos que cambian: los que no envíes se quedan como están. Se aplica desde las siguientes llamadas.

Solo se comprueban los campos que envías: un campo que no envías se queda como está. Un campo enviado vacío a propósito, por ejemplo "language": "", responde 422.

Solo se pueden cambiar estos campos: cualquier otro campo (por ejemplo la grabación o los datos de la línea) responde 422.

Con el plan vencido el cambio se rechaza con 403 y code: plan_expired. Límite: 30 cambios por minuto por clave.

Errores comunes: 401 clave API ausente o incorrecta — 403 plan sin acceso API o sin Voice AI, app Voice AI desactivada, cuenta suspendida — 404 llamada o asistente que no existe o no es tuyo — 422 parámetros no válidos — 429 demasiadas solicitudes: inténtalo de nuevo tras los segundos indicados en Retry-After.

Parámetros

8 · 2 obligatorios

apikey obligatorio

Tu API Key (también sirve la cabecera X-API-Key).

assistant_id obligatorio

El asistente (assistant_id de Lista de asistentes de voz).

language opcional

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

voice_id opcional

La voz (como en voice_id de los ajustes).

voice_label opcional

El nombre mostrado para la voz.

first_message opcional

Lo que dice el asistente al responder (máximo 500 caracteres).

system_prompt opcional

Las instrucciones para el asistente telefónico (máximo 4000 caracteres).

greet_caller_by_name opcional

true para saludar por su nombre a quien ya está en los contactos.

¿Necesitas ayuda con la integración? 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." }