ربط ووردبريس بتيليجرام: انشر مقالاتك في قناتك تلقائياً من التوثيق الرسمي

ربط ووردبريس بتيليجرام يحتاج ثلاثة أشياء فقط: بوتاً تنشئه مجاناً من BotFather، وإضافته مشرفاً في قناتك بصلاحية النشر، ثم أداة في موقعك تطلب من البوت إرسال كل مقال جديد عبر دالتي sendMessage أو sendPhoto، وهذا طريق رسمي يتيحه تيليجرام للمطورين لا التفاف فيه.

لكن الربط وحده لا يصنع منشوراً يُفتح، ففي هذا المقال ستعرف الحدّين اللذين يقرران شكل رسالتك من توثيق تيليجرام نفسه، والطرق الأربع للربط مع ما يناسب كل موقع، ولماذا يتحول رابط مقالك العربي إلى سطر طويل من الرموز وكيف تتجنبه، وفي المنتصف أداة ترى فيها منشورك داخل فقاعة قناة بأزراره وعدّاد حروفه قبل أن يراه متابعوك.

كيف يعمل ربط ووردبريس بتيليجرام من الداخل؟

فهم الآلية يوفر عليك نصف الأعطال، فكل إضافة أو خدمة تعدك بالنشر التلقائي تفعل في الحقيقة الشيء نفسه: ترسل طلباً إلى خوادم تيليجرام باسم بوتك، وتوثيق Bot API يشترط أن تمر كل الطلبات عبر HTTPS بصيغة https://api.telegram.org/bot<token>/METHOD_NAME، حيث الرمز (token) هو مفتاح بوتك ومكانه بعد كلمة bot مباشرة.

وفي طلب النشر تحدد القناة في الحقل chat_id، ويقبل التوثيق فيه اسم القناة بصيغة @channelusername أو معرّفها الرقمي، ثم تضع النص أو الصورة، فيظهر المنشور في القناة باسم القناة لا باسم البوت.

• البوت: حساب آلي تنشئه بأمر /newbot في BotFather، ويعطيك رمزاً سرياً يتحكم به كاملاً
• الصلاحية: البوت لا يكتب في قناة إلا إن كان مشرفاً فيها بصلاحية نشر الرسائل
• المحفّز: ووردبريس يطلق حدثاً عند تغيّر حالة المقال إلى «منشور»، وعليه تبني الإضافات والكود
• الرسالة: نص أو صورة بتعليق، وأزرار تحت المنشور تفتح رابط المقال

أما الرمز فعامله ككلمة مرور، فصفحة BotFather في توثيق تيليجرام تقول إن من يملكه يتحكم ببوتك، وإن الأمر /token يولّد رمزاً جديداً إن تسرّب القديم، فلا تضعه في ملف يُرفع إلى مستودع عام ولا ترسله في محادثة.

1024 أم 4096؟ الحدّان اللذان يقرران شكل منشورك

أكثر ما يفاجئ أصحاب المواقع أن المنشور نفسه يُقبل نصاً ويُرفض صورة، والسبب في سطرين من التوثيق الرسمي: نص الرسالة في sendMessage من 1 إلى 4096 حرفاً، وتعليق الصورة في sendPhoto من 0 إلى 1024 حرفاً، والعدّ في الحالتين «بعد تحليل التنسيق»، أي أن وسوم مثل <b> لا تُحسب، ويُحسب ما يراه القارئ.

البند	رسالة نصية sendMessage	صورة بتعليق sendPhoto
حد النص	1 إلى 4096 حرفاً	0 إلى 1024 حرفاً
شكلها في القناة	نص ومعاينة للرابط تحته أو فوقه	صورة كبيرة والتعليق تحتها
الصورة	من معاينة الرابط إن وُجدت	حتى 10 ميغابايت، ومجموع العرض والارتفاع لا يتجاوز 10000
تناسب	الأدلة الطويلة والملخصات	الأخبار والوظائف والمقالات ذات الصورة القوية

والقرار العملي بسيط: إن كان مقتطفك أطول من 1024 حرفاً فإما أن تختصره، وإما أن ترسل نصاً وتترك الصورة لمعاينة الرابط، وبعض الإضافات ترسل الصورة وحدها ثم النص في رسالة ثانية، وهذا يضاعف الإشعارات على متابعك فاستعمله بحذر.

