لتلقي إشعار على Telegram في كل مرة يبدأ فيها عميل محادثة في صندوق وارد محدد في Papo (https://papo.global/)، يجب عليك إعداد Flow يُشغّل Webhook نحو خدمة وسيطة تُعيد توجيه الرسالة إلى المحادثة المطلوبة. يحافظ ذلك على فريق الدعم أو المبيعات لديك متنبهًا في الوقت الفعلي، دون الحاجة إلى مراقبة المنصة باستمرار.
لا تقوم Papo بإرسال الرسالة مباشرة إلى Telegram. ما تفعله هو تشغيل Webhook يحتوي على بيانات المحادثة الجديدة. وسيط — مثل أتمتة في Make أو n8n أو سكريبت خاص أو نقطة نهاية serverless — يستقبل هذا Webhook ويستدعي Telegram API لتسليم التنبيه إلى المحادثة المختارة.
| الخطوة | الإجراء | الأداة |
|---|---|---|
| 1. تجهيز Telegram | إنشاء بوت والحصول على رمز الوصول ومعرّف محادثة الوجهة | BotFather, Telegram |
| 2. إعداد الوسيط | إنشاء نقطة نهاية تستقبل Webhook من Papo وترسل الرسالة عبر Telegram API | خدمة أتمتة أو كود خاص |
| 3. إنشاء Flow في Papo | إعداد تدفق جديد بمُشغّل "محادثة جديدة" وإجراء "Webhook" يشير إلى نقطة النهاية | وحدة Flows (Papo) |
| 4. اختبار الإشعار | بدء محادثة في صندوق الوارد المختار والتحقق من وصول الرسالة إلى محادثة Telegram | Papo + Telegram |
كيف يعمل — خطوة بخطوة
1. جهّز Telegram
قبل كل شيء، تحتاج إلى بوت على Telegram ومعرّف المحادثة التي ستتلقى التنبيهات. تحدث مع @BotFather على Telegram لإنشاء بوت جديد والحصول على رمز الوصول (شيء مثل 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). بعد ذلك، أضف البوت إلى المجموعة أو القناة المطلوبة واحصل على chat_id. إحدى الطرق البسيطة هي إرسال رسالة إلى البوت والوصول إلى https://api.telegram.org/bot<SEU_TOKEN>/getUpdates لالتقاط المعرّف. دوّن الرمز وchat_id — سيستخدمهما الوسيط.
2. أعدّ الوسيط
تحتاج إلى نقطة نهاية تستقبل Webhook من Papo وتستدعي Telegram API. يمكن أن تكون أتمتة في Make (Integromat)، أو سير عمل في n8n، أو دالة serverless (AWS Lambda، Cloudflare Workers)، أو سكريبت على خادمك. يجب أن تقوم نقطة النهاية بما يلي:
- قبول طلبات POST مع الحمولة المرسلة من Papo.
- استخراج المعلومات ذات الصلة (اسم جهة الاتصال، نص الرسالة، صندوق الوارد).
- تكوين استدعاء إلى
https://api.telegram.org/bot<TOKEN>/sendMessageمع المعاملينchat_idوtext. مثال على الحمولة التي قد يتلقاها الوسيط من Papo:
{
"contact_name": "{{contact.name}}",
"message_text": "{{message.text}}",
"inbox_name": "{{inbox.name}}"
}
بهذه البيانات، يرسل الوسيط إلى Telegram رسالة مثل: "محادثة جديدة من Maria Silva في صندوق WhatsApp Vendas: 'أريد حجز عرض توضيحي'."
3. أنشئ Flow في Papo
في لوحة تحكم Papo، انتقل إلى وحدة Flows وأنشئ تدفقًا جديدًا. أعطه اسمًا يحدد التنبيه، مثل "إشعار Telegram – محادثات جديدة".
أضف عقدة المُشغّل وحدد أن التدفق سيبدأ عندما تصل محادثة جديدة. اختر صندوق الوارد المحدد (على سبيل المثال، رقم WhatsApp أو Instagram أو Telegram المتصل) الذي يجب أن يولّد التنبيه.
بعد المُشغّل، أدرج عقدة إجراء واختر إرسال Webhook. املأ:
- URL: الصق عنوان URL لنقطة النهاية التي أنشأتها في الخطوة 2.
- الطريقة: اتركها POST.
- الحمولة: كوّن JSON بالمتغيرات المتاحة في سياق المحادثة، مثل
{{contact.name}}و{{message.text}}و{{inbox.name}}. سيستخدم الوسيط هذه الحقول لتكوين رسالة Telegram.
4. فعّل التدفق واختبره
احفظ التدفق وفعّله. للاختبار، أرسل رسالة إلى صندوق الوارد المُعد — على سبيل المثال، تحدث مع رقم WhatsApp الخاص بك المتصل بـ Papo. خلال ثوانٍ، يجب أن يظهر الإشعار في محادثة Telegram. إذا لم يصل، تحقق مما يلي:
- ما إذا كان التدفق نشطًا وسجل التنفيذ في وحدة Flows لا يُظهر أخطاء.
- ما إذا كان الوسيط يستقبل الطلب ويستدعي Telegram API بشكل صحيح.
- ما إذا كان رمز Telegram وchat_id صالحين.
لمن يفيد هذا التكامل
- فرق الدعم التي تستخدم Telegram كمركز اتصال وتحتاج إلى تنبيهات فورية حول التذاكر الجديدة.
- فرق المبيعات التي تراقب العملاء المحتملين الواردين في قنوات محددة، مثل صندوق WhatsApp لحملة ما.
- العمليات التي ترغب في توحيد إشعارات قنوات متعددة في مجموعة Telegram واحدة، دون التنقل بين علامات التبويب.
- المديرون الذين يتابعون حجم المحادثات الجديدة في الوقت الفعلي مباشرة في تطبيق المراسلة.
الأسئلة الشائعة
هل أحتاج إلى بوت على Telegram لتلقي التنبيهات؟
نعم. من الضروري إنشاء بوت عبر @BotFather والحصول على رمز الوصول. سيكون البوت مسؤولًا عن إرسال الرسائل إلى المحادثة (مجموعة، قناة، أو محادثة خاصة) التي تحددها.
هل يمكنني إرسال الإشعارات إلى مجموعة على Telegram؟
نعم. ما عليك سوى إضافة البوت إلى المجموعة والحصول على chat_id الخاص بالمجموعة (عادةً رقم سالب). يجب أن يستخدم الوسيط هذا chat_id في استدعاء Telegram API.
ماذا أفعل إذا لم يصل الإشعار إلى Telegram؟
تحقق من تنفيذ Flow في وحدة Flows في Papo. إذا تم تشغيل Webhook بنجاح، فقد تكون المشكلة في الوسيط: تأكد من أنه استقبل الطلب وما إذا كان استدعاء Telegram API قد أعاد خطأ. اختبر نقطة النهاية يدويًا بحمولة نموذجية.
هل يمكنني اختيار صناديق الوارد التي تولّد التنبيهات؟
نعم. في مُشغّل محادثة جديدة، تحدد صندوق الوارد المحدد الذي سيتم مراقبته. لإشعار صناديق مختلفة في محادثات مختلفة، أنشئ تدفقًا منفصلًا لكل صندوق ووجّهه إلى نقطة النهاية المقابلة.
كيف أختبر التكامل دون إزعاج الفريق؟
استخدم جهة اتصال تجريبية — على سبيل المثال، رقمك الشخصي — وأرسل رسالة إلى صندوق الوارد المُعد. تأكد من ظهور التنبيه فقط في محادثة الاختبار. يمكنك حذف تدفق الاختبار بعد التحقق.
هل هناك تكلفة إضافية لاستخدام Webhooks في Papo؟
ميزات Flows وإرسال Webhooks مضمنة في خطط Papo. تتوفر معلومات مفصلة حول الحدود والاشتراكات على الموقع الرسمي.
اقرأ أيضًا
- كيفية تلقي أحداث Papo في الوقت الفعلي عبر Webhook (outbound)
- كيفية استخدام Papo API لإدارة Flows الأتمتة
أنشئ حسابك المجاني على Papo وابدأ في تلقي التنبيهات على Telegram اليوم.