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 Yeastar, vous devrez créer une extension pour celui-ci, puis obtenir les identifiants SIP.

Créer une extension dans Yeastar

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

1. Dans la console de gestion, allez dans « Extension and Trunk » > « Extension » > « Add ».
   
2. Saisissez un nom pour l’extension, attribuez un identifiant d’appelant, et éventuellement un identifiant d’appelant sortant.
3. Configurez le paramètre « IP Phone Concurrent Registrations » avec une valeur supérieure à 1 (au moins 2). SIP Caller s’enregistrera une fois pour vérifier les identifiants, et une seconde fois pour passer des appels depuis un service différent.
4. Dans l’onglet Advanced, assurez-vous de configurer les paramètres Transport et SRTP avec les mêmes valeurs que celles que vous définirez du côté SIP Caller lors de la création de l’extension.
5. Dans l’onglet Security, vous pouvez restreindre l’enregistrement pour qu’il ne soit effectué qu’à partir des adresses IP de SIP Caller. De plus, vous devez décocher l’option « Disable Outbound Calls » et éventuellement « Disable Outbound Calls outside Business Hours ». Si vous prévoyez de passer des appels internationaux avec SIP Caller, décochez également l’option « Disallow International Calls ». Enfin, assurez-vous que le paramètre « Outbound Call Frequency Restriction » est configuré pour permettre de passer des appels à la fréquence dont vous avez besoin pour vos campagnes.
6. Vous aurez besoin des valeurs « Extension Number », « Registration Name » et « Registration Password », copiez-les donc et gardez-les à portée de main lorsque vous configurez l’extension dans SIP Caller.
7. Dans la console de gestion, allez dans « Security » > « Security Rules » > onglet « Allowed IPs », et ajoutez les adresses IP de SIP Caller. Vous pouvez les copier une fois que vous avez sélectionné la région depuis laquelle vous opérerez.
8. Cliquez sur le bouton « Apply » dans le coin supérieur droit, afin que le PBX commence à fonctionner avec cette configuration.

Obtenir les identifiants depuis Yeastar

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

• Nom d’utilisateur : Extension Number
• ID d’authentification : Registration Name
• Mot de passe : Registration Password

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, ou sur un serveur Linux pouvant être utilisé à cette fin lorsque vous n’avez pas accès au serveur Yeastar. 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 Yeastar 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 Yeastar :
   • Allez dans Integrations > AMI, et activez AMI.
   • SIP Caller nécessite que vous activiez les permissions « System » > « Read », « Call » > « Read », « Call » > « Write » et « Agent » > « Read ».

• Définissez le nom d’utilisateur et le mot de passe, puis ajoutez l’adresse IP depuis laquelle vous vous connecterez, c’est-à-dire l’adresse IP du serveur Linux sur lequel vous installez le module. Lors d’une installation locale, saisissez « 127.0.0.1 » comme adresse IP.

2. 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.
3. 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`.
4. Lors de l’exécution du script d’installation sur votre serveur Yeastar, 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 (il sera visible dans Yeastar après avoir enregistré les modifications AMI).
   • 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.