Tworzysz narzędzie, które buduje lub hostuje strony? Dodaj przycisk Connect Notiamo. Użytkownik go klika, loguje się do Notiamo (albo zakłada konto) i klika Zezwól. Notiamo tworzy projekt dla jego strony i daje Twojemu narzędziu kod widgetu. Twoje narzędzie wstawia kod na stronę albo pokazuje go do skopiowania.
Co zyskujesz
- Twoi użytkownicy dostają opinie o stronie bez wychodzenia z Twojego narzędzia.
- Każdy klient, który przyjdzie przez Twój przycisk, daje Ci 20% tego, co płaci, bez podatku, przez pierwsze 12 miesięcy. Raz w miesiącu, gdy masz 50 EUR lub więcej, przygotowujemy zestawienie; wysyłasz nam fakturę, a my płacimy Ci przelewem bankowym, przez PayPal lub Wise, jak wolisz. Opłaty za wypłatę zależą od metody i Twojego banku i ponosisz je Ty. Dane do wypłaty dodajesz w Ustawienia › Poleć i zarabiaj. Obowiązują zasady programu partnerskiego: nie potrzebujesz płatnego planu Notiamo i nie ma rocznego limitu.
- Twoje narzędzie nigdy nie widzi komentarzy ani innych projektów Twoich użytkowników. Dostaje jedną rzecz: kod widgetu nowego projektu.
1. Zostań partnerem
Napisz do nas przez stronę kontaktu i podaj:
- nazwę swojego narzędzia i jego stronę;
- strony Twojego narzędzia, które pokażą przycisk (dokładne adresy, na przykład
https://app.builder.example); - swoją organizację w Notiamo (tam są Twoje zestawienia i dane do wypłaty; wystarczy darmowe konto).
Wysyłamy Ci app id. Wstawiasz go do przycisku.
2. Dodaj przycisk
Załaduj skrypt raz, a potem dodaj przycisk ze swoim app id i adresem strony, którą buduje Twój użytkownik:
<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>
Gdy wszystko się uda, przycisk wysyła zdarzenie notiamo:connected z kodem widgetu:
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // Twoje narzędzie wstawia go do <head> strony
});
button.addEventListener("notiamo:cancelled", () => { /* the user closed the window or clicked Deny */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
Jeśli Twoje narzędzie nie może zmienić kodu strony, dodaj data-mode="copy". Wtedy Notiamo pokazuje kod w małym oknie z przyciskiem Kopiuj.
3. Albo wywołaj go z kodu
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // opcjonalnie: nazwa projektu, inaczej adres strony
mode: "return", // or "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Wywołaj Notiamo.connect() po kliknięciu. Przeglądarki blokują okna, które otwierają się później.
Co widzi Twój użytkownik
- Otwiera się małe okno Notiamo.
- Jeśli nie jest zalogowany, wpisuje swój e-mail. Link logowania otwiera się w innej karcie; okno to zauważa i samo idzie dalej. Nowi użytkownicy zakładają konto w tym samym oknie.
- Strona Zezwól mówi, że Twoje narzędzie chce dodać Notiamo do jego strony. Wybiera organizację i przestrzeń roboczą i klika Zezwól (albo Odmów).
- Okno się zamyka. Twoja strona dostaje kod widgetu.
Limity planu działają tak samo jak w panelu. Nowe darmowe konto ma już jeden projekt: Notiamo używa tego projektu dla strony, zamiast tworzyć drugi.
Bezpieczeństwo
- Tylko aplikacje partnerów mogą w ten sposób tworzyć projekty. Kod dostają tylko strony, które nam podałeś: okno wysyła go na ich dokładny adres i nigdzie indziej.
- Skrypt używa PKCE i losowego
stateprzy każdym kliknięciu. Dostęp jest tylko do odczytu, ograniczony do jednego nowego projektu i kończy się, gdy tylko skrypt odczyta kod widgetu. - Strony Notiamo nigdy nie ładują się w ramce. Dlatego przycisk otwiera okno.
Narzędzia działające na serwerze
Jeśli Twoje narzędzie kończy proces na własnym serwerze, podaj nam też jego adres przekierowania. Wyślij użytkowników na https://my.notiamo.com/oauth/authorize z response_type=code, swoim app id jako client_id, swoim redirect_uri, code_challenge PKCE (S256), state i connect_site (strona). Wymień kod pod https://my.notiamo.com/api/oauth/token, a potem odczytaj GET https://my.notiamo.com/api/connect/project z tokenem dostępu. Odpowiedź zawiera snippet, projectId, publicKey, site i dashboardUrl.
Pytania
Napisz do nas przez stronę kontaktu. Pomożemy Ci przetestować przycisk przed startem.