Como usar o SDK do Soog para identificar clientes e usuários

Criada por Equipe Soog, Modificado em Qua, 24 Set, 2025 na (o) 10:35 AM por Equipe Soog

O SDK do Soog permite que sua aplicação envie informações sobre empresas (clientes) e usuários para dentro da plataforma, de forma simples e segura.

Isso é fundamental para que o Soog consiga relacionar sugestões, votos, comentários e impacto financeiro (MRR) com as pessoas e empresas corretas.

1. Instalação do SDK

Adicione o script abaixo no seu projeto (normalmente no <head> ou logo antes de fechar o <body>):

<script src="https://app.soog.com.br/soog-sdk.js"></script>

2. Inicializando o SDK

Antes de enviar qualquer dado, é necessário inicializar o SDK com a sua clientApiKey, disponível no painel do Soog:

soog.init({   clientApiKey: 'SUA_CHAVE_API_DO_CLIENTE' });

3. Identificando empresas (clients)

Use o método soog.identifyClient() para enviar informações da empresa cliente que está utilizando seu SaaS:

soog.identifyClient({  company: 'Acme Corporation',  mrr: 5000 // opcional });

Campos aceitos

company (obrigatório) → nome da empresa
mrr (opcional) → receita recorrente mensal da empresa

Você pode incluir outros campos personalizados, que serão armazenados como metadados.

4. Identificando usuários

Use o método soog.identifyUser() para identificar usuários dentro de uma empresa:

soog.identifyUser({  name: 'João Silva',  email: 'joao@acme.com',  role: 'Gerente de Produto' });

Campos aceitos

name (obrigatório) → nome completo do usuário
email (obrigatório) → email do usuário
role (opcional) → cargo ou função

5. Quando chamar cada método

identifyClient → Deve ser chamado sempre em conjunto com identifyUser quando a empresa é criada, logada ou tem dados atualizados (exemplo: mudança de plano que altera o MRR).
identifyUser → Deve ser chamado sempre que o usuário logar ou atualizar seus dados (exemplo: mudança de cargo).

6. Exemplo completo

<script src="https://app.soog.com.br/soog-sdk.js"></script> <script>  // Inicializar o SDK  soog.init({ clientApiKey: 'SUA_CHAVE_API_DO_CLIENTE' });    // Identificar a empresa cliente  soog.identifyClient({    company: 'Acme Corporation',    mrr: 5000  });   // Identificar o usuário da empresa  soog.identifyUser({    name: 'João Silva',    email: 'joao@acme.com',    role: 'Gerente de Produto'  }); </script>

7. Benefícios de usar o SDK

Relaciona MRR de clientes às sugestões e feedbacks.
Permite acompanhar quem são os usuários mais ativos.
Melhora a priorização de sugestões com base no impacto financeiro.
Dá visibilidade tanto em nível de empresa quanto de usuário.

? Resumo:

Use soog.identifyClient() para identificar empresas e soog.identifyUser() para identificar usuários. Assim, você terá dados mais ricos, organizados e conectados dentro do Soog, ajudando sua empresa a tomar melhores decisões de produto.

Quer que eu já prepare uma variação desse artigo para desenvolvedores, com exemplos em frameworks como React ou Next.js?