Conector do BotConversa para Claude e ChatGPT (MCP)

O que é o conector do BotConversa?

É uma ponte entre a sua conta do BotConversa e um assistente de IA como o Claude ou o ChatGPT. Ela usa o MCP (Model Context Protocol), o padrão que permite a uma IA usar ferramentas de outros sistemas em vez de só conversar.

O conector tem 167 ações e cobre quase tudo o que um administrador faz no painel: conversas, contatos, fluxos, assistentes de IA, Kanban, sequências, transmissões, equipe e métricas. Você faz o pedido em português, do jeito que falaria com um colega, e a IA escolhe as ações certas.

Como conecto no Claude?

1. Abra o Claude (claude.ai ou o app de computador) e entre em Configurações → Conectores.
2. Clique em Adicionar conector personalizado.
3. Dê um nome, por exemplo BotConversa, e cole o endereço https://mcp.botconversa.com.br/mcp/connector.
4. Clique em Adicionar e, em seguida, em Conectar (vincular).
5. Abre a janela do BotConversa. Se pedir, entre com o seu e-mail e senha do painel.
6. Escolha a companhia que o Claude vai acessar.
7. Escolha o nível de acesso: Leitura ou Completo (Leitura e Escrita), e confirme.
8. Numa conversa nova, confira se o conector BotConversa está ligado no menu de ferramentas da caixa de mensagem.

Como conecto no ChatGPT?

No ChatGPT, conectores personalizados ficam no modo desenvolvedor, que depende do plano da sua conta do ChatGPT.

1. No ChatGPT, entre em Configurações → Apps e conectores.
2. Em Configurações avançadas, ative o Modo desenvolvedor.
3. Volte e clique em Criar para adicionar um conector novo.
4. Preencha o nome (BotConversa), cole o endereço https://mcp.botconversa.com.br/mcp/connector e escolha a autenticação OAuth.
5. Crie o conector e clique para vincular.
6. Na janela do BotConversa, entre na conta, escolha a companhia e o nível de acesso, e confirme.
7. Numa conversa nova, ative o conector BotConversa antes de fazer o pedido.

Os nomes dos menus do Claude e do ChatGPT mudam de tempos em tempos. Se não achar a opção com o nome exato, procure por conectores ou conector personalizado nas configurações.

Leitura ou Completo: qual escolho?

	Leitura	Completo (Leitura e Escrita)
O que a IA pode fazer	Consultar, resumir e analisar	Consultar e também criar, editar e apagar
Exemplo	"Qual fluxo está como Resposta padrão?"	"Troca a Resposta padrão para o fluxo Atendimento."
Indicado para	Começar, auditar, gerar relatórios	Montar e operar a conta no dia a dia

Na dúvida, comece com Leitura. Quando já estiver confortável com o que a IA faz, conecte de novo com o acesso Completo.

Para confirmar a conexão a qualquer momento, pergunte: "Em qual companhia você está conectado e com que permissão?"

O que dá para fazer?

Você não precisa decorar nenhuma ação: basta pedir. A tabela mostra as áreas cobertas e um exemplo de pedido para cada uma.

Área	O que cobre	Exemplo de pedido
Conta e companhia	Configurações gerais, saúde dos canais, horário de funcionamento	"Algum canal está com problema agora?"
Conversas	Ler conversas, abrir imagens e documentos, transcrever áudios, ver mensagens agendadas	"Me resume a conversa com a Ana e diz o que ficou pendente."
Contatos	Buscar, cadastrar (até 100 de uma vez), etiquetas, campos, pausar o robô, atribuir, notas internas	"Pausa o robô para esse contato e atribui para o Carlos."
Fluxos	Listar, criar, duplicar, organizar em pastas, editar textos, fluxos padrão	"Duplica o fluxo de atendimento antes de eu mexer nele."
Assistente de IA	Ler e editar prompt, modelo e saídas dos blocos GPT; Skills	"Lê o prompt do assistente e aponta contradições."
API Oficial	Modelos de mensagem (templates) e WhatsApp Flows	"Quais templates foram reprovados esta semana e por quê?"
Transmissões	Listar, criar como rascunho, pausar ou encerrar	"Pausa o disparo que está saindo agora."
Sequências	Criar, editar passos, atrasos e janelas de envio	"Cria uma sequência de 5 dias, só em dias úteis, das 9h às 18h."
Palavras-chave	Grupos, palavras e fluxo vinculado	"Quando alguém mandar 'orçamento', dispara o fluxo de orçamento."
Campanhas	Links e QR Codes de entrada	"Cria uma campanha para o anúncio do Instagram e me dá o link."
Webhooks	Automações de entrada, ações e requisições de teste	"Quando a Hotmart avisar compra aprovada, põe a etiqueta Comprador."
Kanban	Quadros, colunas e cartões	"Quais cartões estão parados em Aguardando cliente há mais tempo?"
Equipe e estrutura	Membros, departamentos, respostas rápidas, motivos de encerramento, etiquetas, campos	"Quais etiquetas estão sem descrição?"
Métricas	Volume de chats, desempenho por atendente, tempos de resposta	"Como foi a semana do suporte comparada à anterior?"

Como faço um bom pedido?

• Diga o nome como aparece no painel. "Fluxo Boas-vindas 2026" funciona melhor do que "aquele fluxo novo".
• Peça para ver antes de mudar. "Me mostra o que você vai alterar antes de salvar" evita surpresa em fluxo que está no ar.
• Quebre tarefas grandes em etapas. Primeiro "lista os contatos com a etiqueta Trial", depois "coloca todos na sequência de onboarding".
• Confira no painel. Tudo o que a IA faz aparece no BotConversa na hora. Vale abrir e olhar, principalmente nas primeiras vezes.

O que o conector ainda não faz?

• Não manda mensagem avulsa para o cliente. Para falar com um contato, coloque-o num fluxo ou numa sequência.
• Não dispara transmissões. A IA monta o disparo como rascunho, e uma pessoa revisa e envia pela plataforma. Veja Criando uma transmissão.
• Não lê todo tipo de bloco por inteiro. O conteúdo completo aparece para blocos GPT, Enviar Mensagem e texto. Os outros tipos aparecem na estrutura do fluxo, sem todos os detalhes.
• Segue o seu plano. Templates, WhatsApp Flows e parte do assistente dependem da API Oficial ou do plano da companhia.

É seguro?

• Uma companhia por conexão, com o acesso que você escolheu. A IA não enxerga outras companhias nem faz mais do que o nível de acesso permite.
• Mensagem de cliente não dá ordem para a IA. O que o conector lê nas conversas é tratado como informação, nunca como instrução. Um cliente não consegue escrever algo no WhatsApp que faça a IA agir na sua conta.
• Confirme antes de ações que não têm volta. Apagar, publicar, trocar o fluxo padrão ou editar um assistente usado em vários fluxos: peça para a IA descrever o que vai fazer e só então autorize.
• Dá para desconectar quando quiser. Remova o conector nas configurações do Claude ou do ChatGPT, e a IA perde o acesso à conta.