← Central de Ajuda

Conectar a Inteligência Artificial

O TOTE usa o SEU modelo de IA — você conecta sua própria conta de um provedor. Assim você tem controle total e o custo do modelo é direto com o provedor, sem intermediário.

Você precisa de uma conta no provedor escolhido e de uma API Key (uma senha que o TOTE usa pra falar com a IA no seu nome). Abaixo tem o passo a passo de cada um. Só precisa de um.

Qual provedor escolher?

Se você não tem preferência, esses são os atalhos:

  • Quer testar sem gastar: Google (Gemini) — tem plano gratuito. Serve pra experimentar: o plano grátis aceita cerca de 20 respostas por dia, então pra valer você vai querer ativar o faturamento na chave (veja o aviso abaixo).
  • Quer o mais usado: OpenAI (ChatGPT).
  • Quer gastar o mínimo: DeepSeek.
  • Quer respostas mais rápidas: Groq.
  • Quer vários modelos com uma conta só: OpenRouter.

Dá pra trocar quando quiser em Configurações → Trocar IA, sem perder nada do que já foi respondido.

Passo 1 — Pegar a sua API Key

Escolha UM provedor abaixo e siga os passos dele:

OpenAI (ChatGPT)

O mais conhecido. Precisa colocar crédito antes de usar.

  1. 1

    Acesse e faça login

    platform.openai.com/api-keys
  2. 2

    Clique em “Create new secret key”

  3. 3

    Copie a chave (começa com sk-)

    Ela só aparece UMA vez — copie antes de fechar.
  4. 4

    Adicione crédito

    Em Billing. Sem crédito a chave é aceita mas toda resposta falha.

Google (Gemini) — tem plano grátis

O mais fácil pra começar: dá pra criar a chave sem cartão. Mas a chave gratuita tem limite POR DIA (cerca de 20 respostas) — pra uso real, ative o faturamento.

  1. 1

    Acesse o Google AI Studio

    aistudio.google.com/apikey
  2. 2

    Entre com sua conta Google

  3. 3

    Clique em “Create API key”

  4. 4

    Copie a chave gerada

  5. 5

    Ative o faturamento da chave

    Na lista de chaves, olhe a coluna “Nível de faturamento”. Se estiver “Nível gratuito”, clique em “Configurar faturamento”. Sem isso, o Google corta suas respostas depois de ~20 comentários no dia — e num perfil com movimento isso acontece antes do meio-dia. O gasto é seu e costuma ser de centavos por dia nos modelos Flash.

Claude (Anthropic)

Boa escrita e respostas mais naturais.

  1. 1

    Acesse e faça login

    console.anthropic.com/settings/keys
  2. 2

    Vá em Settings → API Keys

  3. 3

    Clique em “Create Key”, dê um nome e copie

  4. 4

    Adicione crédito em Billing

    A Anthropic exige crédito pré-pago.

DeepSeek — o mais barato

Custo bem abaixo dos demais, com qualidade boa pra responder comentário.

  1. 1

    Acesse e faça login

    platform.deepseek.com/api_keys
  2. 2

    Abra “API keys”

  3. 3

    Clique em “Create new API key” e copie

  4. 4

    Adicione crédito em “Top up”

Não funciona com a aba Memória (subir documentos da empresa). As respostas aos comentários funcionam normalmente.

Groq — o mais rápido

Responde em uma fração do tempo dos outros. Tem cota gratuita.

  1. 1

    Acesse e faça login

    console.groq.com/keys
  2. 2

    Clique em “Create API Key”, dê um nome

  3. 3

    Copie a chave (começa com gsk_)

Não funciona com a aba Memória (subir documentos da empresa). As respostas aos comentários funcionam normalmente.

Mistral AI

Europeu. Funciona com a aba Memória.

  1. 1

    Acesse e faça login

    console.mistral.ai/api-keys
  2. 2

    Clique em “Create new key”

  3. 3

    Copie a chave

Grok (xAI)

A IA do X (antigo Twitter).

  1. 1

    Acesse e faça login

    console.x.ai
  2. 2

    Abra “API Keys” e clique em “Create API Key”

  3. 3

    Copie a chave (começa com xai-)

  4. 4

    Adicione crédito em Billing

Não funciona com a aba Memória (subir documentos da empresa). As respostas aos comentários funcionam normalmente.

OpenRouter — vários modelos, uma conta só

