For the complete documentation index, see llms.txt. This page is also available as Markdown.

AI Settings (Latest)

This section covers all configuration options available under AI Settings for your Telegram Chatbot —including prompt setup, communication style, metadata extraction, and advanced model configuration.

What is AI Settings?

AI Settings is where you define how your chatbot thinks, speaks, and operates. It gives you control over the instructions your bot follows, how it communicates with users, what data it extracts from conversations, and which AI model powers it.

AI Settings is divided into four tabs:

Tab
Purpose

Prompt

Define the bot's core instructions and conversation flow logic

Communication Style

Control tone, language, response length, and formatting

Meta Data

Configure which user attributes the bot extracts during conversations

Advance Setting

Set up your AI provider, model selection, and fallback behaviour


When Should You Use This?

Use this section when:

  • You are setting up your chatbot for the first time and need to define its behaviour

  • You want to update the bot's instructions, tone, or language

  • You need to connect your own AI API key or switch to a different model

  • You want to configure fallback behaviour when AI credits run out


How to Access AI Settings

  1. From the left sidebar, click on "Chatbot" and select the bot you want to configure.

  2. From the bot's left menu, click on "AI Settings".

You will see four tabs at the top: Prompt, Communication Style, Meta Data, and Advance Setting.


Tab 1 — Prompt

bullseye-arrow

Goal: The Prompt tab is where you define what your bot is supposed to do and how it should handle conversations. There are two fields to configure.

  1. Click on the "Prompt" tab.

  1. In the Core Instructions field, enter the main directive that defines the bot's purpose, role, and capabilities. This is the primary instruction the bot follows in every conversation. Use / to reference custom attributes or automation tools inline.

Example: "Act as a customer support assistant for an e-commerce store. Help users track orders, process returns, and answer product questions."

To learn the best way to make a prompt, please refer to: Setting Up Your AI Agent: Guidelines and Best Practices

  1. In the Conversation Flow Instructions field, define the step-by-step logic for how the bot should drive the conversation. Use this to set conditions, guide the flow, or trigger automations. Use / to reference attributes or conditions dynamically.

Example: "Start with a greeting. Ask what the user needs help with. If the query includes 'return', guide them through the returns process."

To learn the best way to make a prompt, please refer to: Conversation Flow Setup & Best Practices

  1. Click "Update" or "Update & Next" to save.


Tab 2 — Communication Style

bullseye-arrow

Goal: The Communication Style tab controls how your bot speaks — its tone, language, response length, and formatting.

  1. Click on the "Communication Style" tab.

  1. Configure each of the following options:

Field
Options

Answer Length

Very Short, Short, Medium, Long, Let Agent Decide

Answer As

First Person, Second Person, Third Person, Let Agent Decide

Tone

Formal, Informal, Joyful, Sincere, Let Agent Decide

Language

English, Hindi, Spanish, French, German, Let Agent Decide

Answer Formatting

Bullet List, Numbered List, Paragraph, Let Agent Decide

Include Sources for Response

Toggle ON to show the source of the bot's answers

Ice Breaker

Add ice breakers for your AI Agent component.

  1. Click "Update" or "Update & Next" to save.


Tab 3 — Meta Data

bullseye-arrow

Goal: The Meta Data tab lets you define which user attributes the bot should automatically extract and store during a conversation — such as names, dates, locations, or preferences.

  1. Click on the "Meta Data" tab.

  1. You will see a list of attributes. Each row shows:

    1. Attribute Name — the label identifying the data point

    2. Category — System or Custom

    3. Extract Meta Data — toggle to enable or disable extraction for that attribute

    4. Actions — delete button to remove the attribute from scope

  2. To create new attributes or modify existing ones, click "Manage Attribute". This opens the Custom Attributes. Refer to the Managing Custom Attributes guide for full configuration details.

Managing Custom Attribute

Tab 4 — Advance Setting

bullseye-arrow

Goal: The Advance Setting tab is where you configure which AI provider and model powers your bot, and what happens when your credits or token limit runs out.

There are two sections inside: LLM Provider and Advance.


LLM Provider

  1. Click on "Advance Setting", then expand the "LLM Provider" section.

  1. Choose how you want to power your bot's AI:

    1. Add LLM Credentials — Connect your own API key from OpenAI or OpenRouter.

    2. Purchase Add-ons — Uses BotPenguin's built-in AI credits. No API key required.

  2. If you select "Integrate Your Own Key", choose your provider:

    1. OpenAI — Paste your OpenAI API key directly. See the OpenAI Integration guide for steps to generate your key.

    2. OpenRouter — Select your saved OpenRouter configuration from the dropdown, then choose the specific model you want to use. See the OpenRouter Integration guide for setup steps.

    3. Select the Credential configured in the "LLM Provider Credential" dropdown, and the LLM Model to use.

  1. Click "Update" to save your LLM provider settings.


