Intégrations

Ce que contient l'onglet#

Dans le tableau de bord, sous Réglages, onglet Intégrations, se trouve tout ce qui, en dehors de Flavoso, travaille avec votre établissement. Tout en haut, une ligne montre d'un coup d'œil ce qui est connecté en ce moment.

En dessous, chaque connexion a son propre bloc :

• Paiement en ligne : les comptes de paiement par lesquels les clients paient en ligne. À partir de Pro.
• Imprimante de tickets : une imprimante en cuisine qui sort chaque nouvelle commande sur un ticket. À partir de Pro.
• Commandes par e-mail : chaque nouvelle commande part en plus vers une adresse e-mail. Dans toutes les offres.
• Applications connectées : les logiciels qui travaillent avec votre établissement, par exemple un système de caisse. Dans toutes les offres.
• Vos propres webhooks pour vos propres systèmes. Dans toutes les offres, propriétaire uniquement.

Paiement en ligne#

Dans le bloc « Paiement en ligne », vous connectez votre compte de paiement et l'activez pour les clients. L'argent va directement sur le compte de votre établissement ; Flavoso n'est jamais le bénéficiaire. Le paiement en ligne fait partie de l'offre Pro et au-delà.

La connexion, étape par étape, est décrite au chapitre « Paiement ».

Imprimante de tickets#

Dans le bloc « Imprimante de tickets », vous configurez une imprimante en cuisine qui sort chaque nouvelle commande sur un ticket. Il faut une imprimante réseau qui parle Star CloudPRNT ou Epson Server Direct Print. À partir de Pro.

La configuration en détail se trouve au chapitre « Écran de cuisine », sous « Une imprimante plutôt qu'un écran ».

Commandes par e-mail#

Chaque nouvelle commande part en plus vers une adresse e-mail, par exemple celle de la cuisine. C'est inclus dans toutes les offres.

Vous saisissez l'adresse dans le bloc « Commandes par e-mail », ou directement dans l'assistant de configuration. Les commandes payées en ligne ne partent qu'une fois le paiement confirmé.

Connecter des applications#

Tout logiciel peut se connecter à votre établissement via l'API ouverte de Flavoso, si vous y consentez : un système de caisse, un logiciel de livraison ou de comptabilité. Si un système donné le prend en charge, son éditeur peut vous le dire.

Tout commence dans l'autre logiciel, et seul un propriétaire de l'établissement peut connecter une application. Aucune clé à recopier : vous vous connectez et vous donnez votre accord.

Une application ne peut être connectée à votre établissement qu'une fois que Flavoso l'a vérifiée et validée. Elle porte alors « Vérifiée par Flavoso ». D'ici là, seul son développeur la connecte, à son établissement de test et aux établissements dont il est lui-même propriétaire.

Les applications vérifiées figurent dans l'annuaire des applications : dans le tableau de bord sous Réglages, onglet Intégrations, et publiquement sur flavoso.com/fr/integrations. La connexion se fait toujours depuis l'application elle-même ; l'annuaire y mène.

Après la connexion, tous les propriétaires de l'établissement reçoivent un e-mail : quelle application, quel éditeur, quelles autorisations, qui l'a connectée et quand. Il contient le bouton « Gérer les applications connectées ».

Une application ne voit que l'établissement auquel vous l'avez connectée, et seulement ce pour quoi elle a des autorisations ; la liste se trouve sous les étapes. Les commandes ne contiennent pas l'adresse e-mail du client, le téléphone uniquement pour la vente à emporter et la livraison, et l'adresse uniquement pour les livraisons. En connectant une application, vous chargez Flavoso de lui transmettre ces données. L'éditeur de l'application est responsable de son propre traitement.

1. 1

   Choisir « Connecter avec Flavoso »

   Dans l'autre logiciel. Son éditeur vous dit où exactement.

   Dans l'autre logiciel

