Do you make a tool that builds or hosts websites? Add a Connect Notiamo button. Your user clicks it, signs in to Notiamo (or signs up), and clicks Allow. Notiamo creates a project for their website and gives your tool the widget code. Your tool puts the code on the website, or shows it to copy.
What you get
- Your users get website feedback without leaving your tool.
- Each customer who comes through your button earns you 20% of what they pay, without tax, for their first 12 months. Once a month, when you have 50 EUR or more, we make a statement; you send us an invoice and we pay you by bank transfer, PayPal or Wise, as you choose. Payout fees depend on the method and on your bank, and are paid by you. You add your payout details in Settings › Refer and earn. The partner program rules apply: you need no paid Notiamo plan, and there is no yearly limit.
- Your tool never sees your users’ comments or other projects. It gets one thing: the widget code of the new project.
1. Become a partner
Write to us from the contact page with:
- the name of your tool and its website;
- the pages of your tool that will show the button (exact addresses, for example
https://app.builder.example); - your Notiamo organization (your statements and payout details are there; a free account is enough).
We send you an app id. You put it in the button.
2. Add the button
Load the script once, then add a button with your app id and the address of the website your user is building:
<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>
When it works, the button sends a notiamo:connected event with the widget code:
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // your tool puts it in the website's <head>
});
button.addEventListener("notiamo:cancelled", () => { /* the user closed the window or clicked Deny */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
If your tool cannot change the website’s code, add data-mode="copy". Notiamo then shows the code in a small window with a Copy button.
3. Or call it from your code
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // optional: the project name, else the website's address
mode: "return", // or "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Call Notiamo.connect() from a click. Browsers block windows that open later.
What your user sees
- A small Notiamo window opens.
- If they are not signed in, they type their email. The sign-in link opens in another tab; the window notices it and goes on by itself. New users sign up in the same window.
- The Allow page says that your tool wants to add Notiamo to their website. They choose the organization and the workspace, and click Allow (or Deny).
- The window closes. Your page gets the widget code.
Plan limits apply as in the dashboard. A new free account already has one project: Notiamo uses that project for the website instead of making a second one.
Security
- Only partner apps can create projects this way. Only the pages you gave us get the code: the window sends it to their exact address, nowhere else.
- The script uses PKCE and a random
statefor each click. The access is read-only, bound to the one new project, and ends as soon as the script has read the widget code. - The Notiamo pages never load inside a frame. That is why the button opens a window.
Server-side tools
If your tool finishes on its own server, give us its redirect address too. Send your users to https://my.notiamo.com/oauth/authorize with response_type=code, your app id as client_id, your redirect_uri, a PKCE code_challenge (S256), a state, and connect_site (the website). Exchange the code at https://my.notiamo.com/api/oauth/token, then read GET https://my.notiamo.com/api/connect/project with the access token. The answer has snippet, projectId, publicKey, site and dashboardUrl.
Questions
Write to us from the contact page. We help you test the button before you launch it.