IXC Provedor conversando com a sua IA

Busca clientes no IXC Provedor por UM critério: CPF/CNPJ, nome (contém), telefone/WhatsApp, e-mail (contém) ou código do cliente. Retorna um resumo de cada cliente (código em `id`, nome/razão social, documento, contatos, endereço, situação). Use o `id` retornado como id_cliente nas demais ferramentas (obter_resumo_cliente, listar_contratos, listar_faturas...).

Visão 360° de um cliente para atendimento: cadastro completo, contratos (com status de acesso), logins PPPoE/RADIUS (online/offline), faturas em aberto (marcando as vencidas), atendimentos e ordens de serviço em aberto. id_cliente vem de buscar_clientes. Use os ids retornados nas ferramentas específicas (id do contrato, do login, da fatura...). Senhas nunca são exibidas.

Lista os contratos de um cliente do IXC com status do contrato (P=Pré-contrato, A=Ativo, I=Inativo, N=Negativado, D=Desistiu), status de acesso status_internet (A=Ativo, D=Desativado, CM=Bloqueio manual, CA=Bloqueio automático, FA=Financeiro em atraso, AA=Aguardando assinatura), velocidade (N=Normal, R=Reduzida) e regras de desbloqueio de confiança. id_cliente vem de buscar_clientes; o `id` de cada contrato é o id_contrato das demais ferramentas.

Detalha um contrato do IXC: cadastro completo do contrato, plano de venda (nome e valor), produtos do plano, produtos/descontos próprios do contrato e serviços adicionais. id_contrato vem de listar_contratos ou obter_resumo_cliente.

Lista os planos de venda do IXC (nome, tipo e valor do contrato), por padrão só os ativos. Útil para dúvidas de upgrade/preço. O `id` corresponde ao id_vd_contrato dos contratos.

Altera o acesso no IXC: executa o desbloqueio de confiança de um contrato bloqueado por inadimplência (status_internet CA ou FA), liberando a navegação pelo prazo configurado no IXC. Só funciona se o contrato/IXC permitir (campo desbloqueio_confianca diferente de N e sem desbloqueio ativo). A prévia mostra a situação atual do contrato e avisa quando o desbloqueio não se aplica.

Altera o acesso no IXC: libera temporariamente o acesso de um contrato bloqueado (botão "Liberar temporariamente"), conforme a política do provedor. Alternativa ao desbloqueio de confiança. A prévia mostra a situação atual do contrato.

Altera o serviço no IXC: remove a redução de velocidade aplicada a um contrato (status_velocidade R = Reduzida volta ao normal). A prévia mostra a situação atual do contrato e avisa quando a velocidade não está reduzida.

Lista as faturas/títulos a receber do IXC de um cliente ou contrato, por situação: abertas (inclui parciais), vencidas, pagas, canceladas ou todas, com filtro opcional por vencimento (DD/MM/AAAA). Mostra valores, vencimento, status (A=a receber, R=recebido, P=parcial, C=cancelado), linha digitável, link de pagamento (gateway_link) e se está vencida. O `id` é o id_fatura de obter_boleto, obter_pix_fatura, baixar_boleto_pdf e enviar_boleto.

Retorna os dados do boleto de uma fatura para 2ª via (linha digitável, nosso número, valores e vencimento) sem alterar nada: não recalcula juros/multa nem atualiza o boleto. Funciona para faturas do tipo Boleto; para gateway/Pix use obter_pix_fatura ou o gateway_link de listar_faturas.

Retorna o Pix de uma fatura: código "copia e cola" (pixCopiaECola), valor, vencimento, status e validade. Requer gateway Pix configurado no IXC. A imagem do QR Code só vem com incluir_qrcode (é grande); o código copia e cola sempre basta para pagar.

Gera o PDF do boleto de uma fatura (sem recalcular nem atualizar) e o devolve em base64 SOMENTE se for pequeno (até ~33 KB); útil em automações que anexam o arquivo. Em conversas, prefira obter_boleto (linha digitável), obter_pix_fatura ou enviar_boleto (e-mail/SMS pelo IXC).

Envia uma mensagem ao cliente: pede ao IXC para enviar o boleto de uma fatura por e-mail ou SMS usando o contato cadastrado e a configuração de envio do IXC. Não recalcula nem altera a fatura. Cada execução envia uma nova mensagem. A prévia mostra a fatura e avisa se ela já está paga ou cancelada.

Lista atendimentos (tickets) do IXC por cliente, protocolo, código ou departamento, filtrando por situação (abertos = Novo/Pendente/Em progresso; solucionados; cancelados; todos). su_status: N=Novo, P=Pendente, EP=Em progresso, S=Solucionado, C=Cancelado. Com incluir_mensagens e um único atendimento, traz também as interações. O `id` é o id_atendimento de responder_atendimento e abrir_ordem_servico.

