ابدأ باستخدام إضافة Bird على Firebase

طائر

01‏/06‏/2021

امتداد Firebase

1 min read

ابدأ باستخدام إضافة Bird على Firebase

النقاط الرئيسية

    • يمكّن ملحق Bird | Firebase المطورين من إرسال الرسائل والإشعارات عبر SMS وWhatsApp وMessenger وGoogle Business Messages وTelegram وLINE وViber وغيرها - مباشرة من كتابة مستندات Firestore.

    • عند إضافة مستند جديد إلى مجموعة Firestore المكونة، يقوم الملحق بتحويله إلى حزمة رسالة قابلة للقراءة وإرسالها عبر واجهة API المحادثات الخاصة بـ Bird، ثم يقوم بتحديث المستند بحالة التسليم.

    • يُلغي هذا الملحق الحاجة إلى تكامل خلفية مع واجهة API الخاصة بـ Bird، مما يمكّن الفرق من شحن ميزات الرسائل بشكل أسرع مع الحد الأدنى من التعليمات البرمجية.

    • تتزاوج البنية التحتية القابلة للتوسع في Firebase مع الاتصال العالمي لـ Bird، مما يضمن تسليم الرسائل بشكل موثوق في أي مكان في العالم.

    • يوضح مثال على حالة استخدام كيفية قيام المطاعم بأتمتة إشعارات SMS للعملاء الذين ينتظرون الطاولات - مما يتطلب فقط كتابة في Firestore.

    • يتطلب الإعداد فقط مفتاح واجهة API الخاصة بـ Bird ومعرف SMS (أو قناة أخرى)؛ يتم الإعداد من خلال معالج تثبيت ملحق Firebase.

    • يحدد المطورون مجموعة Firestore التي يستمع إليها الملحق - كل مستند جديد يصبح مُحَفِّزًا للرسالة.

    • بعد الإرسال، يقوم الملحق بتثريث مستند Firestore ببيانات التسليم والحالة ورسائل الخطأ إذا كانت قابلة للتطبيق.

    • تعتبر أفضل ممارسات الأمان أساسية: يجب أن تقيد قواعد Firestore الوصول للقراءة/الكتابة بشكل صارم لمنع إساءة الاستخدام أو إرسال رسائل غير مصرح بها.

    • تسمح سجلات وظائف السحاب للمطورين بفحص فشل الرسائل وأخطاء تنفيذ الملحق ونتائج التسليم.

    • يعمل الملحق بسلاسة مع النظام البيئي الأوسع لـ Bird، مما يمكّن من تحسينات مستقبلية مثل تدفقات قائمة على الذكاء الاصطناعي أو التعرف على الصور أو أتمتة CRM.

    • تخلق هذه التكاملات أساسًا لتجارب أغنى، مثل تمكين العملاء من الرد بكلمات رئيسية، وبناء ميزات قائمة انتظار المطاعم، أو الاتصال بواجهات برمجة تطبيقات خارجية عبر Flow Builder.

