Cos'è un Connettore SIP?

Un Server Connettore SIP funge da ponte tra la tua infrastruttura PBX esistente e la piattaforma di agenti vocali di Mihu AI. Traduce la segnalazione SIP (Session Initiation Protocol) in modo che le chiamate in entrata e in uscita dalle tue estensioni PBX possano essere instradate verso — e gestite da — un agente vocale IA.

Una volta collegato, le tue estensioni PBX si comportano come se stessero chiamando un altro interno, ma dall'altra parte risponde un agente IA completamente capace che qualifica i lead, programma appuntamenti o gestisce le richieste di assistenza in tempo reale.

Sistemi PBX Compatibili

Il connettore SIP di Mihu AI funziona con 3CX, Asterisk, FreePBX e qualsiasi PBX basato su SIP conforme agli standard. Sono supportati sia i deployment cloud che on-premise.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue pronto:

  • An active Mihu AI account with Voice Agent access
  • Admin access to your PBX system
  • The public IP address or FQDN of your PBX server
  • A designated port for SIP traffic (default: 5060 for UDP/TCP, 5061 for TLS)
  • At least one available PBX extension to assign to the voice agent

Passo 1 — Creare il Server Connettore SIP

Vai alla sezione Connettori nella tua dashboard Mihu AI e crea un nuovo Server Connettore SIP. Questo registra un endpoint di connessione a cui il tuo PBX invierà le chiamate.

Open the SIP Connector panel

Dalla tua dashboard Mihu AI, vai su Impostazioni → Connettori → SIP e clicca su "Nuovo Server SIP". Dagli un nome descrittivo che identifichi il PBX a cui si collega, come "Ufficio-3CX-Principale" o "Clinica-Asterisk-PBX".

Enter the server connection details

Inserisci l'hostname o l'IP del server, la porta SIP e seleziona il protocollo di trasporto. TLS è raccomandato per gli ambienti di produzione per garantire la segnalazione crittografata delle chiamate.

Considerazioni NAT

Se il tuo PBX è dietro un firewall NAT, usa l'indirizzo IP pubblico o il FQDN qui — non l'IP privato/interno. Assicurati che le porte 5060-5061 e il tuo range di media RTP (es. 10000-20000) siano inoltrati correttamente.

Passo 2 — Aggiungere un Trunk SIP

Con il server creato, ora devi aggiungere un trunk SIP — questo definisce le credenziali di autenticazione specifiche e le regole di instradamento che collegano le tue estensioni PBX all'agente vocale.

Create a new trunk on the server

All'interno del Server SIP appena creato, clicca su "Aggiungi Trunk". Ogni trunk rappresenta una connessione logica tra un insieme di estensioni PBX e un agente vocale Mihu AI.

Set authentication credentials

Inserisci il nome utente e la password SIP. Questi devono corrispondere alle credenziali configurate sul tuo PBX per il trunk in uscita. Usa una password forte e unica per la sicurezza.

Passo 3 — Configurare i Dettagli del Trunk

Ecco una tabella di riferimento dei campi chiave che dovrai configurare quando imposti il tuo trunk SIP:

Field Description Example
Trunk Name A friendly label for identifying this trunk Office-Main-Trunk
SIP Username The authentication username for the trunk mihu_trunk_01
SIP Password Secure password matching your PBX config ••••••••
Registrar The address the trunk registers with sip.mihu.ai
Transport Protocol for SIP signaling TLS (recommended)

Casi d'Uso Reali

Diversi settori utilizzano i trunk SIP con Mihu AI in modi diversi. Ecco quattro scenari comuni che mostrano come le aziende instradano le chiamate attraverso il loro PBX verso un agente IA:

Sanità: Triage Fuori Orario

Route all calls outside business hours to an AI agent that collects patient symptoms, schedules urgent callbacks, and handles prescription refill requests.

Routing rule:
Time condition: 6PM–8AM → Extension 900 (Mihu AI)
Fallback: Voicemail after 3 rings

Automotive: Overflow del Reparto Assistenza

When all service advisors are busy, overflow calls go to AI that books service appointments, provides repair status updates, and quotes common services.

Routing rule:
Ring group 200 (Service) → No answer 20s → Extension 901 (Mihu AI)

Immobiliare: Qualificazione Lead

Incoming leads from property listings hit AI first to qualify budget, timeline, and preferences before routing hot leads directly to available agents.

Routing rule:
DID +1-555-HOMES → Extension 902 (Mihu AI)
Qualified lead → Transfer to Ring Group 300

E-Commerce: Stato Ordini e Resi

Handle high-volume order inquiries with AI that looks up tracking info, processes return requests, and escalates complex issues to human support.

Routing rule:
IVR option 1 (Order Status) → Extension 903 (Mihu AI)
IVR option 2 (Returns) → Extension 904 (Mihu AI)

Scenari di Instradamento PBX

Ecco come configurare scenari di instradamento comuni nel tuo PBX per funzionare con Mihu AI:

Esempi di Configurazione PBX

Copia questi pattern nel piano di numerazione del tuo PBX o nelle regole di instradamento

