> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Conecte seu sistema telefônico e números existentes à OmniTech

<Note>
  Este guia ajudará você a entender e configurar a integração SIP. Se precisar
  de esclarecimentos durante a configuração, nossa equipe de suporte está disponível para ajudar.
</Note>

## O que é Integração SIP?

A integração SIP (Session Initiation Protocol) permite que você conecte seu sistema telefônico existente à OmniTech. Pense nisso como construir uma ponte entre sua estrutura atual de telefonia e nossa plataforma de IA. Isso significa que você pode:

* Utilizar seus números de telefone existentes com nossos assistentes de IA
* Manter seu sistema telefônico e provedor atual
* Realizar e receber chamadas através da sua própria estrutura
* Manter controle total sobre seus números
* Reduzir custos de operadora utilizando provedores VoIP locais com melhores tarifas

## Como Funciona

Quando você integra seu sistema telefônico à OmniTech:

1. **Chamadas de Entrada**: As chamadas para seus números são roteadas pelo seu sistema telefônico até nossos assistentes de IA
2. **Chamadas de Saída**: Nossos assistentes de IA realizam chamadas exibindo seus números
3. **Gerenciamento**: Você continua administrando seus números através do seu provedor atual
4. **Eficiência de Custos**: Aproveite as tarifas competitivas do seu provedor VoIP para terminação de chamadas

## Opções de Integração

Você pode conectar seu sistema telefônico à OmniTech de duas formas:

### 1. Integração via Ramal PBX

É como fornecer um “ramal” do seu sistema para nossa plataforma de IA:

* **O que é**: Conectar um ramal específico do seu PBX/sistema telefônico
* **Ideal para**:
  * Testar a integração
  * Direcionar ramais específicos para a IA
  * Configuração simples em sistemas já existentes
* **Você precisará de**:
  * Número do ramal (ex.: 1000)
  * Usuário e senha do ramal
  * Endereço do servidor PBX (ex.: pbx.suaempresa.com)

**Exemplo prático**:

Seu escritório utiliza os ramais 1001-1010 para a equipe
Você cria o ramal 1011 para o assistente de IA
Chamadas para 1011 vão para a IA
A IA pode realizar chamadas aparecendo como o ramal 1011

### 2. Integração Direta de Número (DID)

Conecta números específicos à nossa plataforma:

* **O que é**: Direcionar um ou mais números diretamente para a IA
* **Ideal para**:
  * Linhas dedicadas para IA
  * Números de atendimento ao cliente
  * Linhas de vendas ou suporte
* **Você precisará de**:
  * Número de telefone (ex.: +55 11 5555 0123)
  * Credenciais SIP fornecidas pelo seu provedor
  * Endereço do servidor SIP do provedor

**Exemplo prático**:

Você possui um número de suporte: +55 11 5555 0123
Você conecta esse número à IA
Todas as chamadas para +55 11 5555 0123 são atendidas pelo assistente de IA
A IA realiza chamadas exibindo +55 11 5555 0123

## Autenticação e Fluxo de Chamadas

### Configuração Bidirecional

A integração SIP utiliza as mesmas credenciais tanto para chamadas de entrada quanto de saída:

* **Chamadas de Entrada** (VoIP → OmniTech):

Seu sistema VoIP autentica usando usuário/senha
↓
As chamadas chegam à nossa plataforma
↓
O assistente de IA atende

* **Chamadas de Saída** (OmniTech → VoIP):
  A IA inicia a chamada
  ↓
  Nossa plataforma autentica no seu VoIP usando o mesmo usuário/senha
  ↓
  A chamada é encaminhada ao destino

### Sincronização de Credenciais

Para que a integração funcione corretamente:

1. As credenciais configuradas no painel da OmniTech devem corresponder exatamente às do seu VoIP
2. A mesma combinação de usuário/senha é usada em ambas as direções
3. Qualquer alteração deve ser atualizada nos dois sistemas

<Warning>
  Se você alterar as credenciais no seu sistema VoIP, lembre-se de atualizá-las
  no painel da OmniTech (e vice-versa) para manter a conexão ativa.
</Warning>

## Configurando Sua Integração

### Etapa 1: Reúna as Informações

Para Ramal PBX:

Número do ramal: ex.: 1000
Endereço do servidor: ex.: pbx.empresa.com
Usuário: usuário do ramal
Senha: senha do ramal

Para Número Direto:

Número de telefone: ex.: +55 11 5555 0123
Servidor SIP: ex.: sip.provedor.com
Usuário: fornecido pela operadora
Senha: fornecida pela operadora

### Etapa 2: Configuração no Painel

1. Acesse o painel da OmniTech
2. Vá em **Seus Números**
3. Clique em "Integrar SIP trunk"

### Etapa 3: Selecionar Tipo de SIP Trunk

No topo do formulário, selecione um dos tipos:

* **SIP Extension** - Utilize se você já possui uma credencial SIP (ramal) fornecida pelo seu provedor VoIP.
* **Phone Number (DID)** - Utilize se deseja integrar um número DID dedicado em vez de um ramal genérico.

Para Ramal PBX:
Número do ramal: ex.: 1000
Usuário: usuário do ramal
Senha: senha do ramal

<img height="200" src="https://mintcdn.com/omnitech-a4248806/06iazWsGpw98tpwL/resources/sip-integration-sip-type.png?fit=max&auto=format&n=06iazWsGpw98tpwL&q=85&s=23b79855758efe4695732276f15bd143" data-path="resources/sip-integration-sip-type.png" />

