Radar MCP Tools

Lista/busca empresas do cadastro. Filtra por texto (nome, CNPJ, cidade, setor) e status. Retorna nome, CNPJ, cidade/UF, setor, status e nº de contatos.

tools/call
{
  "name": "list_companies",
  "arguments": { "query": "castanheiras", "status": "lead" }
}

Detalha uma empresa pelo id — dados fiscais, sócios (QSA) e contatos vinculados.

tools/call
{
  "name": "get_company",
  "arguments": { "company_id": "cmr..." }
}

Cria uma empresa. Informe ao menos o nome (razão social). Se informar CNPJ, use enrich_company depois. Evita duplicar por CNPJ.

tools/call
{
  "name": "create_company",
  "arguments": { "name": "Padaria Pão Quente LTDA", "cnpj": "12345678000199" }
}

Enriquece a empresa pela Receita Federal (BrasilAPI) pelo CNPJ: razão social, fantasia, CNAE/setor, situação, porte, natureza jurídica, capital, endereço e sócios (QSA). Propaga razão social/CNPJ aos contatos vinculados.

tools/call
{
  "name": "enrich_company",
  "arguments": { "company_id": "cmr..." }
}

Vincula um contato a uma empresa (ou desvincula se company_id vazio). Sincroniza nome/CNPJ da empresa no contato.

tools/call
{
  "name": "link_contact_company",
  "arguments": { "contact_id": "cmq...", "company_id": "cmr..." }
}

Realiza busca semântica na base de conhecimento. Retorna os trechos mais relevantes para a query, com score de relevância e nome do documento de origem.

tools/call
{
  "name": "search_knowledge_base",
  "arguments": { "query": "qual é o prazo de entrega?", "limit": 3 }
}

Lista todos os documentos indexados na KB do usuário com nome, tipo (text, url, image, pdf), status de indexação e tags.

tools/call
{
  "name": "list_kb_documents",
  "arguments": { "tag": "marketing" }
}

Cria e indexa um novo documento de texto na base de conhecimento. O conteúdo é dividido em parágrafos, vetorizado com embeddings OpenAI e armazenado para busca semântica. Requer chave OpenAI configurada na conta.

tools/call
{
  "name": "create_kb_document",
  "arguments": { "name": "Política de Entregas", "content": "Entregas em até 5 dias úteis para todo o Brasil...", "tags": "faq,entrega" }
}

Cria e indexa uma IMAGEM na KB a partir de uma URL pública OU de base64 (arquivo local, sem URL). A imagem é descrita automaticamente por IA (GPT-4o Vision) e indexada para busca semântica. Fica disponível em /api/kb/image/[id] (URL pública — útil como header_image_url de create_whatsapp_template) e pode ser enviada pelo agente no WhatsApp. Requer chave OpenAI configurada na conta.

tools/call
{
  "name": "create_kb_image",
  "arguments": { "name": "Logo principal claro", "image_url": "https://exemplo.com/logo.png", "tags": "marca,logo" }
}

Cria e indexa um VÍDEO na KB a partir de uma URL pública OU de base64. Diferente de imagem, não existe descrição automática por IA — description é obrigatório (é o texto usado na busca semântica pra saber quando enviar o vídeo). Limite de 16MB (mesmo teto que o WhatsApp impõe). Fica disponível em /api/kb/video/[id] — o agente pode enviar em conversa ativa, e também serve como header_video_url de create_whatsapp_template para cadências.

tools/call
{
  "name": "create_kb_video",
  "arguments": { "name": "Vídeo institucional 40s", "description": "Vídeo mostrando o escritório e a equipe, usado quando o lead pergunta como funciona o atendimento", "video_url": "https://exemplo.com/institucional.mp4" }
}

Cria e indexa um ÁUDIO na KB a partir de uma URL pública OU de base64. Não há descrição automática por IA — description é obrigatório. Limite de 16MB. Fica disponível em /api/kb/audio/[id] — o agente pode enviar em conversa ativa. ⚠️ Áudio NÃO pode ser usado em cadência de prospecção (a Meta não suporta cabeçalho de áudio em templates aprovados).

tools/call
{
  "name": "create_kb_audio",
  "arguments": { "name": "Áudio de boas-vindas", "description": "Mensagem de voz de 15s explicando o próximo passo do atendimento", "audio_url": "https://exemplo.com/boas-vindas.ogg" }
}

Atualiza o conteúdo ou as tags de um documento existente. Os chunks antigos são removidos e o documento é re-indexado automaticamente.

tools/call
{
  "name": "update_kb_document",
  "arguments": { "document_id": "clxxx", "tags": "faq,produto,atualizado" }
}

Apaga um documento da base (texto, imagem, vídeo ou áudio) e o índice de busca dele — o mesmo caminho do botão de excluir em /kb. Não tem volta. Para trocar uma imagem: crie a nova com create_kb_image e apague a antiga.

tools/call
{
  "name": "delete_kb_document",
  "arguments": { "document_id": "clxxx", "confirm_name": "Foto - Bolo de Laranja 220g" }
}

Lista as lacunas de conhecimento registradas para a conta, ordenadas por frequência (occurrences) e recência. Sem target_user_id, consulta a PRÓPRIA conta autenticada; admin da plataforma pode passar target_user_id.

tools/call
{
  "name": "list_knowledge_gaps",
  "arguments": { "status": "pending" }
}

Resolve, descarta ou adiciona à KB uma lacuna obtida via list_knowledge_gaps. "add_to_kb" cria automaticamente um novo documento na base de conhecimento (pergunta + resposta) já indexado. Sem target_user_id, opera na PRÓPRIA conta autenticada; admin da plataforma pode passar target_user_id.

tools/call
{
  "name": "resolve_knowledge_gap",
  "arguments": { "gap_id": "clxxx", "action": "add_to_kb", "resolution": "O prazo de entrega padrão é de 5 dias úteis." }
}

