Panoramica

SIP Caller si connette al tuo Sistema Telefonico come un interno remoto. Pertanto, per utilizzare SIP Caller con FreePBX dovrai creare un interno per esso, e poi ottenere le credenziali SIP.

Crea un interno in FreePBX

Per creare un interno in FreePBX procedi come segue:

1. Nella console di gestione, vai su "Connectivity" > "Extensions".
   
2. Seleziona il menu "Add Extension" > "Add New SIP [chan_pjsip] Extension".

3. Inserisci il numero dell'interno nel campo "User Extension", e assegna un nome visualizzato, e opzionalmente un caller ID in uscita.
4. Avrai bisogno dei valori "User Extension" e "Secret", quindi copiali e tienili a portata di mano quando configuri l'interno in SIP Caller.
5. Nella scheda "Advanced", cerca l'opzione "Outbound Concurrency Limit" e imposta il valore al numero di chiamate simultanee che vuoi che SIP Caller effettui.
6. Fai clic sul pulsante "Apply config" nell'angolo in alto a destra, in modo che il PBX inizi a funzionare con questo interno.

Ottieni le credenziali da FreePBX

SIP Caller richiederà i valori "User Extension" e "Secret" ottenuti nel passaggio precedente. Quando configuri l'interno in SIP Caller, dovrai utilizzare quei valori come segue:

• Nome Utente: User Extension
• ID di Autenticazione: User Extension
• Password: Secret

Per istruzioni dettagliate su come configurare il Sistema Telefonico in SIP Caller, consulta qui.

Opzionale - Installa il SIP Caller Queues Monitor per Asterisk

SIP Caller supporta l'esecuzione di campagne in modalità "Dialer Predittivo" o "Dialer Progressivo". Questo significa che il numero di chiamate effettuate verrà regolato in tempo reale, considerando il numero di agenti disponibili nella coda per gestire queste chiamate. Per fare questo, SIP Caller deve conoscere lo stato della coda, ovvero il numero di chiamate in attesa e il numero di agenti disponibili e occupati. Queste informazioni vengono segnalate a SIP Caller dal modulo "SIP Caller Queues Monitor" che deve essere installato nel server del PBX. Questo non è richiesto per eseguire campagne in modalità "Dialer di Potenza". Questo modulo è richiesto anche per attivare i callback quando le chiamate in coda vengono abbandonate o servite.

Per installare il "SIP Caller Queues Monitor" per Asterisk, procedi come segue:

1. Il modulo "SIP Caller Queues Monitor" si connette al tuo server FreePBX / Asterisk utilizzando l'Asterisk Manager Interface (AMI). Pertanto, dovrai creare un utente affinché SIP Caller possa connettersi tramite questo protocollo. Quando utilizzi FreePBX:
   • Vai su Settings > Asterisk Manager Users, e fai clic sul pulsante "Add Manager".

• Inserisci un nome, ad esempio "sipcaller", e configura le restrizioni di rete come necessario (il modulo si connetterà solo localmente).

• Nella scheda Permissions, SIP Caller richiede che tu abiliti i permessi "System" > "Read", "Call" > "Read", "Call" > "Write" e "Agent" > "Read".

2. Quando utilizzi una versione di Asterisk diversa, dovrai modificare il file di configurazione "/etc/asterisk/manager.conf", e aggiungere lì un utente per 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. Nella console di gestione di SIP Caller, vai su Impostazioni > API Keys, e crea una API Key assegnando il ruolo "Phone System Queues Monitor". Questa API Key sarà utilizzata dal modulo "SIP Caller Queues Monitor" per connettersi alla REST API di SIP Caller e segnalare lo stato delle code in tempo reale.
4. Vai su Sistemi Telefonici > Modifica il tuo Sistema Telefonico > scheda Monitoraggio Code, e segui le istruzioni per installare il modulo "SIP Caller Queues Monitor" nel tuo server Asterisk. Avrai bisogno dell'accesso SSH con un utente in grado di eseguire comandi come root tramite `sudo`.
5. Quando esegui lo script di installazione nel tuo server FreePBX/Asterisk, dovrai fornire le seguenti informazioni:
   • Il Token dell'API Key creata sopra.
   • Il numero di porta su cui l'Asterisk Management Interface (AMI) è in ascolto delle richieste (per impostazione predefinita 5038).
   • Il nome utente da usare per connettersi ad AMI (questo è l'utente creato nel passaggio precedente).
   • La password assegnata a questo utente.