===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'''===
[[Fichier:2026-04-03 13h29 01.png|vignette]]
#Réglages
#Transfert d'appels
#Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple '''Absent'''. Pas l'état '''Disponible''' évidemment.
#Dans "Transférer les appels externes à", choisir '''Mon mobile'''
#Cocher '''Rebond'''

===Déclaration du script===
[[Fichier:2026-04-02 17h11 35.png|vignette]]

Rendez-vous dans :

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

#Donner un nom au traitement de l'appel. Exemple : '''astreinte_weekend'''
#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'''
#OK
#Coller dans le champ script le script paramétré ( voir section suivante )
#Sauvegarder
#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 :

<syntaxhighlight lang="csharp" line highlight="14-17">
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);
}
}
}
}
</syntaxhighlight>

===Le script de retour à la normale===

<syntaxhighlight lang="csharp" line highlight="14-16">
using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;

namespace dummy
{
public class ResetAstreinte : ScriptBase<ResetAstreinte>
{
// ============================================================
// CONFIGURATION
// ============================================================
private const string TARGET_EXT = "111";
private const string PRENOM_ELU = "Accueil";
private const string NOM_ELU = "Mairie";
// ============================================================

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. Remettre le nom générique
ext.FirstName = PRENOM_ELU;
ext.LastName = NOM_ELU;

// 2. Vider le numéro mobile
ext.SetProperty("MOBILENUMBER", "");

// 3. Résoudre le DN pour la messagerie vocale
DN targetDN = ps.GetDNByNumber(TARGET_EXT);

// 4. Remettre AwayRoute → messagerie vocale
FwdProfile awayProfile = ext.FwdProfiles
.FirstOrDefault(p => p.Name.Equals(
"Away", StringComparison.OrdinalIgnoreCase));

if (awayProfile != null)
{
AwayRouting route = awayProfile.AwayRoute;

HoursDestination internalHours = route.Internal;
HoursDestination externalHours = route.External;

DestinationStruct destInternal = internalHours.AllHours;
destInternal.To = DestinationType.VoiceMail;
destInternal.Internal = targetDN;
destInternal.External = "";
internalHours.AllHours = destInternal;

DestinationStruct destExternal = externalHours.AllHours;
destExternal.To = DestinationType.VoiceMail;
destExternal.Internal = targetDN;
destExternal.External = "";
externalHours.AllHours = destExternal;
}

// 5. Sauvegarder
ext.Save();

// 6. Recharger et basculer vers Available
ext = ps.GetDNByNumber(TARGET_EXT) as Extension;
if (ext == null)
return Task.FromResult(false);

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

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

return Task.FromResult(true);
}
catch (Exception)
{
return Task.FromResult(false);
}
}
}
}
</syntaxhighlight>

====Table de correspondance des profileName====

{| class="wikitable"
|-
! 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

{| class="wikitable"
|+ Texte de la légende
|-
|'''Marcel Patulacci''' || '''Jean-Michel Apeuprè'''|| '''Poste accueil ''' hors période d'astreinte
|-
| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
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
</syntaxhighlight> || <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
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
</syntaxhighlight>|| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "";
string profileName = "Available";

// Nommage de l'astreinte
string prenomElu = "Accueil";
string nomElu = "";

try
</syntaxhighlight>
|}

Une fois les 3 scripts produits, passer à l'étape [[Astreinte#Déclaration_du_script|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.

{{Valide|v20}}
[[Catégorie:3CX]]

Astreinte

2026-04-28T12:16:08Z

Anthony :

===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'''===
[[Fichier:2026-04-03 13h29 01.png|vignette]]
#Réglages
#Transfert d'appels
#Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple '''Absent'''. Pas l'état '''Disponible''' évidemment.
#Dans "Transférer les appels externes à", choisir '''Mon mobile'''
#Cocher '''Rebond'''

===Déclaration du script===
[[Fichier:2026-04-02 17h11 35.png|vignette]]

Rendez-vous dans :

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

#Donner un nom au traitement de l'appel. Exemple : '''astreinte_weekend'''
#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'''
#OK
#Coller dans le champ script le script paramétré ( voir section suivante )
#Sauvegarder
#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 :

<syntaxhighlight lang="csharp" line highlight="14-17">
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);
}
}
}
}
</syntaxhighlight>

