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

  1. Otwiera się małe okno Notiamo.
  2. 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.
  3. 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).
  4. 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 state przy 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.