Central de ajuda do Radar: perguntas que o "Pergunte ao Radar" não soube responder, de TODAS as contas, agrupadas (acento/caixa/pontuação não separam) e ordenadas por quantas contas perguntaram. É a fila do que falta escrever. Traz variações, telas, cargos e o artigo mais próximo encontrado. Não confundir com list_knowledge_gaps (dúvidas dos clientes finais ao agente de uma conta). APENAS admin da plataforma.

tools/call
{
  "name": "list_help_unanswered",
  "arguments": { "days": "30" }
}

Lista contatos do CRM com paginação. Suporta busca por nome, telefone ou e-mail, e filtro por status.

tools/call
{
  "name": "list_contacts",
  "arguments": { "search": "João", "status": "prospect", "limit": 10 }
}

Retorna detalhes completos de um contato, incluindo as 10 notas mais recentes, estágio do pipeline, valor do negócio e a conversa mais recente (conversationId/conversationStatus/conversationChannel) — use o conversationId em get_conversation_messages, ou get_conversations com contact_id se precisar de TODAS as conversas do contato, não só a mais recente.

tools/call
{
  "name": "get_contact",
  "arguments": { "phone": "5511999999999" }
}

Cria um novo contato no CRM. Retorna erro se já existir um contato com o mesmo número de telefone.

tools/call
{
  "name": "create_contact",
  "arguments": { "name": "Maria Silva", "phone": "5521988887777", "status": "prospect", "dealValue": 3500 }
}

Adiciona uma tag a um contato. Se a tag estiver mapeada a uma automação com trigger tag:<nome>, o fluxo é disparado automaticamente.

tools/call
{
  "name": "add_contact_tag",
  "arguments": { "contact_id": "clxxx", "tag": "VIP" }
}

Remove uma tag de um contato (o inverso de add_contact_tag). Não dispara nenhuma automação.

tools/call
{
  "name": "remove_contact_tag",
  "arguments": { "contact_id": "clxxx", "tag": "VIP" }
}

Visão completa de um contato numa chamada só: cadastro, estágio no funil, últimas mensagens, processo em andamento com as etapas, ordens de serviço em campo e cadências. Use quando a pergunta for "o que está acontecendo com esse cliente?" — evita encadear get_contact + get_conversations + list_processes + list_field_orders.

tools/call
{
  "name": "get_contact_360",
  "arguments": { "phone": "5548988066728" }  →  { "contato": {...}, "conversa": { "mensagens": [...] }, "projetos": [{ "progresso": "1/4", "etapa_atual": {...} }], "ordens_de_campo": [...], "cadencias": [...] }
}

Atualiza os dados cadastrais de um contato: nome, e-mail, empresa, CPF/CNPJ, telefone, origem ou observações.

tools/call
{
  "name": "update_contact",
  "arguments": { "contact_id": "clxxx", "company": "Empresa Ltda", "email": "novo@email.com" }
}

Atualiza o status, estágio do pipeline, valor do negócio ou adiciona uma nota a um contato.

tools/call
{
  "name": "update_contact_status",
  "arguments": { "contact_id": "clxxx", "status": "client", "pipeline_stage_name": "Fechado", "deal_value": 4800 }
}

Lista as conversas mais recentes com status, canal e última mensagem. Por padrão retorna as conversas ativas. Informe contact_id ou contact_phone pra achar a(s) conversa(s) de UM contato específico (nesse caso também traz arquivadas, a menos que status seja informado) — evita ter que casar por nome/telefone na mão.

tools/call
{
  "name": "get_conversations",
  "arguments": { "contact_id": "clxxx" }  →  todas as conversas (ativas e arquivadas) desse contato
}

Retorna o histórico completo de mensagens de uma conversa específica, ordenado do mais antigo ao mais recente.

tools/call
{
  "name": "get_conversation_messages",
  "arguments": { "conversation_id": "clxxx", "limit": 30 }
}

Arquiva uma conversa ativa, encerrando o atendimento. A conversa pode ser consultada com status "archived".

tools/call
{
  "name": "archive_conversation",
  "arguments": { "conversation_id": "clxxx" }
}

Lista pedidos de serviço com dados do cliente, status atual, tentativas de envio ao sistema externo e timestamps.

tools/call
{
  "name": "list_service_orders",
  "arguments": { "status": "pending", "limit": 20 }
}

Retorna detalhes completos de um pedido, incluindo lista de anexos, ID do ticket externo e histórico de erros.

tools/call
{
  "name": "get_service_order",
  "arguments": { "order_id": "clxxx" }
}

Move um pedido de estágio de produção (recebido → preparo → pronto → entregue → cancelado), como no Kanban de Pedidos. Se a conta tiver avisos ativados, o cliente é notificado automaticamente por WhatsApp/SMS. Ideal para integrar o PDV/cozinha do cliente com o Radar.

tools/call
{
  "name": "set_order_stage",
  "arguments": { "order_id": "clxxx", "stage": "pronto" }
}

Envia uma mensagem de texto para um número WhatsApp. Usa automaticamente o provedor ativo configurado na conta. A mensagem fica registrada na conversa do contato (cria o Contact e a Conversa automaticamente se ainda não existirem, com status "lead") — aparece no painel do Radar e no histórico que o agente de IA usa pra responder com contexto. Não funciona para contatos de widget (sessões de chat web).

tools/call
{
  "name": "send_whatsapp_message",
  "arguments": { "phone": "5511999999999", "message": "Olá! Seu pedido foi confirmado." }
}

Envia um template WhatsApp Business (WABA) já aprovado pela Meta — necessário para contato FRIO, quando não há janela de atendimento de 24h aberta (send_whatsapp_message é rejeitado nesse caso). Use list_whatsapp_templates antes para confirmar o nome exato e o número de variáveis {{1}}, {{2}}... do corpo — a contagem enviada em "params" precisa bater exatamente com a do template aprovado. A mensagem (corpo já interpolado com os params) fica registrada na conversa do contato, criando Contact e Conversa automaticamente se ainda não existirem.

tools/call
{
  "name": "send_whatsapp_template",
  "arguments": { "phone": "5511999999999", "template_name": "formulario_recebido_conta_criada", "params": "José" }
}

