Ferramentas do sistema · NeuralClint

As 87 ações de negócio do NeuralClint — a mesma lista usada pela interface e pelo Copilot.

Toda ação de negócio do NeuralClint é uma ferramenta registrada uma única vez, com entrada validada. A interface, o Copilot e as integrações chamam exatamente essas ferramentas. Ferramentas do tipo Consulta só leem dados e o Copilot as executa na hora; as do tipo Altera sempre passam pelo plano de ações.

Ferramentas que recebem segredos (conectar WhatsApp oficial, Instagram e salvar chaves de IA) existem para a interface, mas ficam fora do alcance do Copilot.

Contatos (9)

Ferramenta	Tipo	O que faz
contacts_create	Altera	Cria um contato (cliente/lead) no CRM.
contacts_list	Consulta	Lista contatos, com busca por nome/telefone/e-mail e filtro por tag.
contacts_get	Consulta	Perfil completo do contato: dados, tags, campos personalizados, negócios, conversas e notas.
contacts_update	Altera	Atualiza dados do contato. Campos personalizados vão em `custom` pela chave (veja contact_fields_list); null apaga o valor.
contacts_delete	Altera	Remove um contato pelo id (e as conversas dele).
contacts_add_note	Altera	Adiciona uma nota interna ao contato (visível só para a equipe).
contacts_delete_note	Altera	Remove uma nota de contato.
contacts_add_tags	Altera	Adiciona tags a um contato pelo nome (tags que não existem são criadas).
contacts_remove_tag	Altera	Remove uma tag de um contato (pelo nome da tag).

Contatos em massa e importação (5)

Ferramenta	Tipo	O que faz
contacts_search	Consulta	Busca contatos com filtros (tags, canal, período de cadastro, atividade recente ou inatividade, negócio aberto, dados faltando), ordenação e paginação. Devolve { items, total }.
contacts_bulk_tags	Altera	Adiciona e/ou remove tags (pelo nome) de vários contatos de uma vez. Tags novas são criadas e podem disparar fluxos com gatilho 'Tag adicionada'.
contacts_bulk_delete	Altera	Exclui vários contatos de uma vez (com suas conversas).
contacts_import	Altera	Importa contatos (ex.: de uma planilha). Quem já existe (mesmo e-mail ou telefone) é atualizado, sem duplicar. Linhas sem e-mail e sem telefone são ignoradas. Não dispara fluxos.
contacts_import_file	Altera	Importa contatos de um arquivo CSV anexado (pelo fileId). Informe, pelo nome do cabeçalho, quais colunas são nome, telefone, e-mail e tags; o que não for informado é reconhecido pelo cabeçalho. Não duplica (atualiza quem já existe pelo e-mail ou telefone) e não dispara fluxos.

Tags (4)

Ferramenta	Tipo	O que faz
tags_list	Consulta	Lista as tags do workspace e quantos contatos têm cada uma.
tags_create	Altera	Cria uma tag (etiqueta) para segmentar contatos.
tags_update	Altera	Renomeia ou muda a cor de uma tag.
tags_delete	Altera	Exclui uma tag (ela sai de todos os contatos).

Campos personalizados (4)

Ferramenta	Tipo	O que faz
contact_fields_list	Consulta	Lista os campos personalizados de contato (chave, rótulo, tipo e opções).
contact_fields_create	Altera	Cria um campo personalizado de contato (ex.: CPF, cidade, plano). Em textos de fluxos o valor é {{contact.custom.chave}}.
contact_fields_update	Altera	Altera rótulo, opções ou ordem de um campo personalizado (a chave não muda).
contact_fields_delete	Altera	Exclui um campo personalizado (os valores salvos nos contatos são mantidos, mas ocultos).

Funis e negócios (10)

