Descrições com IA: conectar a OpenAI

Gere descrições de produtos para o Mercado Livre com IA: crie sua API Key da OpenAI e conecte-a ao Assistente IA do WooSync (plano Pro).

Plano Pro

O Assistente IA do WooSync usa a OpenAI (ChatGPT) para redigir as descrições dos seus produtos em segundos. Em vez de escrever cada ficha à mão, a IA monta um texto de venda a partir dos dados do produto e você o revisa antes de publicá-lo no Mercado Livre.

A chave é sua: você cria uma conta própria na OpenAI com uma API Key e o consumo é cobrado na sua conta da OpenAI, não no WooSync. Por isso o primeiro passo é obter essa chave; depois você a cola uma única vez no plugin.

Antes de começar

WooSync instalado no seu WooCommerce. Se você ainda não fez isso, siga Instalar o WooSync.
Sua conta do Mercado Livre conectada, para poder publicar o que a IA redige. Guia: Vincular o WooCommerce com o Mercado Livre.
Plano Pro. O Assistente IA é um módulo avançado; ele vem com o Pro. Veja os detalhes em Planos e licenças.
Uma conta na OpenAI com saldo e uma API Key. A OpenAI é um serviço à parte do WooSync; os passos para criá-la estão aqui embaixo.

Como criar sua conta na OpenAI

Acesse platform.openai.com e cadastre-se (ou faça login).
Verifique seu e-mail e, se for solicitado, seu número de telefone.

A conta da OpenAI é independente do seu ChatGPT gratuito: mesmo que você use o ChatGPT no navegador, para conectar via API você precisa desta conta da plataforma de desenvolvedores e de uma chave própria.

Como adicionar saldo na OpenAI

A OpenAI não gera conteúdo se a sua conta não tiver crédito, mesmo que a conta seja nova. Este é o motivo mais comum de a conexão falhar com a mensagem “You exceeded your current quota”.

Vá em Settings → Billing (Configuração → Faturamento).
Toque em Add payment details e cadastre um cartão.
Adicione um crédito inicial. Com poucos dólares dá para centenas de descrições, porque cada descrição consome muito pouco.

Você controla o gasto pelo seu painel da OpenAI, onde pode ver o consumo e definir um limite mensal, se quiser.

Como gerar sua API Key

No painel da OpenAI, acesse API keys.
Toque em Create new secret key, dê um nome a ela (por exemplo WooSync) e crie-a.
Copie-a naquele momento: ela começa com sk-… e a OpenAI só a mostra uma única vez. Se você perdê-la, não poderá vê-la de novo: basta gerar uma nova e pronto.

Guarde a chave em um lugar seguro. Ela é como uma senha: qualquer pessoa que a tenha pode consumir o saldo da sua conta. Se você suspeitar que ela vazou, revogue-a em API keys e crie outra.

Como conectar a API Key no WooSync

Na sua loja, entre na tela do Assistente IA do plugin (WooSync → Automação → Assistente IA).
Cole a chave no campo API Key, sem espaços no início nem no final.
Toque em Salvar e Testar.

Se estiver tudo certo, você verá o estado em verde: Conectado. Se aparecer Desconectado com uma mensagem de cota, verifique se a sua conta da OpenAI tem saldo (o passo de Billing).

Como gerar descrições com IA

Com a conexão em verde, você já pode pedir para a IA redigir. Ao preparar ou editar um produto para o Mercado Livre, use a opção de gerar a descrição com o Assistente IA: a IA monta um texto a partir dos dados do produto e o deixa pronto no campo de descrição.

Revise e ajuste o texto antes de publicar: corrija dados, tom ou detalhes que a IA não tenha como saber (medidas exatas, condições de garantia, etc.).
Quando ficar do jeito que você quer, exporte ou publique o produto no Mercado Livre como sempre. Se você trabalha com modelos, veja Publicar com modelos.

Problemas frequentes

“You exceeded your current quota” → sua conta da OpenAI não tem crédito disponível. É o mais comum com contas novas. Solução: adicione saldo em Billing e toque novamente em Salvar e Testar.
“Incorrect API key” → a chave foi copiada errada ou foi revogada. Solução: gere uma nova em API keys, copie-a por completo (começa com sk-) e cole-a de novo.
Continua em “Desconectado” mesmo depois de adicionar saldo → costuma ser a chave incompleta ou com um espaço colado ao copiar. Solução: apague o campo, cole a chave de novo sem espaços no início ou no final, e salve outra vez.
A descrição não é publicada no Mercado Livre → o Mercado Livre não permite descrições com telefones, e-mails nem links externos. Se você editou o texto da IA e adicionou dados de contato ou links, o ML rejeita a publicação. Solução: remova telefones, e-mails e URLs do texto e exporte novamente.