Uma chave dá acesso a centenas de modelos (ChatGPT, Claude, Gemini, DeepSeek…). Útil se você quer testar vários sem abrir conta em cada empresa.

  1. 1

    Acesse e faça login

    openrouter.ai/keys
  2. 2

    Clique em “Create Key”, dê um nome

  3. 3

    Copie a chave (começa com sk-or-)

  4. 4

    Adicione crédito em “Credits”

Não funciona com a aba Memória (subir documentos da empresa). As respostas aos comentários funcionam normalmente.

Outro provedor (IA personalizada)

Qualquer serviço compatível com a API da OpenAI.

  1. 1

    Pegue a API Key no painel do seu provedor

  2. 2

    Anote também a URL da API (Base URL)

    Ex.: https://api.seu-provedor.com/v1
  3. 3

    Confira que a URL é pública e HTTPS

    Servidor na sua máquina (localhost) ou na rede interna NÃO funciona — o TOTE roda na nuvem e não enxerga o seu computador.

Não funciona com a aba Memória (subir documentos da empresa). As respostas aos comentários funcionam normalmente.

A API Key é sua e dá acesso à sua conta do provedor. Trate como senha: não mande por WhatsApp nem cole em site nenhum além do TOTE. Aqui ela é guardada cifrada e nunca aparece de volta inteira na tela — só um trecho (os primeiros e os últimos caracteres), o bastante pra você reconhecer qual é.

Passo 2 — Conectar no TOTE

  1. 1

    Abra Configurações → Integrações

    Na seção “Modelo de IA”. Se já houver uma conectada, clique em “Trocar IA”.
  2. 2

    Clique no card do provedor que você escolheu

  3. 3

    Cole a API Key

  4. 4

    Escolha o modelo

    Já vem um sugerido. Se quiser ver os modelos que a SUA conta libera, clique em “Buscar meus modelos”.
  5. 5

    Clique em "Conectar e testar"

    O TOTE faz um teste real antes de salvar — se a chave ou o crédito estiverem errados, ele avisa na hora em vez de falhar depois.
Deu certo? A seção passa a mostrar “Modelo de IA ✓ Conectado”. A partir daí o TOTE já classifica e responde os comentários.

Deu erro? Comece por aqui

  1. 1

    “Não conectou. Verifique a chave/créditos.”

    Quase sempre é falta de crédito no provedor, não a chave. Confira o saldo no painel dele.
  2. 2

    Copiou a chave inteira?

    Um espaço no começo ou no fim já invalida. Copie de novo e cole sem editar.
  3. 3

    O modelo escolhido não existe mais

    Os provedores aposentam modelos. Clique em “Buscar meus modelos” pra ver a lista atual da sua conta.
  4. 4

    Chave nova ainda não funciona

    Alguns provedores levam alguns minutos pra ativar uma chave recém-criada.

Perguntas frequentes

Quanto custa a IA?
O TOTE não cobra pela IA. O consumo é cobrado direto pelo provedor, conforme o uso da sua conta. Pra dar uma referência: cada comentário respondido gasta cerca de 2 mil tokens — nos modelos mais baratos isso fica em alguns centavos a cada dezenas de comentários. Em Configurações → Conta você acompanha o consumo e o custo estimado do mês.
Preciso ter conta em todos esses provedores?
Não. Escolha só um. A lista existe pra você usar o que já tem ou o que achar mais em conta.
Por que preciso usar minha própria conta de IA?
Isso te dá controle sobre custo, modelo e limites, e mantém suas chaves e uso sob a sua conta — o TOTE apenas usa a chave para gerar as respostas.
Posso trocar de provedor ou modelo depois?
Sim. Em Configurações, use “Trocar IA” para escolher outro provedor ou modelo a qualquer momento. O histórico de comentários e respostas continua intacto.
O que é aquele aviso de “não gera embeddings”?
Alguns provedores só sabem conversar, não sabem “indexar” documentos. Com eles, a aba Memória (onde você sobe informações da sua empresa pra IA consultar) fica indisponível — as respostas aos comentários seguem normais. Se você quer usar a Memória, escolha OpenAI, Google (Gemini) ou Mistral.
Posso usar uma IA instalada no meu computador?
Não. O TOTE roda na nuvem e não alcança servidores na sua máquina ou na sua rede interna. A IA precisa estar acessível pela internet, com endereço HTTPS.
O TOTE pode ver ou usar minha chave pra outra coisa?
Não. A chave é guardada cifrada e usada só para gerar as respostas do seu painel. Ela nunca é exibida de volta inteira — você vê apenas um trecho (os primeiros e os últimos caracteres), o bastante pra reconhecer qual chave está ali.
Ficou com dúvida? Fale com a gente em contato@toteresponde.com.br.