نحوه ست کردن ایموجی کاستوم برای ربات تلگرام

اگر می‌خواهید در پیام‌های ربات تلگرام از Custom Emoji یا کاستوم ایموجی استفاده کنید، ابتدا باید شرایط استفاده از این قابلیت را داشته باشید. مهم‌ترین شرط، داشتن Telegram Premium برای مالک ربات است. بعد از فعال کردن اشتراک پرمیوم، می‌توانید ایموجی‌های اختصاصی تلگرام را داخل متن پیام، Caption و حتی دکمه‌های ربات نمایش دهید.

در این مقاله یاد می‌گیرید Custom Emoji چیست، چگونه از آن در Bot API استفاده کنید، شناسه (Emoji ID) را پیدا کنید و مشکلات رایج نمایش داده نشدن ایموجی‌ها را برطرف کنید.

چنانچه اشتراک تلگرام پرمیوم ندارید، میتوانید اقدام به خرید اکانت پرمیوم از آسان استارز کنید.

آیا برای استفاده از ایموجی کاستوم در ربات تلگرام به پرمیوم نیاز داریم؟

بله. اگر قصد دارید از Custom Emoji در ربات تلگرام استفاده کنید، باید مالک ربات اشتراک Telegram Premium داشته باشد. این موضوع در نسخه‌های جدید Telegram Bot API اعمال شده و بدون داشتن پرمیوم، امکان استفاده از بسیاری از ایموجی‌های اختصاصی وجود ندارد.

در گذشته برخی توسعه‌دهندگان از سرویس Fragment برای فعال کردن این قابلیت استفاده می‌کردند. این روش همچنان وجود دارد اما هزینه بیشتری دارد و برای اکثر پروژه‌ها انتخاب مناسبی نیست.

اگر هدف شما فقط استفاده از ایموجی‌های Premium در ربات است، فعال کردن تلگرام پرمیوم ساده‌ترین و ارزان‌ترین راهکار محسوب می‌شود.

Custom Emoji در ربات تلگرام چیست؟

Custom Emoji همان ایموجی‌های اختصاصی تلگرام هستند که کاربران Premium به آن‌ها دسترسی دارند. این ایموجی‌ها برخلاف ایموجی‌های معمولی، انیمیشنی هستند و ظاهر متفاوتی دارند.

ربات تلگرام می‌تواند این ایموجی‌ها را در بخش‌های مختلف نمایش دهد؛ از جمله:

• متن پیام

• Caption تصاویر و ویدئوها

• پیام‌های ارسالی ربات

• دکمه‌های Inline Keyboard

به همین دلیل بسیاری از ربات‌های حرفه‌ای از Custom Emoji برای جذاب‌تر کردن رابط کاربری استفاده می‌کنند.

تصویر یک نمونه کاستوم ایموجی که در ربات رسمی آسان استارز ست شده است:

نحوه استفاده از Custom Emoji داخل متن ربات

برای نمایش ایموجی اختصاصی در متن پیام، باید شناسه یا Emoji ID آن را در پیام ارسال کنید.

اگر از HTML Parse Mode استفاده می‌کنید، ساختار به شکل زیر است.

<tg-emoji emoji-id="5368324170671202286">👍</tg-emoji>

نمونه پیام:

ربات آماده است.

اگر Parse Mode شما MarkdownV2 باشد، می‌توانید از ساختار زیر استفاده کنید.

