Conectar Telefonia SIP
A IA do ConectAI atende ligações por trunks SIP. Você pode usar parceiros homologados (Athostec, Retell AI, Twilio) ou seu próprio trunk.
Pré-requisito: ter o DID em formato internacional (ex.: 5511999999999, sem + e sem espaços) e — se for SIP direto — credenciais do trunk (host, port, user, password).
Providers suportados
| Provider | Tipo de integração | Indicado para |
|---|---|---|
| Athostec | Parceiro nacional, suporte em pt-BR | Maioria dos ISPs |
| Retell AI | Parceiro internacional, latência otimizada | ISPs que priorizam latência |
| Twilio | Provider global | Operações multi-país |
| Custom | Trunk SIP próprio | Provedores com PBX já em casa |
Setup — passo a passo
Acesse
/config/canais→ + Adicionar canal → Telefonia SIP.Preencha os campos básicos:
Campo Detalhe Nome do canal Identificação interna (ex.: “Linha principal”) Provider Athostec / Retell / Twilio / Custom DID (Número) Formato internacional 5511999999999(Apenas Custom) preencha o bloco Credenciais SIP (recolhível):
- Host — ex.:
sip1.athostec.com.br - Porta — geralmente
5060(default) - Usuário — usuário SIP
- Senha — credencial (com botão show/hide)
Para Athostec/Retell/Twilio, o ConectAI usa a integração nativa do parceiro — você não precisa do bloco SIP detalhado.
- Host — ex.:
Salvar. O canal é criado e o DID é registrado automaticamente em
/config/telefonia.Verifique a rota DID → agente em
/config/telefonia. O DID precisa estar roteado para o agente IA que você quer que atenda essa linha.Se você só tem um agente, isso é automático. Se tem múltiplos, escolha qual atende cada DID.
Teste com seu celular. Disque para o DID. Em ~2-3 toques a IA atende com a saudação configurada.
Como rotear DIDs entre agentes
Em /config/telefonia você vê uma tabela:
| DID | Provider | Agente que atende | Status |
|---|---|---|---|
5511999999999 | Athostec | Agente Principal | Conectado |
5511888888888 | Retell | Agente Cobrança | Conectado |
Para mudar a rota, clique no DID e selecione outro agente.
Latência típica
A latência fim-a-fim (cliente fala → IA responde) depende do provider:
| Provider | Latência média |
|---|---|
| Retell | ~700ms |
| Athostec | ~1.000ms |
| Twilio | ~1.200ms |
| Custom (varia) | 1.000-2.000ms |
Latência alta vira péssima experiência. Se você tiver problema, abra um ticket — geralmente é resolvível ajustando o trunk.
Gravação de chamada
A gravação de chamadas depende da feature featRecording no seu plano:
- Starter — sem gravação
- Pro — gravação opcional
- Enterprise — gravação por padrão
Quando ligada, cada chamada gera um arquivo de áudio acessível em /operacoes/interacoes ou /historico no card da chamada.
LGPD e gravação
LGPD: o ConectAI toca uma mensagem de aviso no início da chamada quando a gravação está ativada (ex.: “Esta ligação pode ser gravada para fins de qualidade”). Não desative essa mensagem sem orientação do seu jurídico.
Troubleshooting
”DID não atende”
- Verifique se o canal está toggled on em
/config/canais - Verifique se a rota DID → agente está configurada em
/config/telefonia - Cheque se o agente está ativo (não pausado)
“Latência alta / cortes”
- Geralmente é problema de trunk — abra ticket com o provider
- Cheque rede/internet do PBX se for Custom
”Eco / áudio metálico”
- Configuração de codec — fale com seu provider para usar G.711 µ-law ou G.722
”Cliente diz que IA fala muito rápido”
- Ajuste em
/ia/agentes/[id]→ Geral → Velocidade de fala (ainda em rollout, pode estar como “Em breve”)