أهم النقاط في الأسئلة والأجوبة

  • ماذا تفعل إضافة Firebase لمراقبة الطيور؟

    إنه يستمع إلى التغييرات في مجموعة Firestore ويرسل رسائل عبر واجهة برمجة تطبيقات محادثات Bird كلما تم إضافة مستند جديد.

  • ما هي القنوات التي يمكن للإضافة إرسال الرسائل من خلالها؟

    الرسائل النصية القصيرة، واتساب، ماسنجر فيسبوك، رسائل الأعمال من جوجل، تيليجرام، لاين، فايبر، وأي قنوات مدعومة من بيرد أخرى.

  • هل أحتاج إلى خادم خلفي لإرسال الرسائل؟

    لا. الإضافة تتولى جميع التفاعلات مع واجهة برمجة التطبيقات - تصبح عملية المراسلة بسيطة مثل كتابة مستند في Firestore.

  • ما المعلومات المطلوبة من حسابي على Bird؟

    ستحتاج إلى مفتاح API الخاص بـ Bird ومعرف قناة (مثل، للرسائل القصيرة).

  • كيف أقوم بتثبيت الإضافة؟

    من خلال وحدة تحكم Firebase → الإضافات → تثبيت “إرسال الرسائل مع Bird” ، ثم قم بتكوين مفتاح API واسم المجموعة الخاصة بك.

  • كيف تعرف الإضافة متى ترسل رسالة؟

    إنه يراقب مجموعة Firestore المحددة ويقوم بالتنشيط كلما تم إنشاء مستند جديد.

  • كيف يبدو تنسيق مستند الرسالة؟

    JSON بسيط يحتوي على الوجهة، معرف القناة، ونص الرسالة (أو الحمولة لقنوات أخرى).

  • ماذا يحدث بعد إرسال رسالة؟

    تقوم الإضافة بتحديث مستند Firestore ببيانات التسليم مثل delivery.state، والطوابع الزمنية، وتفاصيل الأخطاء (إن وجدت).

  • كيف يمكنني التحقق من الأخطاء؟

    تظهر الأخطاء في مستند Firestore المُحدث وكذلك في سجلات Cloud Functions ضمن Firebase.

  • كيف أحمي مجموعة Firestore الخاصة بي؟

    استخدم قواعد أمان Firestore لتقييد وصول القراءة/الكتابة فقط للمستخدمين أو حسابات الخدمة المصرح لهم.

  • هل يمكنني استخدام هذه الإضافة لعمليات العمل الأكثر تقدمًا؟

    نعم - يمكنك ربطه بـ Flow Builder أو واجهات برمجة التطبيقات الخارجية أو أدوات التعلم الآلي مثل Google Vision لبناء تجارب تفاعلية وآلية.

  • ما هو مثال على استخدام هذا الامتداد في العالم الحقيقي؟

    نظام طابور المطاعم الذي يرسل إشعارات SMS عندما تكون الطاولة جاهزة - يتم تفعيله ببساطة عن طريق إضافة مستند إلى Firestore.

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

اليوم، نحن متحمسون لمناقشة Bird | ملحق Firebase.

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

اليوم، نحن متحمسون لمناقشة Bird | ملحق Firebase.

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

اليوم، نحن متحمسون لمناقشة Bird | ملحق Firebase.

أرسل رسالة وإشعارات مع بيرد

تُتيح لك هذه الإضافة ربط Firebase بواجهات برمجة التطبيقات متعددة القنوات لـ Bird، مما يسمح لك بإرسال الرسائل عبر الكتابة البسيطة في Firestore.

تتصل إضافة Bird على Firebase بأكبر محفظة متعددة القنوات في العالم لتوصيل الرسائل والإشعارات عبر جميع قنوات عملائك المفضلة. مدعومة بربط Bird العالمي، يعني ذلك أنه يمكنك الوصول إلى عملائك بسرعة - وفي أي مكان في العالم! 


Communication app icons with platforms including WhatsApp, Telegram, Instagram, Messenger, and various social media apps.


لزيادة تبسيط العملية، عند إضافة مستند إلى مجموعة معينة في Firebase، ستستخدم الإضافة واجهة برمجة تطبيقات محادثات Bird لتحويل هذا المستند إلى نص قابل للقراءة وتحديث المستند بحالة التسليم.

كيف تعمل إضافة Bird Firebase


المكون

ما تفعله

من يديرها

مجموعة Firestore

تعمل كمحفز للرسالة عندما يتم كتابة مستند

المطور

إضافة Firebase

تنصت على المستندات الجديدة وتنفيذ المنطق

Firebase

وظيفة Cloud

تحول بيانات المستند إلى طلب رسالة

الإضافة

واجهة برمجة تطبيقات محادثات Bird

ترسل الرسالة عبر القنوات المختارة

Bird

تحديث حالة التسليم

تكتب حالة الرسالة مرة أخرى إلى Firestore

الإضافة

قنوات الرسائل

SMS، WhatsApp، Messenger، إلخ.

بنية Bird التحتية

في هذه المقالة، ستتعلم كيف يمكنك البدء في الإرسال في بضع خطوات بسيطة!