===Le script de retour à la normale===

<syntaxhighlight lang="csharp" line highlight="14-17">
using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;

namespace dummy
{
public class ResetAstreinte : ScriptBase<ResetAstreinte>
{
// ============================================================
// CONFIGURATION — valeurs par défaut quand personne n'est d'astreinte
// ============================================================
private const string TARGET_EXT = "111";
private const string PRENOM_EXT = "Anthony";
private const string NOM_EXT = "";
// ============================================================

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. Remettre le nom générique
ext.FirstName = PRENOM_EXT;
ext.LastName = NOM_EXT;

// 2. Vider le numéro mobile
ext.SetProperty("MOBILENUMBER", "");

// 3. Sauvegarder
ext.Save();

// 4. Recharger et basculer vers Available
ext = ps.GetDNByNumber(TARGET_EXT) as Extension;
if (ext == null)
return Task.FromResult(false);

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

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

return Task.FromResult(true);
}
catch (Exception)
{
return Task.FromResult(false);
}
}
}
}
</syntaxhighlight>

====Table de correspondance des profileName====

{| class="wikitable"
|-
! 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

{| class="wikitable"
|+ Texte de la légende
|-
|'''Marcel Patulacci''' || '''Jean-Michel Apeuprè'''|| '''Poste accueil ''' hors période d'astreinte
|-
| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
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
</syntaxhighlight> || <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
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
</syntaxhighlight>|| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "";
string profileName = "Available";

// Nommage de l'astreinte
string prenomElu = "Accueil";
string nomElu = "";

try
</syntaxhighlight>
|}

Une fois les 3 scripts produits, passer à l'étape [[Astreinte#Déclaration_du_script|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.

{{Valide|v20}}
[[Catégorie:3CX]]

Astreinte

2026-04-28T12:12:01Z

Anthony : /* Le script d'astreinte */

Astreinte

2026-04-28T12:09:57Z

Anthony : /* Le script */

2026-04-03T09:24:41Z

Anthony :

== par le statut ==

Dans les réglages de l'extension qui accueille les appels :

#Réglages
#Transfert d'appels
#Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple '''Absent'''. Pas l'état '''Disponible''' évidemment.
#Dans "Transférer les appels externes à", choisir '''Numéro externe'''
#Saisir le numéro de l'astreinte
#Cocher '''Rebond'''

[[Fichier:2026-04-02 16h03 02.png]]

Limite / contrainte :
*si les astreintes tournent, avant chaque période d'astreinte, il faut faire ce cheminement pour que le bon numéro de mobile soit paramétré
*4 profils d'astreinte maximum
*Nécessite de manipuler l'application WEB

== Via script==
===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'''===

[[Fichier:2026-04-03 11h09 54.png|cadre|néant]]

===Déclaration du script===
[[Fichier:2026-04-02 17h11 35.png|vignette]]
Rendez-vous dans :

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

#Donner un nom au traitement de l'appel. Exemple : '''astreinte_weekend'''
#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'''
#OK
#Coller dans le champ script le script paramétré ( voir section suivante )
#Sauvegarder
#Un message doit indiquer '''Compilation réussie !'''

===Le script===

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 :

<syntaxhighlight lang="csharp" line highlight="14-16,19-20">
using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;
using System.Collections.Generic;

namespace dummy
{
public class SetDynamicAstreinte : ScriptBase<SetDynamicAstreinte>
{
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0601020304";
string profileName = "Away";

// Nommage de l'astreinte
string prenomElu = "ASTREINTE";
string nomElu = "ELU";

try
{
IPhoneSystem ps = PhoneSystem.Root;
Extension targetExt = ps.GetDNByNumber(targetExtNum) as Extension;

if (targetExt != null)
{
// 1. Mise à jour du numéro de mobile
targetExt.SetProperty("MOBILENUMBER", mobileElu);

// 2. MISE À JOUR DU NOM
targetExt.FirstName = prenomElu;
targetExt.LastName = nomElu;

// 3. Changement du profil de statut
var profile = targetExt.FwdProfiles.FirstOrDefault(p => p.Name.Equals(profileName, StringComparison.OrdinalIgnoreCase));

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

// 4. Sauvegarde globale
targetExt.ResetCurrentProfileOverride();
targetExt.Save();

return Task.FromResult(true);
}
}
catch (Exception)
{
// Erreur silencieuse
}
return Task.FromResult(false);
}
}
}
</syntaxhighlight>

