Realizza uno strumento che crea o ospita siti web? Aggiunga un pulsante Connect Notiamo. Il Suo utente lo preme, accede a Notiamo (o si registra) e preme Consenti. Notiamo crea un progetto per il suo sito e dà al Suo strumento il codice del widget. Il Suo strumento mette il codice sul sito, oppure lo mostra da copiare.

Cosa ottiene

  • I Suoi utenti ricevono feedback sul sito senza lasciare il Suo strumento.
  • Ogni cliente che arriva dal Suo pulsante Le fa guadagnare il 20% di quello che paga, tasse escluse, per i suoi primi 12 mesi. Una volta al mese, quando ha 50 EUR o più, prepariamo un estratto; Lei ci invia una fattura e La paghiamo con bonifico bancario, PayPal o Wise, come preferisce. Le commissioni di pagamento dipendono dal metodo e dalla Sua banca, e sono a Suo carico. I dati per il pagamento si aggiungono in Impostazioni › Invita e guadagna. Valgono le regole del programma partner: non Le serve un piano Notiamo a pagamento e non c’è un limite annuale.
  • Il Suo strumento non vede mai i commenti o gli altri progetti dei Suoi utenti. Riceve una sola cosa: il codice del widget del nuovo progetto.

1. Diventi partner

Ci scriva dalla pagina dei contatti indicando:

  • il nome del Suo strumento e il suo sito web;
  • le pagine del Suo strumento che mostreranno il pulsante (indirizzi esatti, per esempio https://app.builder.example);
  • la Sua organizzazione Notiamo (lì trova gli estratti e i dati per il pagamento; basta un account gratuito).

Le inviamo un app id. Lei lo mette nel pulsante.

2. Aggiunga il pulsante

Carichi lo script una volta, poi aggiunga un pulsante con il Suo app id e l’indirizzo del sito che il Suo utente sta creando:

<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>

Quando funziona, il pulsante invia un evento notiamo:connected con il codice del widget:

const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
  const { snippet, projectId } = event.detail;
  saveToTheHead(snippet); // il Suo strumento lo mette nel <head> del sito
});
button.addEventListener("notiamo:cancelled", () => { /* l’utente ha chiuso la finestra o premuto Rifiuta */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));

Se il Suo strumento non può modificare il codice del sito, aggiunga data-mode="copy". Notiamo mostra allora il codice in una piccola finestra con un pulsante Copia.

3. Oppure lo chiami dal Suo codice

const result = await Notiamo.connect({
  clientId: "YOUR_APP_ID",
  site: "https://shop.example",
  name: "Shop",          // facoltativo: il nome del progetto, altrimenti l’indirizzo del sito
  mode: "return",        // oppure "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Chiami Notiamo.connect() da un clic. I browser bloccano le finestre che si aprono dopo.

Cosa vede il Suo utente

  1. Si apre una piccola finestra di Notiamo.
  2. Se non ha effettuato l’accesso, scrive la sua email. Il link di accesso si apre in un’altra scheda; la finestra se ne accorge e prosegue da sola. I nuovi utenti si registrano nella stessa finestra.
  3. La pagina Consenti dice che il Suo strumento vuole aggiungere Notiamo al suo sito. L’utente sceglie l’organizzazione e lo spazio di lavoro e preme Consenti (o Rifiuta).
  4. La finestra si chiude. La Sua pagina riceve il codice del widget.

I limiti del piano valgono come nella dashboard. Un nuovo account gratuito ha già un progetto: Notiamo usa quel progetto per il sito invece di crearne un secondo.

Sicurezza

  • Solo le app partner possono creare progetti in questo modo. Solo le pagine che ci ha indicato ricevono il codice: la finestra lo invia al loro indirizzo esatto, da nessun’altra parte.
  • Lo script usa PKCE e uno state casuale per ogni clic. L’accesso è in sola lettura, legato al solo nuovo progetto, e termina appena lo script ha letto il codice del widget.
  • Le pagine di Notiamo non si caricano mai dentro un frame. Per questo il pulsante apre una finestra.

Strumenti lato server

Se il Suo strumento conclude sul proprio server, ci indichi anche il suo indirizzo di reindirizzamento. Mandi i Suoi utenti a https://my.notiamo.com/oauth/authorize con response_type=code, il Suo app id come client_id, il Suo redirect_uri, un code_challenge PKCE (S256), uno state e connect_site (il sito). Scambi il codice su https://my.notiamo.com/api/oauth/token, poi legga GET https://my.notiamo.com/api/connect/project con il token di accesso. La risposta contiene snippet, projectId, publicKey, site e dashboardUrl.

Domande

Ci scriva dalla pagina dei contatti. La aiutiamo a provare il pulsante prima del lancio.