Différences

Ci-dessous, les différences entre deux révisions de la page.

--- infrastructure:3cx [2019/04/24 15:32] – reprise gautier 1 ghusson
+++ infrastructure:3cx [2019/07/23 14:30] (Version actuelle) – ghusson
@@ Ligne 1: / Ligne 1: @@
+====== Prérequis ======
+  * 88Kb/s pour [[https://fr.wikipedia.org/wiki/G.711|G711A]] (=PCMA =A-LAW) pour 1 sens (176kbs pour les 2 sens, soit 880kbs pour 5 lignes parallèles dans les 2 sens)
+  * Si on veut juste accéder à l'interface WEB depuis l'extérieur et utiliser les conférences, le WebMeeting et l'appli téléphone, on doit ouvrir les ports TCP 443 et TCP/UDP 5090 depuis l'extérieur
+  * Si on veut brancher des SBC, on doit ouvrir le port TCP/UDP 5090 depuis l'extérieur
+  * Si on a pas la possibilité ou si on ne veux pas que l'IPBX gère l'audio, on doit ouvrir le port TCP/UDP 5060 et les ports média (UDP 9000 - 10999)
+  * Si on veut que des téléphones soient utilisés à l'extérieur, on doit ouvrir les ports TCP/UDP 80,443 et 5060 ainsi les ports média (UDP 9000 - 10999)
+  * Dans tous les cas si on a des ports TCP ouverts en entrée (voir ci-dessus), on doit pouvoir faire du full-cone avec(voir RFC 4787), c'est à dire que les ports source des paquets sortants ne doivent pas êtres modifiés par le NAT ou le masquerading du firewall
 ====== Installation du serveur 3CX ======
-===== Installation du SBC sur Raspberry Pi (Raspbian) =====
+===== Pare-feu =====
-Depuis Raspbian :
+Pour Mikrotik, voir script : https://www.liberasys.com/wiki/doku.php?id=mikrotikvoip:mikrotik_voip_script
-  wget http://downloads.3cx.com/downloads/sbc/3cxsbc.zip -O- | sudo bash
+^INBOUND - Default ports^^^
+|**HTTPS**| 5001 | TCP |
+|**HTTP**| 5000 | TCP |
+|**SIP**| 5060 | TCP+UDP |
+|**TUNNEL**| 5090 | TCP+UDP |
+|**AUDIO**| range 9000 - 10999 | UDP |
+|**(Remote conf wizard)**| 5015 | TCP only for the duration of the host setup |
-Puis remplir les paramètres demandés.
+Faire le test de firewall depuis l'interface 3CX : dans le dashboard, cliquer sur firewall
-  * **Port SIP par défaut :** 5060
+Plus de détails : https://www.3cx.com/docs/manual/firewall-router-configuration/
-  * **Port tunnel par défaut :** 5090
-  * **Fichiers de configuration :** /etc/3cxsbc.conf
-  * **Logs :** /var/log/3cxsbc.log
-https://www.3cx.com/docs/3cx-sbc-raspberry-pi
+Remarques :
+  * 3CX envoie les premiers parquets RTP (notemment pour le flux RTP entrant) afin de déclancher la conntrack du firewall. Il n'est donc pas nécessaire de régler le NAT entrant depuis le provider de trunk VoIP.
+  * le trafic RTP sortant de 3CX ne semble pas être pris en charge dans la conntrack de Mikrotik. Les paquest sont peut être forgés et échappent à la conntrack. Cela peut générer des logs importants le cas échéant...
-===== 3CX sur Raspberry PI =====
-Limites : https://www.3cx.com/blog/docs/raspberry-pi-pbx/
+===== DNS local =====
-Doc : https://www.3cx.com/docs/installing-pbx-raspberry-pi/
+  * Mettre une entrée dans le DNS local (nomdedomaine.my3cx.fr) dans le cas de l'utilisation d'un DNS local, Unbound par exemple.
+  * **URL :** https://nomdedomaine.my3cx.fr:5001 ou https://xxx.xxx.xxx.xxx:5001  (ou port 443 si configuré lors de l'installation)
+===== Installation de 3CX sur un Raspberry PI =====
+  * Limites : https://www.3cx.com/blog/docs/raspberry-pi-pbx/
+  * Doc : https://www.3cx.com/docs/installing-pbx-raspberry-pi/
 Désactiver IP v6 :
 <code bash>
+sudo -s
 cat << "EOF" > /etc/sysctl.conf
@@ Ligne 28: / Ligne 49: @@
 net.ipv6.conf.all.disable_ipv6 = 1
 EOF
+reboot
 </code>
-Puis rebooter
+Installer 3CX :
+<code bash>
+wget -O- http://downloads-global.3cx.com/downloads/3cxpbx/public.key | sudo apt-key add -
+echo "deb http://downloads-global.3cx.com/downloads/debian stretch main" | sudo tee /etc/apt/sources.list.d/3cxpbx.list
+sudo apt update
+sudo apt-cache policy 3cxpbx
+sudo apt -t stable install 3cxpbx
+</code>
-===== 3CX sur Debian 9 =====
+Aller sur l'interface de staging et finaliser l'installation : [[http://<device_ip>:5015?v=2|http://<device_ip>:5015?v=2]]
-  wget -O- http://downloads-global.3cx.com/downloads/3cxpbx/public.key | apt-key add -
-  echo "deb http://downloads-global.3cx.com/downloads/debian stretch main" | tee /etc/apt/sources.list.d/3cxpbx.list
-  apt-get update
-  apt-get install 3cxpbx net-tools
-Ou utiliser [[https://downloads-global.3cx.com/downloads/debian9iso/debian-amd64-netinst-3cx.iso|l'image fournie par 3CX]].
+===== Installation de 3CX sur sur une Debian 9 =====
+<code bash>
+wget -O- http://downloads-global.3cx.com/downloads/3cxpbx/public.key | apt-key add -
+echo "deb http://downloads-global.3cx.com/downloads/debian stretch main" | tee /etc/apt/sources.list.d/3cxpbx.list
+apt-get update
+apt-get install 3cxpbx net-tools
+</code>
+Aller sur l'interface de staging et finaliser l'installation : [[http://<device_ip>:5015?v=2|http://<device_ip>:5015?v=2]]
-===== DNS local =====
+===== Installation de 3CX sdepuis l'ISO 3CX =====
+[[https://downloads-global.3cx.com/downloads/debian9iso/debian-amd64-netinst-3cx.iso|l'image fournie par 3CX]].
+Aller sur l'interface de staging et finaliser l'installation : [[http://<device_ip>:5015?v=2|http://<device_ip>:5015?v=2]]
-  * Mettre une entrée dans le DNS local (nomdedomaine.my3cx.fr) dans le cas de l'utilisation d'un DNS local, Unbound par exemple.
-  * **URL :** https://nomdedomaine.my3cx.fr:5001 ou https://xxx.xxx.xxx.xxx:5001
+===== Installation du SBC sur Raspberry Pi (Raspbian) =====
-===== Pare-feu =====
+Doc : https://www.3cx.com/docs/3cx-sbc-raspberry-pi
-Pour Mikrotik, voir script : https://www.liberasys.com/wiki/doku.php?id=mikrotikvoip:mikrotik_voip_script
+Depuis Raspbian :
+  wget http://downloads.3cx.com/downloads/sbc/3cxsbc.zip -O- | sudo bash
-^INBOUND - Default ports^^^
+Puis remplir les paramètres demandés.
-|**HTTPS**| 5001 | TCP |
+  * **Port SIP par défaut :** 5060
-|**HTTP**| 5000 | TCP |
+  * **Port tunnel par défaut :** 5090
-|**SIP**| 5060 | TCP+UDP |
+  * **Fichiers de configuration :** /etc/3cxsbc.conf
-|**TUNNEL**| 5090 | TCP+UDP |
+  * **Logs :** /var/log/3cxsbc.log
-|**AUDIO**| range 9000 - 10999 | UDP |
-|**(Remote conf wizard)**| 5015 | TCP only for the duration of the host setup |
-^OUTBOUND - Minimum^^^
-|**3CX WebMeeting**| webmeeting.3cx.net:443 |
-Faire le test de firewall depuis l'interface 3CX : dans le dashboard, cliquer sur firewall
-Plus de détails : https://www.3cx.com/docs/manual/firewall-router-configuration/
-Pour le "full cone", mettre le routeur en mode bridge (apparemment une freebox fait du full cone avec une IP DMZ mais a un ALG SIP !) , et avec un firewall mikrotik derrière :
-  /ip firewall nat
-  add action=src-nat chain=srcnat out-interface=<bridge internet> src-address=<ip locale 3CX> to-addresses=<IP publique>
-  add action=dst-nat chain=dstnat dst-address=<IP publique> in-interface=<bridge internet> to-  addresses=<ip locale 3CX>
-Attention, ces deux règles de NAT doivent être tout en haut de la table NAT !
-Il suffit ensuite d'ajouter les règles de forward classique. Par défaut tout trafic entrant sera redirigé vers le serveur 3CX.
+Le premier utilisateur est créé automatiquement. Il correspond au standardiste et a le numéro 000. C'est lui qui sera contactéquand on tape "*" dans l'IVR du répondeur.
 ====== Configuration du serveur 3CX ======
 ===== Reconfiguration du serveur 3CX =====
 S'il y a besoin de repartir à zéro :
   sudo /usr/sbin/3CXWizard --cleanup
+Et retourner sur l'interface de staging : [[http://<device_ip>:5015?v=2|http://<device_ip>:5015?v=2]]
@@ Ligne 98: / Ligne 117: @@
 ===== Sécurité : Limiter l'accès d'administration =====
-WebManager -> Sécurité -> Paramètres de sécurité
+WebManager -> Sécurité -> Paramètres de sécurité\\
-Onglet "Restriction de la console"
+Onglet "Restriction de la console"\\
-Cocher : Permettre l'accès depuis des adresses IP spécifiques
+Cocher : Permettre l'accès depuis des adresses IP publiques spécifiques\\
-Cliquer sur ajouter et renseigner les IPs publiques supplémentaires si besoin.
+Cliquer sur ajouter et renseigner les IPs publiques supplémentaires si besoin.\\
-Valider en cliquant sur OK tout en haut
+Valider en cliquant sur OK tout en haut\\
-===== Codecs =====
-WebManager -> Paramètres -> General
-Ordonner les codecs pour les deux sections (Codec prioritaire pour les appels locaux/internes ET Codec prioritaire pour les appels externes) :
-PCMA
-PCMU
-G722
-G729
-GSM
-OPUS
+===== Sécurité : liste blanche =====
+-> WebManager -> Sécurité -> Blacklist d'IP\\
+Ajouter les entrées en liste blanche (Action = Autoriser) pour les IP publiques spécifiques
-===== Numéros d'urgences =====
-Site officiel : https://www.gouvernement.fr/risques/connaitre-les-numeros-d-urgence
-Ces numéros peuvent être appelés à tout moment même en dehors des heures de restriction. Et libèrent un canal VoIP si besoin. \\
--> WebManager -> Paramètres -> General -> Numéros d'urgence -> Ajouter
-: SAMU
+===== Codecs / status =====
-: Police Secours
+-> WebManager -> Paramètres -> Général\\
-: Sapeurs-Pompiers
+Ordonner les codecs pour les deux sections (Codec prioritaire pour les appels locaux/internes ET Codec prioritaire pour les appels externes) :\\
-: Numéro d'appel d'urgence européen
+  * PCMA
---
+  * PCMU
-: Numéro d'Urgence pour les personnes Muettes, Sourdes ou Malentendantes (SMS Fax)
+  * G722
-: Samu Social - Secours aux sans abris
+  * G729
-: Enfants disparus
+  * GSM
-: Allo enfance maltraitée
+  * OPUS
-: Secours en Mer (VHF canal 16)
-: Vigilance citoyenne SNCF/RATP (SMS : 31177)
-: SOS Médecin
-: Stop violences Femmes
-: Allo Service Public - service de renseignement administratif interministériel
-080030030 : Ecoute violences conjugales
-0140054848 : Centre anti-poison Paris
-0800005696 : Stop Djihadisme (Prévenir la radicalisation. signaler, Alerter, Protéger les jeunes et leur famille.)
-0811020217 : Allô Escroquerie
-0800200000 : Allô Ecoute Internet (harcèlement scolaire et tous problèmes d'insultes, vols de pseudo et harcèlements sur Internet)
-0969392919 : Agri Ecoute (écoute de dialogue pour les cas de détresse dans la profession d'agriculteur)
-0800858858 : Croix Rouge
-0140503434 : SOS suicide
-0140479595 : SOS Dépression
-0892683208 : SOS Chéque volé ou perdu - CNACPV
-0892690880 : SOS Carte Bleue/Visa/Eurocard/Mastercard volée ou perdue - Groupement des Cartes Bancaires
 ===== Trunks SIP =====
-https://www.3cx.fr/docs/manuel/trunks-sip/
+Doc : https://www.3cx.fr/docs/manuel/trunks-sip/\\
 -> WebManager -> Trunks SIP -> Ajouter Trunk SIP
-Pour un trunk OpenIP, voir : http://wiki.mycloud3cx.fr/V16/doku.php?id=configuration_sip_trunk_touch_3cx_v16#sip_trunk_touch_en_config_3cx_v16_sur_site
+==== OpenIP ====
-Sur un trunk OpenIP, on a NDI, NDS et SDA.
+Pour un trunk OpenIP, voir : http://wiki.mycloud3cx.fr/V16/doku.php?id=configuration_sip_trunk_touch_3cx_v16#sip_trunk_touch_en_config_3cx_v16_sur_site\\
+Numéro principal = NDS (sous forme nationale)\\
+Sur un trunk OpenIP, on a NDI, NDS et SDA.\\
   * NDI = Numéro de Désignation de l'Installation : tête de ligne, on ne doit pas la voir apparaître dans les communications à l'extérieur
   * NDS = Numéro de Désignation Secondaire : le numéro que l'on a choisi de présenter
   * SDA = (=DDI=DID) Sélection Directe à l'Arrivée : numéro d'un poste interne en particulier
+Remarque : les numéros doivent être définis sous la forme nationale "0987654321" ou "*987654321", pas "0033987654321".
-Remarque : les SDAs doivent être définis sous la forme "0987654321" ou "*987654321", pas "0033987654321".
+==== OVH ====
+https://docs.ovh.com/fr/voip/configuration_basique_dun_sip_trunk_ovh_sur_3cx_phone_system/\\
+Remarque : les numéros doivent être définis sous la forme INTERnationale : "0033987654321".\\
+Rien de particulier, le trunk monte au bout de quelques minutes\\
 ==== Onglet ID d'appelant ====
+Numéro d'appelant par défaut : utiliser le numéro NDS sous forme nationale (ex : 0123456789)\\
-Numéro d'appelant par défaut : utiliser le numéro NDS sous forme internationale (ex : +33 123456789)
+=> Par défaut ne rien ajouter d'autre et faire confiance au provider SIP\\
 Entrant uniquement et Sortant uniquement : voir https://www.3cx.com/docs/cid-reformatting/
-Si on veut sortir avec un numéro international alors que l'extension a un numéro dédié (WebManager → Extensions → Jean Dupont → Général → Informations utilisateur : Numéro présenté) :
+Si on veut que les rappels se fassent sur un numéro national au lieu de international :
-Entrant uniquement : Ajouter
+  * Entrant uniquement :
-Masque source : +33(.*)
+    * Ajouter :
-Masque remplacement : 0\1
+      * Masque source : +33(.*)
+      * Masque remplacement : 0\1
-Sortant uniquement :
+    * AJouter :
-Masque source : (.)(.........)  - numéro à 10 chiffres
+      * Masque source : 0033(.*)
-Masque remplacement : +33\2  - version internationnale
+      * Masque remplacement : 0\1
 Autres exemples :
   * Afficher pays de provenance :
-    * **Masque source :** +(33)(.*)
+    * Masque source : +(33)(.*)
-    * **Masque remplacement :** France : 0\2
+    * Masque remplacement : France : 0\2
+  * Remplacer numéro par nom :
+    * Masque source : 0980660056
+    * Masque remplacement : Liberasys
+Si on veut sortir avec un numéro international alors que l'extension a un numéro dédié en version nationale (→ WebManager → Extensions → Jean Dupont → Général → Informations utilisateur : Numéro présenté) :\\
+  * Sortant uniquement :
+  * Masque source : (.)(.........)  - numéro à 10 chiffres
+  * Masque remplacement : +33\2  - version internationnale
-  * Remplacer numéro par nom :
-    * **Masque source :** 0980660056
-    * **Masque remplacement :** Liberasys
 **Notes :**
@@ Ligne 199: / Ligne 206: @@
 Doc : https://www.3cx.fr/docs/manuel/regles-entrantes/
-WebManager -> Règles entrantes
+-> WebManager -> Règles entrantes
 Il y a une règle entrante par trunk SIP.\\
@@ Ligne 218: / Ligne 225: @@
-====== Règles sortantes ======
+===== Règles sortantes =====
 -> WebManager -> Règles sortantes -> Ajouter
   * **Nom de la règle :** Appels vers l'extérieur
   * **Appels des extensions :** 000-100
-Faire les appels sortants sur : choisir le TRUNK
+  * **Faire les appels sortants sur** : choisir le TRUNK
-Cette règle s'appliquera aux extensions 000 à 100.
+=> Cette règle s'appliquera aux extensions 000 à 100.
 Si l'on dispose de plusieurs routes et que l'on souhaite y attribuer des numéros spécifiques, il est possible de préfixer les numéros composés qui seront redirigés vers les routes en fonction du préfixe choisi.
@@ Ligne 235: / Ligne 242: @@
 Les routes non utilisées doivent être en "BLOCK CALLS".
-https://www.3cx.fr/docs/manuel/trunks-sip/
+===== Numéros d'urgences =====
+Ces numéros peuvent être appelés à tout moment même en dehors des heures de restriction. Et libèrent un canal VoIP si besoin. \\
+-> WebManager -> Paramètres -> General -> Numéros d'urgence -> Ajouter
+  * 15 : SAMU
+  * 17 : Police Secours
+  * 18 : Sapeurs-Pompiers
+  * 112 : Numéro d'appel d'urgence européen
+  * --
+  * 114 : Numéro d'Urgence pour les personnes Muettes, Sourdes ou Malentendantes (SMS Fax)
+  * 115 : Samu Social - Secours aux sans abris
+  * 116 : Enfants disparus
+  * 119 : Allo enfance maltraitée
+  * 196 : Secours en Mer (VHF canal 16)
+  * 3117 : Vigilance citoyenne SNCF/RATP (SMS : 31177)
+  * 3624 : SOS Médecin
+  * 3919 : Stop violences Femmes
+  * 3939 : Allo Service Public - service de renseignement administratif interministériel
+  * 080030030 : Ecoute violences conjugales
+  * 0140054848 : Centre anti-poison Paris
+  * 0800005696 : Stop Djihadisme (Prévenir la radicalisation. signaler, Alerter, Protéger les jeunes et leur famille.)
+  * 0811020217 : Allô Escroquerie
+  * 0800200000 : Allô Ecoute Internet (harcèlement scolaire et tous problèmes d'insultes, vols de pseudo et harcèlements sur Internet)
+  * 0969392919 : Agri Ecoute (écoute de dialogue pour les cas de détresse dans la profession d'agriculteur)
+  * 0800858858 : Croix Rouge
+  * 0140503434 : SOS suicide
+  * 0140479595 : SOS Dépression
+  * 0892683208 : SOS Chéque volé ou perdu - CNACPV
+  * 0892690880 : SOS Carte Bleue/Visa/Eurocard/Mastercard volée ou perdue - Groupement des Cartes Bancaires
+Site officiel : https://www.gouvernement.fr/risques/connaitre-les-numeros-d-urgence
+===== Paramètres réseau =====
+-> WebManager -> Paramètres -> Réseau\\
+Onglet FQDN : DNS SRV Autoriser les appels de/vers des URIs SIP externes => https://www.3cx.com/docs/direct-sip/\\
+Onglet Pare-feu : activer le keepalive toutes les 14 secondes
+===== Paramètres notifications email =====
+-> WebManager -> Paramètres -> Email\\
+Onglet Notification (Permet de configurer les évènements qui seront notifiés à l'administrateur.)
+Adapter :
+  * Adresse email pour les notifications
+  * Evènements (ne pas cocher "Le statut d'enregistrement d'une extension a changé", c'est verbeux en cas de reboot !)
+-> WebManager -> Paramètres -> E-mails -> Templates e-mail\\
+Permet d'éditer les modèles de mails.
+===== Paramètres mise à jour =====
+-> WebManager -> Paramètres -> Mises à jour\\
+activer MAJ auto ?
+===== Paramètres Conférence =====
+-> WebManager -> Paramètres -> Conférence\\
+onglet Audio : Numéros externes de conférence : mettre le champ qui sera rempli lors de l'envoi d'un email d'invitation
+===== SDA direct avec le système de conférence =====
+-> WebManager -> Règles entrantes -> Ajouter une règle SDA \\
+  * Nom : Direct vers conférence
+  * SDA/DID : Sélectionner le SDA
+  * Router les appels vers
+    * Extension
+    * 700
+Les appelants seront invité à saisir l'identifiant de conférence qu'ils ont reçu par mail afin de se connecter à la conférence.
+===== Paramètres Heures de bureau et jours fériés =====
+-> WebManager -> Paramètres -> Heures de bureau et jours fériés\\
+configurer si besoin\\
+Format WAV (PCM, 8 kHz, 16 bit, Mono, Max size: 100MB)\\
+===== Paramètres Musique d'attente =====
+changer si besoin
+===== Paramètres de messagerie vocale =====
+-> WebManager -> Paramètres -> Paramètres de messagerie vocale\\
+quota, vidange, email de notification
+===== Paramètres CDR =====
+-> WebManager -> Paramètres -> CDR\\
+Actver la génération des CDRs
 ====== Extensions / téléphonnes ======
+===== Ajouter une Extension =====
 https://www.3cx.fr/docs/manuel/administration-extensions-ipbx/
@@ Ligne 244: / Ligne 343: @@
 -> WebManager -> Extensions -> Ajouter
-**Informations utilisateur**
+Informations utilisateur :
+  * Extension : numéro interne, incrément automatiquement
+  * Prénom
+  * Nom
+  * adresse mail
+  * numéro mobile
+  * numéro présenté (si différent de celui par défaut)
+Relever :
+  * ID
+  * Mot de passe
+Sélection Directe à l'Arrivée (SDA / DID) :
+  * mettre le numéro du SDA si nécessaire (également adapter le numéro présenté le cas échéant)
-| **Extension** | 000 |
+Onglet Messagerie vocale :
-| **Prénom** | Jean |
+  * Lire date/heure : Lire au format 24 heures
-| **Nom** | Dupont |
+  * Options email : Envoyer le message en pièce jointe
-| **Adresse mail** | j.dupont@nomdedomaine.com |
-| **Numéro mobile** | 0612345678 |
-**Identification**
+Onglet Téléconfiguration téléphonne :
+  * Codecs :
+    * G.711 A-law
+    * G.711 U-law
+    * G722
+    * G729
+    * GSM-FR
-| **ID** | <random> |
+Onglet Options :
-| **Mot de passe** | <random> |
+  * Si téléphone externe (via SBBC ou STUN) : décocher "Désactiver l'usage de l'extension hors LAN (Les extensions distantes utilisant Direct SIP ou STUN seront bloquées)"
+  * dans Options, cocher " Envoyer une notification email sur appel manqué"
-===== Installer téléphones =====
+Onglet Droits :
+  * Régler ici le groupe si nécessaire (droits de groupe, à régler dans -> WebManager -> Groupes)
+  * Si besoins spécifiques, changer les paramètres ici (transfert, diversion, parquage d'appels, droi d'admin spécifique)
+A noter : le groupe par défaut ne peut pas éditer l'annuaire d'entreprise
-  - Plugger les téléphones dans le même réseau (ou celui d'un SBC configuré), 3CX leur attribue une IP locale suite à un message multicast envoyé sur le réseau local (et via le SBC s'il y a lieu),
-  - Webmanager -> Téléphones -> Sélectionner le téléphone -> Assigner extension OU Ajouter extension
+===== Installer un téléphone =====
+  * Faire un reset config du téléphone\\
+  * Plugger les téléphones dans le même réseau (ou celui d'un SBC configuré), le serveur DHCP leur attribue une IP locale. 3CX peut les autoconfigurer (auto-prvisionning) suite à un message multicast envoyé sur le réseau local (et via le SBC s'il y a lieu),\\
+  * -> Webmanager -> Téléphones -> Sélectionner le téléphone -> Assigner extension OU Ajouter extension\\
+  * On se retrouve dans la configuration de l'auto-prvisionning du modèle de téléphone.\\
+  * Dans Téléphone, Méthode de provisioning : choisir la bonne méthode (LAN, SBC, STUN)
+  * Dans Options, changer :
+    * Langue d'affichage : Français
+    * Format de la date : YYYY-MM-DD
+    * Relever le mot de passe WEB du téléphone
+    * Codecs :
+      * PCMA
+      * PCMU
+      * G722
+      * G729
+Après validation, le téléphone redémarre est est auto-provisionné.
+Si ce téléphone est lié à un SDA, le renseigner dans ses paramètres d'extension ("Assignez optionnellement un SDA afin de recevoir des appels directement sur l'extension").
+Remarque : après avoir ajouté le éléphone du strandard, ne pas oublier de reparamétrer l'extension par défaut sur appel entrant dans le trunk !
+===== Touches de fonction : BLF =====
+-> WebManager -> Extensions -> cliquer sur l'extension voulue\\
+Onglet "BLF"\\
-====== Files d'attentes ======
+doc : https://www.3cx.fr/voip-sip/touches-fonction-blf/
+Remarques :
+  * Pour afficher des BLF sur le module d'extension du téléphone Yealink T29G, commencer au BLF 28 (ou 29 si l'on souhaite garder la possibilité de changement de liste).
+  * Les BLF ne peuvent être prises en compte lorsque l'utilisateur n'as pas de téléphone propre à lui. Par exemple, si un utilisateur n'est que "hotdesker", ses BLF ne pourront pas être mises à jour.
+  * Pour une configuration plus fine des appellations des touches de raccourcis (mauvaise traduction par défaut : "Disponible" -> "Pr: Available"), configurer un "raccourci personnalisé". Exemple pour statut "Disponible" : ** *30** Prénom: "**Statut**" Nom:"**Disponible**".
+==== Touche de ligne ====
+Il est possible de configurer une "touche de ligne".\\
+C'est un raccourci pour mettre en attente l'interlocuteur actuel et ainsi de pouvoir en appeler un autre avant de reprendre celui qui a été mis en attente.\\
+Facilite la gestion des mises en attente lorsqu'elles sont supérieures à 1.
+-> Touche -> Module d'extension\\
+On peut éditer manuellement les appellations des touches de raccourcis ("Pr: Available" -> "Disponible")
+===== Téléphone distant ( STUN ) =====
+Décocher "Désactiver l'usage de l'extension hors LAN (Les extensions distantes utilisant Direct SIP ou STUN seront bloquées)" dans l'extension, onglet "Options".
+===== Interface de configuration du téléphone (interne au téléphone =====
+On peut y accéder en allant dans : -> WebManager -> Téléphones, en sélectionnant un téléphone et en cliquant sur "UI téléphone".\\
+Le login est automatique (passé dans le lien). Sinon le login est "admin" et le mot de passe est disponnible sur l'interface 3CX : -> WebManager -> Téléphones, cliquer sur "Mot de passe" puis sur l'icone copier de l'entrée correspondant au téléphone.
+====== Fonctionnalités de strandard téléphonique ======
+===== Files d'attentes =====
 Les files d'attentes permettent de mettre en attente des appelants et de configurer une stratégie de scrutation pour attribuer les appels entrant à des agents.
@@ Ligne 288: / Ligne 454: @@
 https://www.3cx.com/docs/manual/call-center-queues/
-====== Groupes d'appels ======
--> WebManager -> Groupes d'appels
+===== Groupes d'appels =====
-Les appels vers un groupe d'appels fera sonner toutes les extensions jusqu'à ce qu'un des membres du groupe réponde ou qu'un timeout soit atteint.
+-> WebManager -> Groupes d'appels\\
+Les appels vers un groupe d'appels fera sonner toutes les extensions jusqu'à ce qu'un des membres du groupe réponde ou qu'un timeout soit atteint.\\
 https://www.3cx.fr/docs/manuel/groupes-appels-annonce-interphonie/
-====== Parking d'appels ======
+===== Mode "réceptionniste" =====
+Si l'on souhaite faire en sorte qu'un utilisateur puisse être réceptionniste de façon ponctuelle, et ce depuis le téléphone :
+==== Méthode 1 (préférée) : Files d'attentes ====
+  - Créer une file d'attente vers laquelle seront dirigés les appels entrants et y assigner les agents susceptibles de s'en occuper,
+  - Configurer les touches de raccourcis sur le téléphone des agents pour qu'ils puissent se connecter et déconnecter de la file d'attente et ainsi prendre les appels en attente.
+**Note :** Il est également possible de faire la même chose depuis le client web en utilisant le bouton "Q" puis se rendre dans le switchboard.
+==== Méthode 2 : Groupe d'appels ====
+  - Créer un groupe d'appels "réceptionnistes" et y ajouter les utilisateurs désirés,
+  - Renommer le statut personnalisé "Lunch" en "Réceptionnistes" (-> Paramètres -> Paramètres -> "CUSTOM1NAME"),
+  - Se rendre dans la configuration des membres et décocher "Accepter les appels de groupes d'appel" pour tous les statuts SAUF "réceptionnistes",
+  - Changer les BLF de chaque membre du groupe d'appels "réceptionnistes" pour en créer deux : "disponible" et "réceptionniste" pour permettre le changement depuis le téléphone.
+A noter qu'il est possible d'éditer ces statuts personnalisés depuis le webclient -> Paramètres -> Transfert d'appels\\
+ainsi que dans -> WebManager -> Paramètres -> PBX -> Renommer les statuts Déjeuner et Voyage d'affaires.
+Les membres faisant partie du groupe d'appels "réceptionnistes" ne recevront les appels destinés à ce groupe uniquement dans le cas où leur statut est "réceptionniste".
+Ne pas oublier de configurer la destination de non-réponse du groupe "réceptionnistes" pour ne pas que l'appelant se retrouve éjecté si aucun membre ne répond.
+**Inconvénient** : les membres du groupe d'appels "réceptionnistes" ne peuvent faire partie que de ce groupe, auquel cas ils en recevront quand même les appels dès lors qu'ils cocheront la case d'acceptation des appels de groupe dans un éventuel autre groupe.
+===== Parking d'appels =====
+Doc : https://www.3cx.com/blog/docs/call-parking/
 Les parkings d'appels permettent de "parquer" les appels.\\
@@ Ligne 308: / Ligne 506: @@
 A noter que lors de l'utilisation d'un BLF de parcage, il n'est pas possible de reprendre un appel parqué autrement que depuis une touche de raccourci de parcage.
-https://www.3cx.com/blog/docs/call-parking/
-====== Répondeurs ======
+===== Répondeurs / IVR =====
 -> WebManager -> Répondeurs
@@ Ligne 331: / Ligne 528: @@
 Ici, si l'appelant appuie sur la touche "0" son appel sera redirigé vers le poste de Jean Dupont, la touche "1" le mettra dans la file d'attente 01 (dont le numéro d'extension est "800"), touche "2" vers le groupe d'appels 01 et la touche "3" répètera le fichier audio choisi pour expliquer les différents choix.
 https://www.3cx.fr/docs/manuel/svi-repondeurs-numeriques/
-====== Rapports d'appels ======
+Call Flow Designer : https://www.3cx.com/docs/manual/cfd-building-projects/
+Le Call Flow Designer (CFD) permet de créer des scripts complèxes utilisés dans un IVR.
-Il est possible de créer des rapports d'appels automatiques pour établir des statistiques utiles :
--> Webmanager -> Rapports d'appels
-====== Call Flow Designer ======
+===== Joindre directement plusieurs extensions avec un seul numéro =====
-https://www.3cx.com/docs/manual/cfd-building-projects/
+Pour joindre directement une extension avec un seul numéro, par exemple une SDA en plus du numéro principal du trunk, il faut se servir d'un IVR -> Web Manager -> Répondeurs -> Ajouter
-Le Call Flow Designer (CFD) permet de créer des scripts complèxes utilisés dans un IVR.
+Chaque touche dois correspondre à une extension, ainsi un appelant pourra composer le numéro de téléphone suivi directement du numéro correspond à l'extension qu'il souhaite joindre.
-====== Hotdesking ======
+Par exemple, pour un numéro 0123456789 :
+  * 0 = Jean Dupont
+  * 1 = Maurice Moulin
+  * 2 = Bob Morane
+L'appelant composant le 01234567891 tombera directement sur Maurice Moulin sous réserve que la règle entrante du numéro 0123456789 redirige sur le répondeur.
+Mettre la règle de redirection en cas de non saisie à 1 permet d'avoir un IVR transparent s'il n'y a pas de désir de joindre quelqu'un directement. Ainsi un appelant ne connaissant pas l'astuce décrite ici se vera redirigé directement sur le choix de l'administrateur, par exemple une file d'attente.
+===== Hotdesking =====
 Un téléphone peut être configuré en mode "hotdesking" si celui-ci n'est utilisé par aucune extension afin que les utilisateurs autorisés à faire du hotdesking puisse s'y connecter.
@@ Ligne 362: / Ligne 568: @@
 https://www.3cx.fr/docs/manuel/hot-desking/
-====== BLF (Busy Lamp Field) ======
-Les BLF ne peuvent être prises en compte lorsque l'utilisateur n'as pas de téléphone propre à lui. Par exemple, si un utilisateur n'est que "hotdesker", ses BLF ne pourront pas être mises à jour.
+===== WebMeetings et conférences =====
-**Note :** Pour une configuration plus fine des appellations des touches de raccourcis (mauvaise traduction par défaut : "Disponible" -> "Pr: Available"), configurer un "raccourci personnalisé". Exemple pour statut "Disponible" : ** *30** Prénom: "**Statut**" Nom:"**Disponible**"
-https://www.3cx.fr/voip-sip/touches-fonction-blf/
-===== Touche de ligne =====
-Il est possible de configurer une "touche de ligne".\\
-C'est un raccourci pour mettre en attente l'interlocuteur actuel et ainsi de pouvoir en appeler un autre avant de reprendre celui qui a été mis en attente.\\
-Facilite la gestion des mises en attente lorsqu'elles sont supérieures à 1.
-===== Yealink T29G =====
-Configuration avancée du T29G -> Serveur web du téléphone (192.168.205.115) "admin:<mot_de_passe_téléphone>"\\
-Les changements effectués ici sont appliqués instantanément au téléphone.\\
-Les modifications apportées de cette façon ne sont pas liées au compte. Si le compte est supprimé du téléphone et est raccordé ultérieurement les modifications seront supprimées.
-==== Changer touches de raccourcis du module d'extension du téléphone ====
--> Touche -> Module d'extension
-On peut éditer manuellement les appellations des touches de raccourcis ("Pr: Available" -> "Disponible")
-====== WebMeetings et conférences ======
 La différence entre un WebMeeting est une conférence (audio et vidéo) est assez floue.\\
@@ Ligne 396: / Ligne 578: @@
 **Les WebMeetings seraient donc juste un [[https://www.3cx.fr/manuel-utilisation/planifier-conference/#h.ici99bpvlfgs|moyen rapide]] d'organiser une réunion.**
-===== WebMeeting =====
-https://www.3cx.fr/manuel-utilisation/webmeeting/
--> WebClient -> WebMeeting
+==== Conférence ====
-On peut envoyer le lien du webmeeting à des invités, mais les invités peuvent-ils joindre un webmeeting par téléphone ? **Non.**
-Il est possible de gérer un webmeeting depuis un ordiphone avec l'application "3CX WebMeeting" [[https://play.google.com/store/apps/details?id=org.tcx.webmeeting|Android]] / [[https://itunes.apple.com/cy/app/3cx-webmeeting/id1039756959|iOS]]
-===== Conférence =====
 https://www.3cx.fr/manuel-utilisation/planifier-conference/
@@ Ligne 420: / Ligne 595: @@
   * Ajouter des participants ou importer une liste CSV
-==== Configurer SDA pour rejoindre conférence ====
--> WebManager -> Trunks SIP -> "Nom du trunk" -> SDAs -> Ajouter SDA
+==== WebMeeting ====
-**Renseigner le numéro du SDA selon le format "0987654321", pas "0033987654321".**\\
+https://www.3cx.fr/manuel-utilisation/webmeeting/
-Il est également possible de renseigner le numéro sous le format "*987654321".\\
-Ensuite :\\
--> WebManager -> Règles entrantes -> Ajouter une règle SDA ->
+-> WebClient -> WebMeeting
+On peut envoyer le lien du webmeeting à des invités, mais les invités peuvent-ils joindre un webmeeting par téléphone ? **Non.**
+Il est possible de gérer un webmeeting depuis un ordiphone avec l'application "3CX WebMeeting" [[https://play.google.com/store/apps/details?id=org.tcx.webmeeting|Android]] / [[https://itunes.apple.com/cy/app/3cx-webmeeting/id1039756959|iOS]]
-  * Nom : Direct vers conférence
-  * SDA/DID : Sélectionner le SDA
-  * Router les appels vers
-    * Extension
-    * 700
-Les appelants seront invité à saisir l'identifiant de conférence qu'ils ont reçu par mail afin de se connecter à la conférence.
 ===== Click2Talk et Click2Meet =====
@@ Ligne 449: / Ligne 619: @@
 Utilisez cette URL pour permettre à vos interlocuteurs d'organiser des réunions web instantanément avec vous.
-====== Logs ======
--> WebManager -> Statut système -> Log du serveur (-> Logs)
-  * Afficher appels depuis logs sur serveur : ''tail -f /var/lib/3cxpbx/Instance1/Data/Logs/3CXDialer.log''
-====== Status personnalisés ======
-Il est possible de renommer deux statuts pour les personnaliser et ainsi créer des règles d'appels spécifiques en fonction de ces statuts.
--> WebManager -> Paramètres -> "CUSTOM1NAME" ou "CUSTOM2NAME"
-**A noter que le "CUSTOM1NAME" est un statut "disponible" contrairement de "CUSTOM2NAME" qui est un statut "absent".**
-Se rendre ensuite dans -> WebManager -> Extensions -> Jean Dupont -> Règles de transfert\\
-Changer ici les règles de transfert comme désiré.
-Il est possible de configurer ce statut en BLF -> WebManager -> Extensions -> Jean Dupont -> BLF -> "Changer de statut"
-Ne pas oublier de cocher ou décocher la prise en compte des appels de groupes d'appel.
-====== Contacts ======
+===== Contacts =====
 CX dispose de deux annuaires : Un "global" et un "personnel".\\
-===== Annuaire global =====
+==== Annuaire global ====
 -> WebManager -> Avancés -> Contacts
@@ Ligne 488: / Ligne 639: @@
 Les contacts de l'annuaire sont accessibles depuis toutes les extensions utilisateurs depuis le WebClient ou depuis le téléphone.
-===== Annuaire personnel =====
+==== Annuaire personnel ====
 Les utilisateurs peuvent renseigner des contacts personnels dans leur WebClient et ne seront disponibles que pour cet utilisateur.\\
 Il est également possible de configurer des contacts personnels directement dans le téléphone, mais ceux-ci ne sont pas synchronisés avec le WebClient et ne seront donc disponible que sur le téléphone **et y resteront même en provisionnant le téléphone à une autre extension**.
-====== Interphone ======
+===== Interphone =====
 L'interphone permet d'appeler une extension directement sans que celle-ci a besoin de décrocher.
@@ Ligne 501: / Ligne 654: @@
 Pour configurer l'appel via interphone d'une extension en tant que BLF, il faut créer un raccourci personnalisé "*1101" (pour appeler l'extension "01").
-====== Mode "réceptionniste" ======
-Si l'on souhaite faire en sorte qu'un utilisateur puisse être réceptionniste de façon ponctuelle, et ce depuis le téléphone :
-===== Méthode 1 : Groupe d'appels =====
-  - Créer un groupe d'appels "réceptionnistes" et y ajouter les utilisateurs désirés,
-  - Renommer le statut personnalisé "Lunch" en "Réceptionnistes" (-> Paramètres -> Paramètres -> "CUSTOM1NAME"),
-  - Se rendre dans la configuration des membres et décocher "Accepter les appels de groupes d'appel" pour tous les statuts SAUF "réceptionnistes",
-  - Changer les BLF de chaque membre du groupe d'appels "réceptionnistes" pour en créer deux : "disponible" et "réceptionniste" pour permettre le changement depuis le téléphone.
-A noter qu'il est possible d'éditer ces statuts personnalisés depuis le webclient -> Paramètres -> Transfert d'appels\\
-ainsi que dans -> WebManager -> Paramètres -> PBX -> Renommer les statuts Déjeuner et Voyage d'affaires.
-Les membres faisant partie du groupe d'appels "réceptionnistes" ne recevront les appels destinés à ce groupe uniquement dans le cas où leur statut est "réceptionniste".
-Ne pas oublier de configurer la destination de non-réponse du groupe "réceptionnistes" pour ne pas que l'appelant se retrouve éjecté si aucun membre ne répond.
-==== Inconvénient ====
-Les membres du groupe d'appels "réceptionnistes" ne peuvent faire partie que de ce groupe, auquel cas ils en recevront quand même les appels dès lors qu'ils cocheront la case d'acceptation des appels de groupe dans un éventuel autre groupe.
-===== Méthode 2 (préférée) : Files d'attentes =====
-  - Créer une file d'attente vers laquelle seront dirigés les appels entrants et y assigner les agents susceptibles de s'en occuper,
-  - Configurer les touches de raccourcis sur le téléphone des agents pour qu'ils puissent se connecter et déconnecter de la file d'attente et ainsi prendre les appels en attente.
-**Note :** Il est également possible de faire la même chose depuis le client web en utilisant le bouton "Q" puis se rendre dans le switchboard.
-====== Notifications Mails ======
--> WebManager -> Paramètres -> E-mails -> Notifications
-Permet de configurer les évènements qui seront notifiés à l'administrateur.
--> WebManager -> Paramètres -> E-mails -> Templates e-mail
-Permet d'éditer les modèles de mails.
-====== FAX ======
-===== Ajout d'un FAX =====
+===== Ajout d'un FXO/FXS =====
+==== FAX ====
 [[https://www.3cx.com/voip-gateways/grandstream-ht-fxs/|Grandstream HT812]]
@@ Ligne 551: / Ligne 665: @@
   * <password>
-===== Ajout FXS =====
+==== Ajout FXO/FXS ====
 **Il faut que le FXS soit dans le même réseau que le PBX (VPN si PBX distant).**
@@ Ligne 584: / Ligne 698: @@
-====== Import extensions CSV ======
+===== Status personnalisés, règles de transfert et BLF spécifique =====
+WebManager -> Paramètres -> Général\\
+Renommer les statuts Déjeuner et Voyage d'affaires :
+  * Dejeuner
+  * Voyage pro
+Il est possible de renommer deux statuts pour les personnaliser et ainsi créer des règles d'appels spécifiques en fonction de ces statuts.\\
+On retrouve ces status personnalisés dans WebManager -> Paramètres -> Paramètres -> "CUSTOM1NAME" ou "CUSTOM2NAME"\\
+**A noter que le "CUSTOM1NAME" est un statut "disponible" contrairement de "CUSTOM2NAME" qui est un statut "absent".**
+Se rendre ensuite dans -> WebManager -> Extensions -> Jean Dupont -> Règles de transfert\\
+Changer ici les règles de transfert comme désiré.
+Il est possible de configurer ce statut en BLF -> WebManager -> Extensions -> Jean Dupont -> BLF -> "Changer de statut"\\
+Ne pas oublier de cocher ou décocher la prise en compte des appels de groupes d'appel.
+====== Import d'extensions à partir d'un CSV ======
 Le fichier CSV à importer **doit avoir ses cellules formatées en tant que texte**.\\
@@ Ligne 635: / Ligne 766: @@
 </HTML>
-====== Notes ======
+===== Génération de caractères aléatoires pour import CSV =====
+==== Codes PIN ====
-  * L'extension navigateur [[https://www.3cx.fr/manuel-utilisation/click-to-call/|3CX Click to Call]] est disponible pour [[https://addons.mozilla.org/fr/firefox/addon/3cx-clicktocall/|Firefox]] et [[https://addons.mozilla.org/fr/firefox/addon/3cx-clicktocall/|Chromium]].
+Si vous utilisez Libreoffice Calc, sélectionnez les cellules dans lesquelles vous souhaitez générer les codes PIN, puis -> Feuille -> Remplir les cellules -> Nombres aléatoires.\\
-  * Pour se connecter à l'interface du téléphone, utiliser "admin" et "mot de passe téléphone" (trouvable dans les extensions).
+  * Distribution : Entier uniforme
-  * Les interfaces des téléphones offrent plus d'options de personnalisation que 3CX, ne pas hésiter à aller fouiller pour, par exemple, importer de nouvelles sonneries, de nouveaux fonds d'écrans (selon le téléphone), etc. Cependant, 3CX écrasera malheureusement certaines de ces personnalisations en cas de redémarrage du serveur ou de réapprovisionnement du téléphone.
+  * Minimum : 1000
-  * Les téléphones se voient attribués une IP locale après avoir envoyé un message multicast sur le LAN (par le serveur 3CX local ou par le SBC).
+  * Maximum : 9999
-  * 88Kb/s pour [[https://fr.wikipedia.org/wiki/G.711|G711A]] (=PCMA =A-LAW) pour 1 sens (176kbs pour les 2 sens, soit 880kbs pour 5 lignes parallèles dans les 2 sens)
-  * [[https://fr.wikipedia.org/wiki/S%C3%A9lection_directe_%C3%A0_l%27arriv%C3%A9e|SDA]] = DDI = DID
-  * Pour afficher des BLF sur le module d'extension du téléphone Yealink T29G, commencer au BLF 28 (ou 29 si l'on souhaite garder la possibilité de changement de liste).
-  * Chemin des données de 3CX sur le serveur : ''/var/lib/3cxpbx/Instance1/Data/''
-  * Chemin des messages vocaux (voicemails) : ''/var/lib/3cxpbx/Instance1/Data/Ivr/Voicemail/Extensions/<id_extension>/''
+Ou bien vous pouvez utiliser la fonction de Libreoffice Calc :
+  =ALEA.ENTRE.BORNES(1000;9999)
+Sinon vous pouvez utiliser un terminal si vous utilisez un système GNU/Linux ou BSD.\\
+Trente codes PIN de 1000 à 9999 :
-====== Exploitation de 3CX ======
+  shuf -i 1000-9999 -n 30
+==== Mots de passe et identifiants ====
+=== Avec le paquet pwgen ===
+  sudo apt install pwgen
+Trente suites de dix caractères :
+  pwgen 10 30
+=== Avec urandom ===
+Trente suites de dix caractères :
+  for i in {1..30}; do head /dev/urandom | tr -dc A-Za-z0-9 | head -c 10 ; echo ''; done
+=== Avec une formule Libreoffice Calc amusante et pas sérieuse ===
+Copiez et coller cette formule pour générer une suite de dix caractères alphanumériques aléatoires :
+  =SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96)))
+====== Notes ======
+  * L'extension navigateur [[https://www.3cx.fr/manuel-utilisation/click-to-call/|3CX Click to Call]] est disponible pour [[https://addons.mozilla.org/fr/firefox/addon/3cx-clicktocall/|Firefox]] et [[https://addons.mozilla.org/fr/firefox/addon/3cx-clicktocall/|Chromium]].
+  * Pour se connecter à l'interface du téléphone, utiliser "admin" et "mot de passe téléphone" (trouvable dans les extensions).
+  * Les interfaces des téléphones offrent plus d'options de personnalisation que 3CX. Pour s'y connecter, utiliser  Ne pas hésiter à aller fouiller pour, par exemple, importer de nouvelles sonneries, de nouveaux fonds d'écrans (selon le téléphone), etc. Cependant, 3CX écrasera malheureusement certaines de ces personnalisations en cas de redémarrage du serveur ou de réapprovisionnement du téléphone.
+  * Les téléphones se voient attribués une IP locale par le seveur DHCP. Après ils envoient un message multicast sur le LAN (vers le serveur 3CX local ou vers le SBC) pour l'auto-provisionning.
+  * [[https://fr.wikipedia.org/wiki/S%C3%A9lection_directe_%C3%A0_l%27arriv%C3%A9e|SDA]] : SDA = DDI = DID
+====== Exploitation de 3CX ======
 ===== Gérer la blacklist IP =====
@@ Ligne 665: / Ligne 829: @@
+===== Rapports d'appels =====
+Il est possible de créer des rapports d'appels automatiques pour établir des statistiques utiles :\\
+-> Webmanager -> Rapports d'appels
+===== Logs détaillés, debug et envoi au support =====
+-> WebManager -> Statut système -> Log du serveur (-> Logs)\\
+Logs détaillés et collecte pour envoi au support : https://www.3cx.com/docs/collecting-logs-for-3cx-support/
-====== Astuces ======
+Exploitation des logs en live depuis le serveur :
+  * Afficher appels depuis logs sur serveur : ''tail -f /var/lib/3cxpbx/Instance1/Data/Logs/3CXDialer.log''
+  * Afficher tous les logs du serveur : ''tail -f /var/lib/3cxpbx/Data/Logs/*.log /var/lib/3cxpbx/Instance1/Data/Logs/*.log''
-===== Joindre directement plusieurs extensions avec un seul numéro =====
-Pour joindre directement une extension avec un seul numéro, par exemple une SDA en plus du numéro principal du trunk, il faut se servir d'un IVR -> Web Manager -> Répondeurs -> Ajouter
+===== Capture réseau, tcpdump =====
-Chaque touche dois correspondre à une extension, ainsi un appelant pourra composer le numéro de téléphone suivi directement du numéro correspond à l'extension qu'il souhaite joindre.
+Capture tcpdump .pcap : https://www.3cx.com/blog/voip-howto/logs-captures-support-info-wireshark/\\
+sudo tcpdump "not port 22 and not port 56443" -w 3cx_$(date +"%Y%m%d%H%M%S").pcap
-Par exemple, pour un numéro 0123456789 :
-  * 0 = Jean Dupont
-  * 1 = Maurice Moulin
-  * 2 = Bob Morane
-L'appelant composant le 01234567891 tombera directement sur Maurice Moulin sous réserve que la règle entrante du numéro 0123456789 redirige sur le répondeur.
+===== Chemins dans le système =====
+  * logs : /var/lib/3cxpbx/Data/Logs/*.log **ET** /var/lib/3cxpbx/Instance1/Data/Logs/*.log
+  * messages vocaux (voicemails) : ''/var/lib/3cxpbx/Instance1/Data/Ivr/Voicemail/Extensions/<id_extension>/''
+  * CDRs : /var/lib/3cxpbx/Instance1/Data/Logs/CDRLogs/
+  * backups : /var/lib/3cxpbx/Data/Backups
+  * enregistrements : /var/lib/3cxpbx/Instance1/Data/Recordings
+  * provisionning appliqué : /var/lib/3cxpbx/Instance1/Data/Http/Interface/provisioning
-Mettre la règle de redirection en cas de non saisie à 1 permet d'avoir un IVR transparent s'il n'y a pas de désir de joindre quelqu'un directement. Ainsi un appelant ne connaissant pas l'astuce décrite ici se vera redirigé directement sur le choix de l'administrateur, par exemple une file d'attente.
-===== Génération de caractères aléatoires pour import CSV =====
-==== Codes PIN ====
-Si vous utilisez Libreoffice Calc, sélectionnez les cellules dans lesquelles vous souhaitez générer les codes PIN, puis -> Feuille -> Remplir les cellules -> Nombres aléatoires.\\
+===== Plan de numérotation =====
-  * Distribution : Entier uniforme
-  * Minimum : 1000
-  * Maximum : 9999
-Ou bien vous pouvez utiliser la fonction de Libreoffice Calc :
+Par défaut, le plan de numérotation est composé de 3 chiffre. Pour un système qui sera ultérieurement connecté à d'autres ipbx, il est souhaitable de mettre 4 chiffre pour avoir le 1er chiffre comme possibilité de routage vers un autre ipbx ou l'utiliser comme un préfixe de site conventionnel.
+Les numéros spéciaux prédéfinis sont les suivants :
+  * 888 : extension par défaut pour le FAX (et comme destinataire pour le test d'echo)
+  * 700 : extension par défaut pour le système de conférences
+  * 999 : messagerie
-  =ALEA.ENTRE.BORNES(1000;9999)
-Sinon vous pouvez utiliser un terminal si vous utilisez un système GNU/Linux ou BSD.\\
+===== Codes de raccourci =====
-Trente codes PIN de 1000 à 9999 :
+-> WebManager -> Paramètres -> Codes de raccourci
-  shuf -i 1000-9999 -n 30
+Les codes de raccourcis permettent à l'utilisateur d'activer des fonctions par combinaisons de DTMF. Notez que plusieurs d'entre elles sont des préfixes et doivent être suivies d'un numéro de destination, extension, ou parking.
+  * Parquer un appel : *0
-==== Mots de passe et identifiants ====
+  * Reprendre un appel parqué : *1
+  * Intercepter un appel : *20*
+  * Changer de statut en Disponnible : *30
+  * Changer de statut en Absent : *31
+  * Changer de statut en Ne pas déranger : *32
+  * Changer de statut en Dejeuner (personnalisé 1) : *33
+  * Changer de statut en Voyage pro (personnalisé 2) : *34
+  * Connecter à la messagerie vocale de l'extension : *4
+  * Ne pas déranger : désactiver : *60
+  * Ne pas déranger : activer : *61
+  * Connecter l'extension aux files : *62
+  * Déconnecter l'extension aux files : *63
+  * Annonce sans décrocher :
+  * Préfixe de facturation : **
+  * Forcer le 3CX Phone System EN ou HORS heures bureau :
+  * Sortir en numéro anonyme : *5
+  * Hotdesking (disponible pour les éditions Pro / Entreprise) : *77*
+  * Codes de statut des chambres (utilisé pour les services hôteliers) Tapez le code de numérotation suivi du code de statut approprié pour changer le statut de la chambre. Réveil téléphonique, un SVI est nécessaire pour que cette fonctionnalité soit activée. Pour plus d'informations cliquez ici. : *68
+  * Accès au système de conférence : 700*
+  * Echo test : *777
+  * Echo test avec rappel : *888
-=== Avec le paquet pwgen ===
+voir : https://www.3cx.com/docs/pbx-dial-codes/#h.3563xera2eph
-  sudo apt install pwgen
-Trente suites de dix caractères :
-  pwgen 10 30
-=== Avec urandom ===
+===== Configuration Hotel =====
+extension 000 = Accueil / réceptionniste
+attention : numéro d'extension = numéro de chambre ==> attention conflits avec le plan de numérotation
+Dashboard -> Répondeurs ->
+nom : IVR Reveil
+Extention : 807
+Type : Réveil
+Changer le message de réveil (en enregistrer un)
+RQ : il n'y a que la langue anglaise pour l'IVR de réveil ! Mais on peut soi-même faire son language set (47 fichiers à faire...)
-Trente suites de dix caractères :
+Pour chaque chambre :
+provisionner téléphone + extension avec numéro de la chambre
-  for i in {1..30}; do head /dev/urandom | tr -dc A-Za-z0-9 | head -c 10 ; echo ''; done
+Pour l'opérateur : ajouter le droit " Effectue des opérations (diversion, transfert, répondre à l'appel)"
+En se logguant avec l'interface WEB client :
-=== Avec une formule Libreoffice Calc amusante et pas sérieuse ===
+dans personnes : cliquer sur l'icone "trois petits points verticaux" et choisir "assigner"
+entrer les coordonnées du nouvel hôte
+Pour faire le check-out : choisir "effacer"
+doc FXS / FXO
-Copiez et coller cette formule pour générer une suite de dix caractères alphanumériques aléatoires :
-  =SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96))) & SI(ALEA.ENTRE.BORNES(0;1)=0 ; ALEA.ENTRE.BORNES(0;9) ; CAR(ENT(ALEA()*26+1)+CHOISIR(ARRONDI(ALEA();0)+1;64;96)))
+WEBRTC_SIP_PORT 	WebRTC SIP port
+WEBRTC_RTP_FIRST_PORT 	Local start RTP port range (1 call 4 ports)
+WEBRTC_RTP_LAST_PORT 	Local end RTP port range (1 call 4 ports)
+WEBRTC_WRTC_FIRST_PORT 	External (Port forwarding required) start RTP port range (1 call 4 ports)
+WEBRTC_WRTC_LAST_PORT 	External (Port forwarding required) end RTP port range (1 call 4 ports)
+WEBRTC_MAXVIDEO_BANDWIDTH 	WebRTC video bandwidth (kbps)
+CONFERENCEEXTPIN 	The conference extension pin
-*777 Echo Test