انتقل إلى المحتوى الرئيسي
العودة إلى الميزات

CRM تيليجرام

واجهة برمجة Telegram CRM - أتمتة سير عملك على Telegram

واجهة Telegram CRM API: واجهة REST محصورة بمساحة العمل لمزامنة المحادثات وجهات الاتصال، وإطلاق البثّ، وإنشاء التذاكر، وبناء أدواتك الداخلية.

ابدأ نسخة مجانية

نظرة عامة

نظرة عامة: واجهة برمجة Telegram CRM

تمنحك واجهة REST API من Entergram وصولًا برمجيًا إلى كامل مساحة عمل Telegram CRM. زامِن المحادثات وجهات الاتصال إلى BigQuery أو Postgres أو HubSpot أو Salesforce. أطلق عمليات بثّ على Telegram عند فشل دفعة في Stripe أو إغلاق صفقة. أنشئ تذاكر من تنبيهات المراقبة. ابنِ اللوحة الداخلية التي يريدها فريقك فعلًا.

كل استدعاء API محصور بمساحة العمل، ومُسجَّل في سجل التدقيق، ومحكوم بنموذج الصلاحيات بأقل امتياز نفسه المستخدَم عبر المنصة. المفاتيح قابلة للتدوير، ويمكن تقييدها بعناوين IP، وإلغاؤها بنقرة واحدة.

للتكاملات مع وكلاء الذكاء الاصطناعي، راجع صفحة خادم Telegram MCP المرافقة - فهي تكشف سطح البيانات نفسه عبر Model Context Protocol بحيث يستطيع Claude وChatGPT وغيرهما من وكلاء الذكاء الاصطناعي التفاعل مع مساحة عمل Telegram لديك مباشرةً.

نظام Telegram CRM بأكمله، في متناول شيفرتك

أي شيء تفعله في لوحة Entergram، تستطيع شيفرتك فعله أيضًا. إنها واجهة REST بسيطة - مفاتيح محصورة بمساحة العمل، وحمولات JSON، وأفعال HTTP قياسية - فأي لغة قادرة على إرسال طلب تستطيع سرد محادثات Telegram والبحث فيها، وقراءة سجل الرسائل، وإدارة جهات الاتصال والحقول المخصّصة، وفتح التذاكر وتحديثها، وإطلاق عمليات البثّ.

اضبط صلاحياتك مرة واحدة: تغطي الصلاحيات نفسها الواجهة البرمجية وخادم MCP وتكامل Make. com.

اقرأ وثائق الواجهة البرمجية
  1. زامِن Telegram إلى مستودع بياناتك

    اسحب المحادثات وجهات الاتصال وقيم الحقول المخصّصة من Entergram وفق جدول زمني. أدخِلها إلى BigQuery أو Postgres أو HubSpot أو Salesforce حتى يتمكن بقية أقسام العمل من دمج بيانات Telegram مع كل قناة أخرى. مهمة cron ليلية وبضعة استدعاءات API هي كل ما يلزم.

  2. أطلق عمليات بثّ على Telegram من أحداث خارجية

    عند فشل دفعة في Stripe، أو إغلاق صفقة في نظام CRM لديك، أو إطلاق تنبيه مراقبة - أرسل طلب POST إلى Entergram لينطلق بثّ على Telegram إلى الشريحة الموسومة الصحيحة بالقالب الصحيح. مراسلة مدفوعة بالأحداث دون مغادرة منظومتك الحالية.

  3. إنشاء تذاكر برمجيًا

    النماذج، وأدوات المراقبة، وخطوط دعم البريد الإلكتروني - أينما وقع حدث مُنظَّم - أرسله عبر POST كتذكرة مرتبطة بمحادثة Telegram الصحيحة بالأولوية وSLA المناسبَين. يُغلق الحلقة بين Telegram وكل قناة أخرى يستخدمها فريقك.

  4. الأدوات واللوحات الداخلية

    ابنِ لوحة القيادة التي يريدها فريقك فعلًا - خط الأنابيب حسب المرحلة، وزمن الاستجابة لكل مندوب، ومعدل إنجاز التذاكر - مدعومةً بواجهة Entergram البرمجية. كونها محصورة بمساحة العمل يعني أنها لا ترى إلا بياناتك. اقرنها بـ Retool أو Appsmith أو واجهة React مخصّصة.

