Вы делаете инструмент, который создаёт или размещает сайты? Добавьте кнопку 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() по клику. Браузеры блокируют окна, которые открываются позже.
Что видит ваш пользователь
- Открывается маленькое окно Notiamo.
- Если он не вошёл, он вводит свой email. Ссылка для входа открывается в другой вкладке; окно замечает это и само идёт дальше. Новые пользователи регистрируются в том же окне.
- Страница Разрешить сообщает, что ваш инструмент хочет добавить Notiamo на его сайт. Он выбирает организацию и рабочее пространство и нажимает Разрешить (или Отклонить).
- Окно закрывается. Ваша страница получает код виджета.
Лимиты тарифа действуют так же, как в панели. У нового бесплатного аккаунта уже есть один проект: 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.
Вопросы
Напишите нам через страницу контактов. Мы поможем проверить кнопку до запуска.