Todos os artigos

Como deixar o Claude ou o ChatGPT trabalhar no seu CRM (plano Business)

Automatizar7 min de leitura

Para que serve: pedir ao Claude, ao ChatGPT ou ao Cursor que consulte e atualize o CRM por você ("o que temos da empresa X?", "mova o negócio do João para Proposta", "responda a Maria confirmando a reunião") e receber a resposta com os dados reais.

O que você precisa

  • Plano: Business. Nos outros planos, a tela API e integrações avisa que conectar a IA é do plano Business. O token pessoal dessa tela vale em todos os planos para integrar outros sistemas pela API, mas não abre o servidor MCP fora do Business.
  • Permissão: gerente e vendedor. A IA enxerga só o que o seu usuário já enxerga no CRM. O gerente também vê e revoga os tokens e as conexões de toda a equipe.
  • Antes: gerente precisa estar com a verificação em duas etapas ligada para criar token (Como proteger sua conta com 2FA).

O que a IA consegue fazer hoje

A IA faz as mesmas ações da API do Rumo CRM, sempre como o seu usuário: o vendedor só alcança os contatos, negócios e conversas dele, e o que é só do gerente (apagar negócio, desativar empresa) continua só do gerente. Cada grupo de ações depende de uma permissão da conexão ou do token:

  • CRM: ler: buscar e ver contatos, empresas e negócios (com filtro por funil, etapa, responsável e status), os funis e as etapas, os produtos de um negócio, as tarefas (com filtro por negócio, responsável, situação e data), os tipos de atividade, as notas e o histórico de um negócio.
  • CRM: escrever (inclui o que CRM: ler faz): criar ou atualizar contato e editar contato (essas duas só para gerente; o vendedor recebe permissão negada), criar, editar e desativar empresa, criar, editar e apagar negócio, mover, ganhar e perder negócio, trocar os produtos do negócio, criar, editar, concluir e apagar tarefa e registrar nota (ou ligação, e-mail e WhatsApp) no histórico de um negócio. Mover, ganhar, perder e concluir tarefa disparam as mesmas automações da tela. Registrar nota não envia nada a ninguém.
  • Inbox: ler: listar os canais e as conversas e ler as mensagens.
  • Inbox: enviar: enviar texto, arquivo ou template numa conversa que já existe e começar uma conversa de WhatsApp oficial com um template aprovado (a primeira mensagem para um número novo é sempre template, e só no número oficial; veja Disparar template pelo seu sistema (API)). A IA é orientada a mostrar a conversa e a mensagem e esperar a sua confirmação antes de enviar. Apagar, desativar, perder negócio, trocar produtos e apagar tarefa também são marcados para ela pedir confirmação.
  • Webhooks: gerenciar (só gerente): listar, ver, cadastrar, editar e excluir os endereços que recebem os eventos da empresa (webhooks). Cadastrar ou trocar o endereço passa a mandar dados da empresa para fora, então a IA é orientada a confirmar o endereço e os eventos com você antes; excluir também pede confirmação. A chave secreta aparece uma vez só, na resposta do cadastro. Para receber eventos do CRM, a conexão precisa também de CRM: ler; para eventos de mensagens e campanhas, de Inbox: ler.

A conexão da IA tem dois contadores. Toda mensagem que a IA troca com o Rumo CRM conta em 120 por minuto por conexão ou token, inclusive quando ela só lista as ferramentas (o que costuma fazer antes de agir). Cada ação que ela executa conta também no limite da API: 120 por minuto por token e 600 por minuto somando a empresa toda. Na prática, uma IA que lista as ferramentas antes de cada ação faz perto de 60 ações por minuto.

Passo a passo

Claude ou ChatGPT (conector com login)

  1. No Claude ou no ChatGPT, adicione um conector personalizado (MCP) com o endereço https://rumocrm.com/api/mcp.
  2. Na hora de conectar, abre uma página do Rumo CRM. Se pedir, entre com o seu usuário. A página "Conectar ... ao Rumo CRM" lista as permissões pedidas. Clique em Permitir acesso.
  3. Pergunte algo como "busque no meu CRM o contato da empresa Exemplo". A IA usa Buscar contatos e depois Ver contato.
  4. Para cortar o acesso, vá em Configurações → Operação → API e integrações. No card Conectar minha IA, a lista Aplicativos conectados mostra cada IA conectada e o último uso. Clique em Desconectar e confirme. A IA perde o acesso na hora; para voltar, conecte de novo pelo aplicativo. O gerente que clicar em Ver da organização vê e desconecta as conexões de todos. Aplicativos conectados e DesconectarAplicativos conectados e Desconectar