Ferramenta	Tipo	O que faz
pipelines_list	Consulta	Lista os funis de vendas com suas etapas (em ordem). Cria o funil padrão se não houver nenhum.
pipelines_create	Altera	Cria um funil de vendas com as etapas informadas (inclua ao menos uma etapa de ganho e uma de perda).
pipelines_update	Altera	Renomeia o funil e/ou redefine as etapas (ordem, nomes, cores). Etapas omitidas são removidas — só se não tiverem negócios.
pipelines_delete	Altera	Exclui um funil e todos os negócios dele.
deals_list	Consulta	Lista os negócios de um funil (com contato), em ordem de etapa e posição.
deals_create	Altera	Cria um negócio no funil. Sem pipelineId/stageId, usa o primeiro funil e a primeira etapa. Valor em reais.
deals_update	Altera	Altera título, valor (em reais), contato, responsável ou previsão de fechamento de um negócio.
deals_move	Altera	Move um negócio para outra etapa (e posição na coluna). Etapas de ganho/perda fecham o negócio.
deals_delete	Altera	Exclui um negócio.
pipelines_metrics	Consulta	Indicadores de um funil: valor em aberto, taxa de conversão, vendas ganhas, ticket médio, ciclo de venda, conversão por etapa, tempo em cada etapa, perdas por etapa, evolução no tempo e desempenho por responsável. periodDays nulo = desde sempre.

Canais (7)

Ferramenta	Tipo	O que faz
channels_list	Consulta	Lista os canais conectados (WhatsApp, Instagram) e o status de cada um.
channels_connect_whatsapp_cloud	Altera	Conecta um número da API oficial do WhatsApp (Cloud API). Valida o token na Meta antes de salvar.
channels_connect_instagram	Altera	Conecta uma conta profissional do Instagram para receber e responder DMs. Valida o token antes de salvar.
channels_connect_whatsapp_web	Altera	Conecta um WhatsApp pelo QR code (API não-oficial). Depois, use channels_whatsapp_web_status para obter o QR e acompanhar a conexão.
channels_whatsapp_web_status	Consulta	Status de um WhatsApp conectado por QR code: connecting, qr (com a imagem do QR para escanear), connected ou disconnected.
channels_whatsapp_web_reconnect	Altera	Gera um novo QR code para um WhatsApp não-oficial que foi desconectado.
channels_disconnect	Altera	Remove um canal e todo o histórico de conversas dele.

Inbox (7)

Ferramenta	Tipo	O que faz
conversations_list	Consulta	Lista as conversas do inbox, mais recentes primeiro, com contato, canal e prévia da última mensagem.
conversation_messages	Consulta	Retorna as mensagens de uma conversa em ordem cronológica.
conversation_mark_read	Altera	Zera o contador de não lidas de uma conversa.
conversation_update	Altera	Altera o status (open, pending, closed) e/ou o atendente responsável de uma conversa.
messages_send	Altera	Envia uma mensagem ao cliente na conversa, pelo canal dela: texto e/ou um anexo (fileId de um arquivo enviado pelo inbox).
messages_send_template	Altera	Envia um template aprovado do WhatsApp oficial na conversa. Funciona fora da janela de 24h; use whatsapp_templates_list para ver nomes e variáveis.
conversation_suggest_reply	Consulta	Gera com IA uma sugestão de mensagem para o atendente revisar (não envia). mode: reply (responder) ou improve/formal/friendly/shorter (reescrever o rascunho).

IA, agentes e conhecimento (15)

Ferramenta	Tipo	O que faz
conversation_set_ai	Altera	Pausa (humano assume) ou retoma a IA em uma conversa. Ao retomar, a IA responde se houver mensagem do cliente sem resposta.
ai_providers_list	Consulta	Lista os provedores de IA (Anthropic/Claude, OpenAI, Google/Gemini, DeepSeek) e quais já têm chave configurada.
ai_providers_set_key	Altera	Salva a chave de API de um provedor de IA. Valida a chave no provedor antes de salvar.
ai_providers_remove_key	Altera	Remove a chave de um provedor de IA.
ai_models_list	Consulta	Lista os modelos disponíveis em um provedor de IA (consulta ao vivo com a chave salva).
agents_list	Consulta	Lista os agentes de IA do workspace.
agents_create	Altera	Cria um agente de IA que atende clientes. Depois, conecte-o a canais com channels_set_agent.
agents_update	Altera	Altera um agente de IA (instruções, modelo, ativo/inativo…).
agents_delete	Altera	Remove um agente de IA (os canais dele deixam de ter resposta automática).
channels_set_agent	Altera	Define qual agente de IA responde automaticamente em um canal (ou null para desligar).
agents_test	Consulta	Conversa de teste com um agente (nada é enviado ao cliente). Use para validar as instruções antes de ativar.
knowledge_list	Consulta	Lista as fontes da base de conhecimento (textos e páginas) e o status de cada uma.
knowledge_add_text	Altera	Adiciona um texto à base de conhecimento (FAQ, políticas, catálogo…). Sem agentId, vale para todos os agentes.
knowledge_add_url	Altera	Adiciona uma página da web (site, FAQ, catálogo) à base de conhecimento.
knowledge_delete	Altera	Remove uma fonte da base de conhecimento.