Enfileira um SMS que será enviado pelo celular gateway do usuário. Só chega em número de celular. Recomendado: texto curto (≤160 caracteres = 1 SMS), sem acento e no máximo 1 link.

tools/call
{
  "name": "send_sms",
  "arguments": { "phone": "5548999998888", "message": "Oi Joao, aqui e a noEixo. Posso te chamar no WhatsApp?" }
}

Envia um e-mail pela conta Gmail conectada. A mensagem é registrada automaticamente como mensagem da conversa com o destinatário no CRM.

tools/call
{
  "name": "send_email",
  "arguments": { "to": "cliente@empresa.com", "subject": "Proposta comercial", "body": "Segue nossa proposta..." }
}

Lista e-mails não lidos da caixa de entrada com remetente, assunto, data e trecho do corpo.

tools/call
{
  "name": "list_inbox",
  "arguments": { "limit": 5 }
}

Lista os fluxos de automação com nome, trigger e status. Use para descobrir os IDs disponíveis antes de chamar trigger_automation.

tools/call
{
  "name": "list_automations",
  "arguments": { "active_only": "true" }
}

Retorna o detalhe completo de UMA automação, incluindo o array "actions" já parseado (list_automations não traz actions, só resumo). Use SEMPRE antes de update_automation quando for alterar só parte das ações — update_automation substitui o array inteiro, então sem ler o estado atual primeiro é fácil apagar sem querer uma ação existente.

tools/call
{
  "name": "get_automation",
  "arguments": { "automation_id": "clxxx" }
}

Dispara um fluxo de automação para um contato específico. Útil para follow-ups, mensagens programadas ou ações em resposta a eventos externos. O fluxo respeita o cooldown configurado.

tools/call
{
  "name": "trigger_automation",
  "arguments": { "automation_id": "clxxx", "contact_phone": "5511999999999", "contact_name": "João", "context": "{\"serviceName\": \"Consultoria\"}" }
}

Cria um novo fluxo de automação com nome, trigger e lista de ações em JSON. Triggers: order_created, order_submitted, tag:<nome>, booking_created/booking_cancelled/booking_rescheduled, flow_completed:<flowId>, ou nome de evento customizado de um webhook externo (ver parâmetro trigger). Tipos de ação: send_whatsapp, send_email, send_webhook, add_contact_tag, move_to_stage, check_tag, condition, delay, trigger_flow, send_to_ekyte, ekyte_add_tag, ekyte_add_comment, notify_team. Cada ação precisa de "id", "type" e "config" (objeto) — nunca campos soltos fora de "config". Dica: durante a conversa, o agente pode chamar a tool interna add_contact_tag pra marcar o contato (ex: "SQL" quando qualificar um lead) — isso já dispara automações com trigger "tag:<nome>", então dá pra encadear qualificação → send_webhook pra enviar o lead a um CRM externo (ex: RD Station via n8n). Os triggers booking_created/booking_cancelled/booking_rescheduled disparam quando o agente confirma/cancela/reagenda um compromisso (schedule_appointment/cancel_appointment/reschedule_appointment) — incluem {{order.hostName}}/{{order.hostEmail}} (quem ficou responsável, útil pra sincronizar com CRM externo quando o provedor de agenda faz round-robin, ex: NeetoCal) e {{order.appointmentDate}}/{{order.appointmentTime}}/{{order.meetingUrl}} (data/horário formatados em pt-BR + link real da reunião, ex: Google Meet) — úteis pra montar um send_email de confirmação. send_whatsapp funciona com qualquer provedor WhatsApp ativo (Evolution, Stevo ou Meta Direct) — usa sempre a conexão marcada como ativa na conta.

tools/call
{
  "name": "create_automation",
  "arguments": { "name": "Lead qualificado -> RD Station", "trigger": "tag:SQL", "actions": "[{\"id\":\"1\",\"type\":\"send_webhook\",\"config\":{\"webhookUrl\":\"https://n8n.exemplo.com/webhook/sql\",\"webhookPayload\":\"{\\\"nome\\\":\\\"{{order.customerName}}\\\",\\\"telefone\\\":\\\"{{order.customerPhone}}\\\"}\"}}]" }
}

Atualiza um fluxo de automação existente: nome, trigger, ações ou estado ativo/inativo.

tools/call
{
  "name": "update_automation",
  "arguments": { "automation_id": "clxxx", "is_active": "false" }
}

Lista negociações ativas no pipeline com valor do negócio, etapa e status. Use para monitorar o funil comercial.

tools/call
{
  "name": "list_deals",
  "arguments": { "status": "prospect", "min_value": 1000, "limit": 20 }
}

Cria uma nova negociação no CRM com valor e etapa do pipeline. Use para registrar oportunidades comerciais recebidas externamente.

tools/call
{
  "name": "create_deal",
  "arguments": { "name": "Carlos Souza", "phone": "5511988880001", "deal_value": 12000, "pipeline_stage_name": "Proposta Enviada", "source": "linkedin" }
}

Atualiza uma negociação: valor, etapa do pipeline, status ou registra uma anotação na linha do tempo.

tools/call
{
  "name": "update_deal",
  "arguments": { "contact_id": "clxxx", "deal_value": 15000, "pipeline_stage_name": "Fechado Ganho", "notes": "Cliente aceitou proposta via e-mail", "note_type": "email" }
}

Lista produtos e serviços do catálogo com descrição, preço e status. Produtos ativos alimentam o contexto do agente automaticamente.

tools/call
{
  "name": "list_products",
  "arguments": { "type": "service", "active_only": "true" }
}

Cria um novo produto ou serviço no catálogo. O item ficará ativo imediatamente e passará a integrar o contexto do agente em toda resposta. É aqui que mora o preço (campo price, ex.: "A partir de R$ 32.900") — não no system_prompt nem na base de conhecimento. Informação que o agente deve perguntar ao cliente vai em order_fields (update_agent_config).