Cursor e outras ferramentas que pedem token

  1. Vá em Configurações → Operação → API e integrações. Atalho API e integraçõesAtalho API e integrações
  2. No card Criar token, dê um Nome (ex.: "Claude no meu notebook"). Em O que este token pode fazer, deixe marcado CRM: ler e marque CRM: escrever, Inbox: ler ou Inbox: enviar só se a IA for alterar o CRM ou responder conversas. Webhooks: gerenciar aparece só para gerente: marque só se a IA for cadastrar webhooks. Em Validade, escolha 30 dias, 90 dias ou 1 ano. Clique em Criar token. Criar token para a IACriar token para a IA
  3. Aparece Copie o token agora. Clique em Copiar e guarde: ele só aparece essa vez. Clique em Já copiei, fechar.
  4. Na ferramenta, configure o servidor MCP com o endereço https://rumocrm.com/api/mcp e o cabeçalho Authorization: Bearer <seu token>.
  5. Para cortar o acesso, encontre o token em Meus tokens, clique no ícone de lixeira e confirme em Revogar. A IA perde o acesso na hora. O gerente pode clicar em Ver da organização para ver e revogar os tokens de todos. Cada token mostra também quantas requisições fez nos últimos 30 dias.

Se algo der errado

O que aparecePor que aconteceO que fazer
"2FA obrigatório para esta ação"Você é gerente e não ligou a verificação em duas etapasAtive o 2FA em Segurança e 2FA e tente de novo
"O MCP exige o plano Business" ou "O servidor MCP está disponível apenas no plano Business"A conta não está no plano Business. O token pessoal vale para a API, mas não para conectar a IAMude de plano (Como mudar de plano)
"A assinatura desta conta não está ativa. Regularize o plano para usar a API."A assinatura foi cancelada e o período pago acabou, ou o pagamento atrasou além da carênciaRegularize o pagamento (Como recuperar o acesso quando o CRM abre só na tela de planos)
"Selecione uma organização no Rumo CRM antes de conectar"Você participa de mais de uma conta e nenhuma está escolhidaEntre no CRM, escolha a conta e conecte de novo
A IA diz que não tem ferramentasO token ou a permissão não incluem nenhuma das permissões acimaCrie outro token com CRM: ler
A IA diz que não consegue criar, editar ou enviarA conexão ou o token só tem CRM: lerConecte de novo (ou crie outro token) marcando CRM: escrever, Inbox: ler ou Inbox: enviar
"Você não tem permissão para acessar este recurso"Você é vendedor e pediu algo que é só do gerente, como apagar um negócioPeça ao gerente
"Limite de pedidos por minuto atingido. Tente de novo em N s." (ou "Limite de 120 pedidos por minuto deste token atingido")A IA fez pedidos demais em um minutoEspere os segundos indicados e peça de novo
A IA parou de responder com dados do CRMO token venceu ou foi revogado, ou a conexão foi desconectada em Aplicativos conectadosCrie um token novo ou conecte de novo
A IA diz que criou um negócio ou mandou mensagem, mas nada apareceA ação deu erro e a IA não avisou, ou faltou a permissãoConfira no CRM e peça de novo; a IA recebe o motivo do erro

O que este recurso não faz

  • Não apaga contatos (a API também não apaga).
  • Não consulta relatórios nem painéis.
  • Não edita nem apaga notas já registradas: só registra notas novas.
  • Só começa conversa nova pelo WhatsApp oficial e com um template aprovado: não manda texto livre nem arquivo para um número que nunca escreveu, e não funciona em número de QR code nem no Instagram.
  • O token não pode ser visto de novo depois de fechado. Se perder, revogue e crie outro.

Relacionados

Esse artigo te ajudou?

Para que serve no time de vendas

Chatbot no WhatsApp e Instagram no Rumo CRM

Chatbot para WhatsApp e Instagram: responde no Direct quem comentou no post, qualifica o lead e entrega o negócio no funil para o vendedor.

Continuar lendo em Automatizar

Ainda com dúvida sobre isso?

Manda mensagem direto — sem fila, sem bot dando volta.

Artigo da Central de Ajuda Rumo CRM