Skip to content

Telegram templates

Reusable Telegram message templates with keyboards and media.

6 min read

Open Channel → Telegram → Templates.

What this page is for

Save message layouts — text, inline keyboards, and optional media — for Send → Send, campaigns, schedules, and autoreply.

Use variables for personalization. Approved templates can be used from Send → Send or the Send API.

Telegram Templates — list header, template table, and row actions

Sample data shown.

Header controlWhat it does
New TemplateOpen the template picker, then the editor
BackReturn to the list while creating or editing

Search and filter

Search is field-based — click the search area first, pick which column to search, then type your query.

Search in popup — choose Name or Message

StepWhat happens
1. Click searchA Search in popup opens — you must choose a field before typing
2. Pick a fieldName or Message
3. TypeKirisan filters the table as you type (short debounce)

After you pick a field, the search bar shows the field name on the left (for example Name ▼). Click it to switch fields — changing the field clears the query.

Name search — field pill, query, and review filter

Search fieldMatchesMinimum length
NameTemplate name that contains your query3 characters
MessageMessage body that contains your query3 characters

If you type fewer than three characters, Kirisan waits until the minimum is met and shows a short hint under the search bar.

On the same row as search (to the right):

  • ReviewAll reviews, Pending, Approved, or Rejected

Template list

Each row is one saved template:

Telegram Templates table — preview, review status, type, and actions

ColumnMeaning
NameIdentifier you choose (for example welcome-message)
PreviewFirst part of the message body
ReviewPending, Approved, or Rejected — click the badge to open Template review (see Review status). Inactive appears when the template is turned off and is not clickable
TypeCategory assigned after review, or while pending
UpdatedWhen the template was last saved
ActionsTurn on/off, edit, or delete — see Row actions

Pagination below the table appears when results span more than one page.

Row actions

Icon buttons sit at the end of each row:

ActionWhat it does
Active toggleTurns an Approved template on or off. Disabled until review passes — pending and rejected rows cannot be enabled.
EditOpens the editor for that template.
DeleteAsks you to confirm, then removes the template.

When a template is off, the toggle shows red (Inactive). An approved template that is on shows green.

Create a template

  1. Click New Template (or Create your first template when the list is empty).
  2. Pick a starter layout or Blank — see Choose a starting template.
  3. Enter a Template name and set Active if you want it enabled after approval.
  4. Write the message, add optional media or inline keyboard buttons, and check the live preview.
  5. Click Create Template. Kirisan reviews the content; the button shows Reviewing… while it runs.
  6. When approved, the template appears in the list and you can use it on Send → Send and elsewhere.

Choose a starting template

The picker shows ready-made layouts grouped by category:

Choose a template — category tabs and Telegram bubble previews

  • Category tabs — filter by Welcome, OTP, Order, Promo, and more, or stay on All
  • Cards — each shows a Telegram-style preview; click one to load it into the editor
  • Blank — empty message so you can write from scratch
  • Close () — return to the list without creating

Name and active status

At the top of the editor:

New template — name field and active toggle

FieldMeaning
Template nameShort id-style name (for example order-confirmed)
ActiveToggle on to enable the template after review passes; off saves it as inactive. Green toggle = Active; red toggle = Inactive. Pending and rejected templates cannot be turned on from the list.

On a new template, Kirisan runs review when you save. If a template was Rejected, open Template review from the list — edit the message and save again to resubmit.

Message editor

The editor has your content on the left and a Live Preview on the right.

Attachment

Choose None, Image, Video, or Document.

When a media type is selected, set:

FieldWhat to enter
File URLA public HTTPS link to the image, video, or document (for example https://cdn.example.com/photo.jpg). Paste a direct link and the live preview shows it at the top of the Telegram bubble.
File nameOptional display name shown to the recipient (for example invoice or photo.pdf). Leave empty and Kirisan detects the real extension from the URL at send time.

You can also use a {{variable}} in either field for per-recipient media. At send time, Kirisan substitutes values from Send → Send or the Send API. For {{variables}} in File URL, fill an example value under Variables so the preview can load the attachment.

With media attached, the Message field acts as the caption (Telegram caption length limits apply).

Template editor — attachment, file URL, caption, and live preview

Sample data shown.

Message

Type the Telegram body in the Message box. Use the toolbar for Telegram-style formatting:

ControlEffect
BWrap selection with ** for bold
IWrap with * for italic
SWrap with ~~ for strikethrough
CodeWrap with ` for inline code
UWrap with __ for underline

A character counter shows how much of the limit you have used (caption length applies when media is attached).

With None selected under Attachment, only the message and variables panels appear.

Template editor — text message, formatting toolbar, and variables

Sample data shown.

Response type

Choose Plain text or Inline keyboard:

  • Plain text — message only
  • Inline keyboard — add rows of buttons under the message (URL, copy text, or callback data for your bot)

Variables

Same placeholder styles as other channels — see Variables:

StyleExampleWhere it comes from
Per-send / per-recipient{{name}}, {{order_id}}Use Add variable / Insert, or type {{name}} in the Message field. For per-recipient media, you can also put {{placeholders}} in File URL or File name. Fill Example values for the live preview; check Save as default to store a template default.
Built-in server[[date-dd-mm-yyyy]], [[time-hh:mm]]Resolved at send time — Resources → Variables → Time
Account custom[[u-support_phone]]Resources → Variables → Custom

Review status

Click any Pending, Approved, or Rejected badge in the Review column to open Template review:

Template review popup — status, template name, reason, and next steps

Sample shows a rejected template.

The popup includes What this means, Reason (if rejected), What to do next, and Got it to close. Same flow as WhatsApp Templates.

Only Approved and Active templates are available in Send → Send, campaigns, and the Send API.

Delete a template

Click on a row:

Delete template confirmation

Confirm to remove the template.

Last updated: June 16, 2026
Was this page helpful?