> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Configure Telefonia, Notificações Push e WaVoIP
> Habilite ligações de voz pelo painel (WABA, WaVoIP ou SIP), ative as notificações Web Push do aplicativo e configure a integração WaVoIP para ligar pelo WhatsApp direto do atendimento.
Esta página reúne os recursos que expandem o PanÐá Zap para além do atendimento convencional por texto: telefonia e voz (ligações via WhatsApp Oficial, WaVoIP ou SIP corporativo) e notificações push do aplicativo instalado como PWA. Consulte esta seção sempre que precisar habilitar chamadas de voz diretamente do painel de atendimento ou garantir que a equipe receba notificações em tempo real mesmo com o aplicativo em segundo plano.
Além dos recursos abaixo, existe uma API de nível de tenant que permite integrar a plataforma a sistemas externos (enviar mensagens ou buscar informações de atendimentos de forma programática). Esse guia de API é voltado a desenvolvedores e não faz parte do escopo desta página.
## Ligações no PanÐá Zap (Telefonia e Voz)
**Quem usa:** Administrador (configuração); Supervisor e Atendente (uso diário das ligações).
**O que é:** o PanÐá Zap funciona como **centralizadora** das operações de voz: você atende e realiza chamadas diretamente pelo painel, sem trocar de ferramenta.
A plataforma **não é um provedor de telefonia**: ela se conecta a serviços externos que fornecem a infraestrutura de voz.
Existem três modalidades de ligação disponíveis:
| Modalidade | Tecnologia | Indicado para |
| ---------------------- | ------------------------------ | --------------------------------------------------------- |
| **API Oficial (WABA)** | WebRTC nativo Meta | Quem usa canal WhatsApp Oficial, sem ferramentas externas |
| **WaVoIP** | WhatsApp não oficial (Baileys) | Quem usa conexões não oficiais e já tem conta WaVoIP |
| **Telefonia SIP** | Trunk SIP / PABX corporativo | Quem já tem infraestrutura de telefonia VoIP própria |
### Ligações via API Oficial (WABA)
A modalidade mais completa para quem usa o canal WhatsApp Oficial: as chamadas acontecem dentro do próprio WhatsApp do cliente, sem aplicativos externos, gerenciadas direto pelo painel. Disponível para assinantes com canal WABA ativo (quem conecta pelo App nativo via OAuth já recebe a permissão de chamadas aprovada automaticamente).
* **Receber ligações:** ative as chamadas WebRTC nas configurações do canal; as chamadas recebidas tocam para os atendentes conforme a regra de roteamento configurada.
* **Fazer ligações:** é preciso primeiro solicitar uma **permissão de chamada** ao contato; ele autoriza pelo WhatsApp e a permissão vale por **72 horas**. Após o aceite, clique em **Ligar** no painel de atendimento.
**Regras de roteamento disponíveis:**
| Regra | Comportamento |
| ---------------------------------- | ---------------------------------------------------------- |
| **Tocar para todos os atendentes** | Toca para todos; o primeiro que atender assume |
| **Apenas o atendente do ticket** | Toca só para o responsável daquele contato |
| **Rodízio na fila** | Distribui conforme as regras da fila do canal |
| **Fallback escalonado** | Toca para um usuário por vez, escalando se ninguém atender |
Acesse **Configurações → Integrações → Meta → WhatsApp** e selecione o canal WABA.
Ative as chamadas WebRTC nas especificações do canal.
Configure o roteamento em **Configurações → Roteamento de chamadas WABA**.
Abra o atendimento → **Detalhes do contato → Telefonia → WABA** → envie a solicitação de permissão → aguarde o aceite → **Ligar**.
### Ligações via WhatsApp (WaVoIP)
Usa conexões **não oficiais (Baileys)** e requer uma conta ativa no serviço externo WaVoIP (serviço pago e independente da plataforma; contrate um plano em wavoip.com antes de configurar). O passo a passo completo de conexão está na seção [WaVoIP - Ligações pelo WhatsApp](#wavoip-ligações-pelo-whatsapp), mais adiante nesta página.
* O gerenciamento e histórico de chamadas fica em **Gestão Comercial → WaVoIP** (autenticação por login/senha ou token).
* O envio de ligações em massa (arquivo de áudio para uma lista de números) fica em **Comunicação e Marketing → Envio em Massa → WaVoIP**.
### Telefonia SIP (PABX / Trunk VoIP)
Conecta a plataforma ao sistema de telefonia corporativo via protocolo SIP, habilitando um **Webphone** integrado para cada atendente fazer/receber chamadas do trunk direto pelo painel.
**Pré-requisitos do servidor SIP:** precisa suportar obrigatoriamente **WebRTC** (comunicação em tempo real pelo navegador) e **WSS** (WebSocket Secure), geralmente na porta 8089. Instalações padrão do Asterisk já suportam WSS nessa porta: confirme com o responsável pelo servidor.
**Configuração por usuário** (cada atendente recebe um ramal específico): acesse **Usuários** no painel Admin, edite o usuário e expanda **Config SIP**.
| Campo | Descrição |
| ------------------ | -------------------------------------------------- |
| **Habilitar SIP** | Toggle que ativa o SIP para aquele usuário |
| **Transporte SIP** | WS (padrão), ou UDP se o provedor não suportar WSS |
| **Usuário SIP** | Login do ramal |
| **Senha SIP** | Senha do ramal |
| **Servidor SIP** | IP ou domínio do servidor |
| **Porta SIP** | Padrão 8089 |
Salve: o SIP Webphone fica disponível para aquele usuário no painel de atendimento, já populando o número do contato para discagem.
### Registro e histórico
Independente da modalidade usada, todas as ligações ficam registradas em **Gestão Comercial → Log Ligações**, com filtros por:
* **Data início/fim**
* **Status** (Encerrada, Chamando, Falhou, Perdida)
* **Agente**
* **Número Origem/Destino**
Use **Exportar CSV** para baixar o histórico filtrado.
**Benefícios e quando usar:** escolha a modalidade pela infraestrutura que sua operação já tem: WABA para quem já opera 100% na API Oficial e quer telefonia nativa sem serviços externos; WaVoIP para quem usa conexões não oficiais e não tem trunk SIP corporativo; SIP para empresas que já possuem PABX/trunk VoIP próprio e querem um webphone integrado ao painel.
O suporte da plataforma cobre **apenas a integração** (configuração de token/credenciais dentro do sistema). Problemas na infraestrutura do WaVoIP, na configuração do servidor SIP/PABX ou no App da Meta são de responsabilidade do assinante ou do profissional de TI responsável por aquele serviço externo: a plataforma **não é uma operadora de telefonia**, apenas centraliza e exibe as chamadas cuja infraestrutura de voz (número, trunk, minutos) é fornecida por terceiros.
O campo **SMS** (nas opções de telefonia do atendimento) só aparece se houver um gateway de SMS configurado em **Configurações → Integrações**.
## Notificações Aplicativo (web push)
**Quem usa:** Atendente, Supervisor e Administrador (uso diário); Super-Administrador (customização de ícone e nome do app).
**O que é:** a plataforma usa a tecnologia **PWA (Progressive Web App)**, que entrega uma experiência de aplicativo completa direto no celular ou computador, sem precisar baixar de lojas como App Store ou Play Store. Instalado na tela inicial, o sistema roda em tela cheia, com navegação fluida e suporte a **notificações Web Push**: alertas de novos atendimentos e mensagens mesmo com o aplicativo fechado.
### Adicione o app à tela inicial do celular
É **obrigatório** abrir a plataforma por esse ícone: no iOS, o Web Push só funciona quando o app é aberto pelo atalho instalado, nunca pelo navegador comum.
**Android (Google Chrome):**
Acesse o endereço da sua plataforma no Chrome.
Toque no menu **⋮** (três pontos) → selecione **"Instalar app"** ou **"Adicionar à tela inicial"** e confirme.
Abra sempre pelo ícone criado na tela inicial.
**iPhone (iOS) pelo Safari:**
O aparelho precisa estar no **iOS 16.4 ou superior** (versões anteriores não suportam Web Push em PWA).
Acesse o endereço da plataforma no Safari.
Toque em **Compartilhar** (quadrado com seta para cima) → selecione **"Adicionar à Tela de Início"** e confirme.
Abra sempre pelo ícone criado, nunca pelo Safari.
### Ative as notificações
* Dentro do PWA (app aberto pelo ícone no celular), toque no botão **(...)** ao lado do ícone de sino: esse botão só aparece quando o sistema é executado a partir do atalho instalado no celular.
* No painel da plataforma, acesse **Canais**, edite o canal para o qual deseja receber notificações, marque **"Habilitar WebPush"** e salve.
### Customizações de ícone e nome do app (Super-Administrador)
* **Nome do aplicativo:** no campo correspondente, apague o nome atual, digite o nome da sua empresa e clique em **Salvar**; esse nome aparece no título da aba do navegador, nas telas de instalação e nos menus do sistema.
* **Ícone PWA:** na seção **Ícone PWA**, clique em **Alterar ícone PWA** e envie a imagem da logo, obrigatoriamente em **PNG quadrado**, com no mínimo **512x512 pixels**. O sistema gera automaticamente 9 tamanhos diferentes (de 72px a 512px) e atualiza o `manifest.json` necessário para a instalação em qualquer dispositivo.
**Benefícios e quando usar:** garante que o atendente saiba imediatamente de um novo ticket ou mensagem mesmo sem o aplicativo aberto: essencial para operações que não podem deixar o cliente esperando.
**Dicas e observações importantes:** solução de problemas caso as notificações não cheguem:
* Confirme se você abriu a plataforma pelo **ícone instalado** na tela inicial (não pelo navegador): esse é o erro mais comum, e é obrigatório no iOS.
* Confirme se tocou no botão **(...)** ao lado do sino, **dentro do app**, para ativar as notificações: ativar apenas nas configurações do celular não é suficiente.
* Verifique se **"Habilitar WebPush"** está marcado no canal desejado (Canais, no painel da plataforma).
* Confirme se as **permissões de notificação** estão concedidas ao app/navegador nas configurações do celular, e se os modos **"Não Perturbe"/"Foco"** estão desativados.
* **Específico do iPhone:** exige iOS 16.4 ou superior e abertura pelo ícone da tela inicial: pelo Safari normal, as notificações não funcionam.
* **Específico do Android:** a otimização de bateria e a economia de dados costumam bloquear notificações em segundo plano: em **Configurações → Apps → (app/Chrome) → Bateria**, deixe "Sem restrições" e libere o uso de dados em segundo plano; mantenha o Chrome sempre atualizado.
## Wavoip - Ligações pelo WhatsApp
**Quem usa:** Administrador (configuração da integração); Supervisor e Atendente (uso das ligações no dia a dia).
**O que é:** 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. Funciona com **todos os canais de WhatsApp** da plataforma (API Oficial/WABA, Baileys, WebJS, Evolution API, Z-API e demais conexões), com a mesma interface, independente do tipo de canal.
O WaVoIP é uma **plataforma externa**: para criar conta, contratar planos ou resolver qualquer problema técnico de telefonia, o canal é diretamente em wavoip.com.
**O que é possível com a integração:**
* Realizar e receber **ligações de voz pelo WhatsApp** dentro do próprio 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) direto no frontend da plataforma.
* Integrar com **PBX/tronco SIP** já existente na operação.
* Conectar **múltiplos atendentes ligando pelo mesmo número**, com rastreamento individual por ramal.
### Pré-requisitos
* Conta ativa na plataforma com ao menos um canal de WhatsApp conectado.
* Conta criada no WaVoIP (wavoip.com) com um dispositivo criado no painel deles.
A criação de conta no WaVoIP é gratuita e inclui dispositivos de teste para validar a integração antes de contratar um plano pago.
### Conectando
No menu lateral, acesse **Gestão Comercial → WaVoIP**.
Clique em **Conectar** ou **Adicionar dispositivo**; o sistema exibe um **QR Code**.
Leia-o pela interface do WaVoIP e informe o **hash** gerado para concluir a vinculação.
A conexão é ativada automaticamente.
**Alternativa via Canais:**
Acesse wavoip.com, crie/acesse a conta e adicione um dispositivo; copie o **Token** gerado.
Na plataforma, acesse **Canais**, edite a conexão Baileys desejada e cole o token no campo **WaVoIP**; salve.
Um ícone de telefone aparece no card do canal; clique nele e escaneie o QR Code pelo celular (**WhatsApp → Aparelhos Conectados → Conectar um aparelho**).
### Fazendo uma ligação no atendimento
Abra um atendimento e clique no ícone de **telefone** no painel lateral de detalhes do ticket: a chamada inicia imediatamente para o número do contato via WhatsApp. Ao finalizar, ela é registrada automaticamente como **nota de ligação** no histórico do chat.
### Softphone (Webphone) integrado
Acessível pelo ícone de webphone na barra superior, permite:
* Gerenciar números e tokens conectados.
* Configurar preferências de ligação.
* Diagnosticar a conexão (microfone, áudio, rede).
* 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
Acesse **Envio em Massa**, selecione a opção de disparo de ligações e preencha os campos abaixo antes de iniciar o disparo (veja também **Envio em Massa - Wavoip**).
| Campo | Descrição |
| -------------------- | ---------------------------------- |
| **Token** | Dispositivo WaVoIP |
| **Sessão** | Canal vinculado |
| **Números** | Lista de destinatários |
| **E-mail** | E-mail de notificação da campanha |
| **Arquivo de áudio** | Áudio a ser reproduzido na ligação |
### Painel de métricas (Gestão Comercial → WaVoIP)
* Na aba **Login e Chamadas**, autentique com e-mail/senha da conta WaVoIP para ver o histórico completo.
* Na aba **Por Token**, filtre rapidamente por dispositivo.
O painel mostra histórico de chamadas (data, hora, duração, direção, status), horários de pico, gravações (com botão para ouvir cada chamada) e métricas por token.
### Integração SIP/PBX
Se sua operação já usa um PBX ou tronco SIP, o WaVoIP permite integrar os números de WhatsApp a essa infraestrutura via protocolo SIP: para configurar, entre em contato com o suporte do WaVoIP.
**Benefícios e quando usar:** elimina a necessidade de um sistema de telefonia separado para quem já atende pelo WhatsApp: a ligação nasce no mesmo ticket da conversa de texto, com gravação e métricas centralizadas.
Toda a configuração de telefonia (QR Code, hash, tokens, softphone) é gerenciada pelo **WaVoIP**: problemas técnicos de conexão devem ser resolvidos diretamente com o suporte deles em wavoip.com, fora do escopo de suporte da plataforma. As gravações ficam disponíveis conforme o **plano contratado no WaVoIP**; se um áudio não carregar, verifique o prazo de retenção do plano.
Ligações em massa para contatos que nunca interagiram com o número aumentam o risco de denúncias e banimento: prefira ligar apenas para contatos que já tiveram interação prévia.