--- title: "Ferramentas e playbooks do Chatfuel MCP" description: "Cada ferramenta do servidor MCP do Chatfuel por tarefa: quais só leem, quais alteram seu bot e perguntam antes, e os playbooks para tarefas de várias etapas." canonical_url: https://chatfuel.com/pt/docs/mcp/chatfuel-mcp-tools markdown_url: https://chatfuel.com/pt/docs/mcp/chatfuel-mcp-tools.md last_updated: 2026-10-26 lang: pt site: https://chatfuel.com/docs llms_txt: https://chatfuel.com/docs/llms.txt --- # Ferramentas e playbooks do Chatfuel MCP Cada ferramenta do servidor MCP do Chatfuel por tarefa: quais só leem, quais alteram seu bot e perguntam antes, e os playbooks para tarefas de várias etapas. O servidor MCP do Chatfuel dá ao seu assistente de IA um conjunto de ferramentas, cada uma fazendo uma única tarefa na sua conta do Chatfuel, além de playbooks: guias curtos passo a passo para tarefas de várias etapas. Você não chama as ferramentas. O assistente as escolhe a partir do seu pedido, e os nomes abaixo ajudam você a entender o que ele fez. As ferramentas desta página estão no link MCP `https://mcp.chatfuel.com/panel`. As ferramentas para desenvolvedores de `https://mcp.chatfuel.com/panel/api` estão em [MCP ou API MCP: qual link do Chatfuel usar](https://chatfuel.com/pt/docs/mcp/which-chatfuel-mcp-link-to-use). ## Quais ferramentas leem a sua conta? [#quais-ferramentas-leem-a-sua-conta] Estas ferramentas apenas leem e estão disponíveis com acesso **Read-only**: * `list_bots`: seus workspaces, seus bots e o plano e os créditos de IA de cada workspace. * `get_bot`: os canais conectados de um bot e as Automations dele, ativadas ou desativadas. * `get_automation`: as configurações de uma automação e os posts, palavras-chave ou links aos quais ela está limitada. * `get_knowledge_base`: dados da empresa, instruções, horário de funcionamento, FAQ, serviços e especialistas. * `list_posts`: posts e reels recentes do Instagram e posts de Páginas do Facebook, 25 por página. Posts do TikTok não são listados. * `list_chats` e `get_chat`: chats com clientes, 20 por página, e as últimas 20 mensagens de um chat. * `review_chats`: um resumo dos últimos 25 chats, ou de até 100 em um período: chats sem resposta, transferências para humanos, mensagens não entregues, perguntas repetidas e perguntas que o FAQ não cobre. * `diagnose_bot`: por que o bot não responde, começando pela causa que mais bloqueia. * `search_docs`, `get_doc` e `get_playbook`: artigos de ajuda e playbooks do Chatfuel. ## Quais ferramentas alteram a Knowledge Base? [#quais-ferramentas-alteram-a-knowledge-base] * `add_faq`: adiciona até 20 perguntas e respostas. Perguntas que já estão no FAQ são ignoradas. * `update_faq`: altera ou remove entradas do FAQ. Entradas removidas não podem ser restauradas. * `set_company_info`: nome da empresa, e-mail, telefone, endereço, site e formas de pagamento. * `set_instructions`: substitui as instruções adicionais da IA, como assuntos a evitar. * `set_business_hours`: substitui o horário semanal. Os dias que ficarem de fora são considerados fechados. O que esses campos fazem está em [como configurar a Knowledge Base](https://chatfuel.com/pt/docs/ai-features/how-to-set-up-knowledge-base). ## Quais ferramentas alteram as Automations e as respostas a comentários? [#quais-ferramentas-alteram-as-automations-e-as-respostas-a-comentários] * `enable_ai`: ativa o Fuely AI nos canais que você escolher: WhatsApp, Instagram, Facebook, TikTok ou chat do site. Ativa o Main bot e as base automations de cada canal para mensagens, respostas a stories, links e anúncios. As automações de comentários continuam como estão. * `set_automation_enabled`: ativa ou desativa uma automação. Nunca altera o Main bot, e desativar uma automação mantém as configurações dela. * `update_automation_setting`: altera uma configuração, como quando a IA responde, a transferência para a sua equipe, follow-ups, coleta de dados de contato, regras de agendamento ou a resposta pública e privada de uma automação de comentários. * `setup_comment_replies`: configura respostas da IA ou fixas a comentários no Instagram, Facebook ou TikTok, para todos os posts ou para posts e palavras-chave escolhidos. ## Quais ferramentas cuidam de chats, agendamentos e testes? [#quais-ferramentas-cuidam-de-chats-agendamentos-e-testes] * `send_chat_message`: envia o seu texto para um cliente real e passa a conversa para o chat ao vivo. Uma mensagem enviada não pode ser desfeita. * `take_over_chat`: passa uma conversa para o chat ao vivo com você, sem enviar nada. * `return_chat_to_ai`: encerra o chat ao vivo, e a IA responde na hora à última mensagem do cliente. * `setup_booking`: cria ou atualiza serviços agendáveis e especialistas, até 50 serviços e 30 especialistas por pedido. Não exclui nada. * `remove_booking_item`: exclui um serviço ou um especialista. Os agendamentos que os clientes já fizeram continuam valendo. * `test_reply`: envia uma mensagem de cliente de exemplo para um chat de teste (sandbox) e retorna a resposta do bot. Nenhum cliente real recebe mensagens. ## Sobre quais alterações o assistente pergunta antes? [#sobre-quais-alterações-o-assistente-pergunta-antes] O servidor MCP do Chatfuel orienta o assistente a fazer uma pergunta de sim ou não antes de ativar a IA, desativar uma automação, alterar ou remover entradas do FAQ, substituir os dados da empresa, as instruções, o horário de funcionamento ou uma configuração, remover um serviço, ou passar um chat para o chat ao vivo ou tirá-lo de lá. Toda mensagem para um cliente precisa de um sim para o texto exato. "Talvez", "você decide" ou um sim com condições não é um sim: o assistente não altera nada e diz o que deixou de fazer. Um teste em sandbox com `test_reply` não precisa de um sim. ## O que são playbooks? [#o-que-são-playbooks] Playbooks são guias passo a passo que o assistente lê com `get_playbook` antes de tarefas de várias etapas: * **Configuração:** `onboarding` (escolhe o bot e verifica o plano), `bot-overview`, `ai-persona` (nome, tom, idioma, saudação), `automation-settings`, `business-hours`, `diagnose-no-replies`. * **Knowledge Base:** `fill-knowledge-base`, `manage-catalog`. * **Canais:** `comments-autoreply`, `comments-troubleshoot`, `connect-whatsapp`. * **Clientes:** `reply-to-chats`, `find-leads`, `manage-bookings`. * **Análises:** `improve-from-chats`. O catálogo, os agendamentos, as etapas de leads e o link de conexão do WhatsApp só funcionam no link API MCP. No link MCP, o assistente indica o painel para essas tarefas. ## Problemas comuns [#problemas-comuns] ### O assistente não tem uma ferramenta que vejo nesta página [#o-assistente-não-tem-uma-ferramenta-que-vejo-nesta-página] As ferramentas de escrita ficam ocultas em uma conexão **Read-only**. Conecte de novo com acesso total para tê-las. ### O assistente pode editar Flows? [#o-assistente-pode-editar-flows] Não. Flows não podem ser exibidos nem editados pelo MCP. Edite-os no painel do Chatfuel.