HTML أم MarkdownV2؟

الحقل parse_mode يحدد طريقة التنسيق، والتوثيق في قسم خيارات التنسيق يدعم HTML بوسوم مثل <b> و<i> و<a href>، ويدعم MarkdownV2 الذي يشترط تهريب رموز كثيرة منها النقطة والشرطة وعلامة التعجب والأقواس بشرطة مائلة قبلها، والنص العربي مليء بهذه الرموز في العناوين والتواريخ، ولهذا أنصح بـHTML لمواقع المقالات، مع شرط واحد: الرموز < و> و& خارج الوسوم تُكتب بصيغتها المهرّبة وإلا رُفضت الرسالة.

من أدوات أيمن · صدىكل مقال يصل قناتك في تيليجرام وحدهصدى يرسل مقالك بصورته وزر الرابط وأسلوب تختاره، ويرسله لواتساب أيضاً بفواصل وحد يوميتعرّف على صدى

أربع طرق لربط ووردبريس بتيليجرام: أيها يناسب موقعك؟

كل الطرق تصل إلى الدالة نفسها في النهاية، والفرق في من يتحكم بشكل الرسالة، وكم تدفع، وماذا يحدث حين يتعطل شيء.

الطريقة	مثال	ما تكسبه	ما تنتبه له
إضافة نشر عامة	WP Telegram من مستودع ووردبريس	قالب رسالة، وصورة بارزة، وزر رابط، وقواعد بالتصنيف والكاتب	توجيه المقالات إلى قنوات مختلفة بحسب التصنيف في نسختها المدفوعة بحسب صفحتها
خدمة أتمتة	IFTTT وZapier	بلا تثبيت في الموقع، وربط مع خدمات أخرى	تعتمد على خلاصة الموقع أو حسابك فيها، وتأخير وحدود بحسب باقتك
إضافة قنوات متعددة	صدى	تيليجرام وواتساب معاً، وأسلوب لكل نوع منشور، وطابور وسجل وساعات هدوء	واتساب فيه عبر خدمة وسيطة باشتراك منفصل وبخطر قائم على الرقم
كود في القالب الفرعي	دالة على حدث النشر	تحكم كامل وبلا اشتراك	تصونه أنت، وأي خطأ فيه لا يُبلغك أحد به

وإن كانت IFTTT خيارك فاعرف شيئين من صفحتها الرسمية: المحفزات التي تعمل بالاستطلاع تُفحص كل ساعة للحساب المجاني وكل 5 دقائق لباقات Pro، فقد يتأخر منشورك ساعة، وبعض محفزات تيليجرام فيها تشترط أن يكون بوت @IFTTT نفسه مشرفاً في القناة، أي أنك تمنح صلاحية لبوت لا تملكه، وهذا مقبول لقناة صغيرة، أما لقناة موقع تجاري فأفضّل بوتاً باسمك ورمزه عندك.

1- خطوات الربط بأي إضافة

1. افتح @BotFather في تيليجرام وأرسل /newbot، واختر اسماً ظاهراً واسم مستخدم ينتهي بـbot
2. انسخ الرمز الذي يعطيك إياه واحفظه في مكان آمن
3. من إعدادات قناتك أضف البوت مشرفاً وفعّل له صلاحية نشر الرسائل وحدها
4. الصق الرمز في الإضافة، واكتب اسم القناة بصيغة @اسم_القناة
5. أرسل رسالة تجريبية من الإضافة، ثم انشر مقالاً حقيقياً وراقب شكله في الجوال

2- الطريق البرمجي في سطور

إن أردت كوداً بلا إضافة فهذا هيكله، والحدث transition_post_status يعمل عند كل تغيّر في حالة المقال، فنرسل فقط حين يصبح «منشوراً» أول مرة، والدالة wp_remote_post ترسل الطلب، والرمز يُعرَّف في ملف wp-config.php لا في الكود.

