Numéros de téléphone

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

Les numéros de téléphone reliés à vos assistants vocaux, avec le type de connexion (sip ou whatsapp), l'état et quand l'IA répond (ai_mode). whatsapp_calls indique si l'assistant reçoit aussi les appels WhatsApp : avec une ligne (sip), c'est un canal en plus, sur le numéro WhatsApp du compte.

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

1 · 1 obligatoires

apikey obligatoire

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

Besoin d'aide pour l'intégration ? info@sendapp.live

Requête

curl 'https://app.sendapp.ai/api/voice/numbers' \
  -H 'X-API-Key: YOUR_API_KEY'

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

Réponse

{
  "status": "success",
  "numbers": [
    {
      "phone_number": "+390212345678",
      "assistant_id": "YOUR_ACCOUNT_TOKEN",
      "assistant_name": "Studio Dentistico Rossi",
      "connection": "sip",
      "whatsapp_calls": false,
      "status": "registered",
      "ai_mode": "always"
    }
  ]
}

{
  "status": "error",
  "message": "The Voice AI app is turned off in your account (Apps page): turn it on to use the API."
}