Panoramica

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

Crea un interno in Yeastar

Per creare un interno in Yeastar procedi come segue:

1. Nella console di gestione, vai su "Extension and Trunk" > "Extension" > "Add".
   
2. Inserisci un nome per l'interno, assegna un Caller ID, e opzionalmente un caller ID in uscita.
3. Configura il parametro "IP Phone Concurrent Registrations" con un valore maggiore di 1 (almeno 2). SIP Caller si registrerà una volta per verificare le credenziali, e una seconda volta per effettuare chiamate da un servizio diverso.
4. Nella scheda Advanced, assicurati di configurare i parametri Transport e SRTP con gli stessi valori che imposterai lato SIP Caller quando crei l'interno.
5. Nella scheda Security, puoi limitare la registrazione ad avvenire solo dagli indirizzi IP di SIP Caller. Inoltre, devi deselezionare l'opzione "Disable Outbound Calls" e opzionalmente "Disable Outbound Calls outside Business Hours". Se prevedi di effettuare chiamate internazionali con SIP Caller, deseleziona anche l'opzione "Disallow International Calls". Infine, assicurati che il parametro "Outbound Call Frequency Restriction" sia configurato per consentire di effettuare chiamate con la frequenza di cui hai bisogno per le tue campagne.
6. Avrai bisogno dei valori "Extension Number", "Registration Name" e "Registration Password", quindi copiali e tienili a portata di mano quando configuri l'interno in SIP Caller.
7. Nella console di gestione, vai su "Security" > "Security Rules" > scheda "Allowed IPs", e aggiungi gli indirizzi IP di SIP Caller. Puoi copiarli una volta selezionata la regione da cui opererai.
8. Fai clic sul pulsante "Apply" nell'angolo in alto a destra, in modo che il PBX inizi a funzionare con questa configurazione.

Ottieni le credenziali da Yeastar

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

• Nome Utente: Extension Number
• ID di Autenticazione: Registration Name
• Password: Registration Password

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, oppure su un server Linux che può essere utilizzato a questo scopo quando non si ha accesso al server Yeastar. 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 Yeastar utilizzando l'Asterisk Manager Interface (AMI). Pertanto, dovrai creare un utente affinché SIP Caller possa connettersi tramite questo protocollo. Quando utilizzi Yeastar:
   • Vai su Integrations > AMI, e abilita AMI.
   • SIP Caller richiede che tu abiliti i permessi "System" > "Read", "Call" > "Read", "Call" > "Write" e "Agent" > "Read".

• Imposta il Nome Utente e la Password, e poi aggiungi l'indirizzo IP da cui ti connetterai, ovvero l'indirizzo IP del server Linux su cui stai installando il modulo. Quando lo installi localmente, inserisci "127.0.0.1" come indirizzo IP.

2. 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.
3. 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`.
4. Quando esegui lo script di installazione nel tuo server Yeastar, 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 (sarà visibile in Yeastar dopo aver salvato le modifiche AMI).
   • Il nome utente da usare per connettersi ad AMI (questo è l'utente creato nel passaggio precedente).
   • La password assegnata a questo utente.