O que é um Conector SIP?
Um Servidor Conector SIP atua como a ponte entre a sua infraestrutura PBX existente e a plataforma de agentes de voz da Mihu AI. Ele traduz a sinalização SIP (Session Initiation Protocol) para que as chamadas recebidas e efetuadas das suas extensões PBX possam ser encaminhadas para — e tratadas por — um agente de voz IA.
Uma vez conectado, as suas extensões PBX comportam-se como se estivessem a ligar para outro ramal interno, mas do outro lado, um agente IA totalmente capaz responde, qualifica leads, agenda compromissos ou trata consultas de suporte em tempo real.
Sistemas PBX Compatíveis
O conector SIP da Mihu AI funciona com 3CX, Asterisk, FreePBX e qualquer PBX baseado em SIP conforme os padrões. São suportados deployments na cloud e on-premise.
Pré-requisitos
Antes de começar, certifique-se de ter o seguinte 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:
5060for UDP/TCP,5061for TLS) - At least one available PBX extension to assign to the voice agent
Passo 1 — Criar o Servidor Conector SIP
Navegue até a secção de Conectores no seu painel Mihu AI e crie um novo Servidor Conector SIP. Isto regista um ponto de conexão para o qual o seu PBX enviará as chamadas.
Open the SIP Connector panel
No seu painel Mihu AI, vá a Definições → Conectores → SIP e clique em "Novo Servidor SIP". Dê-lhe um nome descritivo que identifique o PBX ao qual se conecta, como "Escritório-3CX-Principal" ou "Clínica-Asterisk-PBX".
Enter the server connection details
Preencha o hostname ou IP do servidor, a porta SIP e selecione o protocolo de transporte. TLS é recomendado para ambientes de produção para garantir a sinalização encriptada de chamadas.
Considerações NAT
Se o seu PBX está atrás de um firewall NAT, use o endereço IP público ou FQDN aqui — não o IP privado/interno. Certifique-se de que as portas 5060-5061 e o seu intervalo de mídia RTP (ex. 10000-20000) estão encaminhados corretamente.
Passo 2 — Adicionar um Trunk SIP
Com o servidor criado, agora precisa de adicionar um trunk SIP — este define as credenciais de autenticação específicas e as regras de roteamento que ligam as suas extensões PBX ao agente de voz.
Create a new trunk on the server
Dentro do Servidor SIP que acabou de criar, clique em "Adicionar Trunk". Cada trunk representa uma conexão lógica entre um conjunto de extensões PBX e um agente de voz Mihu AI.
Set authentication credentials
Insira o nome de utilizador e a palavra-passe SIP. Estes devem corresponder às credenciais configuradas no seu PBX para o trunk de saída. Use uma palavra-passe forte e única para segurança.
Passo 3 — Configurar os Detalhes do Trunk
Aqui está uma tabela de referência dos campos-chave que precisará de configurar ao definir o seu 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) |
Casos de Uso Reais
Diferentes indústrias usam trunks SIP com a Mihu AI de diferentes formas. Aqui estão quatro cenários comuns que mostram como as empresas encaminham chamadas através do seu PBX para um agente IA:
Saúde: Triagem Fora de Horário
Route all calls outside business hours to an AI agent that collects patient symptoms, schedules urgent callbacks, and handles prescription refill requests.
Time condition: 6PM–8AM → Extension 900 (Mihu AI)
Fallback: Voicemail after 3 rings
Automotivo: Overflow do Departamento de Serviço
When all service advisors are busy, overflow calls go to AI that books service appointments, provides repair status updates, and quotes common services.
Ring group 200 (Service) → No answer 20s → Extension 901 (Mihu AI)
Imobiliário: Qualificação de Leads
Incoming leads from property listings hit AI first to qualify budget, timeline, and preferences before routing hot leads directly to available agents.
DID +1-555-HOMES → Extension 902 (Mihu AI)
Qualified lead → Transfer to Ring Group 300
E-Commerce: Estado de Pedidos e Devoluções
Handle high-volume order inquiries with AI that looks up tracking info, processes return requests, and escalates complex issues to human support.
IVR option 1 (Order Status) → Extension 903 (Mihu AI)
IVR option 2 (Returns) → Extension 904 (Mihu AI)
Cenários de Roteamento PBX
Veja como configurar cenários de roteamento comuns no seu PBX para funcionar com a Mihu AI:
Exemplos de Configuração PBX
Copie estes padrões para o plano de marcação do seu PBX ou regras de roteamento
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.
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.
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.
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.
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.
Dica Pro: Transferências Assistidas
Configure o seu agente IA para realizar transferências assistidas para agentes humanos. A IA pode informar o humano sobre o que foi discutido antes de conectar o chamador, poupando tempo e melhorando a experiência do cliente.
Passo 4 — Verificar e Testar
Após guardar a configuração do trunk, verifique o estado da conexão no seu painel Mihu AI. O estado do trunk deverá mostrar "Registado" em 30 segundos.
Check registration status
Volte a Definições → Conectores → SIP e confirme que o trunk mostra um emblema verde "Registado". Se mostrar "Falhou" ou "Timeout", verifique novamente as suas credenciais e configuração de rede.
Make a test call
A partir de qualquer extensão PBX, marque o número de extensão atribuído ao agente de voz Mihu AI. Deverá ouvir a saudação do agente IA em 2-3 segundos. Se a chamada conecta mas não há áudio, verifique o encaminhamento de portas RTP.
Resolução de Problemas
Se encontrar problemas, aqui estão os problemas mais comuns e as suas soluções:
O registo falha
Verifique que o nome de utilizador SIP, a palavra-passe e o endereço do registrar estão corretos. Confirme que o seu firewall permite tráfego SIP de saída na porta 5060 (UDP/TCP) ou 5061 (TLS). Se o seu PBX está atrás de NAT, certifique-se de que o IP público está corretamente configurado em ambos os lados.
Áudio unidirecional ou sem áudio
Isto é quase sempre um problema de NAT ou RTP. Certifique-se de que as portas RTP (tipicamente 10000–20000) estão encaminhadas através do seu firewall. Ative STUN/TURN se o seu PBX suportar para melhor travessia NAT. Verifique também que ambos os lados concordam nos codecs de áudio — G.711 μ-law (PCMU) é a escolha mais segura para compatibilidade.
As chamadas caem após 30 segundos
Isto geralmente indica uma incompatibilidade no temporizador de sessão SIP. Verifique que as definições do temporizador de sessão do seu PBX são compatíveis. Alguns sistemas PBX enviam mensagens re-INVITE ou UPDATE que precisam de ser tratadas corretamente — certifique-se de que não estão a ser bloqueadas pelo seu firewall.
Precisa de Ajuda?
Se ainda tiver problemas, contacte o suporte Mihu AI com o seu ID de trunk e um log de rastreio SIP do seu PBX. Isto ajuda a equipa a diagnosticar rapidamente o problema.