O que você vai precisar

Antes de começar, certifique-se de possuir:

• Uma conta na OpenAI;
• Créditos disponíveis para utilização da API;
• Uma chave de API válida;
• Acesso à sua plataforma de automação (N8N, Make, Zapier, etc.).

📘

A Digitalizei não fornece nem gerencia contas da OpenAI. A contratação e utilização dos serviços de IA são realizadas diretamente com a OpenAI.

Como criar uma conta na OpenAI

1. Acesse a plataforma

Acesse:

https://platform.openai.com

2. Crie sua conta

Clique em Sign Up ou Registrar-se.

Você pode utilizar:

• E-mail e senha;
• Conta Google;
• Conta Microsoft;
• Conta Apple.

3. Verifique sua conta

Após o cadastro, a OpenAI poderá solicitar:

• Verificação de e-mail;
• Confirmação de telefone;
• Informações adicionais de validação.

4. Adicione créditos

Para utilizar a API será necessário adicionar créditos ou cadastrar uma forma de pagamento.

Acesse:

Billing → Add payment method

⚠️

Os assistentes utilizam recursos pagos da OpenAI. O consumo será cobrado diretamente pela OpenAI de acordo com a utilização.

Criando um Projeto

Após acessar sua conta:

1. Clique em Projects;
2. Clique em Create Project;
3. Informe um nome para o projeto.

Exemplo:

Atendimento Digitalizei

📘

Recomendação: mantenha projetos separados para Produção, Homologação e Desenvolvimento.

Criando um Assistente

Após criar o projeto:

1. Acesse Assistants;
2. Clique em Create Assistant.

Nome do Assistente

Utilize nomes claros e objetivos.

Exemplos:

Atendimento Comercial
Suporte Técnico
Financeiro
Pré-vendas

Instruções (Prompt)

No campo Instructions, defina como o assistente deverá se comportar.

Exemplo:

Você é um assistente comercial da empresa Digitalizei.

Seu objetivo é entender as necessidades do cliente, responder dúvidas sobre os produtos e encaminhar oportunidades para o time comercial quando necessário.

Sempre responda de forma objetiva, educada e profissional.

Caso não possua a informação solicitada, informe claramente ao usuário.

Escolha do Modelo

Atualmente recomendamos:

📘

Para a maioria dos atendimentos comerciais e de suporte, o GPT-4.1 Mini oferece excelente desempenho com baixo custo operacional.

Temperatura

A temperatura controla o nível de criatividade das respostas.

Recomendação

0.2 a 0.4

Para atendimento, suporte e vendas.

Recursos Opcionais

File Search

Permite que o assistente consulte documentos enviados para responder perguntas.

Exemplos:

• PDFs;
• FAQs;
• Catálogos;
• Procedimentos internos;
• Bases de conhecimento.

Code Interpreter

Permite que o assistente:

• Faça cálculos;
• Analise planilhas;
• Gere gráficos;
• Execute operações matemáticas.

📘

Para assistentes de atendimento normalmente apenas o File Search já é suficiente.

Formato de Resposta

Configure:

Text

Este formato é o mais compatível com integrações via API e plataformas de automação.

Como criar uma chave de API

Após criar o projeto:

1. Acesse API Keys;
2. Clique em Create API Key;
3. Defina um nome para a chave.

Exemplo:

Digitalizei Produção

Copie a chave imediatamente

Após criada, a chave será exibida apenas uma vez.

Exemplo:

sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx

⚠️

Guarde a chave em local seguro. Após fechar a janela, ela não poderá ser visualizada novamente.

Boas práticas de segurança

Nunca exponha sua chave

Não publique sua chave:

• No frontend;
• Em aplicativos móveis;
• Em sites;
• Em repositórios GitHub;
• Em documentação pública.

Utilize apenas Backend

Fluxo recomendado:

Usuário
   ↓
Seu Sistema
   ↓
OpenAI

Nunca:

Usuário
   ↓
OpenAI

Utilize ambientes separados

Sempre que possível mantenha:

Produção
Homologação
Desenvolvimento

com chaves independentes.