tools/call
{
  "name": "create_product",
  "arguments": { "name": "Consultoria Estratégica", "type": "service", "description": "Sessão de 2h para diagnóstico empresarial", "price": "R$ 800" }
}

Atualiza dados de um produto: nome, descrição, preço, características ou ativa/desativa do catálogo.

tools/call
{
  "name": "update_product",
  "arguments": { "product_id": "clxxx", "price": "R$ 950", "is_active": "true" }
}

Importa leads em lote para o Garimpo Leads (/domain-checker). Aceita até 100 leads por chamada — faça múltiplas chamadas para listas maiores. Cada lead precisa de ao menos website OU email. Leads com website ficam com status "novo" (aguardando verificação); leads sem site ficam como SUSPEITO. Todo lead novo entra numa lista (list_name, ou "MCP — data de hoje"); chamadas com o mesmo list_name caem na mesma lista. Duplicatas não são duplicadas: continuam na lista de origem e ganham a etiqueta lista:<nome>. Após importar, acesse /domain-checker → "Analisar Todos" para enriquecer com CNPJ, score e mensagem via IA.

tools/call
{
  "name": "add_domain_checker_leads",
  "arguments": { "list_name": "Clínicas SP — out/2026", "leads": "[{\"name\":\"Clínica São Lucas\",\"website\":\"clinicasaolucas.com.br\",\"email\":\"contato@clinicasaolucas.com.br\",\"phone\":\"11999990001\",\"cnpj\":\"00.000.000/0001-00\",\"uf\":\"SP\"},{\"name\":\"Dra. Ana Souza\",\"email\":\"dra.ana@gmail.com\",\"phone\":\"11988880002\"}]" }
}

Lista e CONTA leads com filtros. Retorna estatísticas (total, analisados, com e-mail, com telefone/WhatsApp, com ambos, sem contato) + uma amostra de leads. "Analisado" = já teve score/perfil/mensagem gerados pela IA. Ex.: para "quantos leads analisados têm e-mail e telefone", chame com analyzed="true" e leia stats. Use limit=0 para só as estatísticas.

tools/call
{
  "name": "list_domain_checker_leads",
  "arguments": { "list_name": "Clínicas médicas", "faixa": "B", "limit": 10 }
}

Lista as listas de origem dos leads (uma por importação ou busca), com o total de leads ativos e quantos estão em cada faixa A/B/C do score único.

tools/call
{
  "name": "list_lead_lists",
  "arguments": {}
}

Funil de peneira de uma lista ou de todas: lista bruta → canal → enriquecimento → validação → LGPD → em cadência, mais o split de canais e os KPIs. Mesmo cálculo da aba "Funil / Listas".

tools/call
{
  "name": "get_lead_funnel",
  "arguments": { "list_name": "Clínicas médicas" }
}

Mostra o Perfil de Cliente Ideal (ICP) da conta: setores-alvo, UFs, pesos e exigências. Com list_name, mostra também o público próprio da lista e o ICP que vale para ela. É o que decide as faixas A/B/C e quais leads novos entram.

tools/call
{
  "name": "get_icp_config",
  "arguments": { "list_name": "CNPJ SC — jurídico" }
}

Altera o ICP. Sem list_name, o da conta (só os campos enviados mudam). Com list_name, o público próprio da lista: só setores, UFs e "sem site é sinal" — pesos e exigências seguem os da conta; herdar_da_conta="true" apaga o público da lista. As faixas são recalculadas na rodada diária (06:40). Devolve o antes e o depois.

tools/call
{
  "name": "update_icp_config",
  "arguments": { "target_sectors": "advoc, contab, condomin" }
}

Arquiva/restaura, marca como abordado e corrige CNPJ ou mensagem. Vários leads de uma vez (lead_ids, até 100) só para archived e trabalhado; CNPJ e mensagem um por vez. Não apaga nada.

tools/call
{
  "name": "update_domain_checker_lead",
  "arguments": { "lead_ids": "clxxx,clyyy", "trabalhado": "true" }
}

Manda leads para o Pipeline, como o botão "Pipeline" da tela: cria ou atualiza o contato no CRM na etapa escolhida. Depois o contato pode entrar em cadência com enroll_contacts (contact_id devolvido). Exige lead já enriquecido (score >= 50). Até 20 por chamada. Etapa marcada como ganho dispara o gatilho de negócio ganho.

tools/call
{
  "name": "send_domain_checker_to_pipeline",
  "arguments": { "lead_ids": "clxxx", "stage_name": "Novo lead" }
}

Enriquece leads como o botão "Enriquecer": CNPJ, registrante do domínio, redes sociais, score e briefing por IA; com with_message="true" gera também a mensagem. Usa a chave de IA da conta (gera custo) e é lento: até 10 leads por chamada.

tools/call
{
  "name": "enrich_domain_checker_leads",
  "arguments": { "lead_ids": "clxxx,clyyy", "with_message": "true" }
}

Busca estabelecimentos no Google Maps e devolve uma prévia (nome, telefone, site, endereço, avaliação). Não grava nada: para salvar, mande os escolhidos em add_domain_checker_leads com list_name. Usa a chave Google Places da conta (gera custo): até 5 cidades × 5 tipos por chamada.

tools/call
{
  "name": "search_google_places",
  "arguments": { "cidades": "Florianópolis SC", "tipos": "clínica odontológica" }
}

Lista todas as tags únicas utilizadas nos leads com contagem de quantos leads possuem cada tag. Use para descobrir os segmentos/listas existentes antes de filtrar ou gerenciar tags.

tools/call
{
  "name": "list_domain_checker_tags",
  "arguments": {}
}

Adiciona uma ou mais tags a leads específicos por ID ou domínio. As tags existentes são preservadas (merge). Use para organizar leads por segmento, campanha, prioridade ou data de importação.

tools/call
{
  "name": "tag_domain_checker_leads",
  "arguments": { "tags": "clinicas-sp,jun-2026", "domains": "clinicax.com.br,clinicay.com.br" }
}

Remove uma ou mais tags de leads específicos. As outras tags do lead são preservadas.

tools/call
{
  "name": "untag_domain_checker_leads",
  "arguments": { "tags": "jun-2026", "ids": "clxxx,clyyy" }
}

Renomeia uma tag em todos os leads que a possuem. Útil para corrigir erros de digitação ou padronizar nomes de segmentos após importações.

tools/call
{
  "name": "rename_domain_checker_tag",
  "arguments": { "old_tag": "clinicas-sao-paulo", "new_tag": "clinicas-sp" }
}

Conecta a conta a um scheduling link do NeetoCal (provedor alternativo ao Google Calendar). Fluxo em 2 passos: chame sem meeting_slug para validar a chave e listar os scheduling links disponíveis (com hosts/duração); chame de novo com o meeting_slug escolhido para salvar. Cada meeting_slug vira UMA conexão própria — chame de novo com um slug diferente para adicionar outro profissional/link sem apagar os anteriores (ex: um round-robin geral + um link individual por closer). Depois, ative calendar_booking_mode via update_agent_config.

tools/call
{
  "name": "connect_neetocal",
  "arguments": { "api_key": "NCAL-xxxx", "subdomain": "ekyte" }  →  depois: { "api_key": "NCAL-xxxx", "subdomain": "ekyte", "meeting_slug": "demo-30", "label": "Especialista eKyte", "is_default": "true" }  →  e mais: { "api_key": "NCAL-xxxx", "subdomain": "ekyte", "meeting_slug": "reunio-com-pablo-costa", "label": "Pablo Costa" }
}

Lista agendamentos com título do evento, contato, horários de início/fim e status. Use para consultar a agenda de atendimentos ou filtrar por período.

tools/call
{
  "name": "list_bookings",
  "arguments": { "status": "confirmed", "from": "2025-07-01T00:00:00Z", "to": "2025-07-31T23:59:59Z" }
}

Lista as cadências de prospecção ativas. Retorna nome, número de steps, limite diário e total de matrículas ativas. Use para descobrir os IDs antes de matricular contatos.

tools/call
{
  "name": "list_sequences",
  "arguments": { "active_only": "true" }
}

Cria uma nova cadência de prospecção com steps programados em múltiplos canais. Tipos de step: send_whatsapp, send_email, send_sms, send_linkedin, send_facebook, send_webhook, add_tag, move_stage. send_webhook faz POST/GET/PUT genérico pra um sistema externo (ex: RD Station Marketing) — use dois steps em sequência (delay 0) pra popular campos e depois disparar, como no padrão descrito em create_automation. Variáveis nos templates: {{contact.name}}, {{contact.firstName}}, {{contact.company}}, {{contact.phone}}, {{contact.email}}. Em steps send_email também disponível {{unsubscribe_url}} (opcional — o link de descadastro one-click já sai automático no header do e-mail; use no corpo só se quiser deixar visível também, ex: rodapé "não quer mais receber?").

tools/call
{
  "name": "create_sequence",
  "arguments": { "name": "Prospecção Sites Quebrados", "daily_limit": "20", "steps": "[{\"id\":\"s1\",\"delayDays\":0,\"delayHours\":0,\"type\":\"send_whatsapp\",\"waTemplateName\":\"primeiro_toque_aprovado_v1\",\"waTemplateLang\":\"pt_BR\",\"waTemplateParams\":[\"{{contact.firstName}}\"],\"waTemplateHeaderVideoUrl\":\"https://radar.noeixodigital.com/api/kb/video/clxxx\",\"template\":\"Oi {{contact.firstName}}! [texto do template aprovado]\"},{\"id\":\"s2\",\"delayDays\":3,\"delayHours\":0,\"type\":\"send_whatsapp\",\"template\":\"{{contact.firstName}}, tudo bem? Conseguiu verificar o site?\"},{\"id\":\"s3\",\"delayDays\":5,\"delayHours\":0,\"type\":\"send_linkedin\",\"template\":\"Oi {{contact.name}}, te mandei mensagem no WhatsApp sobre o site da {{contact.company}}...\"}]" }
}

Edita uma cadência existente — todos os campos opcionais, só altera o que for enviado. is_active=false pausa a cadência inteira e pausa automaticamente as matrículas ativas dela (o dispatcher para de rodar); is_active=true retoma as matrículas pausadas que nunca responderam (quem respondeu fica pausado, preservado). steps substitui o array INTEIRO — busque os steps atuais via list_sequences antes de editar parcialmente.

tools/call
{
  "name": "update_sequence",
  "arguments": { "sequence_id": "clxxx", "is_active": "false" }  →  pausa a cadência inteira e todas as matrículas ativas dela
}

Apaga permanentemente uma cadência e TODAS as suas matrículas (cascade). Irreversível — use com cuidado, sobretudo em cadências de teste que ficaram órfãs. Não afeta os contatos em si.

tools/call
{
  "name": "delete_sequence",
  "arguments": { "sequence_id": "clxxx" }
}

Matricula contatos em uma cadência de prospecção pelo número de telefone. Cria o contato no CRM automaticamente se não existir. Contatos já matriculados (ativos ou pausados), ou descadastrados (lista de supressão), são ignorados.

tools/call
{
  "name": "enroll_contacts",
  "arguments": { "sequence_id": "clxxx", "phones": "5548999990001,5548999990002", "contact_names": "João Silva,Maria Santos" }
}

Lista matrículas de contatos em cadências, paginado. Status: active (ativa), paused (respondeu — pausada automaticamente), completed (concluída), waiting_manual (tarefa LinkedIn/Facebook pendente), unsubscribed (cancelada). Pra cadências grandes (milhares de matrículas), use count_enrollments primeiro pra saber o tamanho antes de paginar tudo.

tools/call
{
  "name": "list_enrollments",
  "arguments": { "sequence_id": "clxxx", "min_steps_done": "1", "limit": "300", "offset": "0" }
}

Conta matrículas agregadas por status e por step atual, sem baixar a lista inteira. Use ANTES de uma ação em lote (manage_enrollment com sequence_id) pra saber quantas matrículas seriam afetadas, ou pra montar um relatório rápido de uma cadência com milhares de matrículas.

tools/call
{
  "name": "count_enrollments",
  "arguments": { "sequence_id": "clxxx" }  →  { "total": 18228, "byStatus": {"active": 18081, "paused": 140, ...}, "byCurrentStep": {"0": 18081, "1": 147} }
}

Métricas de performance de UMA cadência: enviados por step, aberturas de e-mail, bounces confirmados (hard bounce), descadastros, respostas e conclusões. Use antes de soltar um lote maior, ou pra medir o resultado real de uma cadência já rodando. ⚠️ Cliques em links ainda NÃO são rastreados — só abertura de e-mail (pixel).

tools/call
{
  "name": "sequence_stats",
  "arguments": { "sequence_id": "clxxx" }  →  { "totalSent": 203, "byStep": [{"stepIndex":0,"type":"send_email","sent":203}, ...], "emailOpens": 46, "bouncedContacts": 3, "unsubscribed": 5, "replied": 12, "completed": 8 }
}

Gerencia matrícula(s) em uma cadência. Ações: pause (pausa), resume (retoma), cancel (cancela/remove), advance (executa step atual imediatamente sem esperar o delay), repeat (re-executa o último step), restart (volta ao step 0), done_manual (marca tarefa manual LinkedIn/Facebook como feita e avança para o próximo step). MODO INDIVIDUAL: enrollment_id. MODO EM LOTE: enrollment_ids (vários separados por vírgula) OU sequence_id (+ status/current_step/min_steps_done como filtro do alvo) — aplica em todas que baterem, até 2000 por chamada; quem não está no estado certo pra ação é só pulado, não trava o lote.

tools/call
{
  "name": "manage_enrollment",
  "arguments": { "sequence_id": "clxxx", "status": "active", "min_steps_done": "0", "action": "pause" }  →  pausa em lote todos os ativos que ainda não receberam nenhum toque
}

Lista os templates WABA da conta com status de aprovação (APPROVED, PENDING, REJECTED, PAUSED). Confira antes de referenciar um template em create_sequence/create_automation.

tools/call
{
  "name": "list_whatsapp_templates",
  "arguments": {}
}

Cria um template WABA (texto, imagem, vídeo ou +botões) e submete pra aprovação da Meta (minutos a ~1 dia). header_image_url/header_video_url baixa o arquivo e faz o upload pra Meta automaticamente (não precisa base64). Não existe cabeçalho de ÁUDIO nos templates da Meta. buttons vira QUICK_REPLY — cada tap do lead chega como mensagem de texto normal com o texto do botão.

tools/call
{
  "name": "create_whatsapp_template",
  "arguments": { "name": "promo_agosto_v1", "category": "MARKETING", "body": "Oi {{1}}! A promoção do mês está no ar: 20% off em todo o catálogo até dia 31.", "header_image_url": "https://exemplo.com/banner-promo.jpg", "buttons": "Sim,Não" }
}

Deleta um template WABA pelo nome. A Meta não permite editar o texto de um template já criado — pra corrigir algo (erro de digitação, acento corrompido), a única forma é deletar e criar de novo.

tools/call
{
  "name": "delete_whatsapp_template",
  "arguments": { "name": "promo_agosto_v1" }
}

Lista os templates de e-mail salvos, com corpo completo. Use pra achar o template certo (ou ler o conteúdo de um antigo) antes de montar/corrigir um step send_email.

tools/call
{
  "name": "list_email_templates",
  "arguments": { "search": "jurídico" }
}

Cria um novo template de e-mail na biblioteca. Fica disponível pra copiar em qualquer cadência futura via "📧 Template" no StepEditor.

tools/call
{
  "name": "create_email_template",
  "arguments": { "name": "Jurídico D+7 v2", "subject": "Oi {{contact.firstName}}, ainda dá tempo", "body": "<p>...</p>" }
}

Atualiza nome, assunto, corpo ou formato de um template existente na biblioteca.

tools/call
{
  "name": "update_email_template",
  "arguments": { "template_id": "clxxx", "body": "<p>Texto corrigido...</p>" }
}

Apaga um template da biblioteca. Não afeta cadências já configuradas.

tools/call
{
  "name": "delete_email_template",
  "arguments": { "template_id": "clxxx" }
}

Lista as mensagens rápidas pessoais da conta autenticada + as da equipe, na ordem do menu, com id, título, texto, grupo, ordem, da_equipe e minha.

tools/call
{
  "name": "list_quick_replies",
  "arguments": {}
}

Cria uma mensagem rápida. Por padrão é da equipe.

tools/call
{
  "name": "create_quick_reply",
  "arguments": { "title": "Pedir cidade", "content": "{nome}, em qual cidade fica o terreno de vocês?", "grupo": "Qualificação", "ordem": 1 }
}

Altera título, texto ou o tipo (da equipe/pessoal). Pessoal só o autor altera; da equipe, autor, gerente ou dono.

tools/call
{
  "name": "update_quick_reply",
  "arguments": { "id": "clxxx", "content": "Texto novo" }
}

Apaga uma mensagem rápida. Exige confirm_title igual ao título atual.

tools/call
{
  "name": "delete_quick_reply",
  "arguments": { "id": "clxxx", "confirm_title": "Pedir cidade" }
}

Provisiona uma conta nova (white-label) para um cliente: cria o tenant isolado, o usuário administrador da conta e uma configuração de agente vazia. SOMENTE o administrador da plataforma pode usar. Retorna o userId da conta e a senha temporária. Depois use update_agent_config (target_user_id = este userId) para a persona, e as tools de KB/produtos/automação para o restante. O WhatsApp é conectado à parte, pelo painel Settings da conta (OAuth Meta — não disponível por MCP).

tools/call
{
  "name": "create_client_account",
  "arguments": { "business_name": "Confeitaria Doce Mel", "admin_email": "contato@docemel.com.br", "mcp_profile": "desafio" }
}