add_action( 'transition_post_status', function ( $new, $old, $post ) {
    if ( 'publish' !== $new || 'publish' === $old || 'post' !== $post->post_type ) {
        return;
    }
    $link    = get_permalink( $post );
    $caption = '<b>' . esc_html( get_the_title( $post ) ) . '</b>' . "\n\n" . esc_html( wp_trim_words( get_the_excerpt( $post ), 40 ) );
    wp_remote_post( 'https://api.telegram.org/bot' . MY_TG_TOKEN . '/sendPhoto', array(
        'body' => array(
            'chat_id'      => '@my_channel',
            'photo'        => get_the_post_thumbnail_url( $post, 'large' ),
            'caption'      => mb_substr( $caption, 0, 1000 ),
            'parse_mode'   => 'HTML',
            'reply_markup' => wp_json_encode( array( 'inline_keyboard' => array( array( array( 'text' => 'اقرأ المقال', 'url' => $link ) ) ) ) ),
        ),
    ) );
}, 10, 3 );

هذا الهيكل يعمل لمقال له صورة بارزة، ويحتاج في الإنتاج إلى ثلاث إضافات على الأقل: إرسال نصي حين لا توجد صورة، وتسجيل الرد للتأكد من النجاح، وعدم قص التعليق في منتصف وسم HTML، وهذه التفاصيل هي ما يجعل كثيرين يعودون إلى إضافة جاهزة بعد أسبوع.

مشكلة الرابط العربي ومعاينة الرابط في تيليجرام

هنا تقع المشكلة التي لا يذكرها أغلب الشروح، فرابط مقالك العربي يُرسل مرمّزاً، وكل حرف عربي يصير ستة رموز مثل %D8%A7، فرابط بعنوان من 30 حرفاً عربياً يتحول إلى قرابة 180 رمزاً، وإن وضعته نصاً صريحاً في تعليق صورة حدّه 1024 حرفاً فقد أكل قرابة خُمس المساحة، وظهر للقارئ سطراً من الرموز لا يُقرأ.

• ضع الرابط في زر: زر inline_keyboard تحت المنشور يحمل الرابط كاملاً ولا يظهر منه إلا نص الزر
• أو داخل وسم: <a href=”…”>اقرأ المقال</a> يُظهر كلمتين، والرابط نفسه ليس من نص الرسالة المعدود
• أو فكّ ترميزه للعرض: الرابط المفكوك يُقرأ عربياً ويوفر المساحة، لكن جرّبه في قناتك قبل اعتماده لتتأكد أنه يُفتح كاملاً
• أو الرابط القصير: رابط ووردبريس بصيغة ?p= مع رقم المقال قصير ويحوّل إلى الرابط الكامل

أما المعاينة، أي البطاقة التي تظهر بصورة وعنوان تحت الرابط، فتُبنى من وسوم Open Graph في صفحة المقال بحسب بروتوكول Open Graph، فإن ظهرت بلا صورة فالخلل غالباً في وسم og:image أو في صورة يحجبها جدار حماية الاستضافة، ويمكنك التحكم بها من الطلب نفسه عبر link_preview_options، ففيها تعطيل المعاينة، وتكبير صورتها أو تصغيرها، ووضعها فوق النص بدل تحته.

خطأ شائع: تعديل صورة المقال بعد نشره ثم التعجب من بقاء الصورة القديمة في المعاينة، فتيليجرام يحتفظ بنسخة من المعاينة، ويتداول المطورون بوت @WebpageBot لتحديثها، لكن متتبع أخطاء تيليجرام فيه بلاغات بأنه لا ينجح دائماً، فالأضمن أن تضبط الصورة قبل النشر.

جرّب منشورك قبل أن يراه متابعوك

الأداة التالية ترسم منشورك كما يظهر في قناة تيليجرام: اكتب العنوان والمقتطف والرابط، واختر بين صورة بتعليق أو رسالة نصية، وأضف زراً أو زرين تحت المنشور، والعدّاد يقيس النص بالحدّين الرسميين.

اقرأ العدّاد الذي يخص نوع منشورك فقط، فالصورة يحكمها حد 1024 والنص يحكمه حد 4096، وإن اقتربت من الحد فالمشكلة غالباً في مقتطف طويل لا في العنوان، والزر ينسخ الرسالة بصيغة HTML جاهزة للحقل parse_mode، أو نصاً عادياً إن أردت النشر بيدك.

أخطاء شائعة تُفسد النشر التلقائي في تيليجرام

