ConfiguraçõesIntegraçõesFerramentas nativas

Ferramentas nativas do agente

As ferramentas nativas são as ações built-in do motor conecta/ai — abrir chamado, consultar conexão, mandar 2ª via, agendar visita, escalar para humano. Vêm ligadas em toda organização automaticamente; esta tela é o catálogo para você saber o que existe.

Onde fica

Menu Configuração › Integrações › Ferramentas nativas — rota /config/integracoes/tools-nativas. É uma lista somente leitura, com KPIs no topo (total de tools, execuções nos últimos 7 dias, status OK).

Você não liga/desliga tools nativas aqui. O que habilita cada ação é a aba Capacidades do IXC e o modelo de agendamento. Esta página lista tudo; em runtime, o agente filtra pelas capacidades que você deixou ligadas.

Cada tool mostra o rótulo, o nome técnico, a descrição, o selo Ativa e o selo ⚠ destrutiva quando a ação mexe no serviço do cliente.

Catálogo por domínio

Atendimento

  • open_atendimento — abre contato/OS no IXC
  • list_open_atendimentos · add_atendimento_message · transfer_atendimento · close_atendimento
  • check_open_tickets — lista OS abertas (só leitura)

Diagnóstico

  • check_connection_status — online/offline, RX/TX da ONU, consumo, status do contrato, PON
  • get_connection_log — quedas de PPPoE
  • get_daily_usage — consumo diário em GB
  • radius_disconnect ⚠ — força reautenticação PPPoE
  • reboot_onu ⚠ — reinicia a ONU (opt-in)
  • reset_onu ⚠ — reset de fábrica da ONU (opt-in)
  • trust_unblock ⚠ — desbloqueio de confiança
  • release_fup_throttle ⚠ — libera a redução de velocidade por FUP

Financeiro

  • check_open_invoices — boletos em aberto
  • send_second_invoice — 2ª via (PDF + linha digitável + PIX)
  • send_pix_code — só o copia-e-cola do PIX
  • extend_invoice_due_date — promessa de pagamento (até 7 dias)

Fiscal (NFSe)

  • send_last_nota_fiscal · list_notas_fiscais · send_nota_fiscal

Agendamento

  • schedule_visit — agenda visita / OS
  • check_available_slots — até 6 horários (só no modo “IA agenda direto”)

Escalação

  • escalate_to_human — transfere para um atendente humano, com resumo do contexto

Ações destrutivas

As tools marcadas com ⚠ (radius_disconnect, reboot_onu, reset_onu, trust_unblock, release_fup_throttle) têm impacto real no serviço do cliente. Reboot e reset de ONU vêm desligados por padrão e só entram em ação se você habilitar a capacidade correspondente no IXC.

Voz ainda com paridade parcial

Nos canais de texto (WhatsApp), o catálogo completo está disponível ao agente. Na voz (telefone), apenas um subconjunto de tools está exposto ao agente hoje — abrir chamado, consultar conexão, mandar 2ª via, agendar visita e escalar para humano. A paridade total na voz está no roadmap. Se um atendimento por telefone precisa de uma ação que ainda não chegou à voz, o caminho é escalar para um humano.

Veja também

Acesso remoto a roteadoresFerramentas HTTP