RadiusNet conversando com a sua IA

Localiza clientes no RadiusNet do provedor por UM critério: CPF/CNPJ, telefone com DDD, login PPPoE ou código identificador. Retorna os dados cadastrais e os planos de cada cliente (id_cliente_plano, id_plano, plano, status, valor, vencimento, login PPPoE, endereços, região com problema e previsão de retorno), e-mails, telefones e, nas buscas por CPF/CNPJ ou identificador, o status do roteador. É o ponto de partida: use o id_cliente, o identificador e os id_cliente_plano/id_plano/login retornados nas demais ferramentas. A busca por telefone pode trazer mais de um cliente. Senhas e chaves Wi-Fi nunca são exibidas.

Retorna a ficha cadastral completa de um cliente (nome, CPF/CNPJ, RG, nascimento, nome social, representante legal, inscrições, tipo de pessoa, status, restrições de e-mail/SMS, observação, e-mails, telefones e endereços). Informe o id_cliente OU o id_cliente_plano, ambos retornados por buscar_cliente.

Lista os e-mails ATIVOS de um cliente com o id_email de cada um (necessário para alterar_email_cliente). O id_cliente vem de buscar_cliente.

Altera dados no RadiusNet: cadastra um novo e-mail para o cliente (usado em avisos e cobranças). O id_cliente vem de buscar_cliente.

Altera dados no RadiusNet: substitui um e-mail existente do cliente por outro (o endereço antigo é sobrescrito; avisos e cobranças passam a ir para o novo). O id_email vem de listar_emails_cliente.

Altera dados no RadiusNet: ativa ou desativa um e-mail do cliente (um e-mail inativo deixa de receber avisos e cobranças). O e-mail é identificado pelo id_cliente (de buscar_cliente) e pelo endereço exato (de listar_emails_cliente ou buscar_cliente).

Altera dados no RadiusNet: cadastra um novo telefone para o cliente. Sem tipo, o RadiusNet usa "residencial"; sem operadora, "outras". O id_cliente vem de buscar_cliente.

Altera dados no RadiusNet: ativa ou desativa um telefone do cliente (um telefone inativo deixa de ser usado para contato e avisos). Informe o id_cliente (de buscar_cliente), o DDD e o número exatamente como cadastrados (veja telefones[] em buscar_cliente).

Altera dados no RadiusNet com efeito imediato no assinante: muda o status do cadastro para ativo, avisado ou bloqueado. "bloqueado" restringe/corta a navegação do cliente; "ativo" e "avisado" liberam a velocidade do plano. Para desbloqueio por promessa de pagamento prefira registrar_promessa_pagamento. O id_cliente vem de buscar_cliente. A prévia mostra o status atual e o novo. Ferramenta de risco: só fica disponível se o administrador a habilitar na conexão.

Gera o link de download do Termo de Adesão ou do Termo de Cancelamento de um plano do cliente, em PDF ou ODT. Apenas gera o documento: não cancela nem altera o plano. O id_cliente_plano vem de buscar_cliente (planos[]). O link dá acesso a dados pessoais: envie apenas ao titular.

Lista as cobranças de UM plano do cliente (mensalidades e itens avulsos do plano) por situação, com valores, vencimento, linha digitável, juros/multa atualizados e se há promessa de pagamento. O id_cliente_plano vem de buscar_cliente (planos[]). O id_cobranca retornado é usado em obter_documento, obter_pix_cobranca, registrar_promessa_pagamento e liquidar_cobranca.

Lista apenas as cobranças AVULSAS do cliente (taxas de instalação, mudança de endereço, equipamentos…) por situação. O id_cliente vem de buscar_cliente. Para mensalidades e avulsas juntas use listar_cobrancas_cliente.

Lista as cobranças (de planos e avulsas) de um cliente do RadiusNet, filtrando por situação: não pagas, em atraso ou pagas. Retorna valores, vencimento, linha digitável, juros/multa e se já existe promessa de pagamento. O id_cliente vem de buscar_cliente; o id_cobranca retornado é usado em obter_documento (2ª via), obter_pix_cobranca, registrar_promessa_pagamento e liquidar_cobranca.

Lista as cobranças pelo código identificador do cliente (campo identificador de buscar_cliente; não é o id_cliente nem o CPF), por situação. Útil quando o atendimento só tem o identificador.

