You dey make tool wey dey build or host websites? Add Connect Notiamo button. Your user go click am, sign in to Notiamo (or sign up), and click Allow. Notiamo go create project for their website and give your tool di widget code. Your tool go put di code for di website, or show am make dem copy.

Wetin you go get

  • Your users go get website feedback without comot from your tool.
  • Each customer wey come through your button go earn you 20% of wetin dem pay, without tax, for their first 12 months. Once every month, when you get 50 EUR or more, we go make statement; you go send us invoice and we go pay you by bank transfer, PayPal or Wise, as you choose. Payout fees depend on di method and your bank, and na you go pay dem. You go add your payout details for Settings › Refer and earn. Di partner program rules apply: you no need paid Notiamo plan, and no yearly limit dey.
  • Your tool no go ever see your users’ comments or their other projects. E go get only one thing: di widget code of di new project.

1. Become partner

Write to us from di contact page with:

  • di name of your tool and its website;
  • di pages of your tool wey go show di button (exact addresses, for example https://app.builder.example);
  • your Notiamo organization (your statements and payout details dey there; free account dey enough).

We go send you app id. You go put am inside di button.

2. Add di button

Load di script one time, then add button with your app id and di address of di website wey your user dey build:

<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 e work, di button go send notiamo:connected event with di widget code:

const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
  const { snippet, projectId } = event.detail;
  saveToTheHead(snippet); // your tool go put am for di website <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 no fit change di website code, add data-mode="copy". Notiamo go then show di code for small window with Copy button.

3. Or call am from your code

const result = await Notiamo.connect({
  clientId: "YOUR_APP_ID",
  site: "https://shop.example",
  name: "Shop",          // optional: di project name, if not, di website address
  mode: "return",        // or "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Call Notiamo.connect() from click. Browsers dey block windows wey open later.

Wetin your user go see

  1. Small Notiamo window go open.
  2. If dem never sign in, dem go type their email. Di sign-in link go open for another tab; di window go notice am and continue by itself. New users go sign up for di same window.
  3. Di Allow page go talk say your tool wan add Notiamo to their website. Dem go choose di organization and di workspace, and click Allow (or Deny).
  4. Di window go close. Your page go get di widget code.

Plan limits apply like for di dashboard. New free account don already get one project: Notiamo go use dat project for di website instead of making second one.

Security

  • Na only partner apps fit create projects dis way. Na only di pages wey you give us go get di code: di window dey send am to their exact address, nowhere else.
  • Di script dey use PKCE and random state for each click. Di access na read-only, e tie to di one new project, and e go end as soon as di script don read di widget code.
  • Notiamo pages no dey ever load inside frame. Na why di button dey open window.

Server-side tools

If your tool dey finish for 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, PKCE code_challenge (S256), state, and connect_site (di website). Exchange di code for https://my.notiamo.com/api/oauth/token, then read GET https://my.notiamo.com/api/connect/project with di access token. Di answer get snippet, projectId, publicKey, site and dashboardUrl.

Questions

Write to us from di contact page. We go help you test di button before you launch am.