Exploitation de la téléphonie

L'exploitation se partage entre le Navin Manager (état des services, redémarrages, mises à jour, sauvegardes) et Navin Enterprise (appels, enregistrements, routage, quotas). Les opérations ci-dessous sont celles de l'API /v1/telephony du Control Plane ; chaque action sensible est inscrite au journal d'audit existant.

Appels

Besoin	Opération
Appels en cours du tenant et leurs canaux	GET /v1/telephony/active-calls
Raccrocher un appel	POST /v1/telephony/active-calls/{linkedid}/hangup (ARI, ou LiveKit pour la branche IA)
Transférer un appel vers une extension ou un numéro E.164	POST /v1/telephony/active-calls/{linkedid}/transfer
Historique, filtres, pagination	GET /v1/telephony/calls
Un appel avec ses branches, événements et enregistrements	GET /v1/telephony/calls/{id}
Statistiques en direct pour les tableaux de bord	GET /v1/telephony/stats

Les CDR et CEL arrivent par AMI (cdr_manager, cel_manager). L'état de la connexion aux événements AMI de chaque nœud est lu par l'administrateur de la plateforme (GET /v1/telephony/event-streams).

Enregistrements, messagerie et conférences

• Enregistrements. MixMonitor écrit sur le nœud Asterisk ; Navin Enterprise récupère le fichier par ARI, le chiffre, le dépose dans SeaweedFS (compartiment navin-telephony) puis le supprime du nœud. L'écoute passe par une URL signée de 300 secondes (POST /v1/telephony/recordings/{id}/download, auditée). Une conservation légale (PUT .../legal-hold) empêche la suppression.
• Messagerie vocale. GET /v1/telephony/voicemail, écoute par URL signée (.../listen), marquage lu (.../read), suppression.
• Conférences. Sessions et participants : GET /v1/telephony/conference-sessions.
• Messages de SVI. Dépôt, lecture et téléchargement : /v1/telephony/ivr-prompts.

La durée de conservation des enregistrements vient des quotas du tenant.

Fraude et blocages

Navin Enterprise lève des alertes de fraude (GET /v1/telephony/fraud-alerts, acquittement audité). Un administrateur bloque tout de suite un tenant ou une extension sur chaque Kamailio du pool (POST /v1/telephony/blocks) et lève le blocage (POST /v1/telephony/blocks/{id}/lift). Kamailio applique en permanence les appels par seconde et les appels simultanés du tenant, l'anti-flood (pike) et le bannissement après échecs d'authentification (ipban), voir Sécurité.

Maintenance d'un nœud

1. Drainer le nœud Asterisk ou LiveKit SIP : POST /v1/telephony/pbx-pools/{id}/drain (administrateur de la plateforme), qui passe la destination en drain sur chaque Kamailio du pool ; elle ne reçoit plus de nouvel appel, les appels en cours continuent.
2. Attendre la fin des appels en cours du nœud (GET /v1/telephony/active-calls).
3. Faire l'opération dans le Manager (mise à jour, redémarrage, déplacement).
4. Rétablir la destination par la même opération de drain.

Après un redémarrage de Kamailio, Navin Enterprise rétablit les tables de routage tout seul (il compare core.uptime) ; POST /v1/telephony/pbx-pools/{id}/reconcile force la réconciliation des tables Kamailio et des objets LiveKit SIP avec la version publiée.

Observabilité

Métriques : res_prometheus d'Asterisk, xhttp_prom de Kamailio, ports Prometheus de LiveKit, LiveKit SIP, Egress et des workers, collectés par le Prometheus du catalogue ; journaux par Alloy ; alertes par Alertmanager. Les indicateurs métier (appels, CPS, qualité, files, consommation) sont calculés par Navin Enterprise à partir des CDR, CEL et événements. Les états de santé de chaque service sont dans la console du Manager.

Qui fait quoi

Tâche	Outil
installer, mettre à jour, redémarrer, déplacer un service	Navin Manager
certificats, pare-feu, ports	Navin Manager
sauvegarde et restauration des services	Navin Manager, voir Sauvegarde et restauration
extensions, trunks, numéros, routage, SVI, files, agents	portail Navin, voir Configuration
appels, enregistrements, fraude, drain, réconciliation	Navin Enterprise (API et portail)