Firebase stelt je in staat om snel hoogwaardige apps te ontwikkelen en implementeren, in combinatie met uitgebreide functionaliteiten waarmee je je app continu kunt optimaliseren en opschalen. Firebase host ook vooraf verpakte, open-source extensies om je te helpen bij het automatiseren van veelvoorkomende ontwikkelingstaken.

Vandaag zijn we enthousiast om de Bird | Firebase-extensie te bespreken.

Stuur berichten en meldingen met Bird

De Bird-extensie op Firebase verbindt je met 's werelds grootste omnichannel portfolio om berichten en meldingen te versturen op al je klanten hun voorkeurskanalen. Aangedreven door de wereldwijde connectiviteit van Bird, betekent dit dat je je klanten snel kunt bereiken — overal ter wereld! 

Om het proces verder te stroomlijnen, wanneer je een document toevoegt aan een specifieke Firebase-collectie, zal de extensie de Bird’s Conversations API gebruiken om dat document om te zetten in leesbare tekst en het document bij te werken met de bezorgstatus.

In dit artikel leer je hoe je in een paar stappen kunt beginnen met verzenden!

Een voorbeeld gebruiksscenario

Toen ik hoorde dat mijn collega's werkten aan het creëren van een Firebase-extensie waarmee je eenvoudig berichten kunt integreren in je app, moest ik het uitproberen en er iets mee bouwen.

Opmerking: Je kunt de Bird-extensie op Firebase hier vinden.

Om de extensie in context te brengen, overwegen we een kleine voorbeeldapp voor het beheren van een wachtrij in een restaurant.

De restauranteigenaar of gastheer kan klanten registreren op de webinterface of de klanten kunnen zichzelf registreren. Wanneer hun tafel gereed is, met slechts een druk op de knop van een restaurantmedewerker, zal er een melding verstuurd worden naar de klant om terug te keren naar het restaurant.

Hoewel er veel manieren zijn om een systeem voor het informeren van gebruikers te bouwen, de beste oplossingen verlichten zoveel mogelijk werk voor de klanten. Dit helpt bedrijven om hun klanten een uitstekende ervaring te bieden.

Daarom zullen we gebruik maken van de nieuwe Bird | Firebase-extensie om ervoor te zorgen dat klanten via een sms worden geïnformeerd. Op deze manier kunnen klanten genieten van hun wachttijd zonder zich zorgen te maken dat ze iets missen, en het maakt het ook gemakkelijker voor het restaurantpersoneel om de wachtrij te beheren.

Hoewel dit voorbeeld een sms-melding verzendt, kun je binnen de extensie elk kanaal gebruiken dat je klant verkiest (WhatsApp, Google’s Business Messages, Facebook Messenger, Telegram, Line, Viber, enz.) zodat je de melding kunt aanpassen aan de voorkeuren van de klant.

Hoe op te zetten

In dit voorbeeld gaan we ervan uit dat je een Firebase- en Bird-account hebt.

Als je geen Bird-account hebt, kun je er een aanmaken hier.

Om te beginnen heb je informatie van je Bird-account nodig.

Eerst heb je je API-sleutel nodig om de Firebase-extensie namens jou te laten communiceren met de Bird API. Je kunt de API-sleutel hier vinden. Ten tweede heb je een sms-nummer en een geïnstalleerd sms-kanaal nodig. Als je nog geen Channel ID hebt, ga hier om er een te krijgen.

Zodra je zowel je API-sleutel als een SMS Channel ID hebt, keer terug naar je Firebase-console en ga naar het Extensions-tabblad.

Vanaf hier installeer de [Verstuur Berichten met Bird] Firebase-extensie.

Tijdens de installatiewizard word je gevraagd om je API-sleutel en een collectie naam in te vullen om te gebruiken.

De collectie naam zal worden beluisterd door de Firebase-extensie.

Wanneer een document aan de collectie wordt toegevoegd, zal het de extensie activeren.

Onder de motorkap is de extensie een Cloud Function, die luistert naar veranderingen in de opgegeven collectie, het toegevoegde document leest en communiceert met de Bird API om het bericht te verzenden.

Zodra je extensie-installatie is voltooid, navigeer naar Firestore binnen de Firebase-console. Voeg vervolgens een collectie-ID toe die overeenkomt met de collectie naam die je hebt gebruikt bij het installeren van de extensie.

Opmerking: Het is erg belangrijk om te beperken wie er kan schrijven en lezen naar deze collectie. Als de collectie open blijft, kunnen derden mogelijk de nummers van gebruikers lezen en zelfs berichten verzenden met je account. We raden aan om de Firestore-beveiligingsregels te gebruiken zodat alleen specifieke gebruikers deze privileges hebben en om alle best practices op het gebied van beveiliging die door het Firebase-team worden aanbevolen, op te volgen.

Hoe berichten te verzenden

De berichten collectie die we tijdens de setup hebben geconfigureerd, slaat al je berichten op. Om een sms-bericht te sturen, moet je een document toevoegen aan de collectie die je in de wizard hebt benoemd, gebruikmakend van dit formaat:

Zodra het document is toegevoegd aan de collectie, zal de Bird-extensie vervolgens communiceren met de Bird API en het document bijwerken met extra velden zoals hieronder. Het veld delivery.state hieronder toont de verschillende statussen waarin het bericht kan verkeren.

Als het verzenden van een bericht mislukt, zal het statusveld ERROR zijn en zal het foutveld gevuld worden met een foutberichtstring.

Het is ook mogelijk om fouten van de extensie te observeren en gebruik te maken van de Cloud Functions-tab in de Firebase-console:

De ervaring voor jou en je klanten

Installeer de Bird Firebase-extensie om gemakkelijker dan ooit met je klanten te communiceren

Je hebt nu geen directe backend API-integratie meer nodig om met de Bird API te communiceren.

Je kunt via de Firebase-extensie de implementatie stroomlijnen en het verzenden van meldingen zo eenvoudig als documentenschrijfoperaties maken — ongeacht het communicatiemiddel dat je wilt gebruiken.

Dit is slechts een begin van wat je kunt doen met de extensie en onze API.

We bieden veel kanalen aan en we hebben ook een ongelooflijk krachtige visuele editor in Flow Builder waarmee je nog dynamischere ervaringen kunt creëren.

Volgens het bovenstaande gebruiksscenario zou Flow Builder je in staat stellen om een antwoordfunctie toe te voegen aan de verzonden meldingen, waarmee de klant kan reageren met een trefwoord of zin om hun reservering te annuleren. Maar dat is voor een toekomstig artikel! 🙂

Als je andere gebruiksscenario's hebt waarin je geïnteresseerd bent, staan onze oplossingsingenieurs klaar om je te helpen. Neem contact op met ons team hier en laat het ons weten!