Différences

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

--- infrastructure:3cx [2019/04/27 14:16] – ghusson
+++ infrastructure:3cx [2019/07/23 14:30] (Version actuelle) – ghusson
@@ Ligne 24: / Ligne 24: @@
 Plus de détails : https://www.3cx.com/docs/manual/firewall-router-configuration/
+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...
@@ Ligne 87: / Ligne 91: @@
   * **Fichiers de configuration :** /etc/3cxsbc.conf
   * **Logs :** /var/log/3cxsbc.log
+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.
@@ Ligne 280: / Ligne 286: @@
 ===== Paramètres notifications email =====
--> WebManager -> Paramètres -> 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
+  * 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
+-> WebManager -> Paramètres -> E-mails -> Templates e-mail\\
 Permet d'éditer les modèles de mails.
@@ Ligne 292: / Ligne 298: @@
 ===== Paramètres mise à jour =====
--> WebManager -> Paramètres -> Mises à jour
+-> WebManager -> Paramètres -> Mises à jour\\
 activer MAJ auto ?
 ===== Paramètres Conférence =====
--> WebManager -> 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 ->
+-> WebManager -> Règles entrantes -> Ajouter une règle SDA \\
   * Nom : Direct vers conférence
   * SDA/DID : Sélectionner le SDA
@@ Ligne 312: / Ligne 317: @@
 ===== Paramètres Heures de bureau et jours fériés =====
--> WebManager -> Paramètres -> Heures de bureau et jours fériés
+-> WebManager -> Paramètres -> Heures de bureau et jours fériés\\
-configurer si besoin
+configurer si besoin\\
-Format WAV (PCM, 8 kHz, 16 bit, Mono, Max size: 100MB)
+Format WAV (PCM, 8 kHz, 16 bit, Mono, Max size: 100MB)\\
@@ Ligne 322: / Ligne 327: @@
 ===== Paramètres de messagerie vocale =====
--> WebManager -> Paramètres -> 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
+-> WebManager -> Paramètres -> CDR\\
 Actver la génération des CDRs
@@ Ligne 375: / Ligne 380: @@
 ===== Installer un téléphone =====
-- Faire un reset config du 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),
+  * 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
+  * -> 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.
+  * On se retrouve dans la configuration de l'auto-prvisionning du modèle de téléphone.\\
-Dans Options, changer :
+  * Dans Téléphone, Méthode de provisioning : choisir la bonne méthode (LAN, SBC, STUN)
-  * Langue d'affichage : Français
+  * Dans Options, changer :
-  * Format de la date : YYYY-MM-DD
+    * Langue d'affichage : Français
-  * Relever le mot de passe du téléphone
+    * Format de la date : YYYY-MM-DD
-  * Codecs :
+    * Relever le mot de passe WEB du téléphone
-    * PCMA
+    * Codecs :
-    * PCMU
+      * PCMA
-    * G722
+      * PCMU
-    * G729
+      * 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
+-> WebManager -> Extensions -> cliquer sur l'extension voulue\\
-Onglet "BLF"
+Onglet "BLF"\\
 doc : https://www.3cx.fr/voip-sip/touches-fonction-blf/
@@ Ligne 410: / Ligne 418: @@
 Facilite la gestion des mises en attente lorsqu'elles sont supérieures à 1.
--> Touche -> Module d'extension
+-> 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.
@@ Ligne 441: / Ligne 457: @@
 ===== Groupes d'appels =====
--> WebManager -> Groupes d'appels
+-> 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.\\
-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/
@@ Ligne 452: / Ligne 466: @@
 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 ====
+==== 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,
@@ Ligne 467: / Ligne 490: @@
 **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.
 ===== Parking d'appels =====
+Doc : https://www.3cx.com/blog/docs/call-parking/
 Les parkings d'appels permettent de "parquer" les appels.\\
@@ Ligne 487: / Ligne 505: @@
 Il est possible d'ajouter des raccourcis de parcage dans les BLF.\\
 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/
@@ Ligne 562: / 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
-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]]
@@ Ligne 589: / Ligne 594: @@
   * **Calendrier :** 3CX (direct eMail)
   * Ajouter des participants ou importer une liste CSV
+==== WebMeeting ====
+https://www.3cx.fr/manuel-utilisation/webmeeting/
+-> 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]]
@@ Ligne 680: / Ligne 696: @@
   * Le service d'envoi de fax de chez Free semble mal fonctionner.
   * L'envoi depuis ecofax fonctionne mais retourne d'abord une erreur. Le fax est cependant reçu deux fois : ''Communication failure during Phase B/C (modem protocol botch)''
+===== 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.
@@ Ligne 772: / Ligne 805: @@
   =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)))
-===== 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.
@@ Ligne 794: / Ligne 811: @@
   * 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, 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 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
@@ Ligne 814: / Ligne 831: @@
 ===== Rapports d'appels =====
-Il est possible de créer des rapports d'appels automatiques pour établir des statistiques utiles :
+Il est possible de créer des rapports d'appels automatiques pour établir des statistiques utiles :\\
 -> Webmanager -> Rapports d'appels
@@ Ligne 820: / Ligne 837: @@
 ===== Logs détaillés, debug et envoi au support =====
--> WebManager -> Statut système -> Log du serveur (-> Logs)
+-> 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/
@@ Ligne 830: / Ligne 847: @@
 ===== Capture réseau, tcpdump =====
-Capture tcpdump .pcap : https://www.3cx.com/blog/voip-howto/logs-captures-support-info-wireshark/
+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
@@ Ligne 839: / Ligne 856: @@
   * 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
+===== Plan de numérotation =====
+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
-*777 Echo Test
+===== Codes de raccourci =====
 -> WebManager -> Paramètres -> Codes de raccourci
--> WebManager -> Paramètres -> Paramètres
+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
+  * 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
+voir : https://www.3cx.com/docs/pbx-dial-codes/#h.3563xera2eph
+===== 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...)
+Pour chaque chambre :
+provisionner téléphone + extension avec numéro de la chambre
+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 :
+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
-*888
+WEBRTC_SIP_PORT 	WebRTC SIP port
-*0
-*1
+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