ConversationOutboundMarketingCasaDevOpsPolarisAdmin

Documentation

Tout ce que vous devez savoir sur le module Admin — Analytiques des appels API et suivi des coûts IA.

Aperçu

Le module Admin fournit une visibilité sur l'utilisation de l'application et les dépenses d'IA. Surveiller les volumes d'appels API, suivre la consommation de tokens et garder les coûts sous contrôle.

Deux tableaux de bord

Analyse — volumes d'appels API et taux d'erreur | Coûts IA — utilisation des tokens et dépenses par modèle et endpoint

Analyse

Surveille les volumes d'appels API et les modèles d'utilisation. Voir quels endpoints sont les plus utilisés et suivre les taux d'erreur au fil du temps.

Statistiques d'aujourd'hui

  • Appels totaux — demandes API totales pour le jour actuel
  • Erreurs — nombre de réponses HTTP 4xx/5xx
  • Plus utilisé — le type d'endpoint avec le nombre d'appels le plus élevé

Types d'API suivis

threads.*Lister les threads, obtenir les messages, envoyer les messages
batch.*Obtenir le batch, traiter le batch (approuver/rejeter)
unipile.*Comptes, connexion, opérations de synchronisation
email.*Gestion de compte, synchronisation et envoi
webhook.*Événements de webhook entrant

Vues d'historique

  • Par jour — 30 derniers jours en graphique en barres + tableau
  • Par semaine — Format de semaine ISO (W# et année)
  • Par mois — mois du calendrier
Coûts IA

Suit l'utilisation du modèle IA, la consommation de tokens et les coûts associés. Identifier quelles fonctionnalités et modèles consomment le plus de budget.

Cartes de résumé

  • Coût aujourd'hui — USD total dépensé sur les modèles IA aujourd'hui
  • Tokens aujourd'hui — tokens d'entrée + sortie combinés consommés
  • Coût ce mois — dépenses totales du mois en cours

Répartitions

  • Coût par modèle — quel modèle Claude consomme le plus (Haiku 4.5, Sonnet 4.6)
  • Coût par endpoint — quelle fonction utilise le plus de tokens

Endpoints IA suivis

ai.generateGénérer réponse — brouillons de messages alimentés par l'IA
ai.reformulateReformuler — réécrire les messages dans un ton différent
batch.generateGénération de batch — génération quotidienne de brouillon de suivi
marketing.analysisAnalyse marketing — rapports de performance IA
meeting.extractExtraction de réunion — extraire les éléments d'action des réunions
Filtrage

Analyse et Coûts IA partagent le même système de filtrage pour une exploration cohérente des données.

Présets de dateAujourd'hui, 7j, 30j, 90j, 12m ou Toujours
Plage personnaliséeChoisir n'importe quelle date de début et de fin
Filtre utilisateurFiltrer par membre d'équipe individuel

Tous les graphiques et tableaux remplissent les zéros pour les jours sans données, donc vous voyez toujours une chronologie complète sans lacunes.

Comment les coûts sont calculés

Chaque appel API IA enregistre l'utilisation des tokens automatiquement. Le coût est calculé en fonction de la tarification par token du modèle.

Formule

coût = (tokens_entrée × taux_entrée) + (tokens_sortie × taux_sortie)

Les coûts sont calculés et stockés au moment de chaque appel API, donc les données historiques reflètent toujours la tarification qui était active quand l'appel a été effectué.

Comment fonctionne la journalisation

Les appels API et l'utilisation d'IA sont enregistrés automatiquement — aucune configuration nécessaire.

  • Chaque appel API enregistre: endpoint, type, méthode, code de statut, durée et utilisateur
  • Chaque appel IA enregistre: modèle, endpoint, tokens entrée/sortie, coût calculé et utilisateur
  • La journalisation est "fire-and-forget" — elle ne bloque jamais ou ralentit l'application
  • La journalisation échouée n'affecte jamais la fonctionnalité de l'application
Permissions

Les pages Admin nécessitent des permissions spécifiques pour accéder. Les administrateurs ont un accès complet par défaut.

app.admin.analytics.apiAccès au tableau de bord Analyse (appels API)
app.admin.analytics.aiAccès au tableau de bord Coûts IA

Les utilisateurs non-admin voient un message "Vous n'avez pas de permission" s'ils essaient d'accéder à une page sans la permission requise.

Flux de travail courants

Surveiller l'utilisation quotidienne

Ouvrir Analyse pour vérifier le volume d'appels API d'aujourd'hui et le nombre d'erreurs. Basculer vers Coûts IA pour examiner les dépenses d'aujourd'hui et la consommation de tokens.

Enquêter sur les pics de coûts

Définir la plage de dates sur la période d'intérêt. Vérifier "Coût par endpoint" pour identifier quelle fonction a conduit le pic. Utiliser le filtre Utilisateur pour réduire à un membre d'équipe spécifique si nécessaire.

Examen du coût mensuel

Ouvrir Coûts IA → vérifier la carte "Coût ce mois" pour un total rapide. Basculer vers l'onglet "Par mois" sous Coût au fil du temps pour comparer avec les mois précédents et repérer les tendances.