¿Crea una herramienta que construye o aloja sitios web? Añada un botón Connect Notiamo. Su usuario lo pulsa, inicia sesión en Notiamo (o se registra) y pulsa Permitir. Notiamo crea un proyecto para su sitio web y da a su herramienta el código del widget. Su herramienta pone el código en el sitio, o lo muestra para copiarlo.

Qué obtiene

  • Sus usuarios reciben comentarios sobre su sitio sin salir de su herramienta.
  • Cada cliente que llega por su botón le da el 20 % de lo que paga, sin impuestos, durante sus primeros 12 meses. Una vez al mes, cuando tiene 50 EUR o más, hacemos un extracto; usted nos envía una factura y le pagamos por transferencia bancaria, PayPal o Wise, como prefiera. Las comisiones del pago dependen del método y de su banco, y corren por su cuenta. Sus datos de pago se añaden en Ajustes › Recomiende y gane. Se aplican las reglas del programa de socios: no necesita un plan de pago de Notiamo y no hay límite anual.
  • Su herramienta nunca ve los comentarios ni los otros proyectos de sus usuarios. Recibe una sola cosa: el código del widget del nuevo proyecto.

1. Hágase socio

Escríbanos desde la página de contacto con:

  • el nombre de su herramienta y su sitio web;
  • las páginas de su herramienta que mostrarán el botón (direcciones exactas, por ejemplo https://app.builder.example);
  • su organización de Notiamo (ahí están sus extractos y sus datos de pago; una cuenta gratuita basta).

Le enviamos un app id. Usted lo pone en el botón.

2. Añada el botón

Cargue el script una vez y luego añada un botón con su app id y la dirección del sitio web que crea su usuario:

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

Cuando funciona, el botón envía un evento notiamo:connected con el código del widget:

const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
  const { snippet, projectId } = event.detail;
  saveToTheHead(snippet); // su herramienta lo pone en el <head> del sitio
});
button.addEventListener("notiamo:cancelled", () => { /* el usuario cerró la ventana o pulsó Rechazar */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));

Si su herramienta no puede cambiar el código del sitio, añada data-mode="copy". Notiamo muestra entonces el código en una pequeña ventana con un botón Copiar.

3. O llámelo desde su código

const result = await Notiamo.connect({
  clientId: "YOUR_APP_ID",
  site: "https://shop.example",
  name: "Shop",          // opcional: el nombre del proyecto; si no, la dirección del sitio
  mode: "return",        // o "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Llame a Notiamo.connect() desde un clic. Los navegadores bloquean las ventanas que se abren más tarde.

Qué ve su usuario

  1. Se abre una pequeña ventana de Notiamo.
  2. Si no ha iniciado sesión, escribe su correo electrónico. El enlace de inicio de sesión se abre en otra pestaña; la ventana lo detecta y sigue sola. Los usuarios nuevos se registran en la misma ventana.
  3. La página Permitir dice que su herramienta quiere añadir Notiamo a su sitio web. Elige la organización y el espacio de trabajo, y pulsa Permitir (o Rechazar).
  4. La ventana se cierra. Su página recibe el código del widget.

Los límites del plan se aplican igual que en el panel. Una cuenta gratuita nueva ya tiene un proyecto: Notiamo usa ese proyecto para el sitio web en lugar de crear un segundo.

Seguridad

  • Solo las aplicaciones de socios pueden crear proyectos de esta forma. Solo las páginas que nos dio reciben el código: la ventana lo envía a su dirección exacta, a ningún otro sitio.
  • El script usa PKCE y un state aleatorio en cada clic. El acceso es de solo lectura, está ligado al único proyecto nuevo y termina en cuanto el script ha leído el código del widget.
  • Las páginas de Notiamo nunca se cargan dentro de un marco. Por eso el botón abre una ventana.

Herramientas del lado del servidor

Si su herramienta termina en su propio servidor, denos también su dirección de redirección. Envíe a sus usuarios a https://my.notiamo.com/oauth/authorize con response_type=code, su app id como client_id, su redirect_uri, un code_challenge PKCE (S256), un state y connect_site (el sitio web). Intercambie el código en https://my.notiamo.com/api/oauth/token y luego lea GET https://my.notiamo.com/api/connect/project con el token de acceso. La respuesta tiene snippet, projectId, publicKey, site y dashboardUrl.

Preguntas

Escríbanos desde la página de contacto. Le ayudamos a probar el botón antes de lanzarlo.