Maak je een tool die websites bouwt of host? Voeg een Connect Notiamo-knop toe. Je gebruiker klikt erop, logt in bij Notiamo (of meldt zich aan) en klikt op Toestaan. Notiamo maakt een project voor zijn website en geeft je tool de widgetcode. Je tool zet de code op de website, of toont hem om te kopiëren.
Wat je ervoor krijgt
- Je gebruikers krijgen websitefeedback zonder je tool te verlaten.
- Elke klant die via je knop komt, levert je 20% op van wat hij betaalt, zonder btw, in zijn eerste 12 maanden. Eén keer per maand, als je 50 EUR of meer hebt, maken we een overzicht; je stuurt ons een factuur en wij betalen je via bankoverschrijving, PayPal of Wise, zoals je wilt. De uitbetalingskosten hangen af van de methode en van je bank, en zijn voor jouw rekening. Je uitbetalingsgegevens vul je in bij Instellingen › Aanbevelen en verdienen. De regels van het partnerprogramma gelden: je hebt geen betaald Notiamo-abonnement nodig en er is geen jaarlijkse limiet.
- Je tool ziet nooit de reacties of andere projecten van je gebruikers. Hij krijgt één ding: de widgetcode van het nieuwe project.
1. Word partner
Schrijf ons via de contactpagina met:
- de naam van je tool en zijn website;
- de pagina’s van je tool die de knop tonen (exacte adressen, bijvoorbeeld
https://app.builder.example); - je Notiamo-organisatie (daar staan je overzichten en uitbetalingsgegevens; een gratis account is genoeg).
We sturen je een app id. Die zet je in de knop.
2. Voeg de knop toe
Laad het script één keer en voeg dan een knop toe met je app id en het adres van de website die je gebruiker bouwt:
<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>
Als het lukt, stuurt de knop een notiamo:connected-event met de widgetcode:
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // je tool zet hem in de <head> van de website
});
button.addEventListener("notiamo:cancelled", () => { /* de gebruiker sloot het venster of klikte op Weigeren */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
Kan je tool de code van de website niet aanpassen? Voeg dan data-mode="copy" toe. Notiamo toont de code dan in een klein venster met een Kopiëren-knop.
3. Of roep het aan vanuit je code
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // optioneel: de projectnaam, anders het adres van de website
mode: "return", // of "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Roep Notiamo.connect() aan bij een klik. Browsers blokkeren vensters die later openen.
Wat je gebruiker ziet
- Er opent een klein Notiamo-venster.
- Is hij niet ingelogd, dan typt hij zijn e-mailadres. De inloglink opent in een ander tabblad; het venster merkt dat op en gaat vanzelf verder. Nieuwe gebruikers melden zich in hetzelfde venster aan.
- De pagina Toestaan zegt dat je tool Notiamo aan zijn website wil toevoegen. Hij kiest de organisatie en de werkruimte en klikt op Toestaan (of Weigeren).
- Het venster sluit. Je pagina krijgt de widgetcode.
De limieten van het abonnement gelden zoals in het dashboard. Een nieuw gratis account heeft al één project: Notiamo gebruikt dat project voor de website in plaats van een tweede te maken.
Beveiliging
- Alleen partner-apps kunnen op deze manier projecten maken. Alleen de pagina’s die je ons hebt gegeven krijgen de code: het venster stuurt hem naar hun exacte adres, nergens anders heen.
- Het script gebruikt PKCE en een willekeurige
statebij elke klik. De toegang is alleen-lezen, gebonden aan dat ene nieuwe project, en stopt zodra het script de widgetcode heeft gelezen. - De Notiamo-pagina’s laden nooit in een frame. Daarom opent de knop een venster.
Tools aan de serverkant
Rondt je tool af op zijn eigen server? Geef ons dan ook zijn redirect-adres. Stuur je gebruikers naar https://my.notiamo.com/oauth/authorize met response_type=code, je app id als client_id, je redirect_uri, een PKCE-code_challenge (S256), een state en connect_site (de website). Wissel de code in bij https://my.notiamo.com/api/oauth/token en lees dan GET https://my.notiamo.com/api/connect/project met het toegangstoken. Het antwoord bevat snippet, projectId, publicKey, site en dashboardUrl.
Vragen
Schrijf ons via de contactpagina. We helpen je de knop te testen voordat je hem lanceert.