Guides d'utilisation

Au quotidien

Intégrations

Le point d'entrée unique pour brancher vos outils extérieurs : dépôt de code, encaissement, facturation électronique, agenda.

Avant de commencer

Certaines intégrations demandent un module actif (par exemple, GitHub demande Projets ou Support) ; d'autres demandent un droit de réglage sur l'organisation ou l'établissement (réglable dans Paramètres → Rôles). Une intégration dont le module n'est pas souscrit reste visible dans l'onglet Toutes, avec un bouton pour activer le module.

Les 3 premiers gestes

  1. Parcourez le catalogue — la page liste toutes les intégrations, avec leur état : Connecté, À finaliser, Non connecté ou Module non souscrit. Utilisez les onglets Toutes, Connectées, Disponibles, ou la recherche.

  2. Ouvrez une carte — cliquez sur une intégration pour ouvrir son panneau de configuration, par exemple GitHub : repo, jeton d'accès, secret de webhook.

  3. Connectez, ou suivez le lien — certaines intégrations se configurent directement dans le panneau (Connecter) ; d'autres, comme Automatisations ou Clés API, renvoient vers la page où elles vivent réellement (Ouvrir).

Au quotidien

GitHub

Liez vos tâches et vos tickets à des issues ou des pull requests GitHub, et suivez leur état directement dans Puwapi. Renseignez le dépôt (owner/name), un jeton d'accès personnel avec la portée repo, et un secret de webhook. L'URL de webhook à coller côté GitHub est affichée une fois connecté (événements Issues et Pull requests, type de contenu application/json). Une portée Tenant sert de repli quand un projet n'a pas son propre dépôt connecté.

Paiements en ligne

Encaissez rendez-vous et factures par carte : compte Stripe connecté, ou reversement par virement. Le détail se configure dans le panneau ; la politique de paiement de votre page de réservation se règle dans Rendez-vous.

Facturation électronique

Enregistrez votre entreprise auprès de la plateforme agréée pour émettre et recevoir des factures B2B, obligatoire depuis le 1er septembre 2026. Complétez d'abord vos informations légales (SIREN, adresse, représentant), choisissez l'étendue de l'enregistrement (recevoir et émettre, ou ajouter l'e-reporting), puis Enregistrer mon entreprise. Le représentant légal doit ensuite signer le mandat de facturation pour finaliser l'inscription. Une fois enregistré, le panneau affiche votre adresse électronique (à communiquer à vos fournisseurs) et votre consommation du mois.

Agenda externe

Suivez votre agenda Puwapi depuis Google Agenda, Outlook ou l'app Calendrier de votre téléphone : une URL d'abonnement à coller (mise à jour automatique, lecture seule), ou une URL CalDAV pour les logiciels qui la préfèrent, avec un nom d'utilisateur et un mot de passe dédié (jamais votre mot de passe Puwapi). Écrire depuis Google ou Outlook vers Puwapi n'est pas possible : ces connexions ne fonctionnent que dans un sens.

Automatisations, Messagerie d'équipe, Clés API

Ces trois cartes renvoient vers la page où l'intégration vit réellement : le module Flow pour déclencher un scénario depuis un webhook entrant ou appeler un service extérieur en HTTP, le Chat pour publier dans un canal depuis un système extérieur, et vos Clés API (dans les Paramètres) pour ouvrir vos données à vos propres outils.

Selon votre métier

  • Équipe technique : connectez GitHub pour que chaque ticket créé ou fermé reflète l'état réel de l'issue correspondante.
  • Commerce avec vente en ligne : configurez les paiements en ligne pour encaisser vos rendez-vous par carte, sans jongler entre deux outils.
  • Dirigeant qui suit son planning depuis son téléphone : abonnez votre agenda personnel à l'agenda Puwapi de l'établissement.

Questions fréquentes

Une intégration reste sur « À finaliser », que faire ? C'est l'état d'une intégration déjà engagée mais dont une étape manque (par exemple, un onboarding Stripe commencé mais pas terminé, ou un mandat de facturation non signé). Ouvrez la carte pour reprendre là où vous vous étiez arrêté.

Pourquoi une intégration affiche « Module non souscrit » ? Certaines intégrations dépendent d'un module payant. Activez le module correspondant, la carte devient alors configurable.

Puis-je écrire dans mon agenda Puwapi depuis Google Agenda ? Non, la connexion à un agenda externe est en lecture seule : créez et modifiez vos événements depuis Puwapi, ils se répercutent ensuite vers votre agenda externe.

Limites connues

  • Un abonnement d'agenda externe (Google, Outlook, iPhone) est en lecture seule.
  • La facturation électronique demande la signature du mandat par le représentant légal avant d'être pleinement active.

Pour aller plus loin

  • Projets et Support : où se voit la liaison GitHub sur un élément.
  • Flow : pour aller plus loin avec les automatisations.
  • Rendez-vous : où se règle la politique de paiement en ligne.

#guide