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ê
- Uma pequena janela do Notiamo se abre.
- 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.
- 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).
- 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
statealeató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.