Todos os artigos

Integrações

Como conectar o ChatGPT ou o Claude ao Belion

Com o Conector de IA, o ChatGPT ou o Claude que você já assina passa a enxergar seus produtos e kits — com fotos, atributos e canais — e a trabalhar neles direto do chat: melhorar fotos, montar a imagem de um kit, criar cenas de uso, escrever anúncios no padrão de cada marketplace e gravar textos no cadastro. Não há custo extra no Belion: o modelo é o da sua assinatura. A conexão leva cerca de 3 minutos.

Como funciona

  • A conexão é sua, não da loja: cada usuário conecta a própria conta de IA e escolhe em qual loja ela vai trabalhar.
  • A IA faz só o que o seu papel permite no painel. Quem não pode editar produtos no Belion também não consegue pela IA.
  • Toda ação que grava algo fica registrada na auditoria com o seu nome.
  • A IA não gera imagem dentro do Belion: ela gera no chat, e devolve para o cadastro por um link de envio que ela mesma cria (veja o passo 4).

Antes de começar

  • ChatGPT: plano Plus, Pro, Business, Enterprise ou Edu. Em contas Business e Enterprise, um administrador precisa liberar conectores personalizados em Configurações do workspace → Permissões e funções → Dados conectados.
  • Claude: plano Pro, Max, Team ou Enterprise.
  • No Belion: um usuário ativo em pelo menos uma loja.

1. Copie o endereço do conector

  1. No painel Belion, clique no seu avatar e vá em Preferências → Conectar IA.
  2. Em Endereço do conector (MCP), clique em Copiar. O endereço é https://api.belion.com.br/api/mcp.

2a. No ChatGPT

O botão de criar plugin só aparece com o Modo desenvolvedor ligado.

  1. Foto de perfil → ConfiguraçõesPlugins (em algumas contas chama-se Aplicativos ou Conectores).
  2. Role até Configurações avançadas e ligue Modo desenvolvedor. Se não estiver ali, procure em Segurança e login.
  3. Feche as configurações e recarregue a página.
  4. Abra Plugins no menu lateral e clique em Criar. Abre a janela Novo plugin. Preencha assim:
    • Ícone (opcional): PNG de até 10 KB. Se quiser, use o ícone da Belion: baixar ícone.
    • Nome: Belion.
    • Descrição (opcional): Produtos e kits da minha loja: fotos, anúncios e cadastro.
    • Conexão: deixe em URL do servidor e cole o endereço copiado no passo 1.
    • Autenticação: OAuth. Não precisa abrir Configurações avançadas de OAuth — o ChatGPT detecta tudo sozinho.
    • Leia o aviso sobre servidores personalizados e marque Entendi e quero continuar.
  5. Clique em Criar. O ChatGPT abre a tela de autorização do Belion (passo 3).

Se Criar não aparecer mesmo com o modo desenvolvedor ligado, a conta é Free ou o workspace bloqueia conectores personalizados.

2b. No Claude

  1. Clique no seu nome → ConfiguraçõesConectores.
  2. Clique em Adicionar conector personalizado.
  3. Dê um nome (ex.: Belion), cole o endereço e clique em Adicionar.
  4. Ao lado do conector novo, clique em Conectar. O Claude abre a tela de autorização do Belion (passo 3).

3. Autorize no Belion

  1. Se ainda não estiver logado, entre com o seu usuário do painel. Depois do login você volta para a tela de autorização automaticamente.
  2. Em Em qual loja a IA vai trabalhar?, escolha a loja. Se você tem acesso a mais de uma, a loja atual vem marcada.
  3. Confira o que o aplicativo poderá fazer e clique em Autorizar.
  4. Você volta ao ChatGPT/Claude com o Belion conectado.

Para conectar a mesma IA a outra loja, repita o passo 2 criando um segundo conector (ex.: "Belion — Loja Centro"). Cada conector fica ligado a uma loja.

4. Use no chat

Fale normalmente. Alguns pedidos que já acionam o Belion:

  • "Quais produtos da minha loja estão sem foto?"
  • "Melhore a foto principal do produto Caderno Tilibra 96 folhas para o Mercado Livre." A IA busca a foto atual e o cadastro, e devolve a foto tratada: fundo branco, produto idêntico, sem inventar detalhes.
  • "Monte a imagem do kit Volta às aulas com os componentes."
  • "Crie uma cena de uso desse kit numa mesa de estudos, público adolescente."
  • "Escreva o anúncio desse produto para a Shopee." Ela segue as regras de título e descrição do canal e lista o que falta confirmar.
  • "Grave a descrição curta e o SEO no Belion." Ela pede confirmação e salva no cadastro.
  • "Crie um kit com 2 unidades do produto X e 1 do Y por R$ 89,90."

Para colocar uma imagem gerada no cadastro, aprove a imagem no chat e peça "envie essa imagem para o cadastro do produto". A IA devolve um link de envio, válido por 30 minutos. Para a foto principal, use o botão Baixar da imagem no chat e arraste o arquivo para o link: copiar pela tela entrega só uma miniatura de 400 px, pequena para marketplace. Para cenas e imagens extras, botão direito → Copiar imagemCtrl+V no link basta. Ela entra no produto, na variante ou no kit na hora. A foto principal fica na variante; cenas de uso, tabela nutricional, verso e detalhes entram como adicionais do produto — a IA já sabe a regra. Fotos que a IA encontrou na internet ela anexa sozinha pela URL, sem link.

No Claude, os pedidos prontos também aparecem como comandos ao digitar /: melhorar_foto, imagem_kit, cena_de_uso, conteudo_marketplace e melhorar_descricao. No ChatGPT eles não aparecem no menu, mas a IA os usa sozinha quando você pede em português.

Desconectar

Em Preferências → Conectar IA, a seção Conexões ativas lista cada aplicativo e a loja. Clique em Desconectar: o acesso cai na hora e o aplicativo pede uma nova autorização se você tentar usá-lo de novo. Você também pode remover o conector do lado do ChatGPT/Claude.

Problemas comuns

  • "Pedido inválido ou expirado" na tela de autorização — o pedido vale 10 minutos. Volte ao ChatGPT/Claude e clique em conectar de novo.
  • Não aparece nenhuma loja para escolher — sua conta não tem vínculo ativo com uma loja (ex.: usuário só da plataforma). Entre com um usuário da loja.
  • A IA diz que não tem permissão — o seu papel no Belion não tem a permissão pedida (Ver produtos, Editar produtos ou Kits). Peça ao responsável para liberar em Equipe → Papéis.
  • A IA inventou uma característica do produto — peça para usar só o que está no cadastro. Os pedidos prontos já trazem essa instrução; se faltar um dado, complete o cadastro no Belion e peça de novo.
  • O link de envio expirou ou "já foi utilizado" — peça outro link no chat. Cada link aceita até 5 imagens em 30 minutos.
  • A IA não enxerga a foto atual — o ChatGPT nem sempre mostra imagens vindas de conectores. Arraste a foto do produto para o chat e peça a melhoria; o resultado volta pelo link de envio do mesmo jeito.
  • O ChatGPT pediu para reconectar do nada — a conexão foi desconectada no Belion, ou o seu usuário/loja foi desativado. Refaça o passo 3.

Depois de conectar

Na página Configurações → Integrações, os cards ChatGPT e Claude mostram a conexão como ativa e levam para as Preferências. As conexões são por usuário: cada pessoa da equipe que quiser usar a IA conecta a própria conta, com as próprias permissões.