Ви робите інструмент, який створює або розміщує сайти? Додайте кнопку 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.
Питання
Напишіть нам через сторінку контактів. Ми допоможемо перевірити кнопку до запуску.