2. 2

   Se connecter

   Avec votre compte Flavoso. Si vous avez configuré un second facteur, il vous est demandé.

   Chez Flavoso

3. 3

   Choisir l'établissement

   L'établissement avec lequel l'application doit travailler. Vous ne pouvez connecter que des établissements dont vous êtes propriétaire.

4. 4

   Lire les autorisations

   L'écran montre le logo, le nom et le site web de l'application, et en clair ce qu'elle a le droit de faire. Les applications validées portent « Vérifiée par Flavoso ».

5. 5

   Connecter

   Un clic sur « Connecter », et vous revenez dans l'autre logiciel. C'est fait. « Annuler » ne connecte rien.

• Commandes : les voir, ou les accepter, les refuser, les faire avancer et les reprendre dans son propre système.
• Carte : la voir, ou la modifier : plats, catégories, options, prix et ruptures.
• Établissement : voir les horaires, le statut et les tables, ou mettre en pause la prise de commandes et modifier les horaires et les délais.
• Réservations : les voir, ou les créer, les confirmer et les modifier. Cela ne prend effet qu'à partir de Pro, comme les réservations elles-mêmes, et l'écran de consentement le signale.
• Chiffres : voir le chiffre d'affaires et les ventes.

Déconnecter#

Un propriétaire peut déconnecter à tout moment : Réglages, onglet Intégrations, bloc « Applications connectées », bouton « Déconnecter », puis confirmer. L'application perd immédiatement tout accès.

Les propriétaires reçoivent un court e-mail à ce sujet. Connexions et déconnexions figurent dans le journal.

L'application elle-même peut aussi mettre fin à la connexion. Dans l'application mobile, vous voyez et déconnectez les applications connectées sous Plus, Réglages, Intégrations.

Webhooks personnalisés#

Pour vos propres systèmes ou des services d'automatisation, il existe les webhooks personnalisés : lors d'un événement, par exemple une nouvelle commande, Flavoso envoie un message à votre adresse. Ils se trouvent sous Réglages, onglet Intégrations, « Vos propres webhooks », réservés aux propriétaires et dans toutes les offres.

La structure des messages et la façon dont votre système vérifie la signature sont décrites dans la documentation développeurs sous docs.flavoso.com/fr/api.

• Jusqu'à cinq adresses. Chacune utilise https et doit être joignable publiquement, et pour chaque adresse vous choisissez les événements.
• Chaque envoi est signé (en-tête Flavoso-Signature, HMAC-SHA256). C'est ainsi que votre système sait qu'il vient vraiment de Flavoso.
• Si un envoi échoue, Flavoso réessaie : jusqu'à huit tentatives sur près de deux jours.
• Si rien n'arrive pendant 24 heures et qu'au moins dix tentatives d'affilée échouent, l'adresse est désactivée et les propriétaires reçoivent un e-mail.
• Chaque adresse affiche le journal de ses derniers envois et le bouton « Envoyer un événement de test ».

Développer votre propre application#

Vous créez votre propre application dans la console développeurs : sous app.flavoso.com/fr/developers, ou dans le tableau de bord via le menu du compte en haut à droite, entrée « Console développeurs ». Un compte Flavoso suffit ; ni établissement à vous ni abonnement ne sont nécessaires.

Lors de votre première visite, un assistant de configuration vous guide de l'application à votre première requête, en passant par un établissement de test gratuit. L'établissement de test est un restaurant qui sert uniquement à essayer l'API, avec une carte d'exemple et des tables. Dans la console, sous « Établissement de test », vous créez des commandes et des réservations et les faites avancer comme le ferait la cuisine. Votre application reçoit chaque changement sous forme d'événement, y compris par webhook.

D'autres établissements peuvent connecter votre application dès que vous l'avez soumise pour validation et que Flavoso l'a vérifiée et validée. Tout le reste pour les développeurs se trouve dans la documentation développeurs sous docs.flavoso.com/fr/api.