====Table de correspondance des profileName====

{| class="wikitable"
|-
! 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, "Custom 2" pour cet exemple

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

{| class="wikitable"
|+ Texte de la légende
|-
|'''Marcel Patulacci''' || '''Jean-Michel Apeuprè'''|| '''Poste accueil ''' hors période d'astreinte
|-
| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0699999999";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Marcel";
string nomElu = "Patulacci";

try
</syntaxhighlight> || <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0688888888";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Jean-Michel";
string nomElu = "Apeuprè";

try
</syntaxhighlight>|| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "";
string profileName = "Available";

// Nommage de l'astreinte
string prenomElu = "Accueil";
string nomElu = "";

try
</syntaxhighlight>
|}

Une fois les 3 scripts produits, passer à l'étape [[Astreinte#Déclaration_du_script|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.

{{Valide|v20}}
[[Catégorie:3CX]]

Astreinte

2026-04-03T09:22:18Z

Anthony : /* Configuration concrète */

Astreinte

2026-04-03T09:12:25Z

Anthony : /* Paramétrage du statut vers mon mobile */

Astreinte

2026-04-03T09:11:47Z

Anthony : /* Paramétrage du statut vers mon mobile */

== par le statut ==

Dans les réglages de l'extension qui accueille les appels :

#Réglages
#Transfert d'appels
#Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple '''Absent'''. Pas l'état '''Disponible''' évidemment.
#Dans "Transférer les appels externes à", choisir '''Numéro externe'''
#Saisir le numéro de l'astreinte
#Cocher '''Rebond'''

[[Fichier:2026-04-02 16h03 02.png]]

Limite / contrainte :
*si les astreintes tournent, avant chaque période d'astreinte, il faut faire ce cheminement pour que le bon numéro de mobile soit paramétré
*4 profils d'astreinte maximum
*Nécessite de manipuler l'application WEB

== Via script==
===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 vers '''mon mobile'''===

[[Fichier:2026-04-03 11h09 54.png|cadre|néant]]

===Déclaration du script===
[[Fichier:2026-04-02 17h11 35.png|vignette]]
Rendez-vous dans :

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

#Donner un nom au traitement de l'appel. Exemple : '''astreinte_weekend'''
#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'''
#OK
#Coller dans le champ script le script paramétré ( voir section suivante )
#Sauvegarder
#Un message doit indiquer '''Compilation réussie !'''

===Le script===

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 :

<syntaxhighlight lang="csharp" line highlight="14-16,19-20">
using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;
using System.Collections.Generic;

namespace dummy
{
public class SetDynamicAstreinte : ScriptBase<SetDynamicAstreinte>
{
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0601020304";
string profileName = "Away";

// Nommage de l'astreinte
string prenomElu = "ASTREINTE";
string nomElu = "ELU";

try
{
IPhoneSystem ps = PhoneSystem.Root;
Extension targetExt = ps.GetDNByNumber(targetExtNum) as Extension;

if (targetExt != null)
{
// 1. Mise à jour du numéro de mobile
targetExt.SetProperty("MOBILENUMBER", mobileElu);

// 2. MISE À JOUR DU NOM
targetExt.FirstName = prenomElu;
targetExt.LastName = nomElu;

// 3. Changement du profil de statut
var profile = targetExt.FwdProfiles.FirstOrDefault(p => p.Name.Equals(profileName, StringComparison.OrdinalIgnoreCase));

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

// 4. Sauvegarde globale
targetExt.ResetCurrentProfileOverride();
targetExt.Save();

return Task.FromResult(true);
}
}
catch (Exception)
{
// Erreur silencieuse
}
return Task.FromResult(false);
}
}
}
</syntaxhighlight>

====Table de correspondance des profileName====

