Alterar as definições

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

Altera as definições da Voice AI de um assistente, como a página Voice AI. Envie só os campos que mudam: os que não enviar ficam como estão. Aplica-se a partir das chamadas seguintes.

Só são verificados os campos que envia: um campo que não envia fica como está. Um campo enviado vazio de propósito, por exemplo "language": "", responde 422.

Só estes campos podem ser alterados: qualquer outro campo (por exemplo a gravação ou os dados da linha) responde 422.

Com o plano expirado a alteração é recusada com 403 e code: plan_expired. Limite: 30 alterações por minuto por chave.

Erros comuns: 401 chave API em falta ou errada — 403 plano sem acesso API ou sem Voice AI, app Voice AI desativada, conta suspensa — 404 chamada ou assistente que não existe ou não é seu — 422 parâmetros inválidos — 429 demasiados pedidos: tente novamente após os segundos indicados em Retry-After.

Parâmetros

8 · 2 obrigatórios

apikey obrigatório

A sua API Key (o cabeçalho X-API-Key também funciona).

assistant_id obrigatório

O assistente (assistant_id de Lista de assistentes de voz).

language opcional

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

voice_id opcional

A voz (como em voice_id das definições).

voice_label opcional

O nome mostrado para a voz.

first_message opcional

O que o assistente diz ao atender (máximo 500 caracteres).

system_prompt opcional

As instruções para o assistente telefónico (máximo 4000 caracteres).

greet_caller_by_name opcional

true para saudar pelo nome quem já está nos contactos.

Precisa de ajuda com a integração? 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." }