Relatório de cobranças de TODOS os clientes num período (por vencimento, pagamento, processamento, prestação ou cancelamento), com filtros de situação e de status do cliente. Modo simplificado traz valores, pagamento, código de barras, Pix e links; detalhado inclui itens da cobrança, status do cliente e datas. Paginado (até 50 por página): se possivelmente_ha_mais_paginas for true, peça a próxima página. Para o PDF use obter_documento com o id_cobranca (os links url_pdf_* exigem o token da API).

Consulta se uma cobrança já foi paga (pago "1"/"0", valor pago, vencida ou não) e, se estiver em aberto, devolve o Pix copia e cola. Use para confirmar um pagamento informado pelo cliente. O id_cobranca vem das ferramentas listar_cobrancas_*. Observação: o RadiusNet também usa esta consulta para priorizar a verificação do Pix junto ao banco.

Devolve o código Pix copia e cola (qrcode_copy_paste) de uma cobrança para enviar ao cliente, e se ela já foi paga. O id_cobranca vem das ferramentas listar_cobrancas_*. A imagem do QR Code só vem se pedida (incluir_imagem_qrcode).

Gera o link de download (PDF) de um documento: boleto, fatura e recibo usam o id_cobranca (listar_cobrancas_*); nf (Nota Fiscal 21/22), nfse, nota_debito e nfe usam o código da nota (codigo_nf, codigo_nfse, codigo_nd ou o código da NF-e retornados por listar_notas_fiscais). Boleto só existe para cobrança vinculada a método de pagamento; recibo só para cobrança paga. O link dá acesso a dados pessoais: envie apenas ao titular. Observação: imprimir boleto vencido pode, conforme a configuração do RadiusNet, mudar um cliente bloqueado para "avisado".

Altera dados no RadiusNet: registra uma promessa de pagamento para uma cobrança EM ATRASO. Se o cliente estiver bloqueado, ele passa para "avisado" e a navegação é liberada pelo prazo configurado no RadiusNet; se o pagamento não for compensado no prazo, o cliente volta a ser bloqueado e perde esse benefício em promessas futuras pela API (benefício de uso único). O id_cobranca vem de listar_cobrancas_cliente com filtro at ou att e precisa estar vinculado a um método de pagamento. A prévia mostra a situação atual da cobrança (paga, vencida).

Lista os caixas e os tipos de pagamento vinculados a cada caixa que podem ser usados para liquidar uma cobrança (id_caixa e id_tipo_pagamento para liquidar_cobranca). O id_cobranca vem de listar_cobrancas_*. Exige a permissão "Consultar Tipo de Pagamento e Caixa via API" no RadiusNet.

Operação financeira no RadiusNet: dá baixa (liquida) uma cobrança como paga e gera o recibo. Use somente com pagamento comprovado. Aceita cobranças registradas no banco, cobranças internas e cobranças sem nosso número (liste com listar_cobrancas_cliente filtro npt); cobranças da GerenciaNet ou Boleto Fácil (isGerenciaNet/isBoletoFacil = "1") não podem ser liquidadas. Sem id_caixa/id_tipo_pagamento o RadiusNet usa o caixa padrão da API; quando informados, o par é conferido antes em listar_caixas_tipos_pagamento (um par errado faria o RadiusNet usar o padrão sem avisar). Valor pago, data e juros/multa são opcionais (sem eles, valor integral). Exige a permissão "Liquidar cobranças via API". A prévia mostra a situação atual da cobrança, o caixa e o tipo de pagamento escolhidos e os valores da baixa. Ferramenta de risco: só fica disponível se o administrador a habilitar na conexão.

Lista as notas fiscais de um cliente: Nota Fiscal 21/22 (tipo "NF 21", código em codigo_nf), NFS-e (codigo_nfse), Nota de Débito (codigo_nd) e NF-e/Sefaz, com cobrança vinculada (id_cobranca), valor e datas. Busque pelo id_cliente (de buscar_cliente) OU pelo CPF/CNPJ. Para o PDF use obter_documento com tipo nf, nfse, nota_debito ou nfe e o código da nota.

Lista os setores ativos do provedor (ex.: Técnico, Financeiro). O id_setor é usado em listar_servicos_setor e abrir_atendimento.

Lista os serviços ativos de um setor (ex.: Instalação, Manutenção). O id_setor vem de listar_setores; o id_servico retornado é usado em abrir_atendimento junto com o mesmo id_setor.

Lista os tipos de resolução de atendimento ativos (ex.: Encerrado com sucesso). O id_resolucao_atendimento é usado em finalizar_atendimento.

Lista os atendimentos (chamados) do cliente, em aberto e resolvidos, com protocolo, setor, serviço, situação, data de abertura e a última ocorrência. O id_cliente vem de buscar_cliente; o id_atendimento retornado é usado em adicionar_ocorrencia_atendimento e finalizar_atendimento.

