Definições de um assistente

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

As definições da Voice AI de um assistente: idioma, voz, mensagem de boas-vindas, instruções, saudação pelo nome, gravação e número de telefone.

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

2 · 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).

Precisa de ajuda com a integração? info@sendapp.live

Pedido

curl 'https://app.sendapp.ai/api/voice/config?assistant_id=YOUR_ACCOUNT_TOKEN' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/voice/config?assistant_id=YOUR_ACCOUNT_TOKEN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
$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', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Resposta

{
  "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-04T16:20:11Z"
  }
}

{
  "status": "error",
  "message": "Assistant not found: assistant_id must be one of your assistants (GET /api/voice/assistants)."
}