# إطار عمل تلغراف لواجهة برمجة بوتات التيليجرام

**URL:** <https://discourse.aosus.org/t/topic/2522>\
**Category:** البرمجة\
**Created:** [3 أغسطس 2022، 11:58م UTC](https://discourse.aosus.org/t/topic/2522 "2022-08-03T23:58:13Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Rnx](https://discourse.aosus.org/user_avatar/discourse.aosus.org/rnx/32/5161_2.png) [@Rnx](https://discourse.aosus.org/u/Rnx)\
**Post date:** [3 أغسطس 2022، 11:58م UTC](https://discourse.aosus.org/t/topic/2522/1 "2022-08-03T23:58:13Z")

</div>

![telegrafjs](https://cdn-cf-discourse.aosus.org/original/2X/6/6cf7edbe555bcd4158e7d2eb2a638ea03d51ccbc.jpeg)

# 

# تلغراف | Telegraf

# 

### هو إطار عمل لـ ( **Node.js** ) لواجهة برمجة التطبيقات [**Telegram Bot**](https://core.telegram.org/bots), تسهل عليك تطوير الروبوتات الخاصة بك باستخدام **JavaScript** أو **TypeScript**.

# 

.

# 

#### لاستخدام Telegram Bot API ، عليك أولاً انشاء حساب بوت من خلال الدردشة مع [BotFather](https://t.me/botfather)

سوف يعطيك **BotFather** _رمز **token** _ ، شيء مثل هذا \> `5492211333:AAHJDrQXH9_WkzzvZGiial7u1yaMBG6YLNA`

# 

 ![photo_2022-08-04_01-46-43](https://cdn-cf-discourse.aosus.org/original/2X/3/3a34698d2c4daf5113fafad14f9f42deacceec0e.jpeg)

# 

# تثبيت Telegraf

# 

لاستخدام تلغراف في مشروعك , قم بتشغيل الامر التالي

- عبر مدير الحزم ( **npm** )

```auto
npm install telegraf

```

- عبر مدير الحزم ( **yarn** )

```auto
yarn add telegraf

```

- عبر مدير الحزم ( **pnpm** )

```auto
pnpm add telegraf

```

# 

# مثال بسيط لإستخدام تلغراف

# 

```auto
import { Telegraf } from 'telegraf'

const token = '5492211333:AAHJDrQXH9_WkzzvZGiial7u1yaMBG6YLNA'
const bot = new Telegraf(token)
bot.start((ctx) => ctx.reply('مرحبا بك'))
bot.help((ctx) => ctx.reply('ماذا تريد ان أفعل ؟'))
bot.on('sticker', (ctx) => ctx.reply('ملصق جميل'))
bot.hears('سلام', (ctx) => ctx.reply('وعليكم السلام ورحمة الله وبركاته'))
bot.command('aosus', (ctx) => ctx.reply('https://discourse.aosus.org'))
bot.launch()

```

# 

### شرح الكود

# 

إستدعاء الـ **Module**

```auto
import { Telegraf } from 'telegraf'

```

# 

نضع التوكن الي خذناه من **BotFather**

```auto
const token = '5492211333:AAHJDrQXH9_WkzzvZGiial7u1yaMBG6YLNA'
const bot = new Telegraf(token)

```

# 

## يقوم برد عند بدء تشغيل البوت بـ **\start**

```auto
bot.start((ctx) => ctx.reply('مرحبا بك'))

```

# 

![Telegram_i8yxMhw2Yv](https://cdn-cf-discourse.aosus.org/original/2X/4/459d971bc74fac80a63124e0023b8ee97b79b3e7.gif)

# 

## يقوم بالرد عند تلقي رسالة **\help**

```auto
bot.help((ctx) => ctx.reply('ماذا تريد ان أفعل ؟'))

```

# 

![Telegram_fYOawlkkLY](https://cdn-cf-discourse.aosus.org/original/2X/5/50cd5a555fb9073e9003d84f0715f69ee014e0ee.gif)

# 

## يقوم بالرد عند الإستماع الى حدث معين مثل تلقي **ملصق**

يمكن تغير sticker للإستماع لإي حدث آخر ( Event ) والرد عليه  
مثل video او photo او text او message او channel\_post الخ ..

[مثال لجميع الـ parameters اضغط هنا](https://telegraf.js.org/classes/Telegraf.html#on)

```auto
bot.on('sticker', (ctx) => ctx.reply('ملصق جميل'))

```

# 

![Telegram_Dq5WKPQ4VR](https://cdn-cf-discourse.aosus.org/original/2X/f/f364eb871eb26aa8da90e370fd76a5b64590d918.gif)

# 

## يقوم بالرد عند تلقي الكلمة المحددة مثل ( سلام )

```auto
bot.hears('سلام', (ctx) => ctx.reply('وعليكم السلام ورحمة الله وبركاته'))

```

# 

![JPVRXVzFAn](https://cdn-cf-discourse.aosus.org/original/2X/a/a9a84b19a7e006edc822fff265f2442aac8a039f.gif)

# 

## يقوم بالرد عند تلقي الكلمة المحددة مع البادئة /

```auto
bot.command('aosus', (ctx) => ctx.reply('https://discourse.aosus.org'))

```

# 

![Telegram_D4BM6S0fxw](https://cdn-cf-discourse.aosus.org/original/2X/0/0e03e65f576e4cda56229a07bb5adbeb6712f32c.gif)

# 

## بدء تشغيل البوت

```auto
bot.launch()

```

## [للمزيد من الامثلة اضغط هنا](https://github.com/telegraf/telegraf/tree/develop/docs/examples)

## [الموقع الرسمي لـ Telegraf](https://telegraf.js.org)

## [رابط المستودع على github](https://github.com/telegraf/telegraf)

## [قروب تلغراف على تيليجرام](https://t.me/TelegrafJSChat)

---

<div class="post-metadata">

**Author:** ![FHD](https://discourse.aosus.org/letter_avatar_proxy/v4/letter/f/3bc359/32.png) [@FHD](https://discourse.aosus.org/u/FHD)\
**Post date:** [5 أغسطس 2022، 2:36م UTC](https://discourse.aosus.org/t/topic/2522/2 "2022-08-05T14:36:36Z")

</div>

بسيط جدا وسهل الاستخدام 👍 😍