تُتيح لك هذه الإضافة ربط Firebase بواجهات برمجة التطبيقات متعددة القنوات لـ Bird، مما يسمح لك بإرسال الرسائل عبر الكتابة البسيطة في Firestore.

تتصل إضافة Bird على Firebase بأكبر محفظة متعددة القنوات في العالم لتوصيل الرسائل والإشعارات عبر جميع قنوات عملائك المفضلة. مدعومة بربط Bird العالمي، يعني ذلك أنه يمكنك الوصول إلى عملائك بسرعة - وفي أي مكان في العالم! 


Communication app icons with platforms including WhatsApp, Telegram, Instagram, Messenger, and various social media apps.


لزيادة تبسيط العملية، عند إضافة مستند إلى مجموعة معينة في Firebase، ستستخدم الإضافة واجهة برمجة تطبيقات محادثات Bird لتحويل هذا المستند إلى نص قابل للقراءة وتحديث المستند بحالة التسليم.

كيف تعمل إضافة Bird Firebase


المكون

ما تفعله

من يديرها

مجموعة Firestore

تعمل كمحفز للرسالة عندما يتم كتابة مستند

المطور

إضافة Firebase

تنصت على المستندات الجديدة وتنفيذ المنطق

Firebase

وظيفة Cloud

تحول بيانات المستند إلى طلب رسالة

الإضافة

واجهة برمجة تطبيقات محادثات Bird

ترسل الرسالة عبر القنوات المختارة

Bird

تحديث حالة التسليم

تكتب حالة الرسالة مرة أخرى إلى Firestore

الإضافة

قنوات الرسائل

SMS، WhatsApp، Messenger، إلخ.

بنية Bird التحتية

في هذه المقالة، ستتعلم كيف يمكنك البدء في الإرسال في بضع خطوات بسيطة!

تُتيح لك هذه الإضافة ربط Firebase بواجهات برمجة التطبيقات متعددة القنوات لـ Bird، مما يسمح لك بإرسال الرسائل عبر الكتابة البسيطة في Firestore.

تتصل إضافة Bird على Firebase بأكبر محفظة متعددة القنوات في العالم لتوصيل الرسائل والإشعارات عبر جميع قنوات عملائك المفضلة. مدعومة بربط Bird العالمي، يعني ذلك أنه يمكنك الوصول إلى عملائك بسرعة - وفي أي مكان في العالم! 


Communication app icons with platforms including WhatsApp, Telegram, Instagram, Messenger, and various social media apps.


لزيادة تبسيط العملية، عند إضافة مستند إلى مجموعة معينة في Firebase، ستستخدم الإضافة واجهة برمجة تطبيقات محادثات Bird لتحويل هذا المستند إلى نص قابل للقراءة وتحديث المستند بحالة التسليم.

كيف تعمل إضافة Bird Firebase


المكون

ما تفعله

من يديرها

مجموعة Firestore

تعمل كمحفز للرسالة عندما يتم كتابة مستند

المطور

إضافة Firebase

تنصت على المستندات الجديدة وتنفيذ المنطق

Firebase

وظيفة Cloud

تحول بيانات المستند إلى طلب رسالة

الإضافة

واجهة برمجة تطبيقات محادثات Bird

ترسل الرسالة عبر القنوات المختارة

Bird

تحديث حالة التسليم

تكتب حالة الرسالة مرة أخرى إلى Firestore

الإضافة

قنوات الرسائل

SMS، WhatsApp، Messenger، إلخ.

بنية Bird التحتية

في هذه المقالة، ستتعلم كيف يمكنك البدء في الإرسال في بضع خطوات بسيطة!

حالة استخدام مثال: إشعارات طابور المطعم

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

ملحوظة: يمكنك العثور على إضافة Bird على Firebase هنا.

لتوضيح الإضافة، سنعتبر تطبيقًا صغيرًا لإدارة الطابور في مطعم.

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

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

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

بينما يرسل هذا المثال إشعار رسالة نصية قصيرة، يمكنك داخل الإضافة استخدام أي قناة يفضلها الزبون (WhatsApp، رسائل أعمال Google، Facebook Messenger، Telegram، Line، Viber، إلخ) حتى تتمكن من تعديل الإشعار وفقًا لتفضيلات الزبون.

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

