C cenaly.com
Começar grátis

Telefonia: PABX Próprio

PABX próprio do estabelecimento no painel: linhas e números, ramais e grupos de chamada, roteamento e horários, gravação e análise de chamadas, recepcionista com IA e prompter, telefones e gateways — visão geral da seção e por onde começar

On this page 18

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:

  1. 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;
  2. linha pessoal do funcionário — "uma para cada";
  3. 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:

  1. 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).
  2. Enquanto a janela estiver aberta, repita aquela mesma chamada — o trace mostra apenas o que aconteceu com a janela aberta.
  3. 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.
  4. "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#

Was this article helpful?