Ви робите інструмент, який створює або розміщує сайти? Додайте кнопку Connect Notiamo. Користувач натискає її, входить у Notiamo (або реєструється) і натискає Дозволити. Notiamo створює проєкт для його сайту й передає вашому інструменту код віджета. Ваш інструмент ставить код на сайт або показує його для копіювання.

Що ви отримуєте

  • Ваші користувачі отримують відгуки про сайт, не виходячи з вашого інструмента.
  • Кожен клієнт, який прийшов через вашу кнопку, приносить вам 20% від того, що він платить, без податку, протягом перших 12 місяців. Раз на місяць, коли у вас набирається 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); // ваш інструмент ставить його в <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",          // необов’язково: назва проєкту, інакше адреса сайту
  mode: "return",        // or "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Викликайте Notiamo.connect() після кліку. Браузери блокують вікна, які відкриваються пізніше.

Що бачить ваш користувач

  1. Відкривається маленьке вікно Notiamo.
  2. Якщо він не ввійшов, він вводить свій email. Посилання для входу відкривається в іншій вкладці; вікно це помічає й саме йде далі. Нові користувачі реєструються в тому ж вікні.
  3. Сторінка Дозволити повідомляє, що ваш інструмент хоче додати Notiamo на його сайт. Він обирає організацію та робочий простір і натискає Дозволити (або Відмовити).
  4. Вікно закривається. Ваша сторінка отримує код віджета.

Ліміти тарифу діють так само, як у панелі. Новий безкоштовний акаунт уже має один проєкт: Notiamo використовує цей проєкт для сайту, а не створює другий.

Безпека

  • Створювати проєкти так можуть лише застосунки партнерів. Код отримують лише сторінки, які ви нам вказали: вікно надсилає його на їхню точну адресу й більше нікуди.
  • Скрипт використовує PKCE і випадковий state для кожного кліку. Доступ лише на читання, прив’язаний до одного нового проєкту, і закінчується, щойно скрипт прочитав код віджета.
  • Сторінки Notiamo ніколи не завантажуються всередині фрейму. Тому кнопка відкриває вікно.

Серверні інструменти

Якщо ваш інструмент завершує процес на своєму сервері, дайте нам і його адресу перенаправлення. Надішліть користувачів на https://my.notiamo.com/oauth/authorize з response_type=code, вашим app id у client_id, вашим redirect_uri, PKCE code_challenge (S256), state і connect_site (сайт). Обміняйте код на https://my.notiamo.com/api/oauth/token, потім прочитайте GET https://my.notiamo.com/api/connect/project з токеном доступу. Відповідь містить snippet, projectId, publicKey, site і dashboardUrl.

Питання

Напишіть нам через сторінку контактів. Ми допоможемо перевірити кнопку до запуску.