Sie entwickeln ein Werkzeug, das Websites baut oder hostet? Fügen Sie einen Connect Notiamo-Button hinzu. Ihr Nutzer klickt darauf, meldet sich bei Notiamo an (oder registriert sich) und klickt auf Erlauben. Notiamo legt ein Projekt für seine Website an und gibt Ihrem Werkzeug den Widget-Code. Ihr Werkzeug setzt den Code auf die Website oder zeigt ihn zum Kopieren an.
Was Sie davon haben
- Ihre Nutzer bekommen Website-Feedback, ohne Ihr Werkzeug zu verlassen.
- Jeder Kunde, der über Ihren Button kommt, bringt Ihnen 20 % dessen, was er zahlt, ohne Steuern, in seinen ersten 12 Monaten. Einmal im Monat, sobald Sie 50 EUR oder mehr haben, erstellen wir eine Abrechnung; Sie schicken uns eine Rechnung, und wir zahlen per Banküberweisung, PayPal oder Wise, wie Sie möchten. Die Auszahlungsgebühren hängen von der Methode und Ihrer Bank ab und werden von Ihnen getragen. Ihre Auszahlungsdaten tragen Sie unter Einstellungen › Empfehlen und verdienen ein. Es gelten die Regeln des Partnerprogramms: Sie brauchen keinen kostenpflichtigen Notiamo-Tarif, und es gibt keine jährliche Obergrenze.
- Ihr Werkzeug sieht nie die Kommentare oder anderen Projekte Ihrer Nutzer. Es bekommt nur eines: den Widget-Code des neuen Projekts.
1. Partner werden
Schreiben Sie uns über die Kontaktseite mit:
- dem Namen Ihres Werkzeugs und seiner Website;
- den Seiten Ihres Werkzeugs, die den Button zeigen (genaue Adressen, zum Beispiel
https://app.builder.example); - Ihrer Notiamo-Organisation (dort finden Sie Ihre Abrechnungen und Auszahlungsdaten; ein kostenloses Konto reicht).
Wir schicken Ihnen eine App-ID. Sie tragen sie in den Button ein.
2. Den Button einbauen
Laden Sie das Skript einmal und fügen Sie dann einen Button mit Ihrer App-ID und der Adresse der Website hinzu, die Ihr Nutzer baut:
<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>
Wenn es klappt, sendet der Button ein notiamo:connected-Ereignis mit dem Widget-Code:
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // Ihr Werkzeug setzt ihn in den <head> der Website
});
button.addEventListener("notiamo:cancelled", () => { /* der Nutzer hat das Fenster geschlossen oder auf Ablehnen geklickt */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
Wenn Ihr Werkzeug den Code der Website nicht ändern kann, fügen Sie data-mode="copy" hinzu. Notiamo zeigt den Code dann in einem kleinen Fenster mit einem Kopieren-Button.
3. Oder aus Ihrem Code aufrufen
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // optional: der Projektname, sonst die Adresse der Website
mode: "return", // oder "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Rufen Sie Notiamo.connect() bei einem Klick auf. Browser blockieren Fenster, die sich später öffnen.
Was Ihr Nutzer sieht
- Ein kleines Notiamo-Fenster öffnet sich.
- Ist er nicht angemeldet, gibt er seine E-Mail-Adresse ein. Der Anmeldelink öffnet sich in einem anderen Tab; das Fenster bemerkt das und macht von selbst weiter. Neue Nutzer registrieren sich im selben Fenster.
- Die Seite Erlauben sagt, dass Ihr Werkzeug Notiamo zu seiner Website hinzufügen möchte. Er wählt die Organisation und den Arbeitsbereich und klickt auf Erlauben (oder Ablehnen).
- Das Fenster schließt sich. Ihre Seite bekommt den Widget-Code.
Es gelten die Grenzen des Tarifs wie im Dashboard. Ein neues kostenloses Konto hat schon ein Projekt: Notiamo nutzt dieses Projekt für die Website, statt ein zweites anzulegen.
Sicherheit
- Nur Partner-Apps können auf diesem Weg Projekte anlegen. Nur die Seiten, die Sie uns genannt haben, bekommen den Code: Das Fenster sendet ihn an deren genaue Adresse, nirgendwo sonst hin.
- Das Skript nutzt PKCE und einen zufälligen
statebei jedem Klick. Der Zugriff ist schreibgeschützt, an das eine neue Projekt gebunden und endet, sobald das Skript den Widget-Code gelesen hat. - Die Notiamo-Seiten laden nie in einem Frame. Deshalb öffnet der Button ein Fenster.
Serverseitige Werkzeuge
Wenn Ihr Werkzeug auf seinem eigenen Server abschließt, nennen Sie uns auch seine Weiterleitungsadresse. Schicken Sie Ihre Nutzer zu https://my.notiamo.com/oauth/authorize mit response_type=code, Ihrer App-ID als client_id, Ihrer redirect_uri, einer PKCE-code_challenge (S256), einem state und connect_site (der Website). Tauschen Sie den Code bei https://my.notiamo.com/api/oauth/token ein und lesen Sie dann GET https://my.notiamo.com/api/connect/project mit dem Zugriffstoken. Die Antwort enthält snippet, projectId, publicKey, site und dashboardUrl.
Fragen
Schreiben Sie uns über die Kontaktseite. Wir helfen Ihnen, den Button vor dem Start zu testen.