For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ligação

O canal Ligação conecta uma central telefônica SIP à plataforma Hyperflow, permitindo receber e realizar chamadas de telefone a telefone. Este guia cobre esse canal. A ligação por WhatsApp é configurada em outro lugar e não faz parte deste guia.

Imagem 1 - Canais de ligação conectados como exemplo.

🗂️ Como acessar

  1. No menu lateral do Hyperflow Integrações, clique em Canais.

  2. Clique em + Novo canal.

  3. Selecione o tipo Ligação.

  4. Configure as três abas descritas a seguir: Conexão, Ramais e Horários de atendimento.


🔌 Aba Conexão

Reúne os dados de conexão com a sua central SIP e o comportamento do canal quando uma ligação não pode ser atendida.

Imagem 2 - Aba Conexão preenchida com os campos de credenciais SIP
Campo
O que preencher

Nome

Nome para identificar este canal na plataforma

Tipo de canal

Receptivo, Ativo ou Ambos: define se este canal atende, faz ligações, ou os dois

SBC de saída (IP ou domínio)

Para onde enviamos as ligações que você faz por este canal, fornecido pela sua operadora

Usuário

Credencial de autenticação no servidor

Senha

Senha de autenticação

IPs de entrada

IPs de onde a operadora envia as ligações. Ligações vindas de outro IP são recusadas. Só aparece quando o Tipo de canal é Receptivo ou Ambos

Número principal

Número de telefone principal deste canal, com país e DDD

🎯 Propósito

Estabelecer a conexão com a operadora de telefonia e definir o que acontece quando o canal não consegue atender uma ligação recebida.

✅ Como fazer na tela

  1. Preencha as credenciais fornecidas pela sua operadora SIP, o Número principal e, se o canal receber ligações, os IPs de entrada autorizados.

  2. Copie o IP de whitelist mostrado na tela e peça para sua operadora ou equipe de servidor liberar esse IP de origem. Sem isso, a operadora pode bloquear a conexão.

  3. Em Resposta de indisponibilidade, ative a opção e escolha o que acontece quando a ligação não puder ser atendida: Áudio (reproduz uma mensagem para o cliente e, em seguida, encerra a ligação automaticamente) ou Fluxo Builder (executa um fluxo do Hyperflow Integrações configurado por você).

Imagem 3 - Seção "Resposta de indisponibilidade" com a opção de áudio selecionada

O áudio pode ser escolhido da biblioteca do canal ou enviado na hora, em qualquer formato comum de áudio (o sistema converte automaticamente para .wav).

📌 Resultado esperado

O cabeçalho do canal mostra um indicador de status: verde quando o canal está conectado, cinza quando está desconectado.

Sem uma resposta de indisponibilidade configurada, a ligação é recusada com sinal de ocupado.


📞 Aba Ramais

Lista os ramais deste canal e para onde cada um direciona a ligação.

Imagem 3 - Aba Ramais com a tabela de roteamento preenchida

A tabela mostra colunas Nome, Número, Destino, Detalhe e Ações. Cada ramal tem um nome e um número de telefone completo associado, e direciona para um fluxo do Hyperflow Integrações.

O canal sempre tem um ramal fixo — o Ramal principal, com o mesmo número informado na aba Conexão. Ele não pode ser excluído, e você precisa escolher para onde ele direciona antes de conseguir salvar o canal.

🎯 Propósito

Definir, para cada ramal deste canal, o que acontece quando ele recebe uma ligação.

✅ Como fazer na tela

  1. Clique em Adicionar Ramal.

  2. Informe o Nome (para identificar o ramal na lista) e o Número de telefone completo, com DDD (campo obrigatório).

  3. Escolha o Fluxo do Hyperflow Integrações que vai atender esse ramal.

  4. Salve.

Imagem 4 - Diálogo "Adicionar Ramal" com tipo de destino "Departamento" selecionado

Ramais antigos que apontavam para um Departamento continuam funcionando normalmente e mostram essa informação na tabela. Mas ao abrir um desses ramais para editar, só é possível salvá-lo apontando para um Fluxo — a opção de Departamento não está mais disponível na tela de edição.

📌 Resultado esperado

O ramal aparece na tabela e passa a rotear as próximas ligações que chegarem para ele.


🕐 Aba Horários de atendimento

Define em quais dias e horários cada departamento ou ramal aceita chamadas, e o que fazer fora desse período.

Imagem 5 - Lista de horários configuráveis, com regras por departamento ou por ramal específico

🎯 Propósito

Evitar que ligações cheguem fora do expediente sem nenhuma resposta configurada.

✅ Como fazer na tela

  1. Clique em Adicionar Horário.

  2. Escolha o tipo de escopo: Departamento ou Ramal específico (opcional).

  3. Selecione os dias da semana e a hora inicial e final.

  4. Em Ação fora do horário, escolha uma das três opções: Recusar com sinal de ocupado (padrão, sem nenhuma ação extra), Áudio (toca uma mensagem) ou Fluxo Builder (executa um fluxo do Hyperflow Integrações).

  5. Salve.

Quando um ramal específico tem sua própria regra, ela sempre prevalece sobre a regra do departamento, inclusive para a ação fora do horário.

📌 Resultado esperado

Fora do horário configurado, a ação escolhida é executada. Sem nenhuma ação configurada, a ligação é recusada com sinal de ocupado.


💡 Dicas úteis

  • O IP de whitelist mostrado na aba Conexão precisa ser liberado pela sua operadora ou equipe de servidor antes que as ligações funcionem — não confunda com os IPs de entrada, que são os IPs da sua própria operadora.

  • Configure sempre uma resposta de indisponibilidade e uma ação fora do horário: sem elas, o cliente ouve apenas o sinal de ocupado.

  • O Ramal principal precisa ter um destino escolhido antes de salvar o canal — a tela bloqueia o salvamento e avisa se ele ainda não tiver.

  • Ramal novo só pode ser direcionado para um Fluxo. Se você precisa que uma ligação caia direto num departamento sem passar por um fluxo, fale com o time Hyperflow.

  • Depois de criar os ramais aqui, é no Hyperflow Conversas (tela Chamadas → Departamentos) que você organiza como as ligações são distribuídas entre os agentes.

  • Nos fluxos do Hyperflow Integrações usados pelos ramais e pelas ações fora do horário, os nós que realmente atuam durante uma ligação ficam agrupados na categoria Ligações da paleta: Ligações (atender), Transferir URA e Encerrar Ligação. O nó Posição na Fila não aparece mais na paleta para fluxos novos, por não ter efeito real durante uma ligação de voz.


📌 Resumo

  • O canal Ligação é configurado com três abas: Conexão, Ramais e Horários de atendimento.

  • Na aba Conexão, você informa Nome, Tipo de canal (Receptivo, Ativo ou Ambos), as credenciais SIP, o SBC de saída, os IPs de entrada (novo — allowlist de quem pode ligar para você), o número principal, libera o IP de whitelist junto à operadora e define a resposta de indisponibilidade (Áudio ou Fluxo Builder).

  • Na aba Ramais, cada ramal tem um nome e um número de telefone completo e direciona para um Fluxo. O canal sempre tem um Ramal principal, fixo e obrigatório configurar. Nome e número não podem se repetir no canal, nem o número em outro canal de Ligação.

  • Na aba Horários de atendimento, regras por departamento ou por ramal específico definem quando aceitar chamadas, com três opções de ação fora do horário (recusar, áudio ou fluxo); o ramal específico sempre prevalece sobre a regra do departamento.

  • Sem ação configurada (de indisponibilidade ou fora do horário), a ligação é sempre recusada com sinal de ocupado.

Last updated