Telefonia: seu próprio PBX
O telefone em um estabelecimento geralmente vive separado de todo o resto: o número fica com a operadora de telecomunicações, o aparelho fica no balcão, e quem ligou — só lembra quem atendeu. A seção «Telefonia» transforma isso em uma ferramenta de trabalho: a unidade ganha seu próprio PBX — uma central telefônica que recebe chamadas no seu número, distribui para os funcionários conforme suas regras, grava as conversas e as entrega para análise.
Abrir: Painel administrativo → Telefonia (admin.cenaly.com/telephony). A seção é ativada pelo cartão «Telefonia» na loja de extensões — por padrão, ela fica oculta.
O que é um PBX próprio#
O PBX é dedicado inteiramente à sua unidade. É uma máquina separada na nuvem, com seu próprio endereço IP estático e seu próprio endereço de conexão: voz de terceiros não passa por ela, as contas nas operadoras de telecomunicações são suas, e nós não emitimos nem revendemos numeração. Um servidor compartilhado para todas as novas unidades não é oferecido de forma alguma.
| O quê | Como funciona |
|---|---|
| Contratação do servidor | botão na aba «Servidor». O serviço é pago e é debitado do saldo da conta por dia — o preço por dia aparece no cabeçalho da seção e em cada tamanho de servidor, e a confirmação antes da criação avisa sobre isso. Os débitos diários ficam em um bloco recolhido direto no cartão do servidor (últimos 7 dias) e em um registro de todas as unidades na «Assinatura» |
| Capacidade | uma escada de presets, identificados pelo número de conversas simultâneas; a variação de capacidade ocorre sem tempo de inatividade, e é possível aguardar até que não reste nenhuma chamada ativa |
| Carga | gráfico de processador e rede das últimas 1 hora / 24 horas / 7 dias direto no cartão do servidor |
| Configurações | são salvas automaticamente, não há botões «Salvar» na seção; cada bloco tem um «reloginho» — histórico de configurações com reversão |
| Onde fica fisicamente | a nuvem é escolhida conforme o país da unidade; unidades russas são atendidas somente no Yandex Cloud (cenaly.ru) |
No topo da seção há um checklist «Até a primeira chamada» com três perguntas separadas. Configurações — quatro passos (criar a conta SIP da unidade → conectar a linha de entrada → configurar o caminho da chamada recebida → atribuir pelo menos um número interno), com a contagem «3 de 4» apenas para eles, e um passo incompleto é um link para a aba necessária. Chamada de teste — uma marcação do registro de chamadas: a última chamada recebida aceita; o teste de eco *43 verifica o áudio, mas não a linha da operadora de telecomunicações, por isso aparece como dica ao lado. Gravação de conversas — sua escolha (desativada / ativada com aviso aos que ligam), e ela não entra no «tudo pronto»: não é preciso gravar para ganhar um check verde. Quando as configurações estão prontas e a chamada foi concluída, o checklist se recolhe em uma única linha verde.
Por onde começar#
A ordem é esta, e é também a ordem do caminho da chamada — de fora para dentro:
| № | Passo | Onde | Detalhes |
|---|---|---|---|
| 1 | Criar o número: tronco SIP da operadora de telecomunicações ou gateway com cartão SIM | Operadoras de telecomunicações → Linhas | número da operadora, gateway GSM |
| 2 | Atribuir ramais aos funcionários | Operadores | abaixo |
| 3 | Conectar telefones e softphones | credenciais da janela do ramal | configuração de telefones SIP |
| 4 | Configurar o roteamento de chamadas recebidas | Roteamento, Grupos de chamada | abaixo |
| 5 | Ativar as chamadas de saída, se os funcionários ligam para fora | Saída | abaixo |
| 6 | Ativar a gravação de conversas | Gravação | abaixo |
Passo 1. Número: operadora de telecomunicações ou gateway#
O número de entrada é trazido por você — com seu contrato com a operadora de telecomunicações. Há três fontes, e elas se somam:
| Fonte | Como se conecta | O que importa |
|---|---|---|
| Tronco SIP da operadora de telecomunicações | aba «Operadoras de telecomunicações»: nome, host SIP, porta, transporte, modo (REGISTER — o PBX se registra na operadora de telecomunicações, ou IP-auth — a operadora de telecomunicações envia as chamadas para o nosso IP), login e senha. O botão «Testar conexão» faz um teste ao vivo | o número é criado como linha na aba «Linhas», e a linha tem um interruptor de ativação «Recebe chamadas». Análise — conexão do número da operadora |
| Gateway com cartão SIM, linha fixa ou ISDN | o gateway se registra no nosso PBX como ramal e disca o número interno por conta própria quando chega uma chamada | o gateway transmite o número de quem liga — ele aparece no aparelho, no registro de chamadas e na gravação de «Chamadas». Esse tipo de chamada não tem linha, e as regras de roteamento não se aplicam a ela. Análise — gateway GSM e linha fixa |
| Linha integrada de chamada web | não é preciso conectar nada: o visitante fala pelo navegador | uma linha, não exige um número separado — chamada do site |
O número de troncos e números não é limitado — é a sua máquina e as suas contas nas operadoras de telecomunicações; o limite geral da lista de configurações do PBX é de 500 registros.
Etapa 2. Ramais para a equipe#
A aba "Funcionários e grupos" — números internos. Há dois tipos: nosso ramal (conta na nossa PBX, à qual se conecta um telefone ou softphone; o número é definido por você — 2 a 6 dígitos, numeração própria do estabelecimento, sem limite de quantidade de ramais) e número herdado da operadora de telecomunicações — por trás dele está um número que a pessoa já tem: ramal de outra PBX, celular ou fixo. Para esse não se emite senha, e a chamada até a pessoa passa pelo canal escolhido.
| Recurso | O que faz |
|---|---|
| Vincular ao funcionário | na coluna "Funcionário", clique no nome (ou em "Sem funcionário") e escolha a pessoa — a lista de colaboradores abre ao clicar, em vez de ficar em cada linha. O número aparece no cadastro do funcionário, e uma demissão revoga o ramal automaticamente em todas as unidades |
| "Distribuir para funcionários…" | emite números em lote por filtro de cargo; quem já tem número é ignorado |
| Credenciais | a senha é exibida uma única vez: campos com cópia, "copiar todas as configurações" em texto e QR para Zoiper e Linphone. Esqueceu? Use "Redefinir senha" |
| Duplicação completa do número | um número que vive na operadora é configurado de forma que o telefone da pessoa se registre conosco, e a chamada chegue também ao aparelho antigo dela na operadora |
| O canal está ativo? | para o número herdado, na coluna "Canais e SIP", ao lado do nome do canal há um círculo de conexão: verde — a linha pela qual se liga para a pessoa está registrada na operadora; cinza — não há registro ou a PBX ainda não informou sobre ele; quadrado "stop" — a linha foi desligada por você. Passe o mouse sobre o círculo: a dica mostra qual é a linha, o que aconteceu com ela e quando isso foi observado. Nossos ramais não têm círculo separado — a conexão deles é mostrada pelo ponto à esquerda na mesma linha |
| Hardware e registros | na linha, vê-se com o que o funcionário se conecta ("Yealink T31G", "Zoiper"), em cinza se o aparelho estiver desligado. Ao lado do nome há o ícone de "barras de sinal": é o ping da PBX até esse aparelho (verde — conexão boa, âmbar — atraso perceptível a partir de 150 ms, vermelho — a partir de 300 ms, ✕ — o aparelho parou de responder às verificações). O número "180 ms" aparece ao lado do ícone apenas em caso de atraso perceptível; os números completos ficam na dica ao passar o mouse e no cadastro. No próprio cadastro, o ping fica na linha de status ("conectado · endereço · rede · última conexão") — ali o número é sempre visível e em qualquer seção do cadastro, enquanto a hora, o dia e as barras por hora ficam na aba "Funcionamento", no bloco "Conexão com a PBX". Um aparelho desligado não tem ícone: a PBX não o verifica. O clique abre o cadastro do aparelho: funcionamento nas últimas 24 h/7/30 dias, histórico de conexões, chamadas, verificação de conexão e configurações — servidor, porta, transporte, login e ramal interno desse telefone (o que se digita no próprio aparelho, com cópia) mais ajustes finos de SIP que a PBX aplica a ele. Não há senha ali: ela é exibida uma única vez na emissão. Todos os horários — na dica da tag, no cadastro e nos registros do ramal — seguem o fuso horário da unidade (no cadastro, ele é indicado abaixo da linha de status); se o fuso não estiver definido para a unidade, seguem o relógio do seu dispositivo, e isso também está indicado |
Etapa 3. Telefones e softphones#
Os mesmos cinco valores (servidor, login, senha, porta 5060, transporte UDP) são inseridos em qualquer aparelho: telefone de mesa, telefone DECT do garçom, interfone, adaptador para telefone analógico antigo ou telefone por software no computador e no smartphone. Um mesmo ramal pode ser registrado em vários dispositivos ao mesmo tempo.
O guia completo está em configuração de telefones SIP: onde obter as credenciais, o que é necessário da rede do estabelecimento (UDP de saída 5060 e 10000–20000, SIP ALG desativado no roteador), quando o telefone precisa ser restaurado para as configurações de fábrica e instruções passo a passo para 26 famílias de aparelhos. Lá também está o teste de eco *43: você disca, ouve sua própria voz e, no registro de chamadas, aparecem perdas, jitter e atraso desse aparelho.
Cada pessoa cria suas próprias contas pessoais: Configurações → "Contas SIP pessoais" (admin.cenaly.com/settings?tab=sip-accounts) — são registros da pessoa em sistemas de terceiros (na operadora de telecomunicações, em uma PBX de escritório) ou com seu próprio ramal. Eles ficam vinculados ao login dela, não à empresa, são visíveis apenas para ela e chegam somente ao telefone dos aplicativos Cenaly para Android nos dispositivos dela — Cenaly Admin (aba "Telefone"), Cenaly CRM ("Mais" → "Telefone") e Cenaly SIP Phone. Eles não entram na PBX da unidade, nos telefones de mesa nem no painel web (veja configurações).
Etapa 4. Roteamento de chamadas recebidas#
A aba "Caminho da chamada recebida" — regras de "para quem ligar quando uma chamada chega". As regras são verificadas de cima para baixo, vence a primeira que corresponder; a ordem é a prioridade, e elas são reordenadas com as setas.
| Eixo da regra | Opções |
|---|---|
| Para onde ligaram | chips com os grupos "Linhas (números)" e "Operadoras de telecomunicações (troncos)", é possível escolher vários destinos — qualquer um deles serve |
| Quando | dias da semana e janela de horário no fuso horário da unidade |
| Quem liga | prefixo do número de quem liga |
| Quem atende | todos que têm um número · funcionários selecionados por chips de nomes · grupo de chamadas do grupo · Assistente de IA por nome (consultor telefônico, secretária, qualquer bot de voz) · número externo |
| Se ninguém atender | frase de não atendimento, secretária eletrônica, Assistente de IA, outro grupo |
Grade de chamadas do grupo — uma grade em que a linha é o participante e a coluna são 5 segundos: "nos primeiros 10 segundos toca para a hostess, a partir dos 10 o gerente entra, a partir dos 20 a hostess para". As células são pintadas arrastando o mouse. A última linha é a IA: ela não liga, ela atende, por isso começa onde a última pessoa parou de tocar.
Abaixo da lista de regras está a resposta padrão: o que acontece se nenhuma regra corresponder (saudação, secretária eletrônica, bot). Ali também está o botão notificações de "conversa sendo processada" com escolha de idioma e texto próprio — em vários países o aviso é obrigatório, por isso ele vem ativado por padrão.
Se você excluir uma operadora de telecomunicações para a qual as regras apontam, o painel primeiro pergunta e, para cada regra, diz o que vai acontecer com ela: "continuará funcionando sem essa operadora de telecomunicações" (a condição ainda tem outros números ou operadoras de telecomunicações), "será desativada" (sem a operadora de telecomunicações a condição ficaria mais ampla) ou "será desativada e ficará sem condição". As regras não são excluídas — a grade e a alternativa continuam no lugar. Uma regra que ficou sem nenhuma condição é marcada como "sem condição", e seu botão não liga: caso contrário, ela pegaria qualquer chamada. Defina uma nova condição para ela (número, operadora de telecomunicações, horário ou prefixo de quem liga) — e ative, ou exclua a regra.
Grupos de chamadas do grupo (linhas em "Funcionários e grupos", com a marcação "Grupo") — um número interno (atribuído a partir de 700) com sua própria distribuição: grade, chamada simples "para todos de uma vez / por vez" ou Filas com música de espera, anúncio da posição e limite de tempo. O participante tem o botão "Toca", seu horário de trabalho pessoal, pausa (o funcionário a define sozinho pelo aparelho: *71 — vou me ausentar, *72 — voltei) e sua própria melodia de espera; o botão "Ligar primeiro para quem o cliente já falou" tenta por alguns segundos um funcionário conhecido. Três portas levam ao grupo: discar o número dele do telefone, uma regra de roteamento e a transferência de chamada pela Secretária de IA. No Aplicativo Cenaly Phone, na tela da chamada recebida desse tipo, aparece a grade: para quem está tocando agora, quem entrará em alguns segundos e quem está ocupado. Enquanto ela carrega, no lugar dela aparece "Discando…". Se ligarem diretamente para o seu número, não há grade: toca só no seu. Quando um colega atende a chamada, a janela de chamada recebida ainda mostra por alguns segundos quem atendeu. Como chamar quem atendeu — pelo nome, pelo nome com o número, só pelo número ou apenas "Um colega atendeu" — é o administrador que escolhe: janela "Regras para todos os funcionários", bloco "Seus telefones", "Quem atendeu a chamada — o que os colegas veem". Ao lado estão as salas de conferência (aba "Conferências"): números 600–649 com PIN e vídeo, discou o número de qualquer Dispositivo registrado — entrou na conversa em grupo.
Etapa 5. Chamadas efetuadas#
As chamadas efetuadas vêm desativadas por padrão, e a ativação é confirmada com um texto sobre dinheiro: para fora quem liga é o seu tronco, e a Fatura vem da sua operadora de telecomunicações. A aba "Efetuadas" decide de qual linha sairá a chamada que o funcionário discou do seu telefone — três níveis na ordem de análise:
- Regras inteligentes "modelo do número discado → linha": dígitos mais
X(qualquer),N(2–9),Z(1–9), ponto final "quantos dígitos quiser". A regra pode ser restrita a funcionários específicos, cortar ou acrescentar dígitos antes de enviar à operadora de telecomunicações e substituir o número de identificação; - linha pessoal do funcionário — "uma para cada";
- linha geral padrão.
O antifraude funciona sempre: limite de chamadas efetuadas simultâneas por unidade e por funcionário, limites de comprimento do número discado, proibição incondicional de destinos premium e via satélite (não é removida por configuração) e teto diário de minutos de conversa (por padrão não há teto). Em 80 % do teto, ao esgotá-lo e em caso de tráfego noturno suspeito, o PBX grava um alerta no Chat de trabalho com push — uma conta roubada é reconhecida pelos minutos gastos à noite, e não pela Fatura da operadora de telecomunicações no fim do mês.
Etapa 6. Gravação de conversas e "Chamadas"#
Aba "Gravação": ativar, escolher o escopo (todas as chamadas / somente recebidas / somente de Operador) e decidir se as Gravações com mais de N dias serão excluídas. Por padrão, as Gravações são armazenadas sem limite — o prazo é você que define, não há teto máximo.
A conversa gravada entra não só no player da telefonia, mas também na seção "Chamadas" (admin.cenaly.com/calls) — o centro de trabalho com Gravações: upload e recebimento de arquivos, tabela com filtros e visualizações salvas, Reconhecimento de fala, análise da conversa por IA, tags, métricas, regras e automações, busca e vínculo com o Pedido. Os prazos de armazenamento do repositório de Gravações e da seção "Chamadas" são configurados separadamente. Um artigo detalhado sobre "Chamadas" está em preparação.
Secretária de IA, coach de chamadas e consultor#
A telefonia é a infraestrutura na qual funcionam três superfícies de IA. Elas são configuradas em suas próprias seções, e a PBX decide apenas "quem atende à chamada". Artigos detalhados sobre a secretária e o coach de chamadas estão em preparação.
| Superfície | O que faz | Onde |
|---|---|---|
| Secretária de IA | o robô atende às chamadas recebidas em nome do estabelecimento: persona e tom, horário, questionários (reserva, mensagem, solicitação), regras de transferência de chamada para funcionários, ações permitidas, anti-spam e simulador de texto. Responde a partir da base de conhecimento, o aviso "atende uma IA" nos países obrigatórios não pode ser desativado | admin.cenaly.com/secretary |
| Coach de chamadas do operador | durante a conversa, aparecem automaticamente para o funcionário cartões de respostas da base de conhecimento, sobre a transcrição ao vivo; o modelo de linguagem não é chamado na ligação — funciona um pacote montado previamente | admin.cenaly.com/call-assist |
| Consultor telefônico | Assistente de IA como uma linha comum na lista de ramais: é possível dar a ele um número interno, colocá-lo na regra "se ninguém atendeu" ou na última linha do organograma | admin.cenaly.com/telephony?tab=extensions |
Chamada pelo site#
Dois widgets gratuitos funcionam na mesma PBX e chegam pelas mesmas regras de chamadas recebidas: chamada pelo site — botão de telefone, o visitante fala diretamente do navegador, não é preciso discar o número nem instalar o aplicativo; chamada de retorno — o visitante deixa o número, a PBX mesma o disca e conecta com o estabelecimento, há repetições em caso de chamada não completada e fila noturna com discagem pela manhã. É preciso pagar apenas pela sua própria telefonia — os widgets em si são gratuitos.
Abas da seção «Telefonia»#
As abas estão reunidas em quatro entradas acima delas: Hoje (Visão geral), Trabalho (Painel, Registro de chamadas, Correio de voz, Conferências), Configuração (Linhas, Provedores de telefonia, Caminho da chamada recebida, Funcionários e grupos, Chamadas efetuadas, Gravação) e Diagnóstico (Servidor). Isso é apenas um agrupamento: os endereços das abas e os favoritos na barra lateral continuam os mesmos. O botão «Todos os recursos» mostra todas as abas de uma vez, e o campo «Encontrar função» localiza a configuração até por palavras antigas («tronco», «ramal», «painel de parede», «IVR»). A seção abre com a entrada por função: proprietário — «Hoje», operador — «Trabalho», configurador — «Configuração»; sua escolha pode ser fixada ali mesmo. Acima das abas há uma linha de status: se a alteração foi salva, se o PBX a aplicou e quais configurações aguardam sua atualização.
| Aba | O que tem lá |
|---|---|
| Visão geral | checklist «Até a primeira chamada», bloco «Como será a chamada recebida» (previsão pelas configurações salvas com os botões «Alterar» e «Verificar número» e a última chamada real), resumo da conta SIP da unidade, botão «Verificar conexão», chave de e-mails sobre falhas, histórico de conexões do PBX |
| Painel | quem está falando com quem agora: chamadas em andamento, ramais, linhas; alternador «Painel / Quadro» — números do call center em tamanho grande (aguardando resposta — tanto na fila quanto enquanto os telefones do grupo tocam; livres; nível de atendimento de hoje), operadores por status e todas as chamadas em andamento em lista — quem está ligando, com quem está falando ou para quem está ligando, quanto tempo espera e quanto tempo dura; «Tela cheia (TV)» — para a televisão na parede |
| Registro de chamadas | histórico de todas as chamadas do PBX com status e trajeto de roteamento — veja abaixo |
| Correio de voz | mensagens dos que ligam por caixa: ouvir, designar responsável, marcar como resolvida, retornar a chamada; para o gestor — «Saudação e configurações da caixa» direto da mensagem e atalhos para a chamada no registro e para a tarefa «Retornar chamada» |
| Linhas | números de entrada, a marcação «Aceita chamadas», melodia de espera padrão (o botão «Ouvir e escolher» permite ouvir todo o catálogo sem alterar nada) e a linha integrada de chamada pela web |
| Provedores de telefonia | linhas dos provedores em uma só linha (estado, registro, verificação), edição dos dados no local, subseção «Duplicação completa de números», botão «Conectar número ou linha» (o assistente primeiro pergunta: número no provedor, outro PBX ou linha via gateway) e catálogo de integrações com provedores, PBXs externos e gateways |
| Caminho da chamada recebida | regras de entrada de cima para baixo, esquema do caminho da chamada com verificação do número e resposta padrão «se nenhuma regra se aplicou» — o mesmo editor da ficha «Consultor telefônico» da seção «Chamadas» |
| Chamadas efetuadas | regras «número → linha», linhas pessoais e a linha geral, chave geral e limites |
| Funcionários e grupos | uma única lista de pessoas, grupos e Assistentes de IA (marcação «Pessoa / Grupo / IA», «Ramal interno»); a ficha do funcionário abre na aba «Principal» — como ele atende chamadas e o botão «Conectar telefone» ou «Verificar»; abaixo, em linhas recolhidas — Hardware de telefonia, telefones de mesa, agenda telefônica, estacionamento e interfone, caixas de voz, conexão entre unidades |
| Conferências | salas 600–649: nome, PIN, vídeo, limite de participantes |
| Gravação | ativação, área de gravação, prazo de armazenamento |
| Servidor | a máquina do PBX e a Ponte no PC, capacidade e carga, ajustes finos de SIP, diagnóstico da linha (gravação do tráfego SIP) |
«Ajustes finos de SIP» se explicam sozinhos. O protocolo tem três dezenas de parâmetros de compatibilidade, e o telefone que «não conecta» geralmente esbarra em exatamente um deles. Por isso cada configuração nessa janela tem um expansor «Mais sobre a configuração» com três partes: «Quando é necessária» — se você precisa mesmo mexer nela («deixe ativada enquanto o telefone estiver atrás do roteador», «somente a pedido do provedor»); «O que vai mudar» — o que acontece ao ativar e ao desativar, incluindo o custo («a gravação da conversa e as dicas do Coach de chamadas vão sumir: o PBX não ouve mais esse áudio»); «Como verificar» — uma ação concreta e seu resultado esperado («disque do aparelho *43 — o teste de eco deve devolver sua voz», «clique em „Ligar para o aparelho“ — ele deve tocar», «abra „Histórico de conexões do PBX“»). Campo vazio é o valor padrão, escrito ao lado; as configurações que podem cortar a conexão por completo (troca direta de áudio, conjunto de protocolos, identificação de quem liga, criptografia) estão marcadas com um ícone. Se a telefonia está funcionando — aqui não é preciso mexer em nada.
Registro de chamadas: todas as chamadas, não só as gravadas#
A aba «Registro de chamadas» (?tab=log) mostra o histórico de todas as chamadas do seu PBX, incluindo as que não têm gravação: atendidas, perdidas, ocupadas, abandonadas, aceitas pelo robô. Na linha — horário, quem ligou, para qual linha, em qual ramal o telefone tocou (chips de ramais), quem atendeu, status em palavras e duração.
O clique abre a modal «como a chamada aconteceu»: a regra de roteamento que foi acionada, cada tentativa de chamada com o destino de cada alvo («atendeu em 5 s», «tocou 29 s, não respondeu», «ocupado», «recusou»), o fallback e a frase final. A transferência de chamada para um colega é um evento da mesma chamada, não um novo registro: no trajeto aparece a etapa «transferência», e a conversa é dividida em trechos («cliente ↔ ramal 101 Anna — 0:16», «cliente ↔ ramal 102 Boris — 0:20»). Áudio e análise por IA — na aba «Gravações» da seção «Chamadas»: o botão «Abrir gravação» na ficha da chamada leva direto para lá.
O horário no registro segue o fuso horário da unidade, não o relógio do dispositivo de onde você está olhando. Na ficha da chamada, o fuso está indicado sob a linha com a data — «Horário — pelo fuso horário da unidade (Europe/Moscow · GMT+3)» —, e é nele que correm todos os horários do trajeto da chamada: etapas, «tocou às …», trechos da conversa. Se o fuso da unidade não estiver definido, o horário segue o relógio do seu dispositivo, e isso também está dito. O texto «Copiar para o suporte» grava o horário junto com o fuso.
Diagnóstico do fio (SIP-trace)#
Quando "a chamada não passa", mas nas configurações está tudo certo, discutir não adianta — é preciso ver o que exatamente a nossa PBX e a operadora de telecomunicações trocaram. Para isso, na aba "Servidor" existe o bloco "Diagnóstico do fio (SIP-trace)".
SIP são as mensagens de serviço com que se negocia uma chamada: REGISTER (o telefone ou tronco se anuncia), INVITE (alguém está ligando), códigos de resposta (200 OK, 401, 403, 488…) e o bloco SDP dentro delas, onde se declaram os codecs e endereços para o áudio. O trace é a transcrição dessa troca, como o servidor a vê.
Como capturar:
- Telefonia → "Servidor" → bloco "Diagnóstico do fio". O botão "Gravar 15 minutos" abre a janela de gravação (ao lado aparece a legenda "aberto até …"; o teto da janela é 2 horas).
- Enquanto a janela estiver aberta, repita aquela mesma chamada — o trace mostra apenas o que aconteceu com a janela aberta.
- O botão "Atualizar" puxa a cauda mais recente da troca; as linhas aparecem na janela escura abaixo dos botões. A mensagem "A PBX ainda não publicou a troca" significa "espere um minuto" — a máquina publica a cauda no seu próprio ciclo, isso não é erro.
- "Parar" fecha a janela antes do prazo; ela se fecha de qualquer forma: na troca há números de quem liga, ou seja, dados pessoais, por isso "ligou e esqueceu" aqui é impossível — e isso foi feito de propósito.
O que é importante saber sobre o conteúdo: os valores dos cabeçalhos de autorização (Authorization, WWW-Authenticate) são recortados das linhas — não há senha no trace; mostra-se a cauda da troca, e se o início não coube, isso está escrito logo acima do texto. Na PBX dedicada, além disso, a troca é gravada continuamente e armazenada na máquina por um dia, então a reclamação "uma hora atrás a chamada ficou sem áudio" ainda pode ser analisada a posteriori — ainda não há escolha de intervalo no painel, o recorte da última hora é obtido pelo suporte.
Como ler os cenários típicos:
| O que se vê na troca | O que isso indica |
|---|---|
REGISTER → 401/407, depois novo REGISTER → 200 OK |
registro normal em duas etapas (verificação digest), é assim que deve ser |
REGISTER → 403 Forbidden (ou 404) |
a operadora de telecomunicações recusou: login, senha ou domínio errados, e na autorização por IP — a chamada veio de um endereço diferente |
nenhuma resposta, 408 Request Timeout |
os pacotes não chegam: porta ou transporte errados, filtro do lado da rede ou da operadora de telecomunicações, no IP-auth — nosso endereço não está cadastrado |
INVITE → 488 Not Acceptable Here (ou 606) |
os codecs não bateram: nossa PBX fala G.711 A-law, µ-law e G.722, e não suporta G.729, Opus e AMR |
INVITE → 200 OK, mas sem áudio ou só um lado é ouvido |
a sinalização passou, o problema está no fluxo de áudio (RTP): SIP ALG no roteador, UDP 10000–20000 fechado ou NAT — no bloco SDP (c=, m=audio) dá para ver qual endereço cada lado informou |
INVITE → 480/486/603 |
o assinante está indisponível, ocupado ou recusou a chamada — é a resposta do outro lado, não uma falha |
INVITE → 503 Service Unavailable |
a operadora de telecomunicações recusou: canais esgotados, saldo ou destino bloqueado do lado dela |
BYE logo após a resposta |
uma das partes encerra a sessão — geralmente timers de sessão ou keep-alive em um nó intermediário |
pausa entre o INVITE e a primeira resposta |
dá para ver em qual etapa a PBX espera a operadora de telecomunicações — aquela mesma "silêncio antes da chamada de saída" |
O que enviar ao suporte. Não há exportação em arquivo no painel: selecione o texto na janela do trace e anexe-o ao e-mail (ou um print), informando o horário da chamada e o número — isso basta para a análise. Se for mais prático, ative o "Acesso do suporte" nas configurações, e o colaborador verá a troca por conta própria; como escrever ao suporte — aqui.
⚠️ O diagnóstico está disponível apenas na PBX dedicada: o comando do logger no Asterisk é global, e em um servidor compartilhado ele gravaria a troca de outros locatários. Na camada compartilhada, a ativação é bloqueada.
API e MCP: CRM, seus programas e assistentes de IA#
Sua PBX pode ser gerenciada não apenas pelo painel. O botão «API e MCP» no topo da seção «Telefonia» (visível ao proprietário da conta quando a PBX está conectada) emite chaves para programas externos: CRM, seu script de relatórios ou um assistente de IA como Claude e Cursor.
Como emitir uma chave. «Criar chave» → nome («CRM», «Claude») → conjunto de permissões: «CRM» (registro de chamadas, gravações, chamada em um clique, ramais), «Assistente de IA» (o mesmo mais encaminhamento, «não perturbe» e quem está livre agora), «Somente leitura» ou «Tudo» — ou suas próprias caixas de seleção. Três permissões são concedidas apenas por caixa de seleção separada e não fazem parte de nenhum conjunto, nem mesmo de «Tudo»: «Alterar regras de chamadas», «Exportar configuração» e «Importar configuração de tabelas». Em seguida — unidades (todas ou selecionadas) e prazo (indefinido, 30, 90 ou 365 dias). A chave no formato cpx_… é exibida uma única vez: copie-a imediatamente, armazenamos apenas a impressão digital. As permissões podem ser alteradas a qualquer momento; «Revogar» desativa a chave a partir da próxima requisição.
O que a API faz. Registro de chamadas com filtros (perdidas, por ramal, por número, por período) e o cartão da chamada com o percurso; link para a gravação e transcrição com resumo do «Chamadas»; chamada em um clique a partir do telefone do ramal desejado (primeiro ele toca, depois o número é discado); ramais e grupos, encaminhamento pessoal e «não perturbe»; quem está livre e quem está falando; números e regras de entrada/saída com histórico de alterações. Com a permissão «Alterar regras de chamadas», a chave cria, altera, exclui e reordena regras de entrada e saída uma a uma (apenas os campos transmitidos são alterados — as regras vizinhas não são afetadas), ativa e desativa saídas e reverte regras para a versão anterior. A distribuição de chamadas entre colaboradores (grade, fila, «para todos») é configurada no painel — a regra da API encaminha a chamada para o grupo pelo número dele; países de saída e limites contra fraude não são alterados pela chave. Com permissões de configuração — exportação e importação das mesmas tabelas que em arquivo Excel/CSV: primeiro a pré-visualização «o que será adicionado / alterado / excluído», depois a aplicação. Senhas e logins nunca são fornecidos via API — as senhas dos novos ramais são visíveis apenas no painel.
Como conectar um assistente de IA. Com a mesma chave funciona o servidor MCP https://api.cenaly.com/pbx-api/mcp (streamable HTTP). Na aba «Como conectar» estão configurações prontas para Claude Code, Claude Desktop e Cursor — insira a chave e o assistente poderá responder «quem ligou hoje e não foi atendido», «ligue de volta para este hóspede pelo telefone da Anna» ou «ative meu encaminhamento para o celular». O assistente vê apenas as ferramentas permitidas pela chave.
ChatGPT e claude.ai — sem chave. Os assistentes em nuvem conectam o mesmo servidor MCP via OAuth: adicione https://api.cenaly.com/pbx-api/mcp como seu conector, entre na conta Cenaly e marque o que o aplicativo pode fazer — a janela mostrará qual aplicativo está solicitando acesso. A conexão aparecerá na lista de chaves com a marca OAuth e pode ser revogada ali mesmo. Detalhes, com exemplos e limites, na ajuda «API e MCP da sua PBX».
Para desenvolvedores. REST — https://api.cenaly.com/pbx-api/v1, chave no cabeçalho Authorization: Bearer <ключ>; descrição OpenAPI 3.1 e página de documentação — pelos links na janela (/pbx-api/v1/openapi.json, /pbx-api/v1/docs). Limites por chave: 120 requisições por minuto e 20 000 por dia; chamada em um clique — 10 por minuto e 300 por dia. Eventos de chamadas (cada chamada gravada com transcrição e análise) chegam por webhook — origem «Webhook» na seção «Chamadas». Cada alteração feita pela chave é visível no registro de ações com o nome da chave.
Limitações#
- Ainda não há saída pelo gateway. Um gateway com chip SIM ou linha fixa traz chamadas PARA a PBX; ligar para fora através dele pelo painel não é possível — a regra de saída leva apenas à linha ou ao tronco da operadora de telecomunicações. E as regras de roteamento não se aplicam a chamadas do gateway: essa chamada não tem linha, por isso nas configurações do gateway indica-se diretamente o número do grupo ou do colaborador.
- Criptografia do tronco da operadora de telecomunicações (TLS + SRTP) — com atualização da PBX de outubro de 2026 (como ativar); ainda não foi testada com operadora real, e TLS mútuo com certificado de cliente não é suportado. Para telefones, a criptografia é ativada por ajuste fino da máquina dedicada (ela mesma emite o certificado) — essa parte ainda não foi testada em parque real de aparelhos.
- Alguns recursos existem apenas na máquina dedicada: grupos de discagem e fila, salas de conferência, gravação de conversas, toque em número duplicado de ambos os lados, diagnóstico da troca SIP. A PBX instalada no seu PC via ponte e as sobras do servidor compartilhado não os executam; saídas e regras de roteamento também são montadas por quem tem troncos.
- Codecs — G.711 A-law, µ-law e G.722; G.729, Opus e AMR não são suportados. Não há configuração automática de telefones por endereço MAC (provisioning) — os aparelhos são configurados pelos campos da janela do ramal ou pelo seu servidor de provisionamento.
- Países onde a PBX não está disponível (é necessária licença local ou há sanções): Turquia, Belarus, China, Egito, Emirados Árabes Unidos, Catar, Omã, Kuwait, Irã, Coreia do Norte, Cuba, Síria. Na Rússia, a PBX dedicada é permitida e funciona apenas no Yandex Cloud — em
cenaly.ru, o servidor compartilhado ali está fechado. - A voz do sintetizador depende da nuvem: em
cenaly.ru, na lista de idiomas de notificações, há apenas os que o sintetizador local domina (seis). A posição na fila é anunciada em russo e inglês — em outros idiomas a fila funciona, mas não informa a posição. - Conferências v1: só se entra na sala por dentro (uma chamada externa não é transferida para ela), o vídeo mostra o orador ativo e exige o codec VP8; não há lista de participantes, moderação nem gravação de conferências.
- Não vendemos números. Você compra o tronco e o número diretamente com a operadora de telecomunicações — não é possível transferir o número «para dentro» da plataforma, ele permanece com a operadora.
Solução de problemas#
| Sintoma | Verifique |
|---|---|
| O telefone não se registra | o login foi inserido por completo (sip-…-<número>, e não apenas o número), a senha não foi redefinida, o endereço do servidor foi copiado da janela, transporte UDP. Lista completa — configuração de telefones SIP |
| A chamada existe, mas não há áudio ou só se ouve um lado | disque *43 deste aparelho: tom sem a sua voz — procure SIP ALG no roteador, silêncio total — UDP 10000–20000 fechado |
| As chamadas recebidas não chegam | «Visão geral» → «Testar conexão»: ela percorre a cadeia servidor → linha → rota → ramais e indica o primeiro elo rompido. Verifique a caixa «Aceita chamadas» no número e o registro do tronco |
| A chamada feita é rejeitada com «proibido» | se o interruptor de chamadas feitas está ligado, se o teto diário de minutos não foi esgotado, se não é um destino premium |
| A chamada é rejeitada sem motivo claro, o tronco «oscila», há um longo silêncio antes da conexão | abra o diagnóstico do fio na aba «Servidor» e repita a chamada: na troca dá para ver qual lado responde e com qual código |
| As chamadas pararam de passar e ninguém percebeu | o botão «Enviar e-mail quando as chamadas pararem de passar» na «Visão geral» vem ativado por padrão: o e-mail chega se a falha durar 10 minutos |
Análise geral por sintomas — solução de problemas; se nada ajudou, fale conosco — como obter ajuda.
Perguntas frequentes#
É preciso um número externo para começar?#
Não. Sem número, a PBX já recebe chamadas do site e do aplicativo, e os funcionários ligam uns para os outros por ramais. O número é necessário quando os clientes precisam ligar de um telefone comum.
É possível receber chamadas no celular do funcionário?#
Sim, de duas formas. Número herdado — o ramal fica conosco, e a chamada vai para o celular dele pelo canal escolhido (ele não recebe uma conta conosco). Duplicação completa do número — o telefone do funcionário se registra conosco, e então ele participa de grupos, da fila e das regras em pé de igualdade com os demais.
Quanto custa a telefonia?#
A própria PBX é um serviço pago: o servidor dedicado é debitado do saldo da conta por diária (dia completo de funcionamento — o preço do pacote, dias incompletos — proporcional ao tempo, dia em UTC), e a confirmação antes da criação avisa sobre isso. O que foi debitado e por quais dias aparece no cartão do servidor («Débitos por dia») e na seção «Assinatura». As conversas são pagas à sua operadora de telecomunicações conforme a tarifa dela — não somos intermediários nessa cadeia. Os widgets «Chamada do site» e «Retorno de chamada» são gratuitos.
Seções relacionadas#
- Conexão do número da operadora — tronco SIP: registro ou autorização por IP
- Gateway GSM, linha urbana ou ISDN — cartão SIM e linha analógica na sua PBX
- Configuração de telefones SIP — credenciais do ramal, rede, teste de eco
*43, instruções por marca - Hardware: o que se conecta — telefones, bases DECT e gateways no panorama geral do hardware da unidade
- Chamada do site e Retorno de chamada — chamadas de clientes sem número
- Funcionários e turnos — para quem emitir ramais
- Configurações — aba «Contas SIP pessoais» e outras configurações da conta
- Requer atenção — chamadas perdidas e falhas de telefonia na lista geral de tarefas