¿Qué hace la extensión Bird Firebase?

Escucha los cambios en una colección de Firestore y envía mensajes a través de la API de Conversaciones de Bird cada vez que se agrega un nuevo documento.

¿A través de qué canales puede enviar mensajes la extensión?

SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber y cualquier otro canal compatible con Bird.

¿Necesito un servidor backend para enviar mensajes?

No. La extensión maneja todas las interacciones de API — enviar mensajes se vuelve tan simple como escribir un documento en Firestore.

¿Qué información se requiere de mi cuenta de Bird?

Necesitarás tu clave de API de Bird y un ID de canal (por ejemplo, para SMS).

¿Cómo instalo la extension?

A través de la consola de Firebase → Extensiones → Instalar “Send Messages with Bird,” y luego configurar tu clave de API y nombre de colección.

¿Cómo sabe la extensión cuándo enviar un mensaje?

Monitorea la colección de Firestore especificada y se activa cada vez que se crea un nuevo documento.

¿Cómo es el formato del documento del mensaje?

Un JSON simple que contiene el destino, el ID del canal y el texto del mensaje (o carga útil para otros canales).

¿Qué ocurre después de que se envía un mensaje?

La extensión actualiza el documento de Firestore con metadatos de entrega, como delivery.state, marcas de tiempo y detalles del error (si los hay).

¿Cómo puedo verificar errores?

Los errores aparecen en el documento actualizado de Firestore y también en los registros de Cloud Functions dentro de Firebase.

¿Cómo aseguro mi colección de Firestore?

Utilice las reglas de seguridad de Firestore para restringir el acceso de lectura/escritura solo a usuarios autorizados o cuentas de servicio.

¿Puedo usar esta extensión para flujos de trabajo más avanzados?

Sí — puedes combinarlo con Flow Builder, APIs externas o herramientas de aprendizaje automático como Google Vision para crear experiencias interactivas y automatizadas.

¿Cuál es un ejemplo del mundo real de usar esta extensión?

Un sistema de cola de restaurante que envía notificaciones por SMS cuando una mesa está lista — activado simplemente al agregar un documento de Firestore.

Comienza con la extensión Bird en Firebase

Pájaro

1 jun 2021

Extensión de Firebase

1 min read

Comienza con la extensión Bird en Firebase

Puntos clave

- El Bird | Firebase Extension permite a los desarrolladores enviar mensajes y notificaciones a través de SMS, WhatsApp, Messenger, Google Business Messages, Telegram, LINE, Viber y más—directamente desde escrituras de documentos de Firestore.
- Cuando se añade un nuevo documento a la colección de Firestore configurada, la extensión lo convierte en una carga de mensaje legible y lo envía a través de Bird’s Conversations API, luego actualiza el documento con el estado de entrega.
- Esta extensión elimina la necesidad de una integración de backend con Bird’s API, lo que permite a los equipos lanzar características de mensajería más rápido con un código mínimo.
- La infraestructura en tiempo real y escalable de Firebase se combina con la conectividad global de Bird, asegurando una entrega de mensajes confiable en cualquier parte del mundo.
- Un caso de uso de muestra demuestra cómo los restaurantes pueden automatizar las notificaciones por SMS a clientes que esperan mesas—requiriendo solo una escritura de Firestore.
- La configuración solo requiere una clave de la Bird API y un ID de SMS (u otro canal); la configuración se realiza a través del asistente de instalación de la extensión de Firebase.
- Los desarrolladores definen la colección de Firestore a la que la extensión escucha—cada nuevo documento se convierte en un desencadenante de mensaje.
- Después de enviar, la extensión enriquece el documento de Firestore con datos de entrega, estado y mensajes de error si es aplicable.
- Las mejores prácticas de seguridad son esenciales: las reglas de Firestore deben restringir estrictamente el acceso de lectura/escritura para prevenir el abuso o el envío no autorizado de mensajes.
- Los registros de Cloud Functions permiten a los desarrolladores inspeccionar fallas de mensajes, errores de ejecución de la extensión y resultados de entrega.
- La extensión funciona sin problemas con el ecosistema más amplio de Bird, permitiendo mejoras futuras como flujos basados en IA, reconocimiento de imágenes o automatización de CRM.
- Esta integración crea una base para experiencias más enriquecedoras, como permitir que los clientes respondan con palabras clave, construir características de cola de restaurante o conectarse a APIs externas a través de Flow Builder.

Destacados de Q&A

¿Qué hace la extensión Bird Firebase?
Escucha los cambios en una colección de Firestore y envía mensajes a través de la API de Conversaciones de Bird cada vez que se agrega un nuevo documento.
¿A través de qué canales puede enviar mensajes la extensión?
SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber y cualquier otro canal compatible con Bird.
¿Necesito un servidor backend para enviar mensajes?
No. La extensión maneja todas las interacciones de API — enviar mensajes se vuelve tan simple como escribir un documento en Firestore.
¿Qué información se requiere de mi cuenta de Bird?
Necesitarás tu clave de API de Bird y un ID de canal (por ejemplo, para SMS).
¿Cómo instalo la extension?
A través de la consola de Firebase → Extensiones → Instalar “Send Messages with Bird,” y luego configurar tu clave de API y nombre de colección.
¿Cómo sabe la extensión cuándo enviar un mensaje?
Monitorea la colección de Firestore especificada y se activa cada vez que se crea un nuevo documento.
¿Cómo es el formato del documento del mensaje?
Un JSON simple que contiene el destino, el ID del canal y el texto del mensaje (o carga útil para otros canales).
¿Qué ocurre después de que se envía un mensaje?
La extensión actualiza el documento de Firestore con metadatos de entrega, como delivery.state, marcas de tiempo y detalles del error (si los hay).
¿Cómo puedo verificar errores?
Los errores aparecen en el documento actualizado de Firestore y también en los registros de Cloud Functions dentro de Firebase.
¿Cómo aseguro mi colección de Firestore?
Utilice las reglas de seguridad de Firestore para restringir el acceso de lectura/escritura solo a usuarios autorizados o cuentas de servicio.
¿Puedo usar esta extensión para flujos de trabajo más avanzados?
Sí — puedes combinarlo con Flow Builder, APIs externas o herramientas de aprendizaje automático como Google Vision para crear experiencias interactivas y automatizadas.
¿Cuál es un ejemplo del mundo real de usar esta extensión?
Un sistema de cola de restaurante que envía notificaciones por SMS cuando una mesa está lista — activado simplemente al agregar un documento de Firestore.

