Vue d’ensemble

SIP Caller se connecte à votre système téléphonique en tant qu’extension distante. Par conséquent, pour utiliser SIP Caller avec FreePBX, vous devrez créer une extension pour celui-ci, puis obtenir les identifiants SIP.

Créer une extension dans FreePBX

Pour créer une extension dans FreePBX, procédez comme suit :

1. Dans la console de gestion, allez dans « Connectivity » > « Extensions ».
   
2. Sélectionnez le menu « Add Extension » > « Add New SIP [chan_pjsip] Extension ».

3. Saisissez le numéro d’extension dans le champ « User Extension », et attribuez un nom d’affichage, ainsi qu’éventuellement un identifiant d’appelant sortant.
4. Vous aurez besoin des valeurs de « User Extension » et « Secret », copiez-les donc et gardez-les à portée de main lorsque vous configurez l’extension dans SIP Caller.
5. Dans l’onglet « Advanced », recherchez l’option « Outbound Concurrency Limit » et définissez la valeur au nombre d’appels simultanés que vous souhaitez que SIP Caller effectue.
6. Cliquez sur le bouton « Apply config » dans le coin supérieur droit, afin que le PBX commence à fonctionner avec cette extension.

Obtenir les identifiants depuis FreePBX

SIP Caller nécessitera les valeurs « User Extension » et « Secret » obtenues à l’étape précédente. Lorsque vous configurez l’extension dans SIP Caller, vous devrez utiliser ces valeurs comme suit :

• Nom d’utilisateur : User Extension
• ID d’authentification : User Extension
• Mot de passe : Secret

Pour des instructions détaillées sur la configuration du système téléphonique dans SIP Caller, consultez ici.

Facultatif - Installer le SIP Caller Queues Monitor pour Asterisk

SIP Caller prend en charge l’exécution de campagnes en mode « Numéroteur Prédictif » ou « Numéroteur Progressif ». Cela signifie que le nombre d’appels effectués sera ajusté en temps réel, en tenant compte du nombre d’agents disponibles dans la file d’attente pour traiter ces appels. Pour ce faire, SIP Caller doit connaître l’état de la file d’attente, c’est-à-dire le nombre d’appels en attente et le nombre d’agents disponibles et occupés. Ces informations sont signalées à SIP Caller par le module « SIP Caller Queues Monitor » qui doit être installé sur le serveur PBX. Cela n’est pas requis pour exécuter des campagnes en mode « Numéroteur Puissant ». Ce module est également nécessaire pour déclencher des rappels lorsque des appels de file d’attente sont abandonnés ou traités.

Pour installer le « SIP Caller Queues Monitor » pour Asterisk, procédez comme suit :

1. Le module « SIP Caller Queues Monitor » se connecte à votre serveur FreePBX / Asterisk en utilisant l’Asterisk Manager Interface (AMI). Par conséquent, vous devrez créer un utilisateur permettant à SIP Caller de se connecter via ce protocole. Lorsque vous utilisez FreePBX :
   • Allez dans Settings > Asterisk Manager Users, et cliquez sur le bouton « Add Manager ».

• Saisissez un nom, par exemple « sipcaller », et configurez les restrictions réseau selon vos besoins (le module ne se connectera que localement).

• Dans l’onglet Permissions, SIP Caller nécessite que vous activiez les permissions « System » > « Read », « Call » > « Read », « Call » > « Write » et « Agent » > « Read ».

2. Si vous utilisez une variante différente d’Asterisk, vous devrez modifier le fichier de configuration « /etc/asterisk/manager.conf », et y ajouter un utilisateur pour SIP Caller :

   [sipcaller]  
   secret=a_strong_password_here  
   deny=0.0.0.0/0.0.0.0  
   permit=127.0.0.1/255.255.255.0  
   read=system,call,agent
   write=call

3. Dans la console de gestion SIP Caller, allez dans Réglages > Clés API, et créez une clé API en lui attribuant le rôle « Surveillance des Files d’Attente du Système Téléphonique ». Cette clé API sera utilisée par le module « SIP Caller Queues Monitor » pour se connecter à l’API REST de SIP Caller et signaler l’état des files d’attente en temps réel.
4. Allez dans Systèmes Téléphoniques > Modifier votre Système Téléphonique > onglet Surveillance des Files d’Attente, et suivez les instructions pour installer le module « SIP Caller Queues Monitor » sur votre serveur Asterisk. Vous aurez besoin d’un accès SSH avec un utilisateur pouvant exécuter des commandes en tant que root via `sudo`.
5. Lors de l’exécution du script d’installation sur votre serveur FreePBX/Asterisk, vous devrez fournir les informations suivantes :
   • Le jeton de la clé API créée ci-dessus.
   • Le numéro de port sur lequel l’Asterisk Management Interface (AMI) écoute les requêtes (par défaut 5038).
   • Le nom d’utilisateur à utiliser pour se connecter à l’AMI (il s’agit de l’utilisateur créé à l’étape précédente).
   • Le mot de passe attribué à cet utilisateur.