Altera dados no RadiusNet: abre um novo atendimento (chamado) "Em Aberto" para um plano do cliente, gerando protocolo; pode gerar trabalho de campo (instalação, visita técnica). Fluxo: buscar_cliente (id_cliente_plano) → listar_setores (id_setor) → listar_servicos_setor (id_servico). O RadiusNet recusa abrir outro atendimento do mesmo setor e serviço enquanto houver um em aberto: confira antes com listar_atendimentos_cliente. Sem id_funcionario o responsável é a API. A prévia confere o setor e o serviço e mostra os nomes deles.

Altera dados no RadiusNet: registra uma nova ocorrência (andamento/observação) num atendimento EM ABERTO. O id_atendimento vem de listar_atendimentos_cliente ou abrir_atendimento.

Altera dados no RadiusNet: finaliza (resolve) um atendimento em aberto, registrando uma última ocorrência e a descrição da resolução. Não há reabertura pela API. O id_atendimento vem de listar_atendimentos_cliente e o id_resolucao de listar_resolucoes_atendimento. Informe também o id_cliente dono do atendimento: a prévia então mostra o atendimento (protocolo, setor, serviço, situação) e confere que ele é desse cliente e ainda está em aberto.

Lista as ordens de serviço (O.S.) de um plano do cliente com protocolo, datas de abertura, limite, execução e finalização, prioridade, status e resolução. O id_cliente_plano vem de buscar_cliente (planos[]); o id_ordem_servico retornado é usado em listar_imagens_os.

Lista as O.S. de todos os clientes por tipo (normal, instalação ou retirada), mais recentes primeiro. O RadiusNet devolve 200 O.S. por página (fixo) e cada chamada mostra uma parte de 50 dessa página (parte 1 a 4). Para continuar, repita a chamada com os valores de proxima_consulta (próxima parte ou próxima página). O id_ordem_servico é usado em listar_imagens_os.

Lista os links das imagens anexadas a uma O.S. (fotos do técnico e a assinatura do cliente), de qualquer tipo de O.S. O id da O.S. é o id_ordem_servico de listar_os_cliente ou listar_os_por_tipo. As imagens podem conter dados pessoais: compartilhe com cuidado.

Lista os logins PPPoE vinculados a um plano comercial (ex.: "100 MEGAS FIBRA"), com o status de cada plano de cliente, em páginas de 50 (use pagina para avançar até paginas). Use o id_plano retornado em planos[] por buscar_cliente (não é o id_cliente_plano).

Exporta, paginado, os dados de conexão de TODOS os clientes: login PPPoE, MAC, IP, endereço e telefone (a senha PPPoE é sempre ocultada). Útil para relatórios de rede; para um cliente específico prefira buscar_cliente. Filtre por status do cliente e avance com pagina; a resposta não informa o total de páginas: se possivelmente_ha_mais_paginas for true, peça a próxima página. Exportação em massa de dados pessoais: só fica disponível se o administrador a habilitar na conexão.

Consulta as sessões RADIUS (accounting) para diagnosticar quedas e reconexões: início, última atualização e fim de cada sessão (fim vazio = sessão ainda aberta), causa de desconexão, IP IPv4/IPv6 atribuído, MAC (callingstationid) e NAS. Informe ao menos um filtro: login (login PPPoE de buscar_cliente), acctuniqueid ou um período (data_inicio/data_fim). Paginado; use total e paginas da resposta para navegar.

Lista as CTOs (caixas de terminação óptica) com total de portas, portas usadas/livres, área de atuação, endereço e os planos ligados a cada porta (login, id_cliente_plano, porta, status), em páginas de 20 (use pagina para avançar até paginas). Para achar a CTO e a porta de um cliente, informe login ou id_cliente_plano (de buscar_cliente): só as CTOs onde ele está ligado voltam.

Lista os leads indicados por um cliente (programa de indicação do CRM do RadiusNet): nome, contato do indicado, data e situação (converteu_lead: 2 = aguardando, 1 = efetivado, 0 = não efetivado). Informe o CPF de quem indicou (cpf_cnpj de buscar_cliente). Contém dados de terceiros.

Altera dados no RadiusNet: cadastra um novo lead (potencial cliente) no CRM, que passa a aparecer nos processos comerciais do provedor. Nome e telefone são obrigatórios. Se o telefone já existir em outro lead, o RadiusNet pode recusar ou ATUALIZAR o lead existente, conforme a configuração.