Portées

Lister, récupérer et inspecter les agents, leurs outils et le contenu de la base de connaissances.

Couvre également l'exécution des requêtes sur la base de connaissances.

Créer, mettre à jour, dupliquer et supprimer des agents ; gérer les outils ; téléverser des documents de base de connaissances.

Requis au moment de la pré-signature pour POST /uploads/presign avec kind="doc/knowledge-base". Les octets sont envoyés directement vers l'URL de stockage présignée via PUT.

Lister et récupérer les enregistrements d'appels et les jobs par lots.

Couvre également GET /conversation/{session_id}/status pour le polling de session en direct.

Passer des appels sortants et piloter des sessions de conversation en direct (connexion, envoi de texte, fin).

Couvre les appels déclenchés via REST (/calls, /calls/trigger, /calls/batch), la fin d'un appel en cours (/calls/:call_id/end) et le contrôle de session WebRTC.

Lister, rechercher et récupérer les transcriptions, diagnostics et enregistrements de conversations.

Inclut les endpoints de jetons audio et les feedbacks (qui mutent mais sont dans le rôle lecture car ils ne s'attachent qu'aux conversations existantes).

Lister les enregistrements, récupérer les métadonnées, télécharger l'audio.

Supprimer des enregistrements.

DELETE /recordings/{id}.

Soumettre de l'audio pour transcription (synchrone, asynchrone, upload présigné), interroger le statut des jobs, annuler des jobs.

Requis au moment de la pré-signature pour POST /uploads/presign avec kind="audio/transcribe".

Synthétiser de la parole (synchrone, streaming, par lots) et générer des aperçus de voix.

Toutes les routes sous /tts plus POST /voices/preview.

Lister le catalogue de voix et récupérer les métadonnées d'une voix individuelle.

GET /voices et GET /voices/{voice_id}.

Lister et récupérer les numéros de téléphone enregistrés sur votre compte.

Enregistrer des numéros Twilio, modifier leur configuration de routage, puis les libérer.

Lister et récupérer les identifiants de sous-compte Twilio enregistrés sur votre compte.

Enregistrer et supprimer des identifiants de sous-compte Twilio.

Consulter les messages que les agents peuvent envoyer.

Rédiger et gérer les messages envoyés par les agents.

Ne couvre que la bibliothèque de messages. Ce scope ne permet pas d'envoyer du texte libre à une personne : c'est `sms_inbox:write`.

Lire les conversations SMS des clients et leurs messages.

Répondre en tant que personne, passer les conversations de l'agent à un humain et inversement, et les marquer comme lues.

Distinct de `sms_messages:*` car il envoie du texte libre à un vrai destinataire et lit ce que les clients ont écrit.

Consulter les campagnes SMS et les personnes touchées.

Créer des campagnes SMS, et les démarrer, mettre en pause ou annuler.

Écrit à des milliers de personnes qui ne vous ont jamais contacté en premier, et chaque message est facturé. À accorder délibérément.

Consulter l'opérateur relié qui envoie les SMS.

Relier et gérer l'opérateur qui envoie les SMS.

Consulter les numéros WhatsApp Business reliés.

Relier et gérer les numéros WhatsApp Business.

Envoyer des messages modèles et passer des appels depuis un numéro WhatsApp relié.

Engage des dépenses : chaque message modèle ouvre une conversation facturée par WhatsApp. Il n'est pas impliqué par `whatsapp_accounts:write`.

Lire les conversations et messages clients sur les numéros reliés.

Répondre en tant qu'opérateur, passer les conversations entre l'agent et un humain, lancer des campagnes, et effacer définitivement la conversation d'un client.

Les campagnes sont facturées par conversation : ce scope autorise donc aussi la dépense, pas seulement la réponse. Il permet aussi d'effacer définitivement la conversation d'un client sur un numéro : ses messages, les transcriptions et l'audio de ses appels, et ce que l'agent retient de lui.

Consulter les comptes opérateur reliés.

Relier une clé API opérateur et provisionner automatiquement des trunks SIP.

Provisionne de vrais trunks sur votre compte opérateur : sa portée dépasse donc Aethex.

Consulter la connexion Microsoft Teams reliée.

Connecter et déconnecter un tenant Microsoft Teams, y rattacher ses numéros et passer des appels dessus.

Distinct de `calls:write` car passer un appel Teams agit à l'intérieur de votre tenant Microsoft.

Consulter les intégrations tierces connectées.

Couvre aussi l'exploration des entités et des champs d'un système connecté lors d'un import.

Connecter et gérer les intégrations tierces.

Lister et récupérer les trunks SIP enregistrés sur votre compte.

Créer, intégrer, mettre à jour, supprimer des trunks SIP et définir le trunk sortant par défaut.

POST /sip-trunks/onboard requiert aussi `phone_numbers:write` pour l'enregistrement de numéro en une étape.

Lire les métriques d'utilisation (période courante, quotidienne, mensuelle, résumé) et inspecter les déclencheurs d'utilisation.

Créer et mettre à jour des déclencheurs d'utilisation, redélivrer des déclenchements, faire pivoter le secret de signature des webhooks.

Lister les modèles LLM disponibles et inspecter les métadonnées du catalogue.

GET /models. Requis pour chaque appel au point d'accès du catalogue de modèles.