O tutorial oficial de 9 de agosto de 2023 liga uma mensagem do Telegram a uma geração de texto pela OpenAI e devolve a resposta ao mesmo chat. É um exemplo de integração, não uma garantia de precisão ou de que instruções em linguagem natural bloqueiem todos os assuntos indesejados.
Condições para preparar o exemplo
Os pré-requisitos de 2023 incluíam uma exigência de plano do Make. Consulte a referência vigente em vez de adotar aquela conclusão; verifique separadamente os termos da API do fornecedor de IA.
Para preços, planos, cotas e limites do Make, prevalecem as informações da página oficial de preços do Make.
1. Crie a conexão do bot
A documentação atual do Telegram Bot no Make orienta criar o bot pelo BotFather, usando /newbot, e utilizar o token na conexão do Make.
Esse token é uma credencial: não o coloque na mensagem do bot, no prompt ou em capturas compartilhadas. O bot é diferente da sua conta pessoal do Telegram.
No cenário, o exemplo usa Telegram Bot > Watch Updates como entrada. Crie a conexão e o webhook conforme a configuração disponível e envie uma mensagem de teste para observar a estrutura recebida.
2. Diferencie mensagem e publicação em canal
Para uma conversa com o bot, o texto costuma estar no objeto Message. Para uma publicação em canal, o exemplo usa Channel post. Confira o evento real antes de mapear.
Mensagens podem não ter texto, como fotos ou stickers. Defina se serão ignoradas ou receberão uma resposta apropriada; não envie um campo vazio ao modelo por acidente.
3. Gere uma resposta
O artigo usava OpenAI > Create a Completion, na modalidade de chat. Consulte a documentação atual da integração OpenAI para a conexão e as operações disponíveis. Use a chave da API correspondente; o texto não pressupõe que uma assinatura da interface ChatGPT forneça automaticamente acesso à API.
Separe instruções fixas da mensagem do usuário. Por exemplo, para um bot de dúvidas sobre jardinagem:
Responda no idioma da pergunta. Ajude com dúvidas sobre jardinagem. Se faltar contexto, peça esclarecimentos. Se a pergunta for de outro assunto, explique o escopo do atendimento. Não apresente suposições como fatos.
Mapeie o texto recebido como mensagem do usuário. A instrução orienta a resposta, mas não é uma barreira de segurança infalível. Não dê ao bot acesso a ações ou dados sensíveis apenas por acreditar que o prompt o impedirá de usá-los.
4. Envie ao chat de origem
No exemplo, Telegram Bot > Send a Text Message or a Reply recebe:
- Chat ID: o identificador do chat do evento original, seja mensagem direta ou publicação em canal.
- Text: o conteúdo retornado pela operação de IA escolhida.
O caminho de saída da OpenAI depende da operação usada. Não copie automaticamente Choices > Message > Content se a operação atual retornar outra estrutura.
Teste o comportamento, não só a execução
Verifique uma pergunta dentro do assunto, outra fora dele, uma mensagem sem texto e falha da API. Confirme que a resposta chega ao chat correto e que não repete mensagens indefinidamente.
O fluxo original envia o texto recebido, mas não inclui por si só armazenamento de histórico de conversa. Não prometa memória entre mensagens sem implementar e testar esse recurso separadamente.
Nota editorial: as recomendações de revisão e teste são acréscimos desta adaptação; não relatam uma execução real dos cenários.