Cria um atendimento no IXC com um novo protocolo válido (gerar_protocolo_atendimento) e devolve o protocolo e o id. id_cliente vem de buscar_clientes; id_assunto e id_departamento de consultar_cadastros_auxiliares (tipos assuntos e departamentos); id_contrato/id_login são opcionais. Cada execução cria um novo ticket. A prévia mostra o cliente e o ticket que será criado.

Registra uma interação em um atendimento do IXC (mensagem) e define o novo status: em_progresso (padrão), pendente, solucionado (encerra) ou cancelado. id_atendimento vem de listar_atendimentos. A prévia mostra o atendimento atual e avisa se ele já está encerrado.

Lista ordens de serviço (O.S.) do IXC por cliente, técnico, setor, atendimento de origem ou protocolo, por situação (abertas = não finalizadas; finalizadas; todas) ou status exato (A=Aberta, AN=Análise, EN=Encaminhada, AS=Assumida, AG=Agendada, DS=Deslocamento, EX=Execução, F=Finalizada, RAG=Aguardando agendamento) e período de abertura (DD/MM/AAAA). Ids de técnico e setor vêm de consultar_cadastros_auxiliares.

Cria uma ordem de serviço (visita técnica) no IXC com novo protocolo, vinculada ao cliente e, opcionalmente, ao login, contrato e atendimento de origem. id_cliente vem de buscar_clientes; id_assunto e id_setor de consultar_cadastros_auxiliares (assuntos com finalidade OS/AM e setores; o assunto informa se login/contrato são obrigatórios). A filial padrão é a do cliente. Cada execução cria uma nova O.S. A prévia mostra o cliente e a O.S. que será criada.

Lista os logins de acesso (PPPoE/RADIUS/hotspot) do IXC por UM critério: cliente, contrato, login exato, MAC ou IP. Mostra se está ativo e online (S/N/SS = sem status), IP, MAC, concentrador, última conexão/desconexão e motivo, consumo atual e SSID. Senhas nunca são exibidas. O `id` de cada login é o id_login usado por diagnosticar_conexao, consultar_sinal_onu, desconectar_login e limpar_mac_login.

Diagnóstico de "cliente sem internet/lento" em uma chamada: situação do login (online, IP, última desconexão e motivo), status de acesso e velocidade do contrato (bloqueios), sinal da ONU (fibra) e últimas sessões RADIUS, com dicas objetivas. Informe UM: id_login (de listar_logins/obter_resumo_cliente), login PPPoE ou id_contrato.

Lista as sessões RADIUS (radacct) de um login PPPoE ou de um IP: início, fim, duração em segundos, motivo de desconexão, MAC, IPs e concentrador, das mais recentes para as mais antigas. Útil para investigar quedas. Datas no formato DD/MM/AAAA. O login vem de listar_logins.

Mostra os dados de fibra da ONU do cliente: potência RX/TX (dBm), temperatura, voltagem, data da coleta, causa da última queda, distância, OLT/slot/PON. São os valores da ÚLTIMA COLETA do IXC (campo data_sinal), não uma leitura em tempo real. Opcionalmente traz o histórico de potência. Informe UM: id_login (de listar_logins), id_contrato ou o MAC/serial da ONU.

Verifica se há viabilidade técnica (cobertura) para instalação em um endereço OU em uma coordenada. Requer o módulo InMap com "Autoviabilidade" habilitado no IXC. Informe endereço, número, cidade e UF, ou latitude e longitude.

Altera a conexão do cliente: derruba a sessão PPPoE/RADIUS do login no concentrador para forçar a reconexão (o "reset" clássico para problemas de navegação). O cliente fica sem internet por alguns segundos. A prévia mostra a sessão atual do login.

Altera o cadastro do login: remove o MAC vinculado (necessário após troca de roteador/ONU quando o login está preso ao MAC antigo). O próximo equipamento que autenticar grava o novo MAC. A prévia mostra o MAC atual do login.

Retorna os ids e nomes dos cadastros auxiliares do IXC necessários para abrir atendimentos e O.S.: assuntos, departamentos (de atendimento), setores (de O.S.), técnicos, filiais, canais de atendimento, diagnósticos e respostas padrão. Por padrão só os ativos. Use antes de abrir_atendimento, abrir_ordem_servico e para filtrar listar_ordens_servico.

Testa a conexão com o IXC (URL, certificado, token, IP liberado) e verifica a quais áreas o usuário da API tem acesso de leitura (clientes, contratos, logins, fibra, financeiro, atendimentos, O.S., planos). Use quando outras ferramentas falharem por permissão ou acesso.

Consulta de leitura para usuários avançados em uma lista fechada de tabelas do IXC, com até 5 filtros combinados por E (o IXC não aceita OU). Operadores: = != > < >= <=, L (contém), NL (não contém), IN/NI (lista separada por vírgulas), BE/NBE (entre valor e valor_final). Datas de calendário em DD/MM/AAAA; data e hora em AAAA-MM-DD HH:MM:SS. Prefira as ferramentas específicas; use `campos` para trazer só as colunas necessárias. Segredos são ocultados e campos de senha/credenciais não podem ser usados em filtros nem na ordenação.