你做的是建站或托管网站的工具吗?加一个 Connect Notiamo 按钮。用户点击它,登录 Notiamo(或注册),然后点击允许。Notiamo 会为他们的网站创建一个项目,并把小部件代码交给你的工具。你的工具把代码放到网站上,或者显示出来让用户复制。

你能得到什么

  • 你的用户不用离开你的工具,就能收集网站反馈。
  • 每个通过你的按钮来的客户,你都能获得他们前 12 个月付款金额(不含税)的 20%。每月一次,当你的金额达到 50 EUR 或以上时,我们出具对账单;你向我们开具发票,我们按你的选择通过银行转账、PayPal 或 Wise 付款给你。打款手续费取决于方式和你的银行,由你承担。你可以在设置 › 推荐赚奖励中添加收款信息。适用合作伙伴计划规则:你无需购买 Notiamo 付费套餐,也没有年度上限。
  • 你的工具看不到用户的评论,也看不到他们的其他项目。它只得到一样东西:新项目的小部件代码。

1. 成为合作伙伴

通过联系页面给我们写信,并附上:

  • 你的工具名称和它的网站;
  • 你的工具中会显示按钮的页面(准确地址,例如 https://app.builder.example);
  • 你的 Notiamo 组织(对账单和收款信息都在这里;免费账户就够了)。

我们会发给你一个 app id。你把它放进按钮里。

2. 添加按钮

先加载一次脚本,然后添加一个按钮,写上你的 app id 和用户正在搭建的网站地址:

<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>

成功后,按钮会发出一个带有小部件代码的 notiamo:connected 事件:

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));

如果你的工具不能修改网站代码,请加上 data-mode="copy"。这时 Notiamo 会在一个小窗口中显示代码,并带有复制按钮。

3. 或者在代码中调用

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
}

请在点击事件中调用 Notiamo.connect()。浏览器会拦截稍后才打开的窗口。

你的用户会看到什么

  1. 一个 Notiamo 小窗口打开。
  2. 如果他们还没登录,就输入邮箱。登录链接会在另一个标签页中打开;窗口会察觉到,并自动继续。新用户在同一个窗口中注册。
  3. 允许页面会说明你的工具想把 Notiamo 加到他们的网站上。他们选择组织和工作区,然后点击允许(或拒绝)。
  4. 窗口关闭。你的页面拿到小部件代码。

套餐限制和控制台中一样适用。新的免费账户已经有一个项目:Notiamo 会把这个项目用于该网站,而不是再建第二个。

安全

  • 只有合作伙伴应用才能用这种方式创建项目。只有你提供给我们的页面才能拿到代码:窗口只把代码发送到它们的准确地址,不会发到别处。
  • 脚本在每次点击时使用 PKCE 和一个随机的 state。访问权限是只读的,只绑定这一个新项目,并在脚本读取小部件代码后立即结束。
  • Notiamo 的页面从不在框架(frame)中加载。所以按钮会打开一个窗口。

服务器端工具

如果你的工具在自己的服务器上完成流程,也请把它的重定向地址发给我们。把用户发送到 https://my.notiamo.com/oauth/authorize,带上 response_type=code、作为 client_id 的 app id、你的 redirect_uri、一个 PKCE code_challenge(S256)、一个 state,以及 connect_site(网站地址)。在 https://my.notiamo.com/api/oauth/token 用 code 换取访问令牌,然后用该令牌读取 GET https://my.notiamo.com/api/connect/project。返回结果包含 snippet、projectId、publicKey、site 和 dashboardUrl。

问题

通过联系页面给我们写信。在你上线之前,我们会帮你测试按钮。