Le manuel complet
Un guide en langage clair pour installer KatoCall sur un serveur et le mettre à facturer de vrais appels. Suivez les parties dans l'ordre — aucune expérience en télécoms requise.
Commencez ici
KatoCall est un standard téléphonique avec un moteur de facturation intégré. Vos clients passent des appels à travers lui ; il vérifie leur solde, choisit la route de sortie la moins chère, chronomètre l'appel et le facture — automatiquement.
Vous achetez des minutes à un opérateur à un prix et les revendez aux clients plus cher. KatoCall enregistre les deux et conserve la différence sur chaque appel.
Bon à savoir : KatoCall ne convertit pas les devises. Choisissez une devise dans Réglages (le dollar américain par défaut) et utilisez-la pour l'achat et la vente, afin que chaque marge soit une simple soustraction.
Partie 1
Cela se fait une seule fois, sur un serveur tout neuf. Si un technicien prépare le serveur pour vous, donnez-lui cette partie.
| Un serveur | Debian 12 (Bookworm), 64 bits — fraîchement installé. N'importe quel bon VPS convient (OVH, Hetzner, DigitalOcean, Vultr). |
|---|---|
| Taille | 2 cœurs CPU, 4 Go de RAM, 20 Go de disque. 2 Go de RAM est le minimum. |
| Une IP publique | Le serveur a besoin de sa propre adresse sur internet — votre hébergeur vous la fournit. |
| Accès au serveur | Le mot de passe root, ou un utilisateur avec sudo. |
| De votre opérateur | Un faisceau SIP (son hôte, et une IP autorisée ou un identifiant/mot de passe), plus les numéros (DID) éventuels. |
| Un nom de domaine (optionnel) | Seulement si vous voulez le cadenas https. Vous pouvez commencer sans et l'ajouter plus tard. |
Copiez katocall-1.0.0.tar.gz sur le serveur et lancez ces commandes une par une. Chacune affiche ce qu'elle fait et s'arrête avec un message clair s'il manque quelque chose.
La première commande ne change rien — elle confirme que le serveur est prêt et signale ce qui manque.
# unpack the package tar -xzf katocall-1.0.0.tar.gz cd katocall-1.0.0 # vérifie le serveur (sans risque — ne change rien) sudo bash install/00-preflight.sh
Lancez-les un par un. Le numéro 01 compile le moteur téléphonique et prend 10–20 minutes ; les autres sont rapides.
sudo bash install/01-install-asterisk.sh # le moteur téléphonique (10–20 min) sudo bash install/02-install-base-stack.sh sudo bash install/03-setup-admin-panel.sh sudo bash install/04-configure-ami.sh sudo bash install/05-production-hardening.sh sudo bash install/06-configure-did-forwarding.sh sudo bash install/07-configure-fail2ban.sh sudo bash install/08-configure-nat.sh sudo bash install/09-configure-outbound.sh sudo bash install/11-configure-backups.sh sudo bash install/12-configure-dialer.sh # seulement si vous voulez le composeur
Du 01 au 09 sont obligatoires. L'étape 12 ne sert qu'au composeur — sautez-la et tout le reste fonctionne quand même.
Elle lance environ 65 vérifications — chaque service, le pare-feu, les sauvegardes, la sécurité — et indique quoi corriger pour ce qui échoue.
sudo bash install/verify.sh PASS 66 WARN 1 FAIL 0
Ouvrez l'adresse du serveur dans un navigateur et connectez-vous. Elle impose un nouveau mot de passe immédiatement — rien ne fonctionne tant que vous ne l'avez pas défini.
KatoCall
http://your-server-address/adminKatocallAvant les vrais appels : activez HTTPS. Tant que ce n'est pas fait, le panneau tourne en http non chiffré et votre connexion voyage sur internet sans protection. Une fois qu'un domaine pointe vers le serveur, lancez :
sudo bash install/10-configure-tls.sh panel.yourcompany.com you@yourcompany.com
Partie 2
Vous êtes maintenant dans le panneau. Créez ces six choses dans cet ordre — chacune utilise la précédente. Tout se trouve dans le menu de gauche.
Un fournisseur (Supplier) est un opérateur à qui vous achetez des minutes. Commencez ici car tout le reste y renvoie. Ouvrez Suppliers → New Supplier et donnez-lui un nom.
Une grille tarifaire (Rate Card) est une liste de prix, une ligne par destination (un préfixe comme 1 pour les États-Unis ou 44 pour le Royaume-Uni). Créez-en deux types :
Ne tapez pas des centaines de préfixes : ouvrez la grille et cliquez sur Import CSV pour charger le fichier de prix de votre opérateur d'un coup.
Bon à savoir : Les tarifs sont enregistrés à 4 décimales ; un fichier à 5 décimales est arrondi à l'import.
Un faisceau (Trunk) est la connexion en direct vers un fournisseur. Ouvrez Trunks → New Trunk. Deux choses comptent :
Après l'enregistrement, utilisez Test Call pour vérifier qu'il compose avant d'y diriger des clients.
Un nom de faisceau ne peut pas contenir d'espaces — utilisez IDT-GOLD, pas IDT GOLD.
Un groupe de routage dit : pour ce type de numéro, essaie ces faisceaux, dans cet ordre. Deux réglages :
Si le premier faisceau est occupé ou échoue, KatoCall passe au suivant. Utilisez Preview pour saisir un numéro et voir quel faisceau serait utilisé.
Un compte (Account) est un client. Ouvrez Accounts → New Account. Les choix importants :
Bon à savoir : Tout compte qui passe des appels sortants a besoin d'une Rate Card client couvrant les préfixes que vous vendez — sinon ces appels sont refusés (jamais facturés à zéro).
Un DID est un numéro que les gens appellent pour joindre l'un de vos clients. Ouvrez le compte, allez dans DIDs → Add DID, saisissez le numéro et sa destination de renvoi. (Enregistrez d'abord le compte.)
Chaque champ du panneau a un petit ? à côté qui explique son rôle, dans les dix langues. Settings → Network envoie votre configuration au moteur téléphonique après de gros changements.
Partie 3
Le composeur appelle une liste de numéros, diffuse un message enregistré et laisse les gens appuyer sur une touche pour être mis en relation, être rappelés ou se désinscrire. L'étape 12 de l'installation doit être faite au préalable.
Sachez ce que c'est : c'est un composeur de puissance (power dialer), pas prédictif. Pas de détection de répondeur (une messagerie compte comme répondue) et pas de rythme automatique — vous fixez un nombre fixe d'appels simultanés. Il tourne sur un seul serveur à la fois.
Ouvrez Dialer Campaigns → New Campaign. Choisissez le compte facturé, nommez-la, réglez le rythme : Max Concurrent Calls, Max Attempts et le Retry gap.
Téléversez le Prerecorded Message diffusé à la réponse. Puis construisez le IVR Menu — ce que fait chaque touche :
Dans la section Contacts de la campagne, cliquez sur Upload CSV — un simple fichier de numéros de téléphone.
Appuyez sur Start et le composeur démarre en quelques secondes ; Pause l'arrête tout aussi vite. À la fin, Download Results donne un fichier indiquant ce qui est arrivé à chaque numéro.
Partie 4
Quatre commandes couvrent presque tout ce que vous ferez sur le serveur.
sudo bash install/verify.sh # tout est sain ? sudo /usr/local/sbin/katocall-backup # faire une sauvegarde maintenant sudo bash install/upgrade.sh # appliquer une version plus récente sudo bash install/uninstall.sh # le retirer (conserve vos données)
Vos sauvegardes sont sur le même disque qu'elles protègent. Copiez-les ailleurs régulièrement, sinon une panne de disque emporte les données et leur unique sauvegarde ensemble.
Avant de vous fier à un rapport de revenus, vous pouvez prouver que les comptes tombent juste au centime près :
sudo -u softswitch admin/backend/venv/bin/python admin/backend/manage.py verify_ledger
Partie 5
Quel que soit le problème, sudo bash install/verify.sh est la première chose à lancer. Il vérifie ~65 points et indique le script à relancer.