> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/gestao-de-numeros/configuracao-de-ligacoes-sip.md).

# Configuração de ligações (SIP)

A funcionalidade de Ligações permite que seu número receba e realize chamadas diretamente pelo sistema, utilizando ligações via WhatsApp e tecnologia SIP.

### **Visão Geral**

Com as Ligações habilitadas, você poderá:

* Receber chamadas de clientes
* Realizar chamadas via integração SIP
* Exibir botão de chamada no app ou site
* Permitir retorno de chamadas via WhatsApp
* Definir horários de atendimento

{% hint style="warning" %}

### Pré-requisito

Antes de utilizar a funcionalidade de chamadas, é necessário:

*  Ter no mínimo **2000 mensagens enviadas** no número.
* Caso esse requisito não seja atendido, a funcionalidade pode ficar indisponível.
  {% endhint %}

### **Ativar Ligações**

Para ativar:

1. Acesse **Configuração de ligações**
2. Localize a seção **Ligações**
3. Ative o botão (toggle)

📌 Status possíveis:

* ✅  **Habilitado**: chamadas ativas
* ❌  **Desativado**: chamadas bloqueadas temporariamente

***

#### **Dados do SIP (Configuração Técnica)**

<figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2FfJCWS0xNqx3VDUkwEMiE%2Fimage.png?alt=media&amp;token=4c9a1970-8375-4769-a1d6-b1380d4cf7d6" alt=""><figcaption></figcaption></figure>

Esses dados são usados para integrar com sistemas externos (softphones, PABX, etc).

#### Roteamento de chamadas (Inbound)

Aqui você define **como as chamadas recebidas serão tratadas**. Existem duas opções:

#### 1. Gerenciado por Agente IA

As chamadas são processadas pela plataforma Agentes IA e encaminhadas automaticamente para seus agentes.

**Indicado para:**

* Atendimento automatizado
* Uso com IA ou bots
* Distribuição inteligente de chamadas

**Como funciona:**

* A chamada entra na plataforma
* Passa pelo sistema de roteamento
* É direcionada para agentes ou fluxos configurados

***

#### 2. Entrega Direta (Trunk SIP)

As chamadas são enviadas diretamente para o seu sistema de telefonia (PABX) via SIP.

**Indicado para:**

* Empresas que já possuem PABX ou sistema VoIP
* Uso com softphones ou centrais telefônicas
* Controle total da telefonia

**Como funciona:**

* A chamada não passa por roteamento interno
* Vai direto para o seu sistema externo (softphones, PABX, etc).

#### **Parâmetros disponíveis**

| Campo               | Descrição                                               |
| ------------------- | ------------------------------------------------------- |
| **Servidor (Host)** | Endereço do servidor SIP                                |
| **Porta**           | Porta de conexão (ex: 5061)                             |
| **Usuário**         | Identificador do ramal                                  |
| **Senha**           | Credencial de autenticação                              |
| **Transporte**      | Protocolo (ex: TLS)                                     |
| **Codecs**          | <p>Formatos de áudio suportados<br>opus, alaw, ulaw</p> |

#### Exemplo de configuração SIP

```
Servidor: metasip.otima.io
Porta: 5061
Usuário: 551147371485
Senha: ***************
Transporte: TLS
Codecs: opus, alaw, ulaw
```

#### Onde usar esses dados

Você pode configurar em:

* Softphones (Zoiper, MicroSIP, etc.)
* Sistemas de telefonia (PABX IP)
* Aplicações VoIP personalizadas

***

### **Botão de Ligações**

Permite exibir um botão de chamada para usuários no seu aplicativo ou site.

<figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2FlW91gasQnVf67g601xVh%2Fimage.png?alt=media&amp;token=573f5efd-8395-4b19-a7b0-a9dba86fc7de" alt=""><figcaption></figcaption></figure>

#### Como funciona

* Quando ativado, o botão fica visível para clientes
* Ao clicar, o cliente pode iniciar uma chamada

#### Configuração

1. Vá até **Botão de ligações**
2. Ative ou desative conforme necessário

Status:

* Habilitado: botão visível
* Desativado: botão oculto

***

### **Permissão de Retorno de Chamada**

Permite que o WhatsApp solicite ao usuário autorização para retornar uma chamada.

<figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2FnFqJlcqwPrhcYdd7aBfd%2Fimage.png?alt=media&amp;token=bd3d4625-11fe-406e-8f85-636cc02c01e6" alt=""><figcaption></figcaption></figure>

#### Quando usar

* Para facilitar o contato após uma chamada perdida
* Melhorar conversão de atendimento

#### Como ativar

1. Localize **Permissão de retorno da chamada**
2. Ative a opção

Resultado:

* O usuário poderá autorizar retorno direto pelo WhatsApp

***

### **Horários de Atendimento**

Define quando seu número pode receber chamadas.

<figure><img src="https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fech0v4OAuw7OeuwoISIc%2Fuploads%2F4BOCpBnkcOa13gYFY7GD%2Fimage.png?alt=media&amp;token=fa2f811c-4140-47fe-a879-d74e516ffdbf" alt=""><figcaption></figcaption></figure>

#### Configuração padrão

Disponível 24h

***

#### Como editar

1. Clique em **Editar**
2. Defina:
   * Dias da semana
   * Horários específicos
3. Salve as alterações

***

#### Boas práticas

* Defina horários alinhados ao atendimento humano
* Evite chamadas fora do expediente
* Combine com mensagens automáticas

***

### Recomendações

* Nunca compartilhe seus dados SIP publicamente
* Use equipamentos compatíveis com codecs informados
* Garanta conexão estável para melhor qualidade de chamada
* Teste a configuração após ativar

***

### Solução de Problemas

#### **Não consigo fazer/receber chamadas**

Verifique:

* Se as Ligações estão habilitadas
* Se atingiu o mínimo (2000) de mensagens
* Se os dados SIP estão corretos
* Conexão com internet

***

#### **Áudio com problemas**

* Confirme codecs suportados (opus, alaw, ulaw)
* Verifique firewall/rede
* Teste outro dispositivo

***

#### **Erro de autenticação SIP**

* Usuário ou senha incorretos
* Porta ou servidor errado
* Transporte incompatível