Integração Yeastar PBX
A integração Yeastar conecta o ACCELERO a um PBX Yeastar, permitindo realizar e receber chamadas telefônicas diretamente pelo navegador — sem telefone físico ou softphone externo. A comunicação de voz acontece via WebRTC, usando a SDK oficial da Yeastar (ys-webrtc-sdk-ui).
Os números de ramal são associados às empresas cadastradas no ACCELERO, e uma tela dedicada lista as empresas com ramal para discagem em um clique.
Esta integração é disponibilizada como plugin (yeastar) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 0.0.1 — compatível com ACCELERO 2.16.9 ou superior.
O que a integração faz
Com o plugin ativo, o ACCELERO incorpora um widget de telefonia ao navegador e passa a usar os ramais do PBX Yeastar associados às empresas.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Widget de telefonia | Um componente de telefonia (SDK WebRTC) é injetado em todas as telas para quem tem a permissão adequada |
| Realizar chamadas | Na tela Ramais Yeastar, o botão Ligar inicia uma chamada para o ramal da empresa em um clique |
| Receber chamadas | Chamadas recebidas são tratadas pelo widget WebRTC diretamente no navegador |
| Associar ramais | O cadastro de empresa ganha o campo Ramal, vinculando um ramal do PBX à empresa |
| Listagem de ramais | A tela Ramais Yeastar reúne todas as empresas habilitadas que possuem ramal cadastrado |
Discagem e atendimento direto do navegador, a partir do cadastro de empresas do ACCELERO, sem hardware de telefonia dedicado na estação de trabalho.
Configuração
Caminho de acesso: Configurações > Plugins - Yeastar PBX
A tela de configuração tem uma única aba (Geral) com os dados de conexão ao PBX.
Tela de configuração Plugins - Yeastar PBX (Configurações > Plugins - Yeastar PBX), mostrando os campos Endereço do PBX, Usuário, Senha e Email (Ramal Genérico) e o bloco de informações.
| Campo | Descrição |
|---|---|
| Endereço do PBX | URL completa do PBX Yeastar (ex: https://pbx.exemplo.com) |
| Usuário | Usuário com acesso à API do PBX |
| Senha | Senha correspondente |
| Email (Ramal Genérico) | Email associado ao ramal que será usado pelo ACCELERO para a comunicação. Deve corresponder ao ramal genérico no PBX |
A tela exibe ainda um aviso informando que a integração utiliza a SDK ys-webrtc-sdk-ui para gerenciamento de chamadas.
O endereço do PBX e as credenciais de API são definidos junto com o responsável técnico da telefonia do cliente. Sem Endereço do PBX, Usuário e Email preenchidos, o widget de telefonia não é carregado.
Botões da tela
| Botão | Função |
|---|---|
| Voltar | Retorna à listagem de configurações |
| Salvar | Persiste os dados de conexão |
Campos adicionados às entidades
Empresa
O plugin adiciona a seção Integração Yeastar ao cadastro de empresa, com um único campo:
Seção Integração Yeastar no cadastro de empresa, mostrando o campo Ramal.
| Campo | Descrição |
|---|---|
| Ramal | Número do ramal Yeastar associado a esta empresa (ex: 1001). Aceita até 20 caracteres |
Ao salvar a empresa, o ramal informado é armazenado nos metadados da empresa (yeastar.ramal) e passa a aparecer na tela Ramais Yeastar.
A tela Ramais Yeastar lista apenas empresas habilitadas com o campo Ramal preenchido. Empresas sem ramal não entram na lista de discagem.
Ramais Yeastar (listagem e discagem)
Caminho: Menu lateral > Ramais Yeastar
A tela Empresas com Ramais reúne todas as empresas habilitadas que têm ramal cadastrado, permitindo a discagem direta.
Tela Ramais Yeastar (Empresas com Ramais), mostrando a busca por descrição, a tabela de empresas com ramal e o botão verde de Ligar em cada linha.
Colunas
| Coluna | Conteúdo |
|---|---|
| Descrição | Nome da empresa |
| Divisão | Divisão da empresa |
| Ramal | Ramal Yeastar associado à empresa |
| Ações | Botão Ligar |
Busca
A tela oferece busca por Descrição da empresa, com os botões Pesquisar, Fechar e Limpar.
Discagem
Clique no botão Ligar (ícone de fone) na linha da empresa para iniciar a chamada para o ramal correspondente:
- Se a empresa não tiver ramal, o sistema exibe a mensagem "Esta empresa não possui ramal cadastrado."
- Se o widget de telefonia ainda não tiver carregado, exibe "O sistema de telefonia não está pronto. Aguarde alguns segundos e tente novamente." — aguarde alguns segundos e tente de novo.
O menu Ramais Yeastar e a discagem só ficam disponíveis para operadores com a permissão Yeastar - realizar chamadas (yeastarCall).
Widget de telefonia (WebRTC)
Quando a integração está configurada e o operador tem a permissão Yeastar - exibir widget telefonia, o plugin injeta automaticamente um componente de telefonia em todas as telas do ACCELERO. Esse widget, baseado na SDK WebRTC da Yeastar, é responsável por estabelecer a conexão de voz no navegador, iniciar as chamadas disparadas pela tela Ramais Yeastar e tratar chamadas recebidas.
Widget de telefonia Yeastar carregado em uma tela do ACCELERO (estado ocioso e durante uma chamada).
A comunicação de voz acontece pelo navegador. Mantenha o ACCELERO aberto e garanta que o navegador tenha permissão para acessar o microfone. A integração é destinada a navegadores de desktop.
Permissões
O plugin cria duas permissões de operador, controladas pelo administrador do ACCELERO:
| Permissão | Função interna | O que libera |
|---|---|---|
| Yeastar - exibir widget telefonia | yeastarWidget | Carrega o widget de telefonia WebRTC nas telas do ACCELERO |
| Yeastar - realizar chamadas | yeastarCall | Exibe o menu Ramais Yeastar e permite iniciar chamadas |
Atribua Yeastar - exibir widget telefonia a quem precisa atender/realizar chamadas no navegador e Yeastar - realizar chamadas a quem opera a tela de discagem. Normalmente os dois andam juntos para o mesmo operador.
Como a integração se conecta ao PBX
O ACCELERO autentica-se na API do PBX Yeastar usando o Usuário e a Senha configurados, obtém um token de acesso (mantido em cache por cerca de 25 minutos) e gera um sign para a SDK WebRTC a partir do Email (Ramal Genérico). Esse sign é usado pelo widget no navegador para estabelecer a sessão de telefonia.
A obtenção de token e a geração do sign são tratadas internamente pelo plugin. O operador não precisa interagir com esse processo — basta a configuração estar correta e válida.
Casos de uso
Habilitar a telefonia Yeastar
- Solicitar à IONGRADE a instalação do plugin
yeastar. - Em
Configurações > Plugins - Yeastar PBX, preencher Endereço do PBX, Usuário, Senha e Email (Ramal Genérico) e clicar em Salvar. - Conceder as permissões Yeastar - exibir widget telefonia e Yeastar - realizar chamadas aos operadores que farão chamadas.
- No cadastro de cada empresa relevante, preencher o Ramal na seção Integração Yeastar.
Ligar para uma empresa
- No menu lateral, acessar Ramais Yeastar.
- Localizar a empresa (use a busca por descrição, se necessário).
- Clicar no botão Ligar na linha da empresa.
- Conduzir a chamada pelo widget de telefonia no navegador.
Boas práticas
- Email do ramal genérico correto: o campo Email (Ramal Genérico) deve corresponder ao ramal usado pelo ACCELERO no PBX; um valor incorreto impede a geração da sessão WebRTC.
- Ramais consistentes: cadastre o ramal exatamente como configurado no PBX. Empresas sem ramal não aparecem na tela de discagem.
- Permissões enxutas: conceda as permissões Yeastar apenas aos operadores que efetivamente usam telefonia.
- Microfone liberado: oriente os operadores a permitir o acesso ao microfone no navegador na primeira utilização.
Troubleshooting
O widget de telefonia não aparece
Possíveis causas:
- Configuração incompleta (faltando Endereço do PBX, Usuário ou Email)
- Operador sem a permissão Yeastar - exibir widget telefonia
- Plugin não habilitado
Solução:
- Em
Configurações > Plugins - Yeastar PBX, confirme que os campos de conexão estão preenchidos. - Verifique se o operador tem a permissão Yeastar - exibir widget telefonia (
yeastarWidget). - Atualize a página (F5).
O botão "Ligar" não funciona
Possíveis causas:
- A empresa não tem ramal cadastrado
- O widget de telefonia ainda não carregou
- Operador sem a permissão Yeastar - realizar chamadas
Solução:
- Confirme que a empresa tem Ramal preenchido na seção Integração Yeastar.
- Se aparecer "O sistema de telefonia não está pronto", aguarde alguns segundos e tente novamente.
- Verifique a permissão Yeastar - realizar chamadas (
yeastarCall).
Não há áudio na chamada
Possíveis causas:
- Navegador sem permissão de microfone
- Volume do computador desligado
Solução:
- Permita o acesso ao microfone no navegador.
- Verifique o volume e os dispositivos de áudio do computador.
- Atualize a página e refaça a chamada.
Integração com outros módulos
Empresas
A integração depende do cadastro de Empresas: o campo Ramal vincula o ramal do PBX à empresa, e a tela Ramais Yeastar lista apenas empresas habilitadas com ramal preenchido.
Operadores e Permissões
O acesso ao widget e à discagem é controlado pelas permissões de Operadores Yeastar - exibir widget telefonia e Yeastar - realizar chamadas.
Próximos Passos
- Empresas — Cadastre o ramal Yeastar na seção Integração Yeastar
- Operadores — Configure as permissões de telefonia Yeastar
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO