Ferramentas disponíveis (MCP)
Lista das ferramentas que os assistentes de IA podem usar via MCP, e o acesso que cada uma exige. Você autoriza os acessos na tela de consentimento ao conectar (e pode revisar/revogar depois em Configurações → Conexões MCP).
A maioria das ferramentas é de leitura (nunca alteram nada). Algumas são de escrita — veja a seção "Ferramentas de escrita e confirmação" mais abaixo antes de usar qualquer uma delas. Uma categoria à parte, disparo de campanha, envia mensagem real para seus contatos — tem uma seção própria com as salvaguardas extras.
Métricas e uso
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
get_dashboard_metrics | Métricas do painel: status do WhatsApp, conversas do dia e total, leads, follow-ups, agendamentos do dia, agentes ativos e a saúde geral do sistema. | Ver métricas e painel | "Como estão as métricas do meu Conversaas hoje?" |
get_usage_summary | Consumo do ciclo atual: conversas usadas × limite (%), armazenamento usado × limite (%), e a origem do limite (plano ou ajuste manual). | Ver métricas e painel | "Quanto do meu plano já usei este mês?" |
Agentes
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_agents | Lista os agentes de IA da conta com a configuração de cada um: nome, se está ativo, modelo, instruções, identidade, handoff e capacidades. | Ver configuração dos agentes | "Quais agentes eu tenho e quais estão ativos?" |
get_agent | Configuração completa de um agente específico, pelo ID. | Ver configuração dos agentes | "Me mostra a configuração do agente de vendas." |
Leads e CRM
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_leads | Lista os leads do CRM (mais recentes primeiro) com contato, etapa do funil, dono, valor, prioridade, temperatura e origem. Aceita filtro de arquivados e limite. | Ver leads e CRM | "Quais são meus leads quentes desta semana?" |
get_lead | Dados completos de um lead pelo ID, incluindo a atribuição de origem. | Ver leads e CRM | "Abre o lead do Eduardo e me diz de onde ele veio." |
Conversas
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_conversations | Lista as conversas (mais recentes primeiro) com status, canal, cliente, resumo, agente e a última mensagem. Aceita filtro por agente, status e canal. | Ver conversas e histórico de mensagens | "Quais conversas estão esperando atendimento humano?" |
get_conversation | Uma conversa específica com suas mensagens (texto, autor, tipo, data), em ordem cronológica. | Ver conversas e histórico de mensagens | "Me resume a conversa com o Alexandre Azevedo." |
Catálogo e produtos relacionados
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_catalog_sources | Lista as fontes de catálogo (feeds de produtos/imóveis) com status, contagem de itens e versão ativa. | Ver catálogo de produtos | "Quantos itens tem no meu catálogo?" |
search_catalog | Busca itens dentro de uma fonte de catálogo, com filtros de texto, localização e preço. Retorna a versão ativa. | Ver catálogo de produtos | "Procura no catálogo apartamentos em Curitiba até R$ 500 mil." |
list_product_relations | Lista as associações de "produtos relacionados" — para cada produto, quais aparecem como recomendados junto dele. | Ver catálogo de produtos | "Quais produtos estão marcados como relacionados ao tênis Runner?" |
Campanhas
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_campaigns | Lista as campanhas de WhatsApp (mais recentes primeiro) com status, agente responsável e estatísticas de envio. | Ver campanhas e seu desempenho | "Quais campanhas eu rodei este mês?" |
get_campaign | Detalhes e estatísticas de uma campanha específica. | Ver campanhas e seu desempenho | "Como foi o desempenho da campanha de Black Friday?" |
Relatórios
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
get_report | Um de 9 relatórios de atividade: volume de conversas, handoffs, taxa de automação, horários de pico, motivos de contato, feedback/CSAT, atribuição de vendas, oportunidades de automação e custo de WhatsApp. Aceita período, canal e agrupamento. | Ver relatórios de atividade | "Me mostra o volume de conversas dos últimos 7 dias por canal." |
get_sentiment_summary | Resumo de sentimento das conversas (hoje, 7 dias ou 30 dias). | Ver relatórios de atividade | "Como está o sentimento dos clientes essa semana?" |
Agenda
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_appointments | Agendamentos de um dia (padrão: hoje) — cliente, horário e status. | Ver agendamentos | "O que tenho agendado hoje?" |
E-commerce e retenção
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
get_nps_config | Configuração da pesquisa de NPS automática: se está ligada, canal, horas de espera e mensagem. | Ver configuração de retenção, NPS e recompensas | "O NPS automático está ativo?" |
get_giftback_config | Configuração de recompensas (giftback): descontos por segmento, canais, janela de envio e templates de mensagem. | Ver configuração de retenção, NPS e recompensas | "Quanto de desconto os clientes VIP recebem no giftback?" |
get_retention_config | Regras de retenção por segmento RFM (Campeão, VIP, Em risco, Perdido, etc.) — critério de classificação e follow-up automático — junto com quantos leads existem em cada segmento hoje. | Ver configuração de retenção, NPS e recompensas | "Quantos clientes estão no segmento 'Em risco' agora?" |
get_abandoned_cart_config | Configuração de recuperação de carrinho abandonado e de pedido pendente (boleto/PIX/pagamento recusado) — canais, cupom, janela de envio e sequência de etapas. | Ver configuração de retenção, NPS e recompensas | "Como está configurado o disparo de carrinho abandonado?" |
Automações (fluxos)
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_automations | Lista as automações (fluxos) configuradas — nome, status, gatilho e um resumo de quantas execuções tiveram. | Ver automações configuradas e seu histórico | "Quais automações eu tenho configuradas?" |
get_automation | Detalhes de uma automação específica, incluindo a estrutura do fluxo. | Ver automações configuradas e seu histórico | "Me explica o que a automação 'Recuperação VIP' faz." |
get_automation_runs | Histórico de execuções de uma automação — status, lead associado, horário de início/fim. | Ver automações configuradas e seu histórico | "Quantas vezes a automação de boas-vindas rodou essa semana?" |
Follow-up automático
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
get_followup_settings | Configuração de follow-up automático de um agente — se está ligado, tentativas, intervalo e horário de silêncio. | Ver configuração de follow-up e relatório | "O follow-up automático da Bia está ligado?" |
get_followup_report | Conversas em que houve tentativa de follow-up — quantas tentativas, se o contato respondeu depois, e por que parou. | Ver configuração de follow-up e relatório | "Quantos contatos voltaram a responder depois do follow-up esse mês?" |
Instagram
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_instagram_automations | Automações de comentários do Instagram — gatilho (post/palavra-chave), o que fazem (responder publicamente e/ou mandar DM) e se estão ativas. | Ver automações de comentários do Instagram | "Quais automações de comentário eu tenho no Instagram?" |
Base de conhecimento
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
list_knowledge_sources | Lista as fontes da base de conhecimento (documentos, sites, histórico de WhatsApp, Instagram) com tipo, título e status de processamento. | Ver fontes da base de conhecimento | "Que materiais estão na base de conhecimento do meu agente?" |
Leads e CRM — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_lead | Cria um lead novo (nome, contato, etapa do funil, temperatura, etc.). Pede confirmação antes de criar. | Editar leads do CRM | "Cria um lead pro João, telefone 11999998888, na etapa Novo." |
update_lead_notes | Substitui o texto das notas de um lead. Pede confirmação antes de aplicar. | Editar leads do CRM | "Atualiza as notas do lead da Maria pra 'agendou demo pra sexta'." |
move_lead_stage | Move um lead para outra etapa do funil, pelo nome da etapa (ex.: "Qualificado"). Pede confirmação antes de aplicar. | Editar leads do CRM | "Move o lead do João pra Proposta." |
Base de conhecimento — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_knowledge_source_url | Adiciona um site como fonte de conhecimento (rastreia a URL e páginas ligadas a ela, dentro de limites). Pede confirmação antes de iniciar; o rastreio roda em segundo plano. | Adicionar fontes à base de conhecimento | "Adiciona minha página de perguntas frequentes como fonte de conhecimento." |
Catálogo e produtos relacionados — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_catalog_source | Cria uma fonte de catálogo vazia (imobiliário ou produtos de e-commerce). Pede confirmação antes de criar. | Criar fontes de catálogo, importar feeds e gerenciar produtos relacionados | "Cria uma fonte de catálogo de imóveis chamada 'Feed SP'." |
trigger_catalog_import | Importa um feed (URL) para uma fonte de catálogo existente. Atenção: se o processamento terminar com sucesso, essa versão substitui automaticamente o catálogo que os clientes veem — não tem um passo extra de aprovação depois. Pede confirmação antes de iniciar. | Criar fontes de catálogo, importar feeds e gerenciar produtos relacionados | "Importa esse feed de imóveis pra fonte 'Feed SP': [URL]." |
create_product_relation | Define quais produtos aparecem como "relacionados" de um produto de origem. Se já existir uma associação pra esse produto, ela é substituída por completo — o preview avisa quando isso vai acontecer. Pede confirmação antes de aplicar. | Criar fontes de catálogo, importar feeds e gerenciar produtos relacionados | "Marca a meia cano alto como produto relacionado do tênis Runner." |
update_product_relation | Edita uma associação já existente — nome e/ou a lista de relacionados (que também é substituída por completo quando enviada). Pede confirmação antes de aplicar. | Criar fontes de catálogo, importar feeds e gerenciar produtos relacionados | "Troca os produtos relacionados dessa associação por esses dois aqui." |
delete_product_relation | Exclui uma associação de produtos relacionados (não afeta os produtos em si). Pede confirmação antes de excluir. | Criar fontes de catálogo, importar feeds e gerenciar produtos relacionados | "Remove essa associação de relacionados." |
Agentes — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_agent | Cria um agente de IA novo. O assistente deve conversar com você antes sobre o negócio (o que a empresa faz, como o agente deve se chamar, tom de voz, o que ele deve/não deve fazer) e só então montar o preview. O agente sempre nasce inativo. | Criar agentes e ativar/desativar | "Vamos criar um agente novo pro meu negócio." |
set_agent_active | Ativa ou desativa um agente existente. Atenção ao ativar: se o agente já estiver ligado a um canal conectado (WhatsApp, Instagram, etc.), ele passa a responder clientes reais na hora. | Criar agentes e ativar/desativar | "Ativa o agente Bia." |
update_agent_config | Edita um agente já existente — só os campos que você pedir mudam (instruções, nome, tom, horário, etc.). Atenção: se o agente estiver ativo, a mudança vale na hora para clientes reais. | Criar agentes e ativar/desativar | "Muda as instruções da Bia pra ela também falar sobre parcelamento." |
Campanhas — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_campaign | Cria uma campanha de WhatsApp como rascunho — nunca dispara nada sozinha. Mostra quantos contatos serão atingidos antes de confirmar. | Criar campanhas e pausar/retomar | "Cria uma campanha pro segmento 'Compraram no último mês' avisando da promoção." |
pause_campaign | Pausa uma campanha que está rodando. Pede confirmação antes de aplicar. | Criar campanhas e pausar/retomar | "Pausa a campanha de Black Friday." |
resume_campaign | Retoma uma campanha pausada. Pede confirmação antes de aplicar. | Criar campanhas e pausar/retomar | "Retoma o envio da campanha de Black Friday." |
Agenda — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
update_appointment_status | Altera o status de um agendamento (confirmado, cancelado, concluído, não compareceu). Cancelar sincroniza com o Google Calendar quando aplicável. Pede confirmação antes de aplicar. | Alterar status de agendamentos | "Marca o agendamento das 15h como cancelado." |
E-commerce e retenção — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
update_nps_config | Edita a configuração do NPS automático — só os campos que você pedir mudam. Pede confirmação, mostrando antes/depois. | Alterar configuração de retenção, NPS e recompensas | "Liga o NPS automático e manda 24h depois do atendimento." |
update_giftback_config | Edita a configuração de recompensas (giftback) — descontos, canais, templates. Pede confirmação, mostrando antes/depois. | Alterar configuração de retenção, NPS e recompensas | "Aumenta o desconto do giftback pra clientes campeões pra 15%." |
update_retention_cluster_config | Edita as regras de retenção de um segmento RFM por vez (critério e follow-up automático). Pede confirmação, mostrando antes/depois. | Alterar configuração de retenção, NPS e recompensas | "Liga o follow-up automático pro segmento 'Em risco', esperando 3 dias." |
Follow-up automático — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
update_followup_settings | Edita a configuração de follow-up automático de um agente — tentativas, intervalo, horário de silêncio e a sequência de mensagens (que é substituída por completo quando enviada). Pede confirmação, mostrando antes/depois. | Alterar configuração de follow-up | "Muda o follow-up da Bia pra no máximo 2 tentativas." |
Instagram — escrita
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
create_instagram_automation | Cria uma automação de comentários do Instagram — pode responder publicamente ao comentário e/ou mandar DM. O preview mostra o gatilho e os textos exatos antes de confirmar, e a automação nasce desligada por padrão. | Criar e ativar/desativar automações do Instagram | "Cria uma automação: quem comentar 'preço' no post do tênis recebe uma resposta e uma DM." |
set_instagram_automation_active | Ativa ou desativa uma automação já criada. Atenção ao ativar: a partir daí, comentários reais recebem resposta pública e/ou DM de verdade. | Criar e ativar/desativar automações do Instagram | "Ativa essa automação do Instagram." |
schedule_campaign (agenda para uma data futura) e start_campaign (dispara agora) enviam mensagens de verdade para os contatos de uma campanha. É a ação de maior impacto disponível via IA, e por isso tem um acesso próprio — conceder "criar campanhas e pausar/retomar" não libera o disparo; é preciso autorizar separadamente.
Salvaguardas que se aplicam sempre, sem exceção:
- Preview obrigatório com o nome da campanha, o texto/template exato que vai sair e a quantidade exata de contatos, antes de qualquer confirmação.
- Cooldown de 60 minutos desde a criação da campanha — não dá pra criar e disparar na mesma hora, mesmo confirmando.
- Só funciona em campanhas em rascunho (ou agendada, no caso do disparo imediato).
- Acima de 500 contatos, uma confirmação normal não basta: o assistente precisa de uma segunda confirmação, bem explícita, de que você realmente quer disparar para um público desse tamanho por essa via.
| Ferramenta | O que faz | Acesso exigido | Exemplo de pedido |
|---|
schedule_campaign | Agenda o disparo de uma campanha pra uma data/hora futura. | Disparar campanhas de WhatsApp | "Agenda a campanha de Black Friday pra amanhã às 9h." |
start_campaign | Dispara uma campanha imediatamente. | Disparar campanhas de WhatsApp | "Dispara a campanha de Black Friday agora." |
Ferramentas de escrita e confirmação
Nenhuma ferramenta de escrita muda algo na sua conta sem você confirmar. Isso acontece em duas etapas, na própria conversa com o assistente:
- Você pede a ação. O assistente chama a ferramenta e recebe de volta um preview — o que mudaria, do estado atual para o novo — e nada é alterado ainda.
- O assistente te mostra esse preview e pergunta se pode seguir. Só depois que você confirma (por exemplo, respondendo "sim"), ele chama a ferramenta de novo para aplicar de verdade.
Se você pedir algo que apagaria informação (por exemplo, substituir notas que já tinham conteúdo importante, ou substituir uma lista de produtos relacionados/etapas de follow-up já configurada), o assistente costuma avisar disso no preview antes de perguntar. Se mudar de ideia, é só não confirmar — nada é aplicado.
O que ainda não dá para fazer pela IA
- Conectar de verdade um canal (WhatsApp, Instagram) à sua conta — isso exige login na Meta ou escanear um QR Code, uma ação sua no navegador. O assistente consegue detectar que falta conectar (usando
get_dashboard_metrics) e te orientar a fazer isso em Configurações → Canais, mas não executa essa etapa por você.
- Editar a sequência de etapas do carrinho abandonado — hoje só dá pra consultar (
get_abandoned_cart_config); editar continua sendo feito pelo painel.
- Testar o giftback com um telefone real (
/rfm/giftback/test) — envia uma mensagem real na hora; segue de fora até uma decisão específica sobre isso.
O que as ferramentas nunca retornam
Independentemente do acesso concedido, nenhuma ferramenta devolve senhas, tokens de integração, chaves de API ou dados de pagamento. Veja Segurança e privacidade.