Define o perfil de ações MCP de uma conta já criada: "desafio" (só as ações do curso, bloqueadas também na chamada; trigger_automation só dispara a automação de publicar a landing page) ou "completo". SOMENTE o administrador da plataforma. Vale em até 1 minuto.

tools/call
{
  "name": "set_mcp_profile",
  "arguments": { "target_user_id": "cm...", "profile": "desafio" }
}

Lê a landing page da conta: publicada ou não, endereço (<subdominio>.noeixo.tech), status (publicada | retirada) e todos os campos atuais. Use antes de alterar a página, para mudar só o que o aluno pediu.

tools/call
{
  "name": "get_landing_page",
  "arguments": {}
}

Publica ou atualiza a landing page em <subdominio>.noeixo.tech com o modelo do Desafio noEixo. Primeira vez: subdominio + nome_do_negocio, ramo, cidade, frase_principal, descricao, whatsapp, beneficios (lista JSON, 1–3) e servicos (lista JSON, 1–6). Para alterar, mande só o que muda; "" apaga um campo opcional. Opcionais: cor (#RRGGBB), tempo_resposta, depoimentos (só reais, até 3), perguntas (até 6), endereco, horario, email, chamada_final, foto_url (https), cnpj. Todo texto é escapado; colchete de exemplo do modelo é recusado; bloco sem dado some. O endereço é de uma conta só; trocar o subdomínio tira o antigo do ar.

tools/call
{
  "name": "publish_landing_page",
  "arguments": { "subdominio": "clinicasorriso", "nome_do_negocio": "Clínica Sorriso", "ramo": "Odontologia", "cidade": "Joinville", "frase_principal": "Seu sorriso cuidado sem pressa", "descricao": "Clínica para a família toda.", "whatsapp": "(47) 99999-0000", "beneficios": "[\"Resposta em até 15 min\"]", "servicos": "[{\"nome\":\"Limpeza\",\"descricao\":\"Profilaxia completa\",\"preco\":\"R$ 150\"}]" }
}

Tira do ar a landing page de uma conta (abuso, conteúdo proibido): apaga a página e marca como retirada; o aluno não republica pela ferramenta. SOMENTE o administrador da plataforma. Fica em /logs (landing_page_retirada).

tools/call
{
  "name": "unpublish_landing_page",
  "arguments": { "target_user_id": "cm...", "motivo": "Página com promessa enganosa" }
}

Lê os dados básicos da conta: nome do negócio, plano, data de criação, responsável, e-mail de acesso e perfil de ações (completo | desafio). Responde "qual o nome da minha conta".

tools/call
{
  "name": "get_account_info",
  "arguments": {}
}

Confere se o WhatsApp está ligado ao Radar: { conectado, numero, nome_exibicao, provedor (meta | gupshup), pode_enviar_modelos }. Sem conexão, devolve conectado: false e onde ligar (Minha Conta › WhatsApp › Continuar com Facebook). O número é lido na Meta na hora.

tools/call
{
  "name": "get_whatsapp_status",
  "arguments": {}
}

Lê o Resumo do negócio da conta (escrito pelo Claude no Desafio noEixo: dados do negócio, nota do diagnóstico, pontos a melhorar). Uso INTERNO: o atendente virtual nunca recebe este texto, e ele não está na base de conhecimento. Devolve { business_name, summary, updated_at }; sem resumo, summary vem vazio (o nome do negócio vem sempre).

tools/call
{
  "name": "get_business_summary",
  "arguments": {}
}

Grava o Resumo do negócio da conta: substitui (mode "replace", padrão) ou acrescenta ao final (mode "append"). Até 8.000 caracteres no total — acima disso, erro com o tamanho. Fica registrado quem alterou e quando (sem o texto). Não é enviado ao atendente virtual nem a clientes.

tools/call
{
  "name": "set_business_summary",
  "arguments": { "summary": "Nome: Doce Mel. Vende: bolos sob encomenda. Nota do diagnóstico: 4/10.", "mode": "replace" }
}

Configura o agente conversacional de uma conta: persona (system_prompt), mensagem de boas-vindas, tom, modelo, chave OpenAI e ativação. Sem target_user_id, configura o agente da PRÓPRIA conta autenticada. O administrador da plataforma pode passar target_user_id para configurar a conta de um cliente (ex: recém-criada com create_client_account). Cria a configuração se ainda não existir.

tools/call
{
  "name": "update_agent_config",
  "arguments": { "target_user_id": "clxxx", "system_prompt": "Você é a atendente da Confeitaria Doce Mel...", "tone": "friendly", "is_active": "true", "order_notify_channel": "auto" }
}

Consulta a configuração atual do agente de uma conta (persona, tom, modelo, ativação, memória do cliente, pedidos, notificação de estágio, modo de resposta de prospecção). Sem target_user_id, consulta a PRÓPRIA conta autenticada. O administrador da plataforma pode passar target_user_id. Não retorna a chave OpenAI em texto puro, só se está configurada (hasOpenAIKey).

tools/call
{
  "name": "get_agent_config",
  "arguments": { "target_user_id": "clxxx" }
}

Lista os membros da equipe com cargo, o ajuste individual (só o que difere do padrão do cargo) e a permissão efetiva resultante. Traz também a lista de recursos existentes e se a sua chave pode editar.

tools/call
{
  "name": "list_team_permissions",
  "arguments": {}
}

Altera o que um membro pode fazer. Passe só os recursos que quer mudar — é incremental, o resto do ajuste anterior é preservado e o que nunca foi tocado segue o padrão do cargo. Use reset para devolver a pessoa inteiramente ao padrão.

tools/call
{
  "name": "update_team_member_permissions",
  "arguments": { "member_id": "cmrz...", "permissions": { "cadencias": "write", "garimpo": "read" } }
}

Cria um membro na equipe com senha temporária, que volta uma única vez na resposta. Dono e gerente podem convidar; o gerente só atribui cargo abaixo do seu. E-mail único na plataforma inteira.

tools/call
{
  "name": "invite_team_member",
  "arguments": { "email": "ana@empresa.com", "name": "Ana", "role": "operator" }
}

Muda o cargo de um membro ou gera senha temporária nova. O gerente só age sobre quem está abaixo dele e não promove ninguém a gerente; ninguém altera a própria conta. Cargo novo vale no próximo login da pessoa.

tools/call
{
  "name": "update_team_member",
  "arguments": { "member_id": "cmrz...", "role": "specialist" }
}

Remove um membro (apaga o login). Só o dono da conta. Não remove administradores nem a própria conta. Irreversível — para só tirar acesso, use update_team_member_permissions.

tools/call
{
  "name": "remove_team_member",
  "arguments": { "member_id": "cmrz..." }
}

Lista os estágios do funil na ordem, com quantos contatos há em cada um, qual está marcado como ganho (is_won) e qual processo ele abre.

tools/call
{
  "name": "list_pipeline_stages",
  "arguments": {}
}

Cria um estágio no funil. Marque is_won="true" no estágio de fechamento e aponte process_template_id para o processo que deve ser aberto automaticamente.

tools/call
{
  "name": "create_pipeline_stage",
  "arguments": { "name": "Ganho", "color": "#059669", "is_won": "true", "process_template_id": "onb_2b4e..." }
}

Atualiza um estágio. Só os campos enviados mudam. Envie process_template_id como string vazia para desvincular o processo.

tools/call
{
  "name": "update_pipeline_stage",
  "arguments": { "stage_id": "cmpck...", "is_won": "true", "process_template_id": "onb_2b4e..." }
}

Lista as ordens de campo com status, prazo, técnico e — quando houver — o processo e a etapa a que a OS pertence.

tools/call
{
  "name": "list_field_orders",
  "arguments": { "status": "in_progress" }
}

Cria uma ordem de campo para um contato. Com process_id + process_step_id a OS vira uma etapa do processo; sem eles, é uma OS avulsa. O type_id instancia o checklist e o SLA daquele tipo de OS.

tools/call
{
  "name": "create_field_order",
  "arguments": { "contact_id": "cmu7...", "title": "Medição do terreno", "scheduled_at": "2026-09-25T14:00:00Z", "process_id": "cmu7g...", "process_step_id": "cmu7h..." }
}

Move a OS de status. Ao mover para "done", a etapa de processo vinculada é concluída junto. Para o fechamento completo em campo (checklist obrigatório, fotos antes/depois, assinatura) use a tela do técnico, não esta tool.

tools/call
{
  "name": "update_field_order_status",
  "arguments": { "field_order_id": "cmu7...", "status": "done" }
}

Lista os templates de processo (checklists reutilizáveis, ex: "Onboarding de Cliente Novo"). Retorna id, nome, descrição e os passos. Use antes de create_process para pegar o template_id.

tools/call
{
  "name": "list_process_templates",
  "arguments": {}
}

Cria um template de processo (checklist reutilizável). Os steps são um array de {title, description, order}.

tools/call
{
  "name": "create_process_template",
  "arguments": { "name": "Onboarding de Cliente Novo", "steps": [{ "title": "Criar conta", "order": 0 }, { "title": "Conectar WhatsApp", "order": 1 }] }
}

Instancia um processo para um contato, copiando os passos de um template (ou de uma lista de steps). Use para iniciar o onboarding de um cliente e acompanhar os passos.

tools/call
{
  "name": "create_process",
  "arguments": { "contact_id": "cmr...", "template_id": "onb_..." }
}

Lista processos (acompanhamento de escopo/onboarding por cliente). Filtra por status e/ou contato. Retorna progresso (feitos/total).

tools/call
{
  "name": "list_processes",
  "arguments": { "status": "active" }
}

Retorna um processo com todos os passos e status. Use o process_id de list_processes.

tools/call
{
  "name": "get_process",
  "arguments": { "process_id": "cmr..." }
}

Atualiza o status de um passo (pending → in_progress → done, ou blocked). Marcar "done" registra a data de conclusão. Use para avançar o onboarding conforme executa os passos.

tools/call
{
  "name": "update_process_step",
  "arguments": { "step_id": "cmr...", "status": "done" }
}

Define cores, fonte e logotipo da conta — usados no painel interno e no portal do cliente. Só os campos enviados mudam; string vazia limpa um campo.

tools/call
{
  "name": "set_brand",
  "arguments": { "primary_color": "#ad3432", "dark_color": "#2b2c2e", "font_family": "Montserrat", "logo_url": "https://exemplo.com/logo.png" }
}

Lê a personalização aplicada (cores, fonte, logotipo) junto com a configuração do widget. Avisa quando a conta ainda está com o visual padrão da plataforma.

tools/call
{
  "name": "get_brand",
  "arguments": {}
}

Configura o widget de chat embutível no site do cliente (página pública /widget/[userId]): título, saudação, cor e logotipo.

tools/call
{
  "name": "set_widget_config",
  "arguments": { "title": "Atendimento Montreal", "greeting": "Olá! Como podemos ajudar?", "color": "#ad3432" }
}

Cria ou redefine o acesso de um contato ao portal do cliente (/portal/login), onde ele acompanha os próprios processos e a proposta. Chamar de novo para o mesmo contato troca e-mail e senha, sem duplicar. A senha só é vista aqui — depois fica apenas o hash.

tools/call
{
  "name": "create_portal_access",
  "arguments": { "contact_id": "cmsls...", "email": "cliente@empresa.com", "password": "obra2026" }
}

Lista quem tem acesso ao portal nesta conta, com e-mail de login e último acesso. "ultimo_login" nulo significa que a pessoa nunca entrou.

tools/call
{
  "name": "list_portal_access",
  "arguments": {}
}

Remove o acesso de um contato ao portal. O contato e os processos dele continuam intactos — apenas o login deixa de existir.

tools/call
{
  "name": "revoke_portal_access",
  "arguments": { "email": "cliente@empresa.com" }
}