Você faz uma ferramenta que cria ou hospeda sites? Adicione um botão Connect Notiamo. Seu usuário clica nele, entra no Notiamo (ou cria uma conta) e clica em Permitir. O Notiamo cria um projeto para o site dele e entrega à sua ferramenta o código do widget. Sua ferramenta coloca o código no site ou o mostra para ser copiado.

O que você ganha

  • Seus usuários recebem feedback sobre o site sem sair da sua ferramenta.
  • Cada cliente que chega pelo seu botão rende para você 20% do que ele paga, sem impostos, nos primeiros 12 meses. Uma vez por mês, quando você tiver 50 EUR ou mais, fazemos um extrato; você nos envia uma fatura e pagamos por transferência bancária, PayPal ou Wise, como preferir. As taxas de pagamento dependem do método e do seu banco, e ficam por sua conta. Você adiciona seus dados de pagamento em Configurações › Indique e ganhe. Valem as regras do programa de parceiros: você não precisa de um plano pago do Notiamo e não há limite anual.
  • Sua ferramenta nunca vê os comentários nem os outros projetos dos seus usuários. Ela recebe uma única coisa: o código do widget do novo projeto.

1. Torne-se parceiro

Escreva para nós pela página de contato com:

  • o nome da sua ferramenta e o site dela;
  • as páginas da sua ferramenta que vão mostrar o botão (endereços exatos, por exemplo https://app.builder.example);
  • sua organização no Notiamo (seus extratos e dados de pagamento ficam lá; uma conta gratuita basta).

Enviamos um app id para você. Você o coloca no botão.

2. Adicione o botão

Carregue o script uma vez e depois adicione um botão com seu app id e o endereço do site que seu usuário está criando:

<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 dá certo, o botão envia um evento notiamo:connected com o código do widget:

const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
  const { snippet, projectId } = event.detail;
  saveToTheHead(snippet); // sua ferramenta coloca no <head> do site
});
button.addEventListener("notiamo:cancelled", () => { /* o usuário fechou a janela ou clicou em Negar */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));

Se sua ferramenta não pode mudar o código do site, adicione data-mode="copy". O Notiamo então mostra o código em uma pequena janela com um botão Copiar.

3. Ou chame pelo seu código

const result = await Notiamo.connect({
  clientId: "YOUR_APP_ID",
  site: "https://shop.example",
  name: "Shop",          // opcional: o nome do projeto; senão, o endereço do site
  mode: "return",        // ou "copy"
});
if (result.status === "connected") {
  // result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}

Chame Notiamo.connect() a partir de um clique. Os navegadores bloqueiam janelas que abrem depois.

O que seu usuário vê

  1. Uma pequena janela do Notiamo se abre.
  2. Se ele não estiver conectado, digita o e-mail. O link de login abre em outra aba; a janela percebe e continua sozinha. Usuários novos criam a conta na mesma janela.
  3. A página Permitir diz que sua ferramenta quer adicionar o Notiamo ao site dele. Ele escolhe a organização e o espaço de trabalho e clica em Permitir (ou Negar).
  4. A janela se fecha. Sua página recebe o código do widget.

Os limites do plano valem como no painel. Uma conta gratuita nova já tem um projeto: o Notiamo usa esse projeto para o site em vez de criar um segundo.

Segurança

  • Só apps parceiros podem criar projetos desse jeito. Só as páginas que você nos informou recebem o código: a janela o envia para o endereço exato delas, para nenhum outro lugar.
  • O script usa PKCE e um state aleatório a cada clique. O acesso é somente leitura, ligado ao único projeto novo, e termina assim que o script lê o código do widget.
  • As páginas do Notiamo nunca carregam dentro de um frame. Por isso o botão abre uma janela.

Ferramentas no servidor

Se sua ferramenta termina no próprio servidor, informe também o endereço de redirecionamento dela. Envie seus usuários para https://my.notiamo.com/oauth/authorize com response_type=code, seu app id como client_id, seu redirect_uri, um code_challenge PKCE (S256), um state e connect_site (o site). Troque o código em https://my.notiamo.com/api/oauth/token e depois leia GET https://my.notiamo.com/api/connect/project com o token de acesso. A resposta tem snippet, projectId, publicKey, site e dashboardUrl.

Dúvidas

Escreva para nós pela página de contato. Ajudamos você a testar o botão antes do lançamento.