Noteecast Developer
Le contenu de cette page s'adresse avant tout aux développeu(r•se)s 👨💻👩💻 d'apps et donne la marche à suivre pour intégrer Noteecast. Si vous êtes propriétaire d'une app et que vous souhaitez intégrer Noteecast, faites-le savoir à votre développeu(r•se) en lui partageant cette page !
Introduction
Noteecast est un environnement de confiance qui permet de gérer très facilement les notifications d'apps tierces iOS, Android et Web en s'appuyant soit sur l'Apple Push Notification service (APNs) soit sur les services de Firebase et plus particulièrement sur la solution de messagerie multiplateforme Firebase Cloud Messaging (FCM).
Noteecast est composé d’un trio indissociable d'éléments avec :
- Un serveur d’apps Noteecast Hosting.
- Une API REST Noteecast Connect.
- Une app Noteecast Go disponible au téléchargement dans l'App Store, le Mac App Store (nécessite un Mac avec la puce Apple M1) et sur Google Play.
Principe de fonctionnement
Les notifications locales et push sont idéales pour tenir les utilisateurs informés avec du contenu opportun et pertinent, que l'app soit active, en arrière-plan ou fermée.
Lorsque vous envoyez une notification aux utilisateurs de votre app, vous ne l'envoyez pas directement à chaque utilisateur mais à un service qui se charge ensuite de la diffuser auprès des différents appareils. C'est ce rôle que joue l'APNs ou la solution multiplateforme FCM. L'APNs est une solution développée par Apple et disponible uniquement pour les appareils de la même marque (iPhone, iPad, ...) alors que FCM est une solution développée par Google et multiplateforme (Apple, Android, ...).
Pour que votre app puisse communiquer avec FCM, elle doit impérativement implémenter le SDK FCM conformément aux instructions de configuration de la plateforme utilisée pour votre développement.
- Plateforme iOS (Objective-C, Swift), Android (Java, Kotlin), C++, Unity et Web.
- Plateforme React Native.
- Plateforme Flutter.
Une fois votre app disponible dans les stores, lorsqu'un utilisateur la télécharge, l'installe et l'exécute pour la première fois sur son appareil, elle s'enregistre automatiquement auprès de l'APNs ou FCM qui génère et lui envoie un identifiant unique que l'on appelle jeton (ou token) qu'il faut immédiatement inscrire dans Noteecast Hosting. Comment ? En implémentant l'API REST Noteecast Connect à votre app. Ce jeton est un élément indispensable pour pouvoir notifier l'utilisateur.
Par la suite, l'app Noteecast Go vous permettra d'envoyer des notifications à l'ensemble de vos utilisateurs en récupérant les jetons présents dans Noteecast Hosting.
L'illustration ci-dessous schématise le fonctionnement complet, depuis l'enregistrement de votre app auprès de FCM jusqu'à la réception d'une notification (le fonctionnement est identique pour l'APNs).
Découvrons maintenant les étapes à suivre pour ajouter Noteecast à votre app.
Noteecast Hosting > Créer un espace privé pour votre app
La première étape consiste à créer un espace privé pour votre app dans Noteecast Hosting.
Noteecast Connect > Faites appel à l'API REST
La deuxième étape consiste à faire appel à Noteecast Connect. Noteecast Connect est une API REST publique accessible via le protocole HTTP. Elle est la passerelle entre votre app et Noteecast Hosting et va vous permettre d'y inscrire des jetons générés par l'APNs ou FCM.
Noteecast Go > Envoyez votre première notification
La troisième et dernière étape consiste à réaliser un test en envoyant votre première notification à l'aide de l'app Noteecast Go.
Pour aller plus loin
Nous vous proposons une dernière partie pour vous apporter des connaissances supplémentaires afin d'enrichir votre expérience avec Noteecast.
> Enrichissez votre expérience !
That's all Folks!
Ce tutoriel est maintenant terminé. Contactez-nous si vous avez des questions, nous nous ferons un plaisir de vous répondre !