ملحوظة: يمكنك العثور على إضافة Bird على Firebase هنا.

لتوضيح الإضافة، سنعتبر تطبيقًا صغيرًا لإدارة الطابور في مطعم.

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

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

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

بينما يرسل هذا المثال إشعار رسالة نصية قصيرة، يمكنك داخل الإضافة استخدام أي قناة يفضلها الزبون (WhatsApp، رسائل أعمال Google، Facebook Messenger، Telegram، Line، Viber، إلخ) حتى تتمكن من تعديل الإشعار وفقًا لتفضيلات الزبون.

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

ملحوظة: يمكنك العثور على إضافة Bird على Firebase هنا.

لتوضيح الإضافة، سنعتبر تطبيقًا صغيرًا لإدارة الطابور في مطعم.

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

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

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

بينما يرسل هذا المثال إشعار رسالة نصية قصيرة، يمكنك داخل الإضافة استخدام أي قناة يفضلها الزبون (WhatsApp، رسائل أعمال Google، Facebook Messenger، Telegram، Line، Viber، إلخ) حتى تتمكن من تعديل الإشعار وفقًا لتفضيلات الزبون.

كيفية الإعداد

في هذا المثال، نفترض أن لديك حساب Firebase وحساب Bird.

المتطلبات الأساسية

إذا لم يكن لديك حساب Bird، يمكنك إنشاء واحد هنا.

مكونات الإعداد المطلوبة قبل التثبيت


المتطلبات

الغرض

من أين تأتي

حساب Bird

يمكن الوصول إلى واجهات برمجة التطبيقات الخاصة بالرسائل

لوحة تحكم Bird

مفتاح API

يوثق Firebase مع Bird

إعدادات API لبرنامج Bird

معرف القناة

يحدد القناة التي ترسل الرسائل

إعداد قناة Bird

مشروع Firebase

يستضيف Firestore والإضافات

وحدة تحكم Firebase

قواعد Firestore

يمنع إرسال الرسائل غير المصرح بها

قواعد أمان Firebase

لتبدأ، يتطلب معلومات من حساب Bird الخاص بك.

أولاً، ستحتاج إلى مفتاح API الخاص بك للسماح لإضافة Firebase بالتفاعل مع واجهة برمجة التطبيقات Bird نيابة عنك. يمكنك العثور على مفتاح API الخاص بك في إعدادات API لبرنامج Bird. ثانياً، ستحتاج إلى رقم SMS وقناة SMS مثبتة. إذا لم يكن لديك معرف قناة بالفعل، انتقل إلى صفحة إعداد قناة SMS للحصول على واحد.

تثبيت إضافة Firebase

بمجرد حصولك على كل من مفتاح API ومعرف قناة SMS، عد إلى وحدة تحكم Firebase الخاصة بك وانتقل إلى علامة التبويب الإضافات.

من هنا، قم بتثبيت [إرسال الرسائل مع Bird] إضافة Firebase.


Firebase Extensions marketplace showing the 'Send Messages with Bird' integration among other available extensions, allowing developers to connect Firebase with Bird's messaging API.

أثناء معالج التثبيت، سيتم دعوتك لإضافة مفتاح API واسم مجموعة للاستخدام.

ستقوم إضافة Firebase بالاستماع إلى اسم المجموعة.

عند إضافة مستند إلى المجموعة، سيؤدي ذلك إلى تنشيط الإضافة.

من تحت الغطاء، الإضافة هي وظيفة سحابية، تستمع إلى التغييرات في المجموعة المحددة، تقرأ المستند المضاف وتتفاعل مع واجهة برمجة التطبيقات Bird لإرسال الرسالة.


Configuration page for installing the MessageBird Firebase extension, showing setup fields for API key, message collection name, and deployment options.

تكوين قواعد Firestore والأمان

بمجرد اكتمال تثبيت الإضافة، انتقل إلى Firestore داخل وحدة تحكم Firebase. ثم، أضف معرف مجموعة يتطابق مع اسم المجموعة الذي استخدمته عند تثبيت الإضافة.

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