Firebase te permite desarrollar e implementar rápidamente aplicaciones de alta calidad, junto con funcionalidades extendidas que te permiten optimizar y escalar continuamente tu aplicación. Firebase también aloja extensiones de código abierto preempaquetadas para ayudarte a automatizar tareas comunes de desarrollo.

Hoy, estamos emocionados de discutir la extensión Bird | Firebase.

Enviar mensaje y notificaciones con Bird

La extensión de Bird en Firebase te conecta con el portafolio omnicanal más grande del mundo para entregar mensajes y notificaciones en todos los canales preferidos de tus clientes. Impulsado por la conectividad global de Bird, esto significa que puedes alcanzar a tus clientes rápidamente — y en cualquier parte del mundo!

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

Para simplificar aún más el proceso, cuando agregas un documento a una colección específica de Firebase, la extensión utilizará el Conversations API de Bird para convertir ese documento en texto legible y actualizar el documento con el estado de entrega.

En este artículo, aprenderás cómo puedes empezar a enviar en tan solo unos pocos pasos.

Un ejemplo de uso

Cuando escuché que mis colegas trabajaron en la creación de una extensión de Firebase que te permitiría integrar fácilmente el envío de mensajes en tu aplicación, tuve que probarla y construir algo con ella.

Nota: Puedes encontrar la extensión de Bird en Firebase aquí.

Para contextualizar la extensión, consideraremos una pequeña aplicación de ejemplo para gestionar una cola en un restaurante.

El propietario o anfitrión del restaurante puede registrar clientes en la interfaz web o los clientes pueden registrarse ellos mismos. Cuando su mesa está lista, con solo un clic de un botón por parte de un empleado del restaurante, se enviará una notificación al cliente para que regrese al restaurante.

Aunque hay muchas formas de construir un sistema para notificar a los usuarios, las mejores soluciones alivian tanto trabajo como sea posible para los clientes. Esto ayuda a los negocios a ofrecer a sus clientes una experiencia excelente.

Es por eso que utilizaremos la nueva extensión Bird | Firebase para asegurar que los clientes sean notificados a través de un SMS. De esta manera, los clientes pueden disfrutar de su tiempo de espera y no estresarse por perderse algo, mientras que también facilita al personal del restaurante gestionar la cola.

Aunque este ejemplo envía una notificación por SMS, dentro de la extensión puedes usar el canal que prefiera tu cliente (WhatsApp, Google’s Business Messages, Facebook Messenger, Telegram, Line, Viber, etc.) para que puedas adaptar la notificación a las preferencias del cliente.

Nota: Puedes encontrar la extensión de Bird en Firebase aquí.

Para contextualizar la extensión, consideraremos una pequeña aplicación de ejemplo para gestionar una cola en un restaurante.

Nota: Puedes encontrar la extensión de Bird en Firebase aquí.

Para contextualizar la extensión, consideraremos una pequeña aplicación de ejemplo para gestionar una cola en un restaurante.

Cómo empezar

En este ejemplo, asumiremos que tienes una cuenta de Firebase y Bird.

Si no tienes una cuenta de Bird, puedes crear una aquí.

Para comenzar, se requiere información de tu cuenta de Bird.

Primero, necesitarás tu clave API para permitir que la extensión de Firebase interactúe con la API de Bird en tu nombre. Puedes encontrar tu clave API en los ajustes de Bird API. Segundo, necesitarás un número de SMS y un canal de SMS instalado. Si aún no tienes un ID de Canal, navega a la página de configuración del canal SMS para obtener uno.

Una vez que tengas tanto tu clave API como un ID de Canal de SMS, vuelve a tu consola de Firebase y navega a la pestaña de Extensiones.

Desde aquí, instala la extensión de 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.

Durante el asistente de instalación, se te pedirá que añadas tu clave API y un nombre de colección a usar.

El nombre de la colección será escuchado por la extensión de Firebase.

Cuando se añade un documento a la colección, activará la extensión.

En el fondo, la extensión es una Cloud Function, que escucha los cambios en la colección especificada, lee el documento añadido e interactúa con la API de Bird para enviar el mensaje.

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

Una vez que la instalación de tu extensión esté completa, navega a Firestore dentro de la consola de Firebase. Luego, añade un ID de colección que coincida con el nombre de la colección que usaste al instalar la extensión.

Nota: Es muy importante restringir quién puede escribir y leer en esta colección. Si la colección se deja abierta, terceros podrían ser capaces de leer los números de los usuarios e incluso enviar mensajes con tu cuenta. Recomendamos usar las reglas de seguridad de Firestore para que solo usuarios específicos tengan estos privilegios y seguir todas las mejores prácticas de seguridad establecidas por el equipo de Firebase.