Além dos recursos abaixo, existe uma API da sua conta 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).
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.
1
Configurar o canal
Acesse Configurações → Integrações → Meta → WhatsApp e selecione o canal WABA.
2
Ativar as chamadas
Na configuração do canal, clique em Ativar Chamadas WebRTC.
3
Definir o roteamento
Em Configurações → Gerais → Geral, seção Organização e Distribuição, escolha a opção em Roteamento de chamadas WABA (“Define para quem o telefone toca quando o cliente liga via WABA”).
4
Ligar para um contato
Abra o atendimento → Detalhes do contato → Telefonia → WABA → Pedir permissão de chamada → aguarde o aceite → Ligar (WABA).
Número com SIP ligado: cada número aceita um servidor SIP só. Se o número usa SIP (por exemplo, o do WaVoIP), as ligações saem e chegam por esse servidor, não pelo navegador, e Ligar (WABA) avisa Este número faz ligações por outro sistema (SIP), por isso a ligação não sai por aqui. Ligue pelo sistema configurado no número. Quando o canal também tem o WaVoIP liberado, o aviso termina com Use “Ligar (WaVoIP)” no menu Telefonia. Ativar as chamadas WebRTC num número com SIP desliga o SIP, e a tela pede confirmação antes (veja “Contas Meta: WhatsApp” em Integrações Meta).Microfone: se o computador não tiver microfone, ao ligar ou atender aparece Nenhum microfone encontrado neste computador. Conecte um microfone ou fone com microfone e tente de novo. Se o navegador bloquear o microfone, aparece Microfone bloqueado pelo navegador. Verifique as permissões.
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, 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 lote (arquivo de áudio para uma lista de números) fica em Comunicação e Marketing → Comunicados → 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.
Salve: o SIP Webphone fica disponível para aquele usuário no painel de atendimento, já populando o número do contato para discagem.
Testar conexão: no fim da seção Config SIP há o botão Testar conexão, com um ícone de ajuda ao lado. Use-o antes de salvar, ou quando o ramal não registra, para saber o motivo e a solução. O botão fica ativo com Habilitar SIP ligado e funciona com os transportes WSS e WS; no UDP a tela avisa O teste funciona com WSS e WS. O teste roda no seu navegador, usa os dados preenchidos (mesmo sem salvar) e mostra, etapa por etapa, o resultado com a explicação do que fazer:
Quando tudo passa, a tela mostra Tudo certo: o WebPhone deve registrar com esses dados. Se os dados testados ainda não foram salvos, aparece também o lembrete Os dados testados ainda não foram salvos. Salve o usuário para o WebPhone usar esses dados. O botão Copiar detalhes para o provedor copia o servidor, o usuário, o domínio e o resultado de cada etapa, para você enviar ao suporte do provedor de telefonia.
Mensagens mais comuns e o que fazer:
O teste não faz ligação e não testa áudio: um registro aceito não garante que a chamada complete. Ele também não registra o ramal, então não derruba o aparelho nem o atendente que já esteja usando. A senha é enviada uma vez por teste, e várias senhas erradas seguidas podem fazer o provedor bloquear a rede por alguns minutos; por isso há uma espera de 30 segundos entre testes (o botão mostra Aguarde e os segundos restantes). O resultado vale para a rede do computador onde o teste foi feito: se o atendente estiver em outra rede, o resultado dele pode ser diferente.
- Queda da conexão: quando a conexão com o servidor SIP cai (por exemplo, o provedor fecha a conexão parada, a aba ficou minimizada ou o computador entrou em repouso), o WebPhone volta sozinho, sem recarregar a página. Enquanto isso, mostra Reconectando…, o motivo da queda e o aviso O WebPhone está tentando voltar sozinho, sem precisar recarregar a página., com o botão Reconectar agora, que só pula a espera. As tentativas seguem depois de 2 s, 5 s, 10 s e 30 s e, daí em diante, a cada 1 minuto, sem desistir; quando você volta para a aba, a internet volta ou o computador sai do repouso, o WebPhone tenta na hora.
- Problema de configuração: quando o servidor recusa a senha, o ramal ou o domínio (por exemplo, Usuário ou senha do ramal recusados ou Domínio ou ramal não reconhecido (404)), o WebPhone para de tentar, para não acionar o bloqueio do provedor contra tentativas repetidas (que bloquearia a rede do escritório), e mostra o motivo com a orientação: um administrador pode usar Testar conexão na Config SIP do usuário para ver o motivo e a solução.
- Chamando antes de atender: ao discar (e também na ligação para o colega na Transferência Guiada e na Transferência em Trio), o WebPhone liga o áudio que a operadora ou o PABX manda antes do atendimento: o “chamando” e os avisos da operadora (como número inexistente ou fora de área) tocam como num telefone comum, enquanto o selo mostra Chamando…. Se o PABX só avisar que o ramal está tocando, sem mandar áudio, o painel toca um toque de reserva no navegador. Quando o PABX manda o áudio, o painel espera até 2,5 segundos por ele antes de tocar o toque de reserva e, depois que o áudio da operadora chega, o toque de reserva não volta (se a operadora ficar em silêncio, o painel não preenche o silêncio). O toque para quando o outro lado atende, a ligação é desligada ou cai. Os avisos da operadora só são ouvidos se a operadora ou o PABX mandar o áudio antes de atender: o painel não os cria. Num PABX ou operadora que tenta mais de um destino ou muda de caminho no meio da chamada, a ligação pode cair no instante em que o outro lado atende (veja a revisão do WebPhone, mais abaixo).
- Botões da ligação em curso: durante a ligação, os botões ficam numa fileira dentro da janela do WebPhone e cabem inteiros nela (se faltar espaço, quebram para a linha de baixo): silenciar o microfone, pôr a chamada em espera e retomá-la (o selo mostra Em espera), abrir o teclado para enviar dígitos, transferir a chamada e desligar (o botão vermelho, um pouco maior que os outros). Enquanto o selo mostra Chamando…, só aparecem silenciar, teclado e desligar: espera e transferir aparecem depois que o outro lado atende. O botão de transferir abre o painel Transferir chamada: digite o número ou ramal, ou escolha um colega na lista Atendentes (a bolinha verde indica quem está online e o ramal aparece ao lado do nome), e escolha uma das três formas: Transferência Guiada, Transferência em Trio ou Transferência Direta.
- Transferência Guiada: liga primeiro para o destino, com a ligação original em espera. O painel Em consulta substitui os botões: mostra Chamando o destino e, quando ele atende, Falando com o destino; Concluir transferência só fica ativo depois que o destino atende (e pede confirmação) e Cancelar consulta desiste e volta à ligação original. Também depois que o destino atende, Juntar os três tira o contato da espera e coloca os três na mesma chamada: a consulta vira trio, com o painel Em trio descrito abaixo. A transferência só é dada como concluída quando a central telefônica confirma, com o aviso Chamada transferida para (destino).; se ela não confirmar, aparece Não foi possível transferir a chamada. e a consulta continua como estava.
- Transferência em Trio: chama o destino para entrar na mesma chamada, sem colocar o contato em espera: ele continua falando com você enquanto o destino toca. O painel Em trio mostra Chamando (destino) para entrar na chamada…, com o botão Cancelar convite. Quando o destino atende, o selo passa a Em trio e o painel mostra Você, (contato) e (destino) estão na mesma chamada.: os três se ouvem. A partir daí, Remover (destino) da chamada tira o convidado e a conversa segue só com o contato, e Concluir transferência (pede confirmação) deixa os dois conversando e tira você da chamada. Se o destino não atender, recusar ou não existir, aparece (destino) não atendeu ou está indisponível. e a ligação com o contato segue normal. No painel Em trio, Silenciar microfone fecha só o seu microfone (os outros dois continuam se ouvindo) e Reativar microfone reabre; se você já estava em silêncio, o trio começa em silêncio, e se você remover o convidado em silêncio, a chamada segue em silêncio. Durante o trio, os botões da chamada (espera, teclado, transferir e desligar) ficam recolhidos: use os botões do painel Em trio. Ao iniciar o trio, chamada em espera é retomada.
- Transferência Direta: transfere na hora depois de você confirmar. A chamada só sai da sua tela quando a central telefônica confirma a transferência, com o aviso Chamada transferida para (destino). Se a central não confirmar (por exemplo, ramal que não existe ou está fora do ar), a chamada continua na tela com o aviso O PABX não confirmou a transferência para (destino). Se o contato não estiver mais na linha, desligue e retorne a ligação.
- Chamada recebida: o WebPhone abre sozinho com o selo Tocando…. O botão verde, que vibra enquanto a chamada toca, atende; o vermelho recusa.
- Teclado: cada tecla acende por um instante quando é tocada, para confirmar que o dígito entrou. Vale ao clicar na tecla, ao digitar no campo do número com o teclado aberto e ao digitar no teclado do computador logo depois de clicar numa tecla da tela.
- Chamada com a aba escondida: quando chega uma ligação no ramal e a aba do painel está minimizada ou atrás de outra janela, o computador mostra o aviso Chamada recebida (“(número) está ligando. Clique para abrir o WebPhone.”). Clicar traz o painel para a frente e abre o WebPhone; o aviso some quando a chamada é atendida, recusada ou encerrada. Ele só aparece se o navegador já tiver permissão de notificação para o painel (a mesma dos avisos de mensagens; a tela não pede essa permissão) e não toca som próprio, porque o toque da chamada já toca. No Android esse aviso não existe: fica só o toque.
Registro e histórico
Independente da modalidade usada, todas as ligações ficam registradas em Gestão Comercial → Log Ligações (tela Log de Ligações), com filtros por:- Data Início e Data Fim
- Status (Chamando, Recebida, Aceita, Completada, Encerrada, Perdida, Ocupado ou Falhou)
- Agente
- Número Origem e Número Destino
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.
Adicione o app à tela inicial do celular
Android (Google Chrome):1
Abra o endereço da plataforma
Acesse o endereço da sua plataforma no Chrome.
2
Instale o app
Toque no menu ⋮ (três pontos) → selecione “Instalar app” ou “Adicionar à tela inicial” e confirme.
3
Use o atalho
Abra sempre pelo ícone criado na tela inicial.
1
Confirme a versão do iOS
O aparelho precisa estar no iOS 16.4 ou superior (versões anteriores não suportam Web Push em PWA).
2
Abra pelo Safari
Acesse o endereço da plataforma no Safari.
3
Adicione à Tela de Início
Toque em Compartilhar (quadrado com seta para cima) → selecione “Adicionar à Tela de Início” e confirme.
4
Use o atalho
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 e escolha Ativar notificações push (depois de ativadas, a opção passa a se chamar Atualizar notificações push): essa opção só aparece quando o sistema é executado a partir do atalho instalado.
- No painel da plataforma, acesse Administração → Canais, edite o canal para o qual deseja receber notificações, marque Habilitar Web Push e salve.
- 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 Web Push está marcado no canal desejado (Administração → Canais).
- 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 WaVoIP é uma plataforma externa: para criar conta, contratar planos ou resolver qualquer problema técnico de telefonia, o canal é diretamente em wavoip.com.
- 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 lote 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.
Conectando
O WaVoIP é ligado por canal, na tela de canais:1
Crie o dispositivo no WaVoIP
Acesse wavoip.com, crie/acesse a conta e adicione um dispositivo; copie o Token gerado.
2
Informe o token no canal
Na plataforma, acesse Administração → Canais, edite o canal de WhatsApp desejado, abra a seção WaVoIP (Chamadas VoIP), digite o token em Token WaVoIP (opcional) e pressione Enter (é possível adicionar vários tokens, um por dispositivo). Salve.
3
Confira a conexão do token
No card do canal, clique em Ver tokens WaVoIP. Em canais Baileys, o sistema reaproveita automaticamente a sessão existente. Nos demais tipos de conexão é preciso ler dois QR Codes: o do sistema (gerado na conexão do canal) e o do WaVoIP, que se abre pelo botão Abrir QR Code Wavoip quando o token aparece como Desconectado (leia pelo celular em WhatsApp → Aparelhos Conectados → Conectar um aparelho). Use Atualizar Status para conferir se o token ficou Conectado.
A seção de token WaVoIP no canal e o menu WaVoIP só aparecem quando o recurso está liberado para a sua empresa. Se não encontrar, solicite ao suporte do PanÐá Zap.
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 lote
Acesse Comunicação e Marketing → Comunicados, aba WaVoIP (ela só aparece quando o WaVoIP está habilitado na sua conta). Em Sessões Disponíveis aparecem os canais conectados com token WaVoIP. Adicione os números em Números de Telefone, escolha o áudio em Arquivo de Áudio e, em Sessões Conectadas, clique no número desejado para ligar por aquela sessão (uma ligação por vez). O passo a passo completo está na aba WaVoIP de Comunicados.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.

