Inizia con l'estensione Bird su Firebase
Uccello
1 giu 2021
Estensione Firebase
1 min read
Punti Chiave
Il Bird | Firebase Extension consente agli sviluppatori di inviare messaggi e notifiche tramite SMS, WhatsApp, Messenger, Google Business Messages, Telegram, LINE, Viber e altro—direttamente dalla scrittura dei documenti di Firestore.
Quando un nuovo documento viene aggiunto alla collezione Firestore configurata, l'estensione lo converte in un payload di messaggio leggibile e lo invia tramite l'API delle Conversazioni di Bird, quindi aggiorna il documento con lo stato di consegna.
Questa estensione rimuove la necessità di un'integrazione backend con l'API di Bird, consentendo ai team di fornire funzionalità di messaggistica più rapidamente con codice minimalista.
L'infrastruttura scalabile e in tempo reale di Firebase si abbina alla connettività globale di Bird, garantendo una consegna affidabile dei messaggi ovunque nel mondo.
Un caso d'uso di esempio dimostra come i ristoranti possano automatizzare le notifiche SMS ai clienti in attesa di tavoli—richiedendo solo una scrittura su Firestore.
La configurazione richiede solo una chiave API di Bird e un ID SMS (o di altro canale); la configurazione avviene tramite la procedura guidata di installazione dell'estensione di Firebase.
Gli sviluppatori definiscono la collezione Firestore a cui l'estensione si registra—ogni nuovo documento diventa un attivatore di messaggio.
Dopo l'invio, l'estensione arricchisce il documento Firestore con dati di consegna, stato e messaggi di errore se applicabile.
Le migliori pratiche di sicurezza sono fondamentali: le regole di Firestore devono limitare strettamente l'accesso in lettura/scrittura per prevenire abusi o invio non autorizzato di messaggi.
I log delle Cloud Functions consentono agli sviluppatori di ispezionare i guasti nei messaggi, gli errori nell'esecuzione dell'estensione e gli esiti della consegna.
L'estensione funziona perfettamente con il più ampio ecosistema di Bird, consentendo futuri miglioramenti come flussi basati sull'IA, riconoscimento delle immagini o automazione CRM.
Questa integrazione crea una base per esperienze più ricche, consentendo ai clienti di rispondere con parole chiave, costruire funzionalità per le code dei ristoranti o collegarsi a API esterne tramite Flow Builder.
Punti salienti del Q&A
Cosa fa l'estensione Bird Firebase?
Ascolta le modifiche in una raccolta Firestore e invia messaggi attraverso l'API delle Conversazioni di Bird ogni volta che viene aggiunto un nuovo documento.
Quali canali può utilizzare l'estensione per inviare messaggi?
SMS, WhatsApp, Facebook Messenger, Google Business Messages, Telegram, LINE, Viber e qualsiasi altro canale supportato da Bird.
Ho bisogno di un server backend per inviare messaggi?
No. L'estensione gestisce tutte le interazioni API: inviare messaggi diventa semplice come scrivere un documento su Firestore.
Quali informazioni sono necessarie dal mio account Bird?
Avrai bisogno della tua chiave API di Bird e di un ID canale (ad es. per SMS).
Come posso installare l'estensione?
Attraverso la console di Firebase → Estensioni → Installa “Invia Messaggi con Bird,” e poi configura la tua chiave API e il nome della collezione.
Come fa l'estensione a sapere quando inviare un messaggio?
Monitora la collezione Firestore specificata e si attiva ogni volta che viene creato un nuovo documento.
Come appare il formato del documento del messaggio?
Un semplice JSON che contiene la destinazione, l'ID del canale e il testo del messaggio (o payload per altri canali).
Cosa succede dopo che un messaggio è inviato?
L'estensione aggiorna il documento Firestore con i metadati di consegna come delivery.state, timestamp e dettagli sugli errori (se presenti).
Come posso controllare gli errori?
Si verificano errori nel documento Firestore aggiornato e anche nei registri delle Cloud Functions all'interno di Firebase.
Come posso proteggere la mia collezione Firestore?
Utilizza le regole di sicurezza di Firestore per limitare l'accesso in lettura/scrittura solo agli utenti o agli account di servizio autorizzati.
Posso usare questa estensione per flussi di lavoro più avanzati?
Sì — puoi abbinarlo a Flow Builder, API esterne o strumenti di machine learning come Google Vision per creare esperienze interattive e automatizzate.
Qual è un esempio del mondo reale dell'utilizzo di questa estensione?
Un sistema di gestione delle code per ristoranti che invia notifiche SMS quando un tavolo è pronto, attivato semplicemente aggiungendo un documento Firestore.