في هذا المثال، نفترض أن لديك حساب Firebase وحساب Bird.

المتطلبات الأساسية

إذا لم يكن لديك حساب Bird، يمكنك إنشاء واحد هنا.

مكونات الإعداد المطلوبة قبل التثبيت


المتطلبات

الغرض

من أين تأتي

حساب Bird

يمكن الوصول إلى واجهات برمجة التطبيقات الخاصة بالرسائل

لوحة تحكم Bird

مفتاح API

يوثق Firebase مع Bird

إعدادات API لبرنامج Bird

معرف القناة

يحدد القناة التي ترسل الرسائل

إعداد قناة Bird

مشروع Firebase

يستضيف Firestore والإضافات

وحدة تحكم Firebase

قواعد Firestore

يمنع إرسال الرسائل غير المصرح بها

قواعد أمان Firebase

لتبدأ، يتطلب معلومات من حساب Bird الخاص بك.

أولاً، ستحتاج إلى مفتاح API الخاص بك للسماح لإضافة Firebase بالتفاعل مع واجهة برمجة التطبيقات Bird نيابة عنك. يمكنك العثور على مفتاح API الخاص بك في إعدادات API لبرنامج Bird. ثانياً، ستحتاج إلى رقم SMS وقناة SMS مثبتة. إذا لم يكن لديك معرف قناة بالفعل، انتقل إلى صفحة إعداد قناة SMS للحصول على واحد.

تثبيت إضافة Firebase

بمجرد حصولك على كل من مفتاح API ومعرف قناة SMS، عد إلى وحدة تحكم Firebase الخاصة بك وانتقل إلى علامة التبويب الإضافات.

من هنا، قم بتثبيت [إرسال الرسائل مع Bird] إضافة Firebase.


Firebase Extensions marketplace showing the 'Send Messages with Bird' integration among other available extensions, allowing developers to connect Firebase with Bird's messaging API.

أثناء معالج التثبيت، سيتم دعوتك لإضافة مفتاح API واسم مجموعة للاستخدام.

ستقوم إضافة Firebase بالاستماع إلى اسم المجموعة.

عند إضافة مستند إلى المجموعة، سيؤدي ذلك إلى تنشيط الإضافة.

من تحت الغطاء، الإضافة هي وظيفة سحابية، تستمع إلى التغييرات في المجموعة المحددة، تقرأ المستند المضاف وتتفاعل مع واجهة برمجة التطبيقات Bird لإرسال الرسالة.


Configuration page for installing the MessageBird Firebase extension, showing setup fields for API key, message collection name, and deployment options.

تكوين قواعد Firestore والأمان

بمجرد اكتمال تثبيت الإضافة، انتقل إلى Firestore داخل وحدة تحكم Firebase. ثم، أضف معرف مجموعة يتطابق مع اسم المجموعة الذي استخدمته عند تثبيت الإضافة.

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

في هذا المثال، نفترض أن لديك حساب Firebase وحساب Bird.

المتطلبات الأساسية

إذا لم يكن لديك حساب Bird، يمكنك إنشاء واحد هنا.

مكونات الإعداد المطلوبة قبل التثبيت


المتطلبات

الغرض

من أين تأتي

حساب Bird

يمكن الوصول إلى واجهات برمجة التطبيقات الخاصة بالرسائل

لوحة تحكم Bird

مفتاح API

يوثق Firebase مع Bird

إعدادات API لبرنامج Bird

معرف القناة

يحدد القناة التي ترسل الرسائل

إعداد قناة Bird

مشروع Firebase

يستضيف Firestore والإضافات

وحدة تحكم Firebase

قواعد Firestore

يمنع إرسال الرسائل غير المصرح بها

قواعد أمان Firebase

لتبدأ، يتطلب معلومات من حساب Bird الخاص بك.

