Skip to main content

​
Objetivo

Guiar o produtor na criação do app, API Key, e configuração das URLs de callback para integração SSO com o ecossistema EasyGoal.
Pré-requisito: Step 1 concluído com integration_type = "integrated". Se integration_type = "external", este step pode ser pulado.

​
Fluxo no Typebot

1

Introdução SSO

Explicar o que será configurado e o que o produtor precisará ter em mãos.
2

Criação do App

Instruções para acessar /producer/api-keys, criar um novo app e salvar a API Key.
3

API Key Prefix

Input de texto: “Cole o prefixo da sua API Key (ex: eg_…AbC12345)” → variável api_key_prefix
4

URLs de Callback

  • URL de callback PRODUÇÃO (obrigatório) → callback_url_prod
  • URL de callback STAGING (opcional) → callback_url_staging
  • URL de callback LOCALHOST → callback_url_local
5

Scopes Selecionados

Checkboxes: user:read, user:email, billing:read, billing:write, products:read → selected_scopes
6

Instalação do Pacote

Instruções de instalação do @easygoal/auth e configuração do AuthProvider.
7

Teste de Integração

Botões: “O login funcionou?” → Sim / Não, tive problemas → sso_test_result
8

Ambiente de Teste

  • URL do staging → staging_url
  • Email de teste → test_email
  • Credenciais de teste → test_credentials

​
Instalação do Pacote SSO

npm install @easygoal/auth

const authConfig = {
  loginUrl: 'https://sso.easygoal.com.br',
  appUrl: 'https://meuapp.com',
  apiKey: 'SUA_API_KEY',
  scopes: ['user:read', 'user:email'],
};

​
Colunas da Planilha (Step 2)

ColunaHeaderVariável
Eapi_key_prefix{{api_key_prefix}}
Fcallback_url_prod{{callback_url_prod}}
Gcallback_url_staging{{callback_url_staging}}
Hcallback_url_local{{callback_url_local}}
Iselected_scopes{{selected_scopes}}
Jsso_test_result{{sso_test_result}}
Ksso_test_issue{{sso_test_issue}}
Lstaging_url{{staging_url}}
Mtest_email{{test_email}}
Ntest_credentials{{test_credentials}}

​
Checklist de Validação (Admin)

  • API Key existe e está pendente/aprovada
  • URLs de callback são HTTPS (exceto localhost)
  • URLs batem com o domínio do produto
  • Scopes solicitados fazem sentido para o tipo de app
  • Teste de login funciona no ambiente de staging
  • Pacote @easygoal/auth integrado corretamente