![👍](tg://emoji?id=5368324170671202286)

هر دو روش توسط Telegram Bot API پشتیبانی می‌شوند و تنها کافی است مقدار صحیح Emoji ID را وارد کنید.

استفاده از Custom Emoji روی دکمه‌های Inline Keyboard

Custom Emoji فقط محدود به متن پیام نیست. اگر شرایط Bot API برقرار باشد، می‌توانید آن را روی دکمه‌های Inline Keyboard نیز نمایش دهید.

نمونه کد:

reply_markup: {
  inline_keyboard: [
    [
      {
        text: "⭐ خرید اشتراک",
        callback_data: "buy"
      }
    ]
  ]
}

اگر ایموجی موجود در متن دکمه از نوع Custom Emoji باشد، تلگرام آن را مانند متن پیام رندر می‌کند. این قابلیت باعث می‌شود دکمه‌های ربات حرفه‌ای‌تر و جذاب‌تر دیده شوند.

چطور شناسه (Emoji ID) یک Custom Emoji را پیدا کنیم؟

برای استفاده از هر Custom Emoji باید شناسه آن را داشته باشید. بدون Emoji ID امکان نمایش ایموجی وجود ندارد.

برای پیدا کردن شناسه مراحل زیر را انجام دهید.

1. یک پیام شامل Custom Emoji ارسال کنید.

2. Entityهای پیام را از طریق Bot API دریافت کنید.

3. مقدار custom_emoji_id را پیدا کنید.

4. همان مقدار را داخل emoji-id قرار دهید.

نمونه:

<tg-emoji emoji-id="5368324170671202286"></tg-emoji>

چرا ایموجی کاستوم من نمایش داده نمی‌شود؟

اگر ایموجی اختصاصی در ربات نمایش داده نمی‌شود، معمولاً یکی از دلایل زیر باعث بروز مشکل شده است.

مالک ربات Telegram Premium ندارد

رایج‌ترین دلیل همین مورد است. بدون اشتراک Premium بسیاری از Custom Emojiها قابل استفاده نیستند.

شناسه Emoji اشتباه است

اگر مقدار custom_emoji_id اشتباه باشد، تلگرام نمی‌تواند ایموجی را رندر کند.

از نسخه قدیمی Bot API استفاده می‌کنید

نسخه‌های قدیمی Telegram Bot API از Custom Emoji پشتیبانی نمی‌کنند. همیشه از آخرین نسخه استفاده کنید.

Parse Mode اشتباه است

اگر HTML یا MarkdownV2 به درستی تنظیم نشده باشد، تلگرام ایموجی اختصاصی را به متن معمولی تبدیل می‌کند.

Entity پیام ارسال نشده است

در صورتی که Entity مربوط به Custom Emoji در درخواست Bot API وجود نداشته باشد، ایموجی نمایش داده نمی‌شود.

تلگرام پرمیوم را از کجا تهیه کنیم؟

اگر قصد دارید از Custom Emoji در ربات تلگرام استفاده کنید، ابتدا باید اشتراک Telegram Premium را فعال کنید.

در آسان استارز می‌توانید تلگرام پرمیوم را بدون نیاز به ورود به حساب کاربری و تنها با وارد کردن یوزرنیم تلگرام تهیه کنید. اشتراک در مدت کوتاهی فعال می‌شود و پس از آن می‌توانید از قابلیت‌هایی مانند Custom Emoji، استیکرهای اختصاصی و سایر امکانات Premium در ربات خود استفاده کنید.

آیا بدون تلگرام پرمیوم می‌توان از Custom Emoji استفاده کرد؟

در بیشتر موارد خیر. ساده‌ترین و رسمی‌ترین روش، داشتن Telegram Premium برای مالک ربات است.

آیا ربات تلگرام می‌تواند ایموجی Premium ارسال کند؟

بله. اگر Bot API از این قابلیت پشتیبانی کند و شناسه صحیح Custom Emoji ارسال شود، ربات می‌تواند ایموجی اختصاصی را نمایش دهد.

آیا Custom Emoji روی دکمه‌های Inline Keyboard هم کار می‌کند؟

بله. این ایموجی‌ها علاوه بر متن پیام، روی دکمه‌های Inline Keyboard نیز قابل استفاده هستند.

چگونه Emoji ID را پیدا کنیم؟

کافی است Entity پیام را بررسی کرده و مقدار custom_emoji_id را استخراج کنید.

تفاوت Emoji معمولی و Custom Emoji چیست؟

Emoji معمولی بخشی از استاندارد Unicode است. اما Custom Emoji توسط تلگرام ارائه می‌شود، انیمیشنی است و امکانات بیشتری نسبت به ایموجی‌های معمولی دارد.

آیا همه کاربران ایموجی کاستوم را می‌بینند؟

بله. اگر پیام به‌درستی از طریق Bot API ارسال شود، کاربران می‌توانند ایموجی اختصاصی را مشاهده کنند؛ حتی اگر خودشان اشتراک Premium نداشته باشند.