Fluxos (11)

Ferramenta	Tipo	O que faz
flows_list	Consulta	Lista os fluxos de automação (nome, status, gatilho, versão publicada).
flows_get	Consulta	Retorna um fluxo com o rascunho completo (nós e conexões).
flows_create	Altera	Cria um fluxo de automação (rascunho).
flows_update	Altera	Atualiza o nome e/ou o rascunho de um fluxo (não afeta a versão publicada).
flows_publish	Altera	Valida e publica o rascunho como nova versão, e ativa o fluxo. Retorna os problemas encontrados se não puder publicar.
flows_set_status	Altera	Ativa ou pausa um fluxo publicado (pausado não dispara novas execuções).
flows_start_contacts	Altera	Inicia um fluxo publicado para vários contatos (ex.: uma campanha para quem tem certa tag). Cada um usa a conversa mais recente; com o bloco 'Enviar template', o fluxo também alcança quem nunca conversou pelo WhatsApp oficial.
flows_delete	Altera	Exclui um fluxo e o histórico de execuções.
flows_start	Altera	Inicia manualmente um fluxo publicado em uma conversa (útil para gatilho manual).
flows_runs	Consulta	Lista as últimas execuções de um fluxo (status, onde parou, erro).
flows_run_steps	Consulta	Passo a passo de uma execução (por onde passou, saídas tomadas, mensagens e erros).

Integrações (7)

Ferramenta	Tipo	O que faz
integrations_catalog	Consulta	Lista as plataformas que podem ser integradas por webhook (Hotmart, Kiwify, Eduzz, Stripe…) e onde cadastrar a URL em cada uma.
integrations_list	Consulta	Lista as integrações conectadas, com a URL do webhook (webhookPath, relativa ao domínio do app) e a data do último evento.
integrations_create	Altera	Conecta uma plataforma (provider = id do integrations_catalog) e gera a URL de webhook para colar no painel dela. Compras viram contatos com tags e podem iniciar fluxos.
integrations_update	Altera	Renomeia, pausa/ativa ou muda o que uma integração faz com os eventos recebidos.
integrations_rotate_url	Altera	Gera uma nova URL de webhook (a antiga para de funcionar). Use se a URL vazou.
integrations_delete	Altera	Remove uma integração (a URL do webhook deixa de funcionar).
integrations_events	Consulta	Últimos eventos recebidos das integrações (compras, reembolsos…), com o status do processamento.

Templates do WhatsApp (4)

Ferramenta	Tipo	O que faz
whatsapp_account_set	Altera	Vincula o ID da conta do WhatsApp Business (WABA) ao número oficial; necessário para gerenciar templates.
whatsapp_templates_list	Consulta	Lista os templates do WhatsApp oficial com o status de aprovação da Meta (APPROVED, PENDING, REJECTED…).
whatsapp_templates_create	Altera	Cria um template do WhatsApp oficial e envia para aprovação da Meta (leva de minutos a algumas horas). Use {{1}}, {{2}}… como variáveis, com um exemplo para cada. MARKETING para ofertas e recuperação de vendas; UTILITY para avisos de pedido, pagamento e agendamento.
whatsapp_templates_delete	Altera	Exclui um template do WhatsApp oficial (na Meta).

Respostas rápidas (4)

Ferramenta	Tipo	O que faz
quick_replies_list	Consulta	Lista as respostas rápidas do inbox (atalho e texto).
quick_replies_create	Altera	Cria uma resposta rápida, usada no inbox digitando /atalho.
quick_replies_update	Altera	Altera o atalho ou o texto de uma resposta rápida.
quick_replies_delete	Altera	Exclui uma resposta rápida.