Felina
Contas

Contas Client

Conecte contas do Telegram (número de telefone) para automações em massa.

O que é

Contas Client (/contas) são contas do Telegram ligadas a um número de telefone — a conta “de gente”, não o bot.

Elas alimentam automações como criar canais em massa e promover admins em massa, que o bot sozinho não cobre bem.

Para que serve

  • Criar vários canais de uma vez
  • Colocar administradores em lote
  • Operações que exigem login de conta de usuário no Telegram

Status que você pode ver

  • Conectada — pronta para usar
  • Conectando — no meio do login
  • Desconectada — precisa conectar de novo
  • Morta / Erro — a sessão caiu de verdade; na linha tem Reconectar (mesmo fluxo de ligar: código do Telegram). Erro no aquecimento não mata a conta — o aviso fica na tela de Aquecimento.

Como conectar

  1. Abra Contas Client

    Menu Contas Client → /contas.

  2. Conectar Conta

    Clique em Conectar Conta.

  3. Informe o telefone — ou o arquivo

    Use o número no formato internacional que o Telegram espera (com DDI).

    Ou mande o arquivo de sessão (.session) ou a string (Telethon ou Pyrogram). API ID e Hash são opcionais nessa via.

  4. Escolha o proxy (opcional)

    No mesmo formulário, o campo Proxy lista o que você cadastrou em Proxies. Escolha um ou deixe Sem proxy. Sem cadastro, a lista diz Nenhum proxy ainda — abra Recursos → Proxies e volte.

  5. Digite o código

    O Telegram envia um código de login no app. Cole na Felina no passo Ler Código de Login / campo de código.

    Se pedir senha de verificação em duas etapas, informe a senha da conta — a do Telegram, não a da Felina. Depois, ligar, trocar ou tirar fica no card da página da conta.

  6. Confira o status

    Quando ficar Conectada, a conta aparece na lista e pode ser usada nas automações.

Reconectar

Se a linha estiver Morta, Erro ou Desconectada, clique em Reconectar. Abre o mesmo fluxo de Conectar Conta (código no Telegram, senha se pedir). Não cria outra conta com o mesmo número.

Categorias

As categorias organizam as contas (ex.: por projeto ou chip). Dá para criar, ligar na conta e filtrar a lista.

  1. Crie a categoria

    Em /contas, clique em Categorias. Escreva o nome, escolha a cor se quiser e salve.

  2. Escolha ao conectar

    Em Conectar Conta, o campo Categoria (opcional) já aparece no formulário. Escolha uma ou deixe Sem categoria.

  3. Troque no card ou na tabela

    Conta já ligada: no card ou na linha da tabela, abra o seletor de categoria e escolha outra — ou Sem categoria para tirar. Não precisa reconectar.

  4. Filtre a lista

    No filtro ao lado do status, escolha Todas as categorias, Sem categoria ou uma categoria. A lista mostra só o que bate.

Página da conta

Clique no card. Abre a página daquela conta: canais, grupos, bots, há quanto tempo está na Felina e o que aconteceu com a ligação. Canal ou grupo que ainda não está na Felina tem Adicionar. Morta ou Erro mostra o porquê.

Na conta Conectada, o card tem Editar perfil para foto, bio e @ no Telegram. Veja Foto, bio e @.

No mesmo card, o seletor Proxy liga ou tira o proxy da conta (Sem proxy). Mais abaixo, os cards Dispositivos e Senha de duas etapas — aparelhos da sessão e senha do Telegram.

Vista Tabela

Use o seletor de visualização (ícone de grade/tabela no canto dos filtros) para alternar entre Cards e Tabela.

Na Vista Tabela, cada linha exibe as colunas: Nome, Número, Categoria, API ID, API Hash, Status e Ações. Na coluna Número, o ícone ao lado do telefone copia o número.

Ordenar por nome

Clique no título Nome da tabela. O 1º clique põe as contas em ordem alfabética A→Z (seta para cima), o 2º em Z→A (seta para baixo) e o 3º volta à ordem original. Acento e maiúscula não mudam a ordem (Ágata fica junto do A). A ordem vale junto com a busca e os filtros, e continua se você trocar para Cards.

Atualizar dados da conta

Na coluna Ações, o ícone de atualizar (setas em círculo) puxa do Telegram o nome, o @ e o id e grava na Felina. Use quando o perfil mudou no app e a lista ainda mostra o antigo. Enquanto busca, o ícone gira. Se a conta não estiver ligada, aparece um aviso — conecte e tente de novo.

Cadastrar ou atualizar API ID e API Hash na linha

  1. No campo API ID da linha, cole ou edite o número do seu app Telegram.
  2. No campo API Hash: se a conta já tem hash salvo, você vê bolinhas (••••••••), com Mostrar / Ocultar e Copiar. Se ainda não tem, o campo fica vazio com Colar API Hash — cole o valor novo.
  3. Quando houver alteração, aparece o botão Salvar na coluna Ações. Clique para gravar.

Copiar API ID ou API Hash

  • Ícone de copiar ao lado do API ID: copia o número da linha (campo digitado ou o que já estava salvo).
  • Ícone de copiar ao lado do API Hash: se você colou um valor, copia esse. Se o hash já estava salvo, a Felina busca o valor gravado e copia — mesmo com as bolinhas na tela. Sem hash salvo e sem nada colado, avisa que a conta ainda não tem hash.

Duas formas de ligar

Em Conectar Conta você pode:

  • Telefone + código + API ID e Hash
  • Arquivo de sessão (ou a string); API ID e Hash se você tiver

Uma forma não apaga a outra. No card, Completar ligação serve para pôr a que faltou.

O que acontece depois

Nas telas de Automações, você escolhe qual conta Client executar a tarefa. Sem conta Conectada, a automação não roda.

Cuidados

Use contas que você controla. Login é sensível: não compartilhe sessão nem código de acesso.

  • Conta banida no Telegram não resolve “na Felina” — o bloqueio é do Telegram
  • Se desconectar no celular de forma agressiva, a sessão na Felina pode cair

Problemas comuns

  • Código não chega — confira o app Telegram no celular daquele número
  • Fica em Conectando — cancele e tente de novo; confira internet
  • Morta ou Desconectada — clique em Reconectar na linha (ou na página da conta). Não use Conectar Conta com o mesmo número.

Próximos passos