Ferramentas e playbooks do Chatfuel MCP

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.

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?

• 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.

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?

• 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?

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?

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

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?

Não. Flows não podem ser exibidos nem editados pelo MCP. Edite-os no painel do Chatfuel.