Votre outil crée ou héberge des sites web ? Ajoutez un bouton Connect Notiamo. Votre utilisateur clique dessus, se connecte à Notiamo (ou s’inscrit) et clique sur Autoriser. Notiamo crée un projet pour son site et donne le code du widget à votre outil. Votre outil place le code sur le site, ou l’affiche pour qu’il soit copié.
Ce que vous y gagnez
- Vos utilisateurs reçoivent des retours sur leur site sans quitter votre outil.
- Chaque client venu par votre bouton vous rapporte 20 % de ce qu’il paie, hors taxes, pendant ses 12 premiers mois. Une fois par mois, dès que vous avez 50 EUR ou plus, nous établissons un relevé ; vous nous envoyez une facture et nous vous payons par virement bancaire, PayPal ou Wise, au choix. Les frais de versement dépendent du moyen choisi et de votre banque, et sont à votre charge. Vous ajoutez vos coordonnées de versement dans Paramètres › Parrainage. Les règles du programme partenaires s’appliquent : aucun abonnement Notiamo payant n’est nécessaire, et il n’y a pas de plafond annuel.
- Votre outil ne voit jamais les commentaires ni les autres projets de vos utilisateurs. Il reçoit une seule chose : le code du widget du nouveau projet.
1. Devenir partenaire
Écrivez-nous depuis la page de contact avec :
- le nom de votre outil et son site web ;
- les pages de votre outil qui afficheront le bouton (adresses exactes, par exemple
https://app.builder.example) ; - votre organisation Notiamo (vos relevés et vos coordonnées de versement s’y trouvent ; un compte gratuit suffit).
Nous vous envoyons un app id. Vous le mettez dans le bouton.
2. Ajouter le bouton
Chargez le script une fois, puis ajoutez un bouton avec votre app id et l’adresse du site que votre utilisateur crée :
<script src="https://my.notiamo.com/connect/v1.js" defer></script>
<button data-notiamo-connect
data-client="YOUR_APP_ID"
data-site="https://shop.example"
data-name="Shop">
Connect Notiamo
</button>
Quand tout fonctionne, le bouton envoie un événement notiamo:connected avec le code du widget :
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // votre outil le place dans le <head> du site
});
button.addEventListener("notiamo:cancelled", () => { /* l’utilisateur a fermé la fenêtre ou cliqué sur Refuser */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
Si votre outil ne peut pas modifier le code du site, ajoutez data-mode="copy". Notiamo affiche alors le code dans une petite fenêtre avec un bouton Copier.
3. Ou l’appeler depuis votre code
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // facultatif : le nom du projet, sinon l’adresse du site
mode: "return", // ou "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Appelez Notiamo.connect() lors d’un clic. Les navigateurs bloquent les fenêtres qui s’ouvrent plus tard.
Ce que voit votre utilisateur
- Une petite fenêtre Notiamo s’ouvre.
- S’il n’est pas connecté, il saisit son e-mail. Le lien de connexion s’ouvre dans un autre onglet ; la fenêtre le remarque et continue d’elle-même. Les nouveaux utilisateurs s’inscrivent dans la même fenêtre.
- La page Autoriser indique que votre outil veut ajouter Notiamo à son site. Il choisit l’organisation et l’espace de travail, puis clique sur Autoriser (ou Refuser).
- La fenêtre se ferme. Votre page reçoit le code du widget.
Les limites de la formule s’appliquent comme dans le tableau de bord. Un nouveau compte gratuit a déjà un projet : Notiamo utilise ce projet pour le site au lieu d’en créer un second.
Sécurité
- Seules les applications partenaires peuvent créer des projets de cette façon. Seules les pages que vous nous avez données reçoivent le code : la fenêtre l’envoie à leur adresse exacte, nulle part ailleurs.
- Le script utilise PKCE et un
statealéatoire à chaque clic. L’accès est en lecture seule, lié au seul nouveau projet, et prend fin dès que le script a lu le code du widget. - Les pages Notiamo ne se chargent jamais dans un cadre. C’est pourquoi le bouton ouvre une fenêtre.
Outils côté serveur
Si votre outil termine sur son propre serveur, donnez-nous aussi son adresse de redirection. Envoyez vos utilisateurs vers https://my.notiamo.com/oauth/authorize avec response_type=code, votre app id comme client_id, votre redirect_uri, un code_challenge PKCE (S256), un state et connect_site (le site). Échangez le code sur https://my.notiamo.com/api/oauth/token, puis lisez GET https://my.notiamo.com/api/connect/project avec le jeton d’accès. La réponse contient snippet, projectId, publicKey, site et dashboardUrl.
Questions
Écrivez-nous depuis la page de contact. Nous vous aidons à tester le bouton avant son lancement.