1. البوت عضو لا مشرف: فيُرفض الطلب، والحل صلاحية نشر الرسائل في إعدادات القناة
2. النشر عند كل تحديث: بعض الإضافات ترسل المقال كلما عدّلته إن فعّلت ذلك، فتمتلئ القناة بالمكرر
3. إغراق القناة: أسئلة البوتات الشائعة تنصح بألا تتجاوز رسالة في الثانية للمحادثة الواحدة، وتذكر حداً بـ20 رسالة في الدقيقة للمجموعات، وتجاوزها يعيد الخطأ 429
4. رمز مكشوف: لصق الرمز في لقطة شاشة أو في كود منشور، والعلاج الفوري /token في BotFather
5. مقتطف آلي مقطوع: يخرج بجمل ناقصة ورموز مثل […]، والأفضل مقتطف تكتبه بنفسك في سطرين

قِس ما تجلبه القناة

أضف إلى رابط الزر وسوماً مثل utm_source=telegram وutm_medium=channel، فتظهر زيارات القناة منفصلة في تقارير التحليلات، وبعد شهر قارن بين المنشورات بالصورة والنصية، وبين الساعات، ثم اجعل الأفضل افتراضياً، وإن كنت تنشر في واتساب أيضاً فاقرأ النشر التلقائي في قناة واتساب لأن قواعده مختلفة تماماً، وفي بناء مجتمعات رقمية لمدونتك تجد لماذا تستحق القناة أن تكون جمهوراً لا مجرد مكبّر صوت.

وإن كان موقعك للوظائف فالقناة أسرع طريق يصل به الخبر لمن ينتظره، وقد شرحت في إنشاء موقع وظائف سعودي على ووردبريس كيف تكون القنوات جزءاً من بناء الموقع لا إضافة بعده، وفي جلب زوار حقيقيين لموقعك طرقاً تكمّلها.

من أدوات أيمن · سايروقناة لا تجف من المحتوىسايرو تكتب لموقعك مقالات عربية أصيلة من مصادرك بإيقاع تحدده، فتجد قناتك كل يوم ما تنشرهتعرّف على سايرو

الأسئلة الشائعة

كيف أنشر مقالات ووردبريس في قناة تيليجرام تلقائياً؟

أنشئ بوتاً من BotFather، وأضفه مشرفاً في قناتك بصلاحية النشر، ثم الصق رمزه واسم القناة في إضافة نشر مثل WP Telegram أو صدى، فيُرسل كل مقال تنشره إلى القناة دون تدخل منك.

ما أقصى طول لمنشور تيليجرام من البوت؟

الرسالة النصية من 1 إلى 4096 حرفاً، وتعليق الصورة حتى 1024 حرفاً، والعدّ بعد إزالة وسوم التنسيق بحسب توثيق Bot API الرسمي.

هل النشر التلقائي في تيليجرام مسموح؟

نعم، فالبوتات واجهة رسمية للنشر، والتوثيق يقبل اسم القناة في دالة الإرسال صراحة، والمطلوب أن تحترم حدود الإرسال وشروط مطوري البوتات وألا تنشر ما يخالفها.

لماذا يظهر رابط مقالي في تيليجرام برموز غريبة؟

لأن الرابط العربي يُرسل مرمّزاً، فكل حرف يصير ستة رموز، والحل أن تضعه في زر أو داخل وسم رابط بنص قصير، أو تستعمل الرابط القصير بصيغة ?p= ورقم المقال.

هل أحتاج برمجة لربط الموقع بقناة تيليجرام؟

لا، فالإضافات وخدمات الأتمتة تكفيك، والكود خيار لمن يريد تحكماً كاملاً ويستطيع صيانته بنفسه.

ما الفرق بين بوت نشر تلقائي تليجرام وخلاصة RSS؟

خلاصة RSS ملف يقرؤه غيرك متى شاء، أما البوت فيرسل المنشور لحظة النشر بالشكل الذي تحدده من صورة وأزرار وتنسيق، ولهذا تعتمد عليه أغلب إضافات النشر.

مصادر الصور: Atlantisboii عبر commons.wikimedia.org (CC BY 4.0، بتعديل)، Alejandro Escamilla عبر commons.wikimedia.org (CC0، بتعديل)، Wittystef عبر commons.wikimedia.org (CC BY-SA 4.0، بتعديل).