- Integrazioni
- Telefonia
- Sistemi PBX basati su Asterisk
Sistemi PBX basati su Asterisk
Telefonia
Trasferisci chiamate tra RocketAiFlow e sistemi PBX basati su Asterisk tramite trunk PJSIP.
L'integrazione è stata realizzata usando un trunk PJSIP statico tra Asterisk e il provider/PBX remoto.
Usa questa integrazione quando il tuo ambiente usa Asterisk, FreePBX o un PBX basato su Asterisk e vuoi far ricevere chiamate agli agenti RocketAiFlow, avviare campagne outbound o trasferire chiamate verso operatori reali.
Come funziona il trasferimento della chiamata
RocketAiFlow usa il trunk configurato come percorso telefonico tra agente AI e PBX.
Durante la chiamata, l'agente può continuare la conversazione, terminare la chiamata o chiamare una function di transfer quando il cliente deve parlare con un operatore reale.
- La chiamata entra o esce da RocketAiFlow attraverso il trunk Asterisk/PJSIP configurato.
- L'AI voice agent gestisce la conversazione e decide se serve un trasferimento in base al prompt e alle functions abilitate.
transfer,transfer_callotransfer_to_serviceinvia la destinazione, l'interno o il servizio scelto dal workflow.- Asterisk instrada la destinazione usando il contesto configurato. Se nella function non selezioni un contesto custom, RocketAiFlow usa il contesto di default
raf-internal. - Dopo il test, valida la chiamata nel Registro chiamate e controlla lo stato del trunk nel monitoring.
Configurazione PJSIP e trunk RocketAiFlow
Installa questa configurazione sul server PBX Asterisk che vuoi integrare.
Inserisci il blocco nella configurazione PJSIP di Asterisk, di solito /etc/asterisk/pjsip.conf, oppure in un file incluso da pjsip.conf. Su sistemi basati su FreePBX, usa il file custom PJSIP previsto dalla tua installazione invece di modificare direttamente i file generati.
Sul lato RocketAiFlow abbiamo già predisposto un trunk di default chiamato providerPjsip. Prima di abilitarlo, inserisci l'IP corretto del tuo server Asterisk/PBX, poi cambia la password con quella usata in questa configurazione PBX.
La configurazione PBX definisce transport, AOR, auth, endpoint e identify per RocketAiFlow, che si registra o invia chiamate a quel PBX.

;=============== TRANSPORT SECTION
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060
local_net=172.22.0.0/24 ; <--- Replace with your PBX local network
external_signaling_address=YOUR_PUBLIC_IP
external_media_address=YOUR_PUBLIC_IP
; If you use a domain/DDNS instead of a static public IP, use:
; external_signaling_address=pbx.yourdomain.com
; external_media_address=pbx.yourdomain.com
; --- AOR used by RocketAiFlow REGISTER requests ---
[providerPjsip_aor]
type=aor
contact=sip:10.0.0.10:5060 ; <--- Replace with the RocketAiFlow server IP address
qualify_frequency=3
; --- AUTH: same credentials used by RocketAiFlow ---
[providerPjsip_auth]
type=auth
auth_type=userpass
username=providerPjsip
password=CHANGE_ME_PROVIDER_PJSIP_PASSWORD ; <--- Replace with the RocketAiFlow trunk password
; --- ENDPOINT that receives calls from RocketAiFlow ---
[providerPjsip]
type=endpoint
transport=transport-udp
context=raf-pjsipProvider ; <--- Dialplan context where calls from RocketAiFlow enter
disallow=all
allow=ulaw
aors=providerPjsip_aor
outbound_auth=providerPjsip_auth
auth=providerPjsip_auth
force_rport=no
direct_media=no
from_user=providerPjsip
from_domain=10.0.0.10 ; <--- Replace with the RocketAiFlow server IP address
rewrite_contact=no
rtp_symmetric=no
; --- IDENTIFY: links the RocketAiFlow IP or host to this endpoint ---
[providerPjsip_identify]
type=identify
endpoint=providerPjsip
match=10.0.0.10 ; <--- Replace with the RocketAiFlow server IP address
;=============== End of configuration fileConfigura l'integrazione in RocketAiFlow
Dopo aver abilitato il trunk di default providerPjsip, configura il workflow RocketAiFlow in base alla direzione che vuoi testare.
Percorso inbound
Apri Inbound AiAI Inbound Routing, seleziona il trunk providerPjsip e scegli l'agente. Tutte le chiamate che arrivano verso l'exten providerPjsip e il contesto raf-from-voip-provider vengono gestite dall'agente selezionato.


Percorso outbound
Apri AI Dialer FlowsDialer Campaigns e scegli il trunk in base a dove devono arrivare le chiamate. Se vuoi farle arrivare nel tuo PBX, seleziona providerPjsip.
Per il percorso providerPjsip, imposta Context su raf-providerPjsip, poi inserisci in Exten l'interno o il numero che vuoi contattare sul tuo server. Quell'extension deve essere instradata dal tuo PBX nel contesto raf-pjsipProvider.


Funzioni di transfer
Quando crei le funzioni di transfer, scegli il contesto raf-providerPjsip e inserisci in exten l'interno o il numero che vuoi contattare sul tuo server. In questo modo RocketAiFlow fa la dial usando il trunk configurato e i numeri trasferiti finiscono lato PBX nel contesto raf-pjsipProvider.

Testa l'integrazione
Parti da un test controllato prima di allargare route o campagna.
- Conferma che il trunk sia registrato prima del test.
- Per l'inbound, chiama il numero instradato attraverso il trunk Asterisk e verifica che l'agente risponda.
- Per l'outbound, avvia una campagna con un contatto e Concurrent Call Capacity impostato a 1.
- Chiedi all'agente di trasferire verso un operatore reale o un reparto supportato.
- Conferma che Asterisk riceva e instradi correttamente la destinazione.
- Rivedi Registro chiamate, transcript, timing, stato finale e monitoring trunk dopo la chiamata.