Para Número Direto:

Número de telefone: ex.: +55 11 5555 0123
Usuário: fornecido pela operadora
Senha: fornecida pela operadora

<img height="200" src="https://mintcdn.com/omnitech-a4248806/06iazWsGpw98tpwL/resources/sip-integration-did.png?fit=max&auto=format&n=06iazWsGpw98tpwL&q=85&s=422859a4e32c7a699a392967d0b98dac" data-path="resources/sip-integration-did.png" />

### Etapa 4: Configurações de Saída

Essas configurações controlam como a OmniTech envia chamadas de saída pelo seu provedor SIP.

* **SIP Address** - Insira o endereço/servidor do trunk SIP sem a porta.
* **Outbound Proxy (IP Fixo)** - Alguns provedores exigem que as chamadas sejam originadas de um único IP autorizado. Configure assim:
  * **Ativado (ON)** - Se seu provedor exigir IP fixo, ative esta opção. A OmniTech enviará todas as requisições de saída por um IP estático conhecido.
    Use apenas se o provedor exigir explicitamente.
  * **Desativado (OFF)** - Se o provedor aceitar chamadas de qualquer IP, mantenha desativado. Nesse caso, a OmniTech utilizará IPs dinâmicos.

SIP address: (ex.: pbx.empresa.com/sip.provedor.com)

<img height="200" src="https://mintcdn.com/omnitech-a4248806/06iazWsGpw98tpwL/resources/sip-integration-outbound.png?fit=max&auto=format&n=06iazWsGpw98tpwL&q=85&s=a5fcc28ece31261ec3ee9e4c2a5efd2e" data-path="resources/sip-integration-outbound.png" />

### Etapa 5: Configuração de Formato de Número

Define como os números serão formatados ao realizar chamadas:

1. **Internacional com +**

Formato: +\[código do país]\[número]
Exemplo: +55 11 5555 0123
SIP Request: sip:[+551155550123@your.pbx.com](mailto:+551155550123@your.pbx.com)

2. **Internacional sem +**

Formato: \[código do país]\[número]
Exemplo: 55 11 5555 0123
SIP Request: sip:[551155550123@your.pbx.com](mailto:551155550123@your.pbx.com)

3. **Formato Nacional**
   Formato: \[número local]
   Exemplo: 1141926265
   SIP Request: sip:[1141926265@your.pbx.com](mailto:1141926265@your.pbx.com)

### Etapa 6: Configurações de Entrada

Essas configurações determinam como a OmniTech recebe e autentica chamadas de entrada do seu provedor SIP.

1. **Our SIP Address** - A OmniTech atribui um URI SIP exclusivo de entrada `5wed79aeavr.sip.livekit.cloud`. Seu provedor deve configurar o envio de chamadas para esse endereço.
2. **IP Address (Whitelist IPs)** - Se seu provedor enviar chamadas a partir de IPs públicos fixos, selecione IP Address e adicione-os à whitelist.
3. **Username and Password** - Se o provedor suportar autenticação SIP, selecione Username and password. As mesmas credenciais de saída serão utilizadas.

<img height="200" src="https://mintcdn.com/omnitech-a4248806/06iazWsGpw98tpwL/resources/sip-integration-inbound.png?fit=max&auto=format&n=06iazWsGpw98tpwL&q=85&s=a8cba0ac7fbe2b77b22222cfbdaa9be4" data-path="resources/sip-integration-inbound.png" />

### Etapa 7: Seleção de País

Selecione o país onde seu SIP trunk está provisionado.

<img height="200" src="https://mintcdn.com/omnitech-a4248806/06iazWsGpw98tpwL/resources/sip-integration-country.png?fit=max&auto=format&n=06iazWsGpw98tpwL&q=85&s=e17887876c975293dcf71f3db31166b6" data-path="resources/sip-integration-country.png" />

### Etapa 8: Verificação

Após configurar:

1. Faça uma chamada de teste para seu número/ramal
2. Verifique se a IA atende
3. Utilize a função de teste para validar chamadas de saída

## Requisitos de Segurança

Suas credenciais SIP devem ser seguras:

* **Usuário**: Número do ramal ou usuário fornecido pela operadora
* **Senha deve conter**:
* 12 ou mais caracteres
* Números
* Letras maiúsculas e minúsculas
* Caracteres especiais recomendados

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso usar múltiplos números?">
    Sim! Você pode integrar vários ramais ou números diretos à nossa plataforma.
  </Accordion>

  {" "}

  <Accordion title="Perco o controle dos meus números?">
    Não, você mantém total controle através do seu provedor atual. A integração
    apenas cria a conexão entre seu sistema e nossa plataforma.
  </Accordion>

  {" "}

  <Accordion title="Posso continuar usando meus números normalmente?">
    Sim, você pode configurar regras de roteamento para decidir quais chamadas
    vão para a IA e quais seguem para seu sistema convencional.
  </Accordion>

  {" "}

  <Accordion title="Posso alterar configurações depois?">
    Sim, você pode atualizar as configurações a qualquer momento pelo painel.
  </Accordion>

  <Accordion title="Como isso reduz custos de chamada?">
    Ao utilizar seu próprio provedor VoIP, você aproveita tarifas locais e acordos existentes,
    geralmente mais competitivos do que tarifas padrão de operadora.
  </Accordion>
</AccordionGroup>

***

<Note>
  Precisa de ajuda para configurar? Nossa equipe de suporte é especializada em
  integrar sistemas telefônicos e pode orientá-lo durante todo o processo.
</Note>