> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/ferramentas-e-integracoes/wavoip-ligacoes-pelo-whatsapp.md).

# Wavoip - Ligações pelo WhatsApp

## Wavoip - Ligações pelo WhatsApp

O Norux possui integração nativa com o **WaVoIP**, plataforma de voz sobre IP que permite realizar e receber **ligações pelo WhatsApp** diretamente pelo painel, sem precisar de telefonia convencional.

A integração funciona com **todos os canais de WhatsApp** do Norux — API Oficial (WABA), Baileys, WebJS, Evolution API, Z-API e demais conexões. A interface é a mesma independentemente do tipo de canal utilizado.

{% hint style="info" %}
**O WaVoIP é uma plataforma externa.** Para criar conta, adquirir planos ou resolver qualquer problema técnico relacionado à telefonia, acesse diretamente: [wavoip.com](https://wavoip.com/)
{% endhint %}

***

#### O que é possível com a integração

* Realizar e receber **ligações de voz pelo WhatsApp** dentro do ticket de atendimento
* **Gravar todas as chamadas** e acessar as gravações pelo painel
* Acompanhar **métricas e histórico de chamadas** por horário, token e canal
* Fazer **disparo de ligações em massa** com arquivo de áudio
* Usar um **softphone integrado** (webphone) diretamente no frontend do Norux
* Integrar com **PBX/tronco SIP** existente na sua operação
* Conectar **múltiplos atendentes ligando pelo mesmo número** com rastreamento individual por ramal

***

#### Pré-requisitos

* Conta ativa no Norux com pelo menos um canal de WhatsApp conectado
* Conta criada no WaVoIP ([wavoip.com](https://wavoip.com/))
* Dispositivo criado no painel do WaVoIP

{% hint style="info" %}
A criação de conta no WaVoIP é **gratuita** e inclui dispositivos de teste para validar a integração antes de contratar um plano pago.
{% endhint %}

***

#### Como conectar

A conexão com o WaVoIP é feita diretamente pelo frontend do Norux, sem necessidade de acessar as configurações de canal individualmente.

1. Acesse **Gestão Comercial → WaVoIP** no menu lateral
2. Clique em **Conectar** ou **Adicionar dispositivo**
3. O sistema exibirá um **QR Code** — leia-o diretamente pela interface do WaVoIP
4. Informe o **hash** gerado para concluir a vinculação
5. A conexão é ativada automaticamente

{% hint style="warning" %}
Toda a configuração de telefonia — QR Code, hash, tokens e softphone — é gerenciada pelo **WaVoIP**. Em caso de dificuldade na conexão ou qualquer problema técnico relacionado às ligações, entre em contato diretamente com o suporte da WaVoIP em [wavoip.com](https://wavoip.com/).
{% endhint %}

***

#### Fazer uma ligação no atendimento

Com a integração ativa, um botão de ligação aparece dentro de qualquer ticket de atendimento:

1. Abra um atendimento no Norux
2. No painel lateral de detalhes do ticket, clique no **ícone de telefone**
3. A chamada é iniciada imediatamente para o número do contato via WhatsApp
4. Ao finalizar, a chamada é registrada automaticamente como **nota de ligação** no histórico do chat

***

#### Softphone (Webphone) integrado

O WaVoIP disponibiliza um **softphone nativo** diretamente no frontend do Norux, acessível pelo ícone de webphone na barra superior.

No softphone você pode:

* Gerenciar os números e tokens conectados
* Configurar preferências de ligação
* Realizar diagnóstico da conexão (verificar se o microfone, áudio e rede estão funcionando)
* Adicionar novos tokens manualmente ou vinculados a um canal específico
* Acompanhar o status das ligações em andamento

***

#### Disparo de ligações em massa

É possível realizar disparos em lote utilizando um arquivo de áudio pré-gravado.

1. Acesse **Envio em Massa** no menu lateral
2. Selecione a opção de **disparo de ligações**
3. Preencha os campos:

| Campo                | Descrição                                        |
| -------------------- | ------------------------------------------------ |
| **Token**            | Token do dispositivo WaVoIP que fará os disparos |
| **Sessão**           | Canal de WhatsApp vinculado                      |
| **Números**          | Lista de telefones que receberão a ligação       |
| **E-mail**           | E-mail de notificação da campanha                |
| **Arquivo de áudio** | Áudio que será reproduzido na ligação            |

4. Inicie o disparo

{% hint style="warning" %}
Ligações em massa para contatos que nunca interagiram com o número aumentam o risco de denúncias e banimento. Recomenda-se ligar apenas para contatos que já tiveram interação prévia com o número. Consulte as boas práticas anti-banimento antes de usar este recurso.
{% endhint %}

***

#### Painel de métricas (Gestão Comercial → WaVoIP)

Acesse **Gestão Comercial → WaVoIP** para acompanhar todas as atividades de ligação da sua operação.

**Aba: Login e Chamadas**

Autenticação com a conta WaVoIP para visualizar o histórico completo:

| Campo                                   | Descrição                                 |
| --------------------------------------- | ----------------------------------------- |
| **E-mail**                              | E-mail cadastrado no WaVoIP               |
| **Senha**                               | Senha da conta WaVoIP                     |
| **Botão Autorizar e Carregar Chamadas** | Valida as credenciais e exibe o histórico |

**Aba: Por Token**

Consulta rápida filtrada por dispositivo:

| Campo                     | Descrição                           |
| ------------------------- | ----------------------------------- |
| **Token WaVoIP**          | Selecione o token desejado          |
| **Botão Buscar Chamadas** | Filtra e exibe o histórico do token |

**O que você verá**

* **Histórico de chamadas:** data, hora, duração, direção (entrada/saída) e status
* **Horários de pico:** gráfico de distribuição das chamadas ao longo do dia
* **Gravações:** coluna com botão para ouvir cada chamada
* **Métricas por token:** volume e desempenho por dispositivo/canal

{% hint style="info" %}
As gravações ficam disponíveis de acordo com o **plano contratado no WaVoIP**. Caso um áudio não carregue, verifique se a chamada ainda está dentro do prazo de retenção configurado no plano.
{% endhint %}

***

#### Integração SIP / PBX

Se sua operação já utiliza um PBX ou tronco SIP, o WaVoIP permite integrar os números de WhatsApp a essa infraestrutura existente via protocolo SIP. Com isso, é possível receber e fazer ligações pelo WhatsApp dentro do seu sistema de telefonia atual, sem perceber diferença na interface.

Para configurar a integração SIP, entre em contato com o suporte da WaVoIP: [wavoip.com](https://wavoip.com/)

***

#### Suporte e problemas

A integração WaVoIP é **100% gerenciada pelo frontend do Norux**, incluindo o softphone, QR Code, tokens e métricas. Como a responsabilidade técnica da telefonia é da WaVoIP, qualquer ajuste ou problema relacionado a:

* Qualidade de chamada
* Conexão do dispositivo
* Gravações
* Tokens e dispositivos
* Softphone

deve ser tratado diretamente com o suporte da WaVoIP em [**wavoip.com**](https://wavoip.com/).

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.norux.chat/admin/ferramentas-e-integracoes/wavoip-ligacoes-pelo-whatsapp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