المواصفات

واجهة برمجة Telegram CRM بالتفصيل

المواصفات

اعرف المزيد
  • وسم المحادثات تلقائيًا من مُحفِّزات خارجيةيبلغ العميل مرحلة معيّنة في منتجك ← يضيف استدعاء API الوسم VIP ويرفع عمود المرحلة. وفي المرة التالية التي تفتح فيها محادثة Telegram، يكون سياق CRM حاضرًا مسبقًا. يعمل مع أي نظام webhook أو أحداث.
  • أمان مفاتيح API ودورة حياتهاالمفاتيح محصورة بمساحة العمل، ومُجزَّأة باتجاه واحد عند التخزين، وتُعرض مرة واحدة فقط عند الإنشاء. اضبط مدة الصلاحية (افتراضيًا 90 يومًا، أو أقصر إن فضّلت)، وقوائم IP المسموح بها الاختيارية (نطاقات CIDR)، وألغِ أي مفتاح فورًا من تبويب المطوّرين. كل استدعاء يُسجَّل مع بادئة المفتاح وعنوان IP ووكيل المستخدم.
  • نموذج الصلاحياتworkspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. تنطبق الصلاحيات نفسها على الواجهة البرمجية وخادم MCP وتكامل Make.com. اختر الحد الأدنى الذي يحتاجه تكاملك - فأقل امتياز يحدّ من نطاق الضرر في حال تسرّب مفتاح.
  • تكامل Make.com (منخفض البرمجة)لا ترغب في كتابة الشيفرة؟ يستخدم تكامل Make.com نموذج الصلاحيات نفسه. اربط Entergram بمئات التطبيقات عبر سيناريوهات مرئية. تتيح إجراءات التطبيق تحديث الوسوم وتحديث بيانات جهات الاتصال ووضع علامة مقروءة على المحادثة، مثل: دفعة Stripe ← تحديث وسم في CRM، أو إرسال نموذج Typeform ← بيانات جهة الاتصال.
  • المرافق: خادم Telegram MCPإن أردت أن يتفاعل وكلاء الذكاء الاصطناعي (Claude، ChatGPT، Cursor) مع مساحة عمل Telegram لديك، فاطّلع على خادم Telegram MCP - فهو يكشف سطح API نفسه عبر Model Context Protocol بحيث يكتشف وكلاء الذكاء الاصطناعي الأدوات ويستدعونها تلقائيًا، دون أن تكتب أي شيفرة عميل API.
القدرةالتفاصيل
متطلب الخطةPro (ومقاعد Pro في مساحة العمل)
البروتوكولREST (JSON عبر HTTPS)
نقاط النهايةchats · messages · contacts · custom_fields · tickets · broadcasts · workspace · members · accounts
المصادقةمفتاح API محصور بمساحة العمل (Bearer token)
مدة الصلاحية الافتراضية للمفتاح90 يومًا (قابلة للضبط أقصر)
قائمة IP المسموح بهانطاقات CIDR اختيارية
الإلغاءفوري
التدقيقكل استدعاء يسجّل بادئة المفتاح وعنوان IP ووكيل المستخدم
حدود المعدللكل مفتاح ولكل نقطة نهاية - 429 مع ترويسة Retry-After

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

ماذا يمكنني أن أفعل بواجهة Telegram CRM API؟

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

ما الصلاحيات المتاحة؟

workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. اختر الحد الأدنى الذي يحتاجه تكاملك - فأقل امتياز يحدّ من نطاق الضرر في حال تسرّب مفتاح. وتنطبق الصلاحيات نفسها على الواجهة البرمجية وخادم MCP وتكامل Make.com.

أمثلة ملموسة - ما الذي تبنيه الفِرَق فعلًا؟

فريق تداول يزامن كل محادثة Telegram إلى BigQuery كل ساعة ليتمكن المحلّلون من دمجها مع بيانات السلسلة. فريق دعم SaaS لديه مهمة cron تسحب تذاكر الأمس غير المحلولة وتدفعها إلى ملخص على Slack. فريق نموّ يطلق بثًّا على Telegram من webhook كلما وقع حدث ترقية في Stripe. فريق عمليات بنى لوحة Retool تعرض زمن الاستجابة لكل مندوب، ومعدل إنجاز التذاكر، وتوزيع مراحل خط الأنابيب - كلها مدعومة بواجهة Entergram البرمجية.

كيف أُنشئ مفاتيح API وأديرها؟

اذهب إلى تبويب المطوّرين في مساحة عمل Entergram. انقر «إنشاء مفتاح»، واختر الصلاحيات التي تحتاجها، واضبط اختياريًا مدة صلاحية أقصر وقائمة IP مسموح بها، وانسخ المفتاح. يُعرض المفتاح الخام مرة واحدة فقط - احفظه بأمان. المفاتيح مُجزَّأة باتجاه واحد عند التخزين. ألغِ أي مفتاح فورًا من التبويب نفسه.

كيف أُدوِّر مفتاحًا مُسرَّبًا؟

تبويب المطوّرين ← اعثر على المفتاح ببادئته ← إلغاء (فوري). ثم أنشئ مفتاحًا جديدًا بالصلاحيات وقائمة IP نفسها، وانشره في تكاملك، وتحقق من معلومات آخر استخدام للمفتاح القديم للتأكد من توقّف أي حركة.

هل تستطيع الواجهة البرمجية رؤية بيانات مساحة عمل أخرى؟

لا. كل استدعاء API محصور بمساحة العمل التي أصدرت المفتاح. لا يستطيع مفتاح من مساحة العمل A أن يقرأ مساحة العمل B إطلاقًا - فالحصر مُطبَّق من جهة الخادم في كل استعلام.

ما أخطاء HTTP التي قد أراها؟

401 = المفتاح منتهٍ أو مُلغى أو خاطئ لمساحة العمل. 403 = يفتقر المفتاح إلى الصلاحية المطلوبة، أو ورد الطلب من عنوان IP خارج القائمة المسموح بها. 429 = بلغت حد المعدل؛ تراجع وأعِد المحاولة وفق ترويسة Retry-After.

ما الفرق بين الواجهة البرمجية وخادم MCP؟

كلاهما يصل إلى بيانات مساحة العمل نفسها بالصلاحيات نفسها. الواجهة البرمجية مخصّصة لشيفرتك - مهام cron، وwebhooks، والأدوات الداخلية، وخطوط المزامنة. أما خادم MCP فمخصّص لوكلاء الذكاء الاصطناعي - Claude وChatGPT وCursor - الذين يكتشفون الأدوات ويستدعونها تلقائيًا عبر Model Context Protocol. استخدم الواجهة البرمجية عندما تكون الشيفرة هي المستهلك؛ واستخدم خادم MCP عندما يكون الذكاء الاصطناعي.

هل تدعم الواجهة البرمجية webhooks؟

الـ webhooks الصادرة على خارطة الطريق. أما اليوم فالنمط قائم على السحب: استدعِ الواجهة وفق جدول زمني أو استجابةً لأحداثك الخاصة. ويتضمن تطبيق Make.com أيضًا مشغّلات لأحداث مساحة العمل؛ راجع قائمتها داخل Make قبل أن تبني سيناريو يعتمد على أحدها.
ابدأ نسخة مجانية