1

Direct Extension Routing

The simplest setup: assign a dedicated extension to the AI agent. Any call to this extension goes directly to Mihu AI. Ideal for testing or dedicated AI lines.

; 3CX / Asterisk dial plan exten => 900,1,Dial(SIP/mihu-trunk/900,30) exten => 900,n,Hangup() ; FreePBX: Create extension 900, set destination to "Custom Trunk: mihu-trunk"
2

Time-Based Routing (After Hours)

Route calls to AI only during specific hours. During business hours, calls go to human agents; after hours, they go to the AI agent for 24/7 coverage.

; Time condition: Mon-Fri 9AM-6PM → Ring Group, else → AI exten => s,1,GotoIfTime(09:00-18:00,mon-fri,*,*?business:afterhours) exten => s,n(business),Dial(SIP/ring-group-100,30) exten => s,n,Goto(afterhours) exten => s,n(afterhours),Dial(SIP/mihu-trunk/900,30) exten => s,n,Hangup()
3

Overflow Routing (All Agents Busy)

When all human agents are on calls, overflow to AI instead of putting customers on hold. The AI handles the inquiry or takes a message for callback.

; Ring group with overflow to AI after 20 seconds exten => 100,1,Dial(SIP/agent1&SIP/agent2&SIP/agent3,20) exten => 100,n,Dial(SIP/mihu-trunk/900,30) exten => 100,n,Hangup() ; FreePBX: Ring Group → Destination if no answer: "Custom: mihu-trunk/900"
4

IVR Menu Integration

Add AI as an option in your IVR menu. Customers can choose to speak with AI for quick tasks (order status, appointments) or wait for a human agent.

; IVR: "Press 1 for AI assistant, Press 2 for human agent" exten => 1,1,Dial(SIP/mihu-trunk/900,30) exten => 1,n,Hangup() exten => 2,1,Dial(SIP/ring-group-sales,60) exten => 2,n,VoiceMail(sales@default) exten => 2,n,Hangup()
5

Caller ID-Based Routing (VIP vs. General)

Route callers based on their phone number. VIP customers go directly to human agents; general inquiries go to AI for initial handling.

; Check caller ID against VIP list exten => s,1,GotoIf($[${DB_EXISTS(vip/${CALLERID(num)})}]?vip:general) exten => s,n(vip),Dial(SIP/priority-queue,30) exten => s,n,Hangup() exten => s,n(general),Dial(SIP/mihu-trunk/900,30) exten => s,n,Hangup()

Consiglio Pro: Trasferimenti Assistiti

Configura il tuo agente IA per eseguire trasferimenti assistiti agli agenti umani. L'IA può informare l'umano su ciò che è stato discusso prima di collegare il chiamante, risparmiando tempo e migliorando l'esperienza del cliente.

Passo 4 — Verificare e Testare

Dopo aver salvato la configurazione del trunk, verifica lo stato della connessione nella tua dashboard Mihu AI. Lo stato del trunk dovrebbe mostrare "Registrato" entro 30 secondi.

Check registration status

Torna su Impostazioni → Connettori → SIP e conferma che il trunk mostra un badge verde "Registrato". Se mostra "Fallito" o "Timeout", ricontrolla le tue credenziali e la configurazione di rete.

Make a test call

Da qualsiasi estensione PBX, componi il numero di interno assegnato all'agente vocale Mihu AI. Dovresti sentire il saluto dell'agente IA entro 2-3 secondi. Se la chiamata si connette ma non c'è audio, controlla l'inoltro delle porte RTP.

Risoluzione dei Problemi

Se riscontri problemi, ecco i problemi più comuni e le loro soluzioni:

La registrazione fallisce

Verifica che il nome utente SIP, la password e l'indirizzo del registrar siano corretti. Controlla che il tuo firewall consenta il traffico SIP in uscita sulla porta 5060 (UDP/TCP) o 5061 (TLS). Se il tuo PBX è dietro NAT, assicurati che l'IP pubblico sia configurato correttamente nelle impostazioni sia del PBX che di Mihu AI.

Audio unidirezionale o assente

Questo è quasi sempre un problema di NAT o RTP. Assicurati che le porte RTP (tipicamente 10000–20000) siano inoltrate attraverso il tuo firewall. Abilita STUN/TURN se il tuo PBX lo supporta per un migliore attraversamento NAT. Verifica anche che entrambi i lati concordino sui codec audio — G.711 μ-law (PCMU) è la scelta più sicura per la compatibilità.

Le chiamate cadono dopo 30 secondi

Questo indica solitamente una discrepanza nel timer di sessione SIP. Verifica che le impostazioni del timer di sessione del tuo PBX siano compatibili. Alcuni sistemi PBX inviano messaggi re-INVITE o UPDATE che devono essere gestiti correttamente — assicurati che non vengano bloccati dal tuo firewall.

Hai Bisogno di Aiuto?

Se hai ancora problemi, contatta il supporto Mihu AI con il tuo ID trunk e un log di traccia SIP dal tuo PBX. Questo aiuta il team a diagnosticare rapidamente il problema.