{| class="wikitable"
|-
! 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, "Custom 2" pour cet exemple

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

{| class="wikitable"
|+ Texte de la légende
|-
|'''Marcel Patulacci''' || '''Jean-Michel Apeuprè'''|| '''Poste accueil ''' hors période d'astreinte
|-
| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0699999999";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Marcel";
string nomElu = "Patulacci";

try
</syntaxhighlight> || <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0688888888";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Jean-Michel";
string nomElu = "Apeuprè";

try
</syntaxhighlight>|| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "";
string profileName = "Available";

// Nommage de l'astreinte
string prenomElu = "Accueil";
string nomElu = "";

try
</syntaxhighlight>
|}

[[Catégorie:3CX]]

Astreinte

2026-04-03T09:11:03Z

Anthony : /* Via script */

== par le statut ==

Dans les réglages de l'extension qui accueille les appels :

#Réglages
#Transfert d'appels
#Choisir le statut de l'extension à activer pour enclencher le renvoi vers l'astreinte. Dans l'exemple '''Absent'''. Pas l'état '''Disponible''' évidemment.
#Dans "Transférer les appels externes à", choisir '''Numéro externe'''
#Saisir le numéro de l'astreinte
#Cocher '''Rebond'''

[[Fichier:2026-04-02 16h03 02.png]]

Limite / contrainte :
*si les astreintes tournent, avant chaque période d'astreinte, il faut faire ce cheminement pour que le bon numéro de mobile soit paramétré
*4 profils d'astreinte maximum
*Nécessite de manipuler l'application WEB

== Via script==
===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 vers '''mon mobile'''===

[[Fichier:2026-04-03 11h09 54.png|cadre|gauche]]

===Déclaration du script===
[[Fichier:2026-04-02 17h11 35.png|vignette]]
Rendez-vous dans :

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

#Donner un nom au traitement de l'appel. Exemple : '''astreinte_weekend'''
#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'''
#OK
#Coller dans le champ script le script paramétré ( voir section suivante )
#Sauvegarder
#Un message doit indiquer '''Compilation réussie !'''

===Le script===

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 :

<syntaxhighlight lang="csharp" line highlight="14-16,19-20">
using System;
using System.Threading.Tasks;
using TCX.Configuration;
using CallFlow;
using System.Linq;
using System.Collections.Generic;

namespace dummy
{
public class SetDynamicAstreinte : ScriptBase<SetDynamicAstreinte>
{
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0601020304";
string profileName = "Away";

// Nommage de l'astreinte
string prenomElu = "ASTREINTE";
string nomElu = "ELU";

try
{
IPhoneSystem ps = PhoneSystem.Root;
Extension targetExt = ps.GetDNByNumber(targetExtNum) as Extension;

if (targetExt != null)
{
// 1. Mise à jour du numéro de mobile
targetExt.SetProperty("MOBILENUMBER", mobileElu);

// 2. MISE À JOUR DU NOM
targetExt.FirstName = prenomElu;
targetExt.LastName = nomElu;

// 3. Changement du profil de statut
var profile = targetExt.FwdProfiles.FirstOrDefault(p => p.Name.Equals(profileName, StringComparison.OrdinalIgnoreCase));

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

// 4. Sauvegarde globale
targetExt.ResetCurrentProfileOverride();
targetExt.Save();

return Task.FromResult(true);
}
}
catch (Exception)
{
// Erreur silencieuse
}
return Task.FromResult(false);
}
}
}
</syntaxhighlight>

====Table de correspondance des profileName====

{| class="wikitable"
|-
! 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, "Custom 2" pour cet exemple

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

{| class="wikitable"
|+ Texte de la légende
|-
|'''Marcel Patulacci''' || '''Jean-Michel Apeuprè'''|| '''Poste accueil ''' hors période d'astreinte
|-
| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0699999999";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Marcel";
string nomElu = "Patulacci";

try
</syntaxhighlight> || <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "0688888888";
string profileName = "Custom 2";

// Nommage de l'astreinte
string prenomElu = "Jean-Michel";
string nomElu = "Apeuprè";

try
</syntaxhighlight>|| <syntaxhighlight lang="csharp" line highlight="3-5,8-9">
public override Task<bool> StartAsync()
{
string targetExtNum = "100";
string mobileElu = "";
string profileName = "Available";

// Nommage de l'astreinte
string prenomElu = "Accueil";
string nomElu = "";

try
</syntaxhighlight>
|}

[[Catégorie:3CX]]