Advance

  1. Expand the "Advance" section to configure fallback and response behaviour.

  1. Configure the following fields:

Field
Description

Switch model after exceeding token count

Toggle ON to automatically switch to a fallback model once the max token count is reached

Model after switching

The fallback model the bot uses once the primary model's token limit is exceeded

Search Mode

Controls how the bot searches its knowledge base. Fast Search prioritises speed.

Max Token Count

Maximum tokens the AI can use per response. Default is 4096.

Temperature

Controls response creativity. 0 = precise and consistent. 1 = varied and creative. Default is 0.5.

Available models for fallback:

  • gpt-5.4

  • gpt-5.1

  • gpt-5.1-chat-latest

  • gpt-5.2

  • gpt-5.2-chat-latest

  • gpt-4.1

  • gpt-4.1-mini

  1. Click "Update" to save.


Best Practices

💡 Write Core Instructions in plain language — clear, role-specific prompts produce better and more consistent bot responses.

⚠️ Always configure a fallback model under Advance Setting so your bot continues working if primary credits run out.

🎯 Set Temperature to 0.3–0.5 for support or FAQ bots. Use higher values only for creative or open-ended conversation bots.

🔄 After making any changes to AI Settings, test your bot using the Bot Preview panel on the right before publishing.


Troubleshooting

Bot is not following the instructions set in the Prompt tab

Ensure you clicked Update after saving.

Check that the instructions are clear and do not contradict each other across Core Instructions and Conversation Flow Instructions.

Bot stops responding after some time

Your AI credits or token limit may be exhausted.

Check your API account balance and ensure a fallback model is configured under the Advance section.

OpenRouter configuration is not appearing in the LLM Provider dropdown

Ensure you have successfully connected OpenRouter and saved at least one configuration under More → Integrations → OpenRouter.

Responses feel too random or off-topic

Lower the Temperature value (try 0.3 or below) and click Update.

Meta Data attributes are not being extracted during conversations

Confirm the Extract Meta Data toggle is enabled for the relevant attributes in the Meta Data tab.

Communication style settings are not reflected in bot responses

Click Update after making changes.

If the issue persists, try refreshing the page and reapplying your settings.


FAQs

Can I use my own API key instead of platform credits?

Yes. Under the Advance Setting tab, select Integrate Your Own Key under LLM Provider and connect either an OpenAI or OpenRouter key.

What happens if my API credits run out?

If no fallback model is configured, the bot will stop generating AI responses.

Configure a fallback model under the Advance section to prevent this.

Can I set the bot to respond in a language other than English?

Yes. Under the Communication Style tab, use the Language dropdown to select your preferred language or set it to Let Agent Decide for automatic detection.

What is the difference between Core Instructions and Conversation Flow Instructions?

Core Instructions define the bot's overall role and purpose.

Conversation Flow Instructions define the step-by-step logic for how the bot drives individual conversations — conditions, routing, and interaction sequences.

What does Temperature control?

Temperature controls how varied the bot's responses are.

A low value (0.1–0.3) produces focused, predictable answers. A high value (0.7–1.0) produces more creative, varied responses.

For most business bots, 0.3–0.5 is recommended.

What is Max Token Count?

Tokens are units of text the AI processes.

Max Token Count limits how long each AI response can be.

The default of 4096 covers most use cases. Lower it to reduce API costs; raise it if responses are being cut off mid-sentence.

Can I create custom attributes for Meta Data extraction?

Yes. Click Manage Attribute inside the Meta Data tab.

This takes you to the Custom Attributes section where you can create, edit, and configure attributes.

Refer to the Managing Custom Attributes guide for details.

Can I switch AI models without disconnecting my API key?

Yes. Update the model selection under LLM Provider or the fallback model under Advance at any time and click Update — no need to reconnect your key.


ChatGPTOpenRouterManaging Custom AttributeBest Practices for Training Your AI

Support

If you still have questions for our team, write to us at support@botpenguin.com. We'll get back to you within 48 hours.


🎉 You have successfully configured AI Settings for your Telegram Chatbot. Your bot is now ready to engage users with the right intelligence, tone, and behaviour.

Last updated

Was this helpful?