> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Problemas de Integração SIP

> Solucione problemas de conexão de tronco SIP e problemas de configuração

Este guia ajuda a resolver problemas comuns de integração SIP ao conectar seu provedor SIP à Sua SofIA.

## Estratégia de Teste

1. **Teste chamadas de saída primeiro** - mais fácil de configurar
2. **Teste chamadas de entrada em segundo** - depois que a saída funcionar

## Problemas de SIP de Saída

### Problemas de Conexão

**Tronco SIP não conectando para chamadas de saída:**

1. **Verifique as Credenciais SIP** - nome de usuário, senha, detalhes do servidor
2. **Seleção de Tipo de Telefone** - verifique com o provedor o tipo correto
3. **Configuração de IP Fixo** - geralmente habilite e insira o endereço IP do provedor
4. **Configurações do Provedor** - verifique configurações de codec, transporte, porta

### Problemas de Registro SIP

**Importante:** Plataforma Sua SofIA:

* **NÃO envia mensagens SIP REGISTER** para seu provedor
* **NÃO requer recebimento de SIP REGISTER** do seu provedor
* Usa **autenticação de chamada direta** em vez disso

### Testando Saída

1. Configure as configurações do tronco SIP
2. **Faça uma chamada de teste direta** pela plataforma
3. Verifique os logs de chamadas para erros

## Problemas de SIP de Entrada

### Configuração de Autenticação

**Para chamadas de entrada:**

1. **Use Autenticação por IP** - em vez de nome de usuário/senha
2. **Adicione IPs do Provedor à Lista de Permissões** - adicione TODOS os IPs do provedor em nossa plataforma
3. **Configuração do Provedor - IMPORTANTE**
   * **Use nosso domínio FQDN** para roteamento (NÃO o IP de saída)
   * **Envie para o domínio** - garante roteamento correto
   * **NÃO envie para IP** - causa problemas de roteamento

### Problemas Comuns de Entrada

**Chamadas não alcançando o assistente:**

* Verifique se todos os IPs do provedor estão na lista de permissões
* Garanta que o provedor envie para o domínio FQDN (não IP)
* Verifique o formato do número de destino

## Problemas Gerais

**Problemas de rede:**

* Verifique a conectividade da internet
* Verifique se não há firewall bloqueando tráfego SIP

**Compatibilidade do provedor:**

* Verifique se o provedor suporta chamadas diretas (sem registro)
* Verifique suporte de autenticação por IP

## Lista de Verificação de Teste

### Antes de Entrar em Contato com o Suporte

1. **Teste de Saída:**
   * [ ] Credenciais verificadas
   * [ ] Tipo de telefone selecionado corretamente
   * [ ] IP fixo habilitado com endereço IP do provedor
   * [ ] Chamada de teste direta tentada

2. **Teste de Entrada:**
   * [ ] Autenticação por IP configurada
   * [ ] Todos os IPs do provedor na lista de permissões em nossa plataforma
   * [ ] Provedor configurado para enviar para domínio FQDN (não IP direto)
   * [ ] Chamada de teste de número externo

3. **Geral:**
   * [ ] Conectividade de rede verificada

## FAQ

### Transferência de Chamada Telefônica Não Funciona

**P: Por que a função Transferir Chamada Telefônica não está funcionando?**

**R:** Se as transferências de chamada estiverem falhando, tente estas soluções:

1. **Verifique as Configurações de Transferência SIP:**
   * Defina transferência de chamada para modo "Avançado"
   * Use formato SIP URI: `sip:número@servidor-sip`
   * Exemplo: `sip:+1234567890@sip.provider.com:5060`

2. **Verifique o Suporte do Provedor:**
   * Confirme se seu provedor SIP suporta SIP REFER
   * Verifique se a funcionalidade de transferência está habilitada em sua conta
   * Alguns provedores requerem configuração específica para transferências

3. **Teste Diferentes Formatos:**
   * Tente com porta: `sip:+1234567890@servidor-sip:5060`
   * Tente sem porta: `sip:+1234567890@servidor-sip`
   * Tente formato simples: `sip:+1234567890`

4. **Verifique o Destino:**
   * Garanta que o número de destino seja acessível
   * Teste se o número atende chamadas normalmente
   * Verifique se o número está bloqueado ou restrito

5. **Problemas Comuns:**
   * Provedor não suporta SIP REFER
   * Formato SIP URI incorreto
   * Rede/firewall bloqueando solicitações de transferência
   * Número de destino não atendendo

**Passos de solução de problemas:**

1. Teste primeiro com um número conhecido que funciona
2. Tente diferentes formatos de SIP URI
3. Entre em contato com seu provedor SIP para confirmar suporte de transferência
4. Verifique logs de chamadas para mensagens de erro específicas

## Obtendo Ajuda

**Ao entrar em contato com o suporte, forneça:**

* Mensagens de erro dos logs de chamadas
* Configuração do tronco SIP
* Resultados de teste (saída e entrada)
* Detalhes da tentativa de transferência e formato SIP URI usado