Astreinte

Principe

On paramètre le statut choisi pour l'astreinte en renvoi vers mon mobile. Un script viendra modifier le statut de l'extension cible ainsi que son numéro de contact mobile, prénom et nom. Ce script déclenchable par l'appel à un code court, paramétrable si on le souhaite sur une BLF.

Paramétrage du statut de l'extension vers mon mobile

1. Réglages
2. Transfert d'appels
3. Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple Absent. Pas l'état Disponible évidemment.
4. Dans "Transférer les appels externes à", choisir Mon mobile
5. Cocher Rebond

Déclaration du script

Rendez-vous dans :

Admin / Intégrations / Scripts d'appels / + Ajouter personnalisé

1. Donner un nom au traitement de l'appel. Exemple : astreinte_weekend
2. Créer un code de raccourci, ce qui permettra d'exécuter le script simplement en appelant ce code, et in fine par une BLF. Exemple : *99
3. OK
4. Coller dans le champ script le script paramétré ( voir section suivante )
5. Sauvegarder
6. Un message doit indiquer Compilation réussie !

Le script d'astreinte

L'éxécution du script va modifier l'extension targetExtNum , il va le basculer sur le statut profileName , modifier son mobile de contact mobileElu , son nom et prénom.

Il faut donc seulement modifier les lignes surlignés dans le code ci-dessous :

using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;

namespace dummy
{
    public class SetDynamicAstreinte : ScriptBase<SetDynamicAstreinte>
    {
        // ============================================================
        // CONFIGURATION — modifier uniquement ces lignes par script
        // ============================================================
        private const string TARGET_EXT   = "111";
        private const string MOBILE_ELU   = "0612345678";
        private const string PRENOM_ELU   = "Claude";
        private const string NOM_ELU      = "IA";
        private const string PROFILE_NAME = "Away";
        // ============================================================

        public override Task<bool> StartAsync()
        {
            try
            {
                IPhoneSystem ps = PhoneSystem.Root;
                Extension ext = ps.GetDNByNumber(TARGET_EXT) as Extension;
                if (ext == null)
                    return Task.FromResult(false);

                // 1. Nom / Prénom
                ext.FirstName = PRENOM_ELU;
                ext.LastName  = NOM_ELU;

                // 2. Numéro mobile
                ext.SetProperty("MOBILENUMBER", MOBILE_ELU);

                // 3. Trouver le profil Away
                FwdProfile targetProfile = ext.FwdProfiles
                    .FirstOrDefault(p => p.Name.Equals(
                        PROFILE_NAME, StringComparison.OrdinalIgnoreCase));

                if (targetProfile != null)
                {
                    // AwayRoute, Internal, External sont read-only
                    // mais ce sont des références : on peut modifier
                    // leurs membres si ceux-ci sont accessibles en écriture
                    AwayRouting route = targetProfile.AwayRoute;

                    // Capturer les HoursDestination comme variables locales
                    // (objets référence — la propriété est read-only,
                    //  mais l'objet pointé est modifiable)
                    HoursDestination internalHours = route.Internal;
                    HoursDestination externalHours = route.External;

                    // Capturer AllHours (struct) → modifier → réassigner
                    DestinationStruct destInternal = internalHours.AllHours;
                    destInternal.To               = DestinationType.Boomerang;
                    destInternal.External         = MOBILE_ELU;
                    internalHours.AllHours        = destInternal;

                    DestinationStruct destExternal = externalHours.AllHours;
                    destExternal.To               = DestinationType.Boomerang;
                    destExternal.External         = MOBILE_ELU;
                    externalHours.AllHours        = destExternal;
                }

                // 4. Sauvegarder
                ext.Save();

                // 5. Recharger et basculer le profil
                ext = ps.GetDNByNumber(TARGET_EXT) as Extension;
                if (ext == null)
                    return Task.FromResult(false);

                FwdProfile profile = ext.FwdProfiles
                    .FirstOrDefault(p => p.Name.Equals(
                        PROFILE_NAME, StringComparison.OrdinalIgnoreCase));

                if (profile != null)
                {
                    ext.CurrentProfile = profile;
                    ext.Save();
                }

                return Task.FromResult(true);
            }
            catch (Exception)
            {
                return Task.FromResult(false);
            }
        }
    }
}

Table de correspondance des profileName

Dans 3CX	Dans le script
Disponible	Available
Absent	Away
Ne pas déranger	Out of office
Custom 1	Custom 1
Custom 2	Custom 2

Configuration concrète

Il faut choisir un statut autre que "Disponible" qui sera activé pour l'astreinte, "Away" pour cet exemple

On a besoin de gérer deux astreintes. Le poste Accueil reçoit les appels en temps normal

Texte de la légende

Marcel Patulacci	Jean-Michel Apeuprè	Poste accueil hors période d'astreinte
public override Task<bool> StartAsync() { string targetExtNum = "100"; string mobileElu = "0699999999"; string profileName = "Away"; // Nommage de l'astreinte string prenomElu = "Marcel"; string nomElu = "Patulacci"; try	public override Task<bool> StartAsync() { string targetExtNum = "100"; string mobileElu = "0688888888"; string profileName = "Away"; // Nommage de l'astreinte string prenomElu = "Jean-Michel"; string nomElu = "Apeuprè"; try	public override Task<bool> StartAsync() { string targetExtNum = "100"; string mobileElu = ""; string profileName = "Available"; // Nommage de l'astreinte string prenomElu = "Accueil"; string nomElu = ""; try

Une fois les 3 scripts produits, passer à l'étape Déclaration du script qui va permettre d'affecter un code court à chaque script. Exemple :

• *90 pour hors période d'astreinte
• *91 pour Jean-Michel
• *92 pour Marcel

On peut communiquer les codes aux personnes habilitées à gérer le système d'astreinte et aller jusqu'à paramétrer des BLF pour faciliter la vie d'une secrétaire par exemple.

v20