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

امتداد Firebase

1 min read

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

امتداد Firebase

1 min read

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

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

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

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

إرسال الرسائل والإشعارات مع Bird

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

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


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

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

مثال على حالة استخدام

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

ملاحظة: يمكنك العثور على امتداد Bird على Firebase هنا.

لإدخال الامتداد في السياق، سننظر في تطبيق مثالي صغير لإدارة الطوابير في مطعم.

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

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

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

بينما يرسل هذا المثال إشعارًا عبر SMS، داخل الامتداد يمكنك استخدام أي قناة يفضلها العميل (WhatsApp، رسائل Google للأعمال، فيسبوك ماسنجر، تيليجرام، لاين، فايبر، إلخ) بحيث يمكنك تكييف الإشعار حسب تفضيلات العميل.

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

ملاحظة: يمكنك العثور على امتداد Bird على Firebase هنا.

لإدخال الامتداد في السياق، سننظر في تطبيق مثالي صغير لإدارة الطوابير في مطعم.

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

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

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

بينما يرسل هذا المثال إشعارًا عبر SMS، داخل الامتداد يمكنك استخدام أي قناة يفضلها العميل (WhatsApp، رسائل Google للأعمال، فيسبوك ماسنجر، تيليجرام، لاين، فايبر، إلخ) بحيث يمكنك تكييف الإشعار حسب تفضيلات العميل.

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

ملاحظة: يمكنك العثور على امتداد Bird على Firebase هنا.

لإدخال الامتداد في السياق، سننظر في تطبيق مثالي صغير لإدارة الطوابير في مطعم.

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

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

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

بينما يرسل هذا المثال إشعارًا عبر SMS، داخل الامتداد يمكنك استخدام أي قناة يفضلها العميل (WhatsApp، رسائل Google للأعمال، فيسبوك ماسنجر، تيليجرام، لاين، فايبر، إلخ) بحيث يمكنك تكييف الإشعار حسب تفضيلات العميل.

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

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

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

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

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

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

من هنا، قم بتثبيت ملحق Firebase [Send Messages with Bird].

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 داخل وحدة تحكم Firebase. ثم أضف معرف مجموعة يطابق اسم المجموعة الذي استخدمته عند تثبيت الامتداد.

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

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

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

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


بمجرد إضافة المستند إلى المجموعة، ستتفاعل إضافة Bird بعد ذلك مع Bird API وتحدث المستند بحقول إضافية كما هو موضح أدناه. يوضح الحقل 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.


إذا نتج عن إرسال رسالة فشل، سيكون الحقل state هو ERROR، وسيتم ملء الحقل 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.

قم بتثبيت امتداد Bird Firebase للتواصل مع عملائك - أسهل من أي وقت مضى

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

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

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

نحن نقدم العديد من القنوات ولدينا أيضًا محرر مرئي قوي للغاية في Flow Builder الذي يسمح لك بإنشاء تجارب أكثر ديناميكية.

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

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

انضم إلى نشرتنا الإخبارية.

ابقَ على اطلاع مع Bird من خلال التحديثات الأسبوعية إلى بريدك الوارد.

بتقديمك طلبًا، فإنك توافق على أن تقوم Bird بالاتصال بك بشأن منتجاتنا وخدماتنا.

يمكنك إلغاء الاشتراك في أي وقت. انظر بيان الخصوصية الخاص بـ Bird للتفاصيل حول معالجة البيانات.

انضم إلى نشرتنا الإخبارية.

ابقَ على اطلاع مع Bird من خلال التحديثات الأسبوعية إلى بريدك الوارد.

بتقديمك طلبًا، فإنك توافق على أن تقوم Bird بالاتصال بك بشأن منتجاتنا وخدماتنا.

يمكنك إلغاء الاشتراك في أي وقت. انظر بيان الخصوصية الخاص بـ Bird للتفاصيل حول معالجة البيانات.

انضم إلى نشرتنا الإخبارية.

ابقَ على اطلاع مع Bird من خلال التحديثات الأسبوعية إلى بريدك الوارد.

بتقديمك طلبًا، فإنك توافق على أن تقوم Bird بالاتصال بك بشأن منتجاتنا وخدماتنا.

يمكنك إلغاء الاشتراك في أي وقت. انظر بيان الخصوصية الخاص بـ Bird للتفاصيل حول معالجة البيانات.