Os bots do Telegram são amplamente utilizados para automação de tarefas, suporte ao cliente, geração de conteúdo e desenvolvimento de assistentes de IA. Ao conectar a API GPT da Serverspace, você poderá adicionar recursos de inteligência artificial ao seu bot e receber respostas de modelos de linguagem modernos diretamente no Telegram.
A API GPT da Serverspace utiliza um formato de requisições compatível com OpenAI, permitindo que a integração seja concluída em apenas alguns minutos e implementada em praticamente qualquer linguagem de programação.
Requisitos Antes de Começar
Antes de configurar a integração, certifique-se de que você possui:
- Uma conta Serverspace;
- O serviço GPT API ativado;
- Uma chave de API para acessar o serviço;
- Um bot do Telegram criado através do BotFather;
- Um servidor ou ambiente local com Python instalado;
- Conhecimentos básicos de Python.
O seguinte endpoint da API será utilizado:
Etapa 1. Criar um Bot do Telegram
Abra o Telegram e procure pelo bot BotFather:
Você pode criar um bot por meio do miniaplicativo ou diretamente pelo chat.
Usando o Miniaplicativo:
Digite o nome do bot, a descrição (opcional) e escolha um nome de usuário para ele:
Após inserir essas informações, seu primeiro bot será criado. No menu, você encontrará o token da API e diversas configurações adicionais:
Ao finalizar, você receberá um token de acesso semelhante a:
123456789:AAExampleTokenXXXXXXXXXXXXXXXXGuarde esse token — ele será necessário para conectar-se à API do Telegram.
Etapa 2. Obter uma Chave da API GPT da Serverspace
No painel de controle da Serverspace, acesse a seção GPT API.
Abra a guia de gerenciamento de chaves de API e copie a chave de acesso gerada.
Essa chave será utilizada para autenticar as requisições à GPT API.
Etapa 3. Instalar as Bibliotecas Necessárias
Instale as dependências:
pip install python-telegram-bot requestsApós a instalação, você poderá começar a escrever o código do bot.
Etapa 4. Criar a Aplicação do Bot do Telegram
Crie um arquivo:
bot.pyAdicione o seguinte código:
import requests
from telegram import Update
from telegram.ext import Application, MessageHandler, ContextTypes, filters
TELEGRAM_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
GPT_API_KEY = "YOUR_SERVERSPACE_API_KEY"
API_URL = "https://gpt.serverspace.com.br/v1/chat/completions"
async def handle_message(update: Update, context: ContextTypes.DEFAULT_TYPE):
user_message = update.message.text
```
headers = {
"Authorization": f"Bearer {GPT_API_KEY}",
"Content-Type": "application/json"
}
payload = {
"model": "gpt-5.2",
"messages": [
{
"role": "user",
"content": user_message
}
],
"temperature": 0.7,
"max_tokens": 500
}
response = requests.post(
API_URL,
headers=headers,
json=payload
)
result = response.json()
answer = result["choices"][0]["message"]["content"]
await update.message.reply_text(answer)
```
def main():
app = Application.builder().token(TELEGRAM_TOKEN).build()
```
app.add_handler(
MessageHandler(filters.TEXT & ~filters.COMMAND, handle_message)
)
app.run_polling()
```
if **name** == "**main**":
main()
Este script recebe mensagens dos usuários do Telegram, envia-as para a GPT API e retorna a resposta gerada de volta ao chat.
Etapa 5. Configurar suas Credenciais
Substitua os seguintes valores:
TELEGRAM_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
GPT_API_KEY = "YOUR_SERVERSPACE_API_KEY"pelo token do seu bot do Telegram e pela chave da API da Serverspace.
Etapa 6. Executar o Bot
Execute o seguinte comando:
python bot.pyApós a inicialização, o bot começará a receber mensagens e encaminhá-las para a GPT API.
Experimente enviar qualquer mensagem ao seu bot no Telegram — ele processará a solicitação usando o modelo de IA e retornará uma resposta.
Exemplo de uma Requisição Direta para a GPT API
Para entender melhor como a API funciona, veja o exemplo abaixo usando cURL:
curl https://gpt.serverspace.com.br/v1/chat/completions
-H "Content-Type: application/json"
-H "Authorization: Bearer YOUR_API_KEY"
-d '{
"model": "gpt-5.2",
"messages": [
{
"role": "user",
"content": "Olá! Fale sobre tecnologias em nuvem."
}
],
"temperature": 0.7,
"max_tokens": 500
}'A API retornará uma resposta JSON contendo o texto gerado.
Como Preservar o Histórico da Conversa
Por padrão, a GPT API não armazena o histórico das conversas entre as requisições.
Se você precisar preservar o contexto, envie as mensagens anteriores junto com cada nova solicitação:
[
{
"role": "user",
"content": "Olá"
},
{
"role": "assistant",
"content": "Olá! Como posso ajudar?"
},
{
"role": "user",
"content": "Fale sobre servidores virtuais"
}
]Dessa forma, o modelo poderá visualizar as mensagens anteriores e manter uma conversa coerente.
Recomendações de Segurança
Ao utilizar a GPT API em projetos de produção, recomenda-se:
- Nunca armazenar chaves de API em locais públicos;
- Utilizar variáveis de ambiente em vez de inserir as chaves diretamente no código-fonte;
- Restringir o acesso ao servidor;
- Monitorar regularmente o consumo de tokens;
- Renovar periodicamente as chaves de API.
FAQ
Posso utilizar bibliotecas da OpenAI?
Sim. A API GPT da Serverspace utiliza um formato de requisições compatível com OpenAI, portanto a maioria das integrações existentes pode ser adaptada com alterações mínimas.
Qual endpoint devo utilizar?
Utilize o seguinte endpoint para enviar requisições:
https://gpt.serverspace.com.br/v1/chat/completionsComo funciona a autenticação?
A autenticação é realizada utilizando um Bearer Token:
Authorization: Bearer YOUR_API_KEYPosso utilizar diferentes modelos?
Sim. O painel de controle da Serverspace oferece acesso a diversos modelos de inteligência artificial de diferentes provedores.
A API armazena automaticamente o histórico da conversa?
Não. A GPT API é um serviço stateless e não armazena o histórico de conversas. Caso o contexto da conversa seja necessário, sua aplicação deverá enviar as mensagens anteriores em cada requisição.
Posso hospedar o bot em um VPS?
Sim. Um bot do Telegram pode ser executado em um servidor em nuvem da Serverspace, em uma máquina local, em um VPS, em um contêiner Docker ou em qualquer outro ambiente com suporte a Python.
Para quais tipos de projetos essa integração é adequada?
Com a GPT API, você pode criar:
- Chatbots com IA;
- Consultores virtuais;
- Sistemas de suporte ao cliente;
- Geradores de conteúdo;
- Ferramentas de tradução;
- Serviços educacionais;
- Ferramentas internas de automação corporativa.
Conclusão
A integração da API GPT da Serverspace com um bot do Telegram permite criar rapidamente um assistente inteligente para interagir com usuários. Graças à API REST simples, à autenticação por chave de API e ao formato de requisições compatível com OpenAI, o processo de integração leva apenas alguns minutos e é adequado tanto para projetos de teste quanto para ambientes de produção.
