Get started with the Bird extension on Firebase

• The Bird | Firebase Extension allows developers to send messages and notifications across SMS, WhatsApp, Messenger, Google Business Messages, Telegram, LINE, Viber, and more—directly from Firestore document writes.
• When a new document is added to the configured Firestore collection, the extension converts it into a readable message payload and sends it via Bird’s Conversations API, then updates the document with delivery status.
• This extension removes the need for a backend integration with Bird’s API, enabling teams to ship messaging features faster with minimal code.
• Firebase’s real-time and scalable infrastructure pairs with Bird’s global connectivity, ensuring reliable message delivery anywhere in the world.
• A sample use case demonstrates how restaurants can automate SMS notifications to customers waiting for tables—only requiring a Firestore write.
• Setup requires only a Bird API key and an SMS (or other channel) ID; configuration is done through Firebase’s extension installation wizard.
• Developers define the Firestore collection the extension listens to—every new document becomes a message trigger.
• After sending, the extension enriches the Firestore document with delivery data, status, and error messages if applicable.
• Security best practices are essential: Firestore rules must tightly restrict read/write access to prevent abuse or unauthorized message sending.
• Cloud Functions logs allow developers to inspect message failures, extension execution errors, and delivery outcomes.
• The extension works seamlessly with the broader Bird ecosystem, enabling future enhancements like AI-based flows, image recognition, or CRM automation.
• This integration creates a foundation for richer experiences, such as enabling customers to reply with keywords, building restaurant queue features, or connecting to external APIs via Flow Builder.

• What does the Bird Firebase extension do?It listens to changes in a Firestore collection and sends messages through Bird’s Conversations API whenever a new document is added.
• Which channels can the extension send messages through?SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber, and any other Bird-supported channels.
• Do I need a backend server to send messages?No. The extension handles all API interactions—messaging becomes as simple as writing a document to Firestore.
• What information is required from my Bird account?You’ll need your Bird API key and a channel ID (e.g., for SMS).
• How do I install the extension?Through the Firebase console → Extensions → Install "Send Messages with Bird," and then configure your API key and collection name.
• How does the extension know when to send a message?It monitors the specified Firestore collection and triggers whenever a new document is created.
• What does the message document format look like?A simple JSON containing the destination, channel ID, and message text (or payload for other channels).

What happens after a message is sent? The extension updates the Firestore document with delivery metadata like delivery.state, timestamps, and error details if applicable.

How can I check for errors? Errors appear in the updated Firestore document and also in the Cloud Functions logs within Firebase.

How do I secure my Firestore collection? Use Firestore security rules to restrict read/write access only to authorized users or service accounts.

Can I use this for advanced workflows? Yes—pair it with Flow Builder, external APIs, or machine-learning tools like Google Vision to build interactive, automated experiences.

What's a real-world example? A restaurant queue system that sends SMS notifications when a table is ready—triggered simply by adding a Firestore document.

• Can I use this extension for more advanced workflows? Yes — you can pair it with Flow Builder, external APIs, or machine-learning tools like Google Vision to build interactive, automated experiences.
• What’s a real-world example of using this extension? A restaurant queue system that sends SMS notifications when a table is ready — triggered simply by adding a Firestore document.

This extension connects Firebase to Bird’s omnichannel messaging APIs, allowing you to send messages via simple Firestore writes.

The Bird extension on Firebase connects you to the world’s largest omnichannel portfolio to deliver messages and notifications on all of your customers’ preferred channels. Powered by Bird’s global connectivity, this means you can reach your customers quickly — and anywhere in the world!

To further streamline the process, when you add a document to a specific Firebase collection, the extension will utilize Bird’s Conversations API to convert that document into readable text and update the document with the delivery status.

How the Bird Firebase extension works

In this article, you will learn how you can get sending in just a few steps!

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

When I heard that my colleagues worked on creating a Firebase extension that would allow you to easily integrate message sending in your app, I had to take it for a spin and build something with it.

***Note: *You can find the Bird extension on Firebase here.

To bring the extension into context, we will consider a small example app for managing a queue at a restaurant.

The restaurant owner or host can register customers on the web UI or the customers can register themselves. When their table is ready, with just a click of a button from a restaurant employee, a notification will be sent to the customer to return to the restaurant.

While there are many ways to build a system for notifying users, the best solutions alleviate as much work as possible for the customers. This helps businesses provide their customers an excellent experience.

That is why we will utilize the new Bird | Firebase extension to ensure customers are notified through an SMS. This way, customers can enjoy their waiting time and not stress about missing out, while also making it easier for restaurant staff to manage the queue.

While this example sends a SMS notification, within the extension you can use whichever channel your customer prefers (WhatsApp, Google’s Business Messages, Facebook Messenger, Telegram, Line, Viber, etc.) so you can adapt the notification to the customer's preferences.

In this example, we will assume you have a Firebase and Bird account.

Prerequisites If you don't have a Bird account, you can create one here.

Required setup components before installation

To begin, it requires information from your Bird account.

First, you will need your API key to allow the Firebase extension to interact with the Bird API on your behalf. You can find your API key in the Bird API settings. Second, you will need an SMS number and an installed SMS channel. If you do not have a Channel ID already, navigate to the SMS channel setup page to get one.

Install the Firebase extension Once you have both your API key and an SMS Channel ID, return to your Firebase console and navigate to the Extensions tab.

From here, install the [Send Messages with Bird] Firebase extension.

The messages collection that we configured during setup will store all your messages. To send an SMS message, you will need to add a document to the collection you named in the wizard using this format:

Message document format

*Once the document is added to the collection, the Bird extension will then interact with the Bird API and update the document with extra fields as below. The delivery.state field below depicts the different statuses the message can be in.

If sending a message results in a failure, the state field will be ERROR, and the error field will be populated with an error message string.

It is also possible to observe errors from the extension and usage via in the Cloud functions tab in the Firebase console:

The messages* collection that we configured during setup will store all your messages. To send an SMS message, you will need to add a document to the collection you named in the wizard using this format:

Message document format

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

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..

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.

Now, you no longer require a direct backend API integration to interact with the Bird API.

You can streamline the implementation via the Firebase extension and make sending notifications as simple as document write operations — no matter the communication channel you want to use.

This is only scratching the surface of what you can do with the extension and our API.

We offer many channels and we also have an incredibly powerful visual editor inFlow Builder that allows you to create even more dynamic experiences. For advanced use cases, you can even integrate Flow Builder with external APIs like Google Vision API and Cloud Functions to add AI-powered image recognition to your customer interactions. With Flow Builder, you can also automate CRM workflows like creating leads and cases in Salesforce directly from customer interactions.

Following the use case above, Flow Builder would allow you to add a reply feature to the notifications sent, which enables the customer to reply with a keyword or phrase to cancel their reservation. But that’s for a future article! 🙂

If you have any other use cases that you would be interested in, our solution engineers are here to help you. Please contact our team and let us know!

Read more from this category

Mar 31, 2025Building AI Chatbots That Customers Actually Want to Use