أولاً، ستحتاج إلى مفتاح API الخاص بك للسماح لإضافة Firebase بالتفاعل مع واجهة برمجة التطبيقات Bird نيابة عنك. يمكنك العثور على مفتاح API الخاص بك في إعدادات API لبرنامج Bird. ثانياً، ستحتاج إلى رقم SMS وقناة SMS مثبتة. إذا لم يكن لديك معرف قناة بالفعل، انتقل إلى صفحة إعداد قناة SMS للحصول على واحد.

تثبيت إضافة Firebase

بمجرد حصولك على كل من مفتاح API ومعرف قناة SMS، عد إلى وحدة تحكم Firebase الخاصة بك وانتقل إلى علامة التبويب الإضافات.

من هنا، قم بتثبيت [إرسال الرسائل مع Bird] إضافة Firebase.


Firebase Extensions marketplace showing the 'Send Messages with Bird' integration among other available extensions, allowing developers to connect Firebase with Bird's messaging API.

أثناء معالج التثبيت، سيتم دعوتك لإضافة مفتاح API واسم مجموعة للاستخدام.

ستقوم إضافة Firebase بالاستماع إلى اسم المجموعة.

عند إضافة مستند إلى المجموعة، سيؤدي ذلك إلى تنشيط الإضافة.

من تحت الغطاء، الإضافة هي وظيفة سحابية، تستمع إلى التغييرات في المجموعة المحددة، تقرأ المستند المضاف وتتفاعل مع واجهة برمجة التطبيقات Bird لإرسال الرسالة.


Configuration page for installing the MessageBird Firebase extension, showing setup fields for API key, message collection name, and deployment options.

تكوين قواعد Firestore والأمان

بمجرد اكتمال تثبيت الإضافة، انتقل إلى Firestore داخل وحدة تحكم Firebase. ثم، أضف معرف مجموعة يتطابق مع اسم المجموعة الذي استخدمته عند تثبيت الإضافة.

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

كيفية إرسال الرسائل

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

تنسيق مستند الرسالة


Code snippet showing the JSON structure for sending messages through Bird API with fields for channel ID, recipient, and message content.

بمجرد إضافة المستند إلى المجموعة، ستتفاعل إضافة Bird مع واجهة برمجة تطبيقات Bird وتقوم بتحديث المستند مع حقول إضافية كما هو موضح أدناه. حقل delivery.state أدناه يعكس الحالات المختلفة التي يمكن أن تكون فيها الرسالة.


JavaScript code example showing how to send SMS notifications through Firebase and Bird integration, with template for restaurant table readiness alerts and delivery status monitoring.

إذا أدى إرسال رسالة إلى فشل، سيكون حقل الحالة ERROR، وسيتم تعبئة حقل الخطأ بسلسلة رسالة الخطأ.

كما أنه من الممكن ملاحظة الأخطاء من الإضافة والاستخدام عبر علامة وظائف السحابة في وحدة تحكم Firebase:


Firebase Cloud Functions dashboard showing the deployed MessageBird extension triggered by document writes to the messages collection.

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

تنسيق مستند الرسالة


Code snippet showing the JSON structure for sending messages through Bird API with fields for channel ID, recipient, and message content.

بمجرد إضافة المستند إلى المجموعة، ستتفاعل إضافة Bird مع واجهة برمجة تطبيقات Bird وتقوم بتحديث المستند مع حقول إضافية كما هو موضح أدناه. حقل delivery.state أدناه يعكس الحالات المختلفة التي يمكن أن تكون فيها الرسالة.


JavaScript code example showing how to send SMS notifications through Firebase and Bird integration, with template for restaurant table readiness alerts and delivery status monitoring.

إذا أدى إرسال رسالة إلى فشل، سيكون حقل الحالة ERROR، وسيتم تعبئة حقل الخطأ بسلسلة رسالة الخطأ.

كما أنه من الممكن ملاحظة الأخطاء من الإضافة والاستخدام عبر علامة وظائف السحابة في وحدة تحكم Firebase:


Firebase Cloud Functions dashboard showing the deployed MessageBird extension triggered by document writes to the messages collection.

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

تنسيق مستند الرسالة


Code snippet showing the JSON structure for sending messages through Bird API with fields for channel ID, recipient, and message content.

