Вы делаете инструмент, который создаёт или размещает сайты? Добавьте кнопку 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.

Вопросы

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