بمجرد إضافة المستند إلى المجموعة، ستتفاعل إضافة Bird مع واجهة برمجة تطبيقات Bird وتقوم بتحديث المستند مع حقول إضافية كما هو موضح أدناه. حقل delivery.state أدناه يعكس الحالات المختلفة التي يمكن أن تكون فيها الرسالة.


JavaScript code example showing how to send SMS notifications through Firebase and Bird integration, with template for restaurant table readiness alerts and delivery status monitoring.

إذا أدى إرسال رسالة إلى فشل، سيكون حقل الحالة ERROR، وسيتم تعبئة حقل الخطأ بسلسلة رسالة الخطأ.

كما أنه من الممكن ملاحظة الأخطاء من الإضافة والاستخدام عبر علامة وظائف السحابة في وحدة تحكم Firebase:


Firebase Cloud Functions dashboard showing the deployed MessageBird extension triggered by document writes to the messages collection.

التجربة لك ولعملائك

Restaurant waitlist form with MessageBird logo, requesting customer name, party size, and phone number to send table availability notifications.Confirmation page showing a customer named Jim has been added to the restaurant waitlist, with notification that an SMS will be sent when their table is ready.Restaurant staff interface showing waitlist with customers and their party sizes, where three parties have been notified and Jim's party of four is ready to be notified.Restaurant management interface showing all waitlisted customers have been notified, including Jim's party of four who was previously pending notification.Mobile phone screen showing an SMS notification from a restaurant informing Jim that his table is almost ready.
Restaurant waitlist form with MessageBird logo, requesting customer name, party size, and phone number to send table availability notifications.Confirmation page showing a customer named Jim has been added to the restaurant waitlist, with notification that an SMS will be sent when their table is ready.Restaurant staff interface showing waitlist with customers and their party sizes, where three parties have been notified and Jim's party of four is ready to be notified.Restaurant management interface showing all waitlisted customers have been notified, including Jim's party of four who was previously pending notification.Mobile phone screen showing an SMS notification from a restaurant informing Jim that his table is almost ready.
Restaurant waitlist form with MessageBird logo, requesting customer name, party size, and phone number to send table availability notifications.Confirmation page showing a customer named Jim has been added to the restaurant waitlist, with notification that an SMS will be sent when their table is ready.Restaurant staff interface showing waitlist with customers and their party sizes, where three parties have been notified and Jim's party of four is ready to be notified.Restaurant management interface showing all waitlisted customers have been notified, including Jim's party of four who was previously pending notification.Mobile phone screen showing an SMS notification from a restaurant informing Jim that his table is almost ready.

ابدأ مع إضافة Firebase الخاصة بـ Bird

الآن، لم تعد بحاجة إلى تكامل مباشر مع واجهة برمجة التطبيقات الخلفية للتفاعل مع واجهة برمجة تطبيقات الطيور.

يمكنك تبسيط التنفيذ عبر ملحق Firebase وجعل إرسال الإشعارات سهلاً مثل عمليات كتابة المستندات - بغض النظر عن قناة الاتصال التي ترغب في استخدامها.

هذا مجرد بداية لما يمكنك القيام به باستخدام الملحق وواجهتنا البرمجية.

نقدم العديد من القنوات ولدينا أيضًا محرر مرئي قوي للغاية في Flow Builder يتيح لك إنشاء تجارب ديناميكية أكثر. بالنسبة لحالات الاستخدام المتقدمة، يمكنك أيضًا دمج Flow Builder مع واجهات برمجة التطبيقات الخارجية مثل Google Vision API وCloud Functions لإضافة التعرف على الصور المدعوم بالذكاء الاصطناعي إلى تفاعلات عملائك. مع Flow Builder، يمكنك أيضًا أتمتة سير عمل CRM مثل إنشاء العملاء والموضوعات في Salesforce مباشرةً من تفاعلات العملاء.

بالإشارة إلى حالة الاستخدام أعلاه، سيسمح لك Flow Builder بإضافة ميزة الرد على الإشعارات المرسلة، مما يمكن العملاء من الرد بكلمة أو عبارة لإلغاء حجزهم. لكن هذا لمقالة مستقبلية! 🙂

إذا كنت لديك أي حالات استخدام أخرى تود استفسارها، فإن مهندسي الحلول لدينا هنا لمساعدتك. يرجى الاتصال بفريقنا وإعلامنا!

الآن، لم تعد بحاجة إلى تكامل مباشر مع واجهة برمجة التطبيقات الخلفية للتفاعل مع واجهة برمجة تطبيقات الطيور.

يمكنك تبسيط التنفيذ عبر ملحق Firebase وجعل إرسال الإشعارات سهلاً مثل عمليات كتابة المستندات - بغض النظر عن قناة الاتصال التي ترغب في استخدامها.

هذا مجرد بداية لما يمكنك القيام به باستخدام الملحق وواجهتنا البرمجية.

نقدم العديد من القنوات ولدينا أيضًا محرر مرئي قوي للغاية في Flow Builder يتيح لك إنشاء تجارب ديناميكية أكثر. بالنسبة لحالات الاستخدام المتقدمة، يمكنك أيضًا دمج Flow Builder مع واجهات برمجة التطبيقات الخارجية مثل Google Vision API وCloud Functions لإضافة التعرف على الصور المدعوم بالذكاء الاصطناعي إلى تفاعلات عملائك. مع Flow Builder، يمكنك أيضًا أتمتة سير عمل CRM مثل إنشاء العملاء والموضوعات في Salesforce مباشرةً من تفاعلات العملاء.

بالإشارة إلى حالة الاستخدام أعلاه، سيسمح لك Flow Builder بإضافة ميزة الرد على الإشعارات المرسلة، مما يمكن العملاء من الرد بكلمة أو عبارة لإلغاء حجزهم. لكن هذا لمقالة مستقبلية! 🙂

إذا كنت لديك أي حالات استخدام أخرى تود استفسارها، فإن مهندسي الحلول لدينا هنا لمساعدتك. يرجى الاتصال بفريقنا وإعلامنا!

الآن، لم تعد بحاجة إلى تكامل مباشر مع واجهة برمجة التطبيقات الخلفية للتفاعل مع واجهة برمجة تطبيقات الطيور.

يمكنك تبسيط التنفيذ عبر ملحق Firebase وجعل إرسال الإشعارات سهلاً مثل عمليات كتابة المستندات - بغض النظر عن قناة الاتصال التي ترغب في استخدامها.

هذا مجرد بداية لما يمكنك القيام به باستخدام الملحق وواجهتنا البرمجية.

نقدم العديد من القنوات ولدينا أيضًا محرر مرئي قوي للغاية في Flow Builder يتيح لك إنشاء تجارب ديناميكية أكثر. بالنسبة لحالات الاستخدام المتقدمة، يمكنك أيضًا دمج Flow Builder مع واجهات برمجة التطبيقات الخارجية مثل Google Vision API وCloud Functions لإضافة التعرف على الصور المدعوم بالذكاء الاصطناعي إلى تفاعلات عملائك. مع Flow Builder، يمكنك أيضًا أتمتة سير عمل CRM مثل إنشاء العملاء والموضوعات في Salesforce مباشرةً من تفاعلات العملاء.

بالإشارة إلى حالة الاستخدام أعلاه، سيسمح لك Flow Builder بإضافة ميزة الرد على الإشعارات المرسلة، مما يمكن العملاء من الرد بكلمة أو عبارة لإلغاء حجزهم. لكن هذا لمقالة مستقبلية! 🙂

إذا كنت لديك أي حالات استخدام أخرى تود استفسارها، فإن مهندسي الحلول لدينا هنا لمساعدتك. يرجى الاتصال بفريقنا وإعلامنا!

أخبار أخرى

اقرأ المزيد من هذه الفئة

A person is standing at a desk while typing on a laptop.

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.

A person is standing at a desk while typing on a laptop.

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.

A person is standing at a desk while typing on a laptop.

المنصة الكاملة المدعومة بالذكاء الاصطناعي التي تتوسع مع أعمالك.