AI Prosumer
PT

CONSTRUA COM SHAREAI

Como ligar uma aplicação ao ShareAI Builder, passo a passo

Construa um aplicativo de agendamento que conecte clientes ao ShareAI, prepare agendas úteis com IA e coloque-os no controle de seus gastos com IA.

A experiência que você vai construir

JamZY · Agendamentos
A demonstração real de agendamento JamZY: escolha um serviço e horário, depois conecte opcionalmente ShareAI para gerar a preparação.

Escolha um agendamento. Conecte ShareAI. Chegue com um plano.

SUA IMPLEMENTAÇÃO

Uma conexão com o cliente que você pode construir.

Três entregáveis concretos: conectar o cliente, preparar seu agendamento e deixar a integração pronta para verificação.

Obtenha a referência de implementação
01ACESSO DO CLIENTE

Login e sessões renováveis

Um cliente seleciona sua conta ShareAI, aprova seu aplicativo e retorna para JamZY.

OAuth + PKCEConsentimento da conta
Você pode verificá-lo quando

Fazer login, atualizar a sessão e desconectar com sucesso.

Construa a conexão com o cliente
02IA DE AGENDAMENTO

Um rascunho útil de preparação

Transforme um objetivo de agendamento em uma agenda e perguntas por meio de uma solicitação deliberada de IA.

IA financiada pelo clienteAcesso a modelos
Você pode verificá-lo quando

Gere um rascunho; salvar um agendamento não faz nenhuma chamada de IA.

Construa o fluxo de preparação
03TERMOS & REVISÃO

Uma configuração que você pode verificar

Explique taxas opcionais de IA e colete as verificações de plataforma que sua submissão de revisão precisa.

Contratos aceitosVerificações de plataforma
Você pode verificá-lo quando

Cada plataforma incluída e escopo solicitado tem verificações registradas.

Defina os termos e verifique o aplicativo

LEVE PARA SEU EDITOR

Construa com seu agente.

Copie o guia completo com o objetivo de implementação, entradas necessárias e verificações de aceitação. Mantenha exemplos de código, tabelas e links de documentação juntos.

Guia completoContexto de implementaçãoVerificações de verificação
Mais formatos
Visualizar como Markdown Baixar Markdown

Pronto para seu projeto, no formato que você precisa.

Atualizado

Veja o que você vai construir

Você criará uma conexão que seus clientes podem entender: a conta ShareAI deles, um rascunho opcional de preparação com IA e um caminho claro de volta ao compromisso deles.

Onde você trabalhará Seu exemplo finalizado

Conecte seu aplicativo ao Builder ShareAI, desde a inscrição até uma integração testada pronta para revisão. Este tutorial usa JamZY, um pequeno aplicativo de agendamento de compromissos em Node.js, para mostrar cada etapa: registrar o aplicativo, configurar sua plataforma Web, conectar a conta ShareAI de um cliente e enviar uma solicitação autorizada de IA. Aplique os mesmos passos ao seu próprio produto.

CapacidadeO que o cliente concordaO que JamZY demonstra
Login com ShareAIUma conexão de conta e as informações de identidade que seu aplicativo solicita.Uma identidade privada do cliente a partir das informações autenticadas do Usuário.
Pague com ShareAI · Uso de IAUsando a conta pessoal ou organizacional selecionada pelo cliente para inferência autorizada.Um rascunho de preparação de compromisso financiado pelos créditos elegíveis dessa conta.
Builder markupA taxa adicional de uso de IA no contrato de aplicação aceito.Monetização de uso opcional, após aprovação e publicação do contrato.
Pagamentos de produtosUma compra específica apresentada em um checkout separado ShareAI.Uma extensão explicada no tutorial de pagamento. O demo de compromisso não implementa checkout.

Tenha uma conta ShareAI, permissão para usar a conta pessoal ou organizacional que será proprietária do aplicativo, um callback público HTTPS, um logotipo e páginas funcionais de privacidade, termos e exclusão de conta. Para executar o exemplo, use Node.js 22 ou mais recente e um endereço HTTPS para seu aplicativo.

JamZY · aplicativo de referência de compromisso Ampliar captura de tela ↗
A demonstração real de agendamento JamZY: escolha um serviço e horário, depois conecte opcionalmente ShareAI para gerar a preparação.
O agendamento local de compromissos e a preparação de IA financiada pelo cliente são ações separadas. Nenhum convite de calendário é enviado por esta demonstração.
  1. Escolha o tipo e a duração do compromisso.
  2. Selecione um horário de demonstração disponível.
  3. Conecte ShareAI para usar o assistente de IA opcional.
  4. A IA é executada somente após esta ação explícita; apenas agendar não chama ShareAI.
Use os detalhes do seu próprio aplicativo

As capturas de tela usam detalhes de aplicativos de exemplo. Os endereços ShareAI neste guia são endereços de produção. A geração de preparação faz uma solicitação real de IA e pode gastar créditos; selecionar ou salvar um compromisso de demonstração não faz isso. As verificações de verificação são concluídas pelos seus próprios testes de integração bem-sucedidos.

Você está pronto para continuar quando

Você pode distinguir login de conta, consumo de IA, sobretaxa opcional e uma compra de produto confirmada. Ler este guia não exige uma solicitação paga.

Participe do Programa Builder

Você criará a identidade do Builder que possui seu aplicativo e seus relacionamentos com clientes.

Onde você trabalhará Console → Programa Builder

  1. Crie ou entre na sua conta ShareAI. Escolha a conta pessoal ou organizacional que será proprietária de JamZY; use a mesma conta durante toda a configuração.
  2. Abrir Builder Program no Console ShareAIEscolha as atividades de builder que correspondem ao seu trabalho. Para este guia, escolha o caminho da empresa de produtos para um aplicativo que você possui. Trabalho de Cliente é para serviços entregues a um cliente; uma integração conecta um aplicativo existente.
  3. Selecione a conta pessoal ou organizacional que será proprietária da inscrição no programa antes de aplicar. Organizações podem enviar uma aplicação antes da verificação, mas a aprovação da equipe sozinha não ativa o acesso. Complete a verificação de email da organização e da empresa a partir da checklist de onboarding no Console. Uma organização aprovada permanece Pending verification até que ambas as verificações sejam concluídas. Builder, Provider e programas Creator seguem esta regra.
  4. Após a aceitação, abra Builder Program → Product. O alternador de ator identifica a conta que você está editando.
Builder Program · ponto de entrada de inscrição Ampliar captura de tela ↗
A página inicial Builder Program apresenta o caminho do produto e links para inscrição no Console.
Comece com o caminho do produto, depois conclua a inscrição para a conta que será proprietária do JamZY.
  1. Continue para o Console para se inscrever no Builder Program.
Você está pronto para continuar quando

Builder Program abre para o proprietário pretendido e oferece Novo aplicativo. Uma decisão de inscrição, revisão do aplicativo, revisão de informações públicas e aprovação de Monetization Gateway são etapas separadas.

Crie sua aplicação

Você dará ao JamZY seu próprio registro de aplicativo, para que sua identidade, acesso e termos comerciais permaneçam juntos.

Onde você trabalhará Programa Builder → Produto → Novo aplicativo

  1. Em Product, selecione Novo aplicativo. Insira seu site público para preencher os detalhes iniciais ou escolha Eu os escreverei manualmente.
  2. Faça upload de um logotipo PNG ou JPEG, insira JamZY como o nome e descreva o produto em uma frase clara. Revise o site e o e-mail de contato do builder.
  3. Continue nas perguntas de configuração. Mantenha as respostas verdadeiras: elas descrevem como o aplicativo é entregue e pago.
Configuração do aplicativo · detalhes Ampliar captura de tela ↗
Revise o nome do aplicativo, introdução, logotipo e site público antes de continuar. Os detalhes de contato são ilustrativos.
Revise o nome do aplicativo, introdução, logotipo e site público antes de continuar. Os detalhes de contato são ilustrativos.
  1. Dê ao aplicativo um nome claro.
  2. Continue para as perguntas de integração.

Use um site público acessível para o perfil da aplicação. Um site privado ou apenas local pode falhar na validação mesmo quando seu callback de desenvolvimento está registrado corretamente. A nova aplicação começa como um rascunho. Você pode continuar editando sem torná-la pública. O identificador da aplicação é diferente de um ID de cliente OAuth ou um ID de assinatura.

Você está pronto para continuar quando

JamZY aparece sob Produto para o proprietário pretendido. Não crie uma aplicação extra para cada plataforma de dispositivo.

Descreva como seu aplicativo é entregue

Você receberá opções de OAuth que se ajustam ao local onde sua aplicação é executada e quem controla suas credenciais.

Onde você trabalhará Novo aplicativo → Configuração do aplicativo

Para uma implantação JamZY que você opera por conta própria, escolha o modelo de precificação que corresponde à sua oferta: SaaS, aplicativo em nuvem hospedado pelo fornecedor, o cliente paga pelo próprio consumo e ShareAI para solicitações de IA. Estas são respostas de exemplo, não um requisito para todos os produtos.

Configuração do aplicativo · implantação Ampliar captura de tela ↗
A resposta de integração determina se um segredo de cliente do servidor estará disponível.
A resposta de integração determina se um segredo de cliente do servidor estará disponível.
  1. Escolha onde seu aplicativo realmente será executado.
Onde o aplicativo é executadoEscolha OAuthOnde as credenciais residem
Seu backend hospedadoO cliente do servidor Web pode usar um segredo de cliente. PKCE ainda se aplica.O segredo e os tokens permanecem no seu servidor.
Aplicativo de navegador / SPACliente Web público com PKCE.Nenhum segredo de cliente embutido. Use um design de sessão apropriado para navegador ou backend.
Distribuição auto-hospedada ou híbridaCliente público com PKCE sob a política de integração.Não distribua um segredo compartilhado do fornecedor para instalações do cliente.
Windows, macOS, Linux, Android ou iOSUm cliente público para cada plataforma habilitada.PKCE e armazenamento seguro apropriado para a plataforma; nenhum segredo incorporado.

O exemplo para download JamZY usa deliberadamente um cliente Web público com PKCE, mesmo que tenha um pequeno backend. O servidor mantém os tokens fora do armazenamento do navegador. Uma resposta hospedada pelo fornecedor permite um cliente do servidor; isso não obriga você a escolher um.

Você pode revisar as respostas salvas em Informações do Aplicativo → Configuração do aplicativo. Alterações na implantação podem remover segredos de cliente incompatíveis e exigir verificação repetida. Revise esse impacto antes de salvar.

Você está pronto para continuar quando

A implantação salva descreve sua arquitetura real. A opção de segredo de cliente segue essa resposta; uma opção desativada é uma explicação da política, não uma credencial ausente.

Precisa dos detalhes?Registro de cliente ↗

Apresente seu aplicativo claramente

Você fornecerá aos clientes os detalhes do produto e as políticas necessárias antes que eles decidam se conectar.

Onde você trabalhará Informações do Aplicativo

Abra Informações do Aplicativo após o Painel. Trabalhe nas seções dedicadas: detalhes, configuração do aplicativo, apresentação, branding, galeria e revisão. Dê ao produto uma descrição útil, um site preciso e capturas de tela claras do fluxo de trabalho do cliente.

Informações do Aplicativo Ampliar captura de tela ↗
Dê à sua aplicação um nome próprio, introdução e site público HTTPS.
Dê à sua aplicação um nome próprio, introdução e site público HTTPS.
  1. Desenvolva os detalhes, configuração, apresentação e branding em suas próprias seções.

Use a identidade do seu próprio aplicativo. A marca ShareAI pertence ao botão de integração e ao material explicativo; ela não deve substituir o logotipo do seu produto. Mantenha links de privacidade, termos e exclusão acessíveis sem necessidade de login.

Salve as alterações quando a ação de salvar flutuante aparecer. A proposta de informações públicas tem sua própria revisão; editar uma proposta aprovada não substitui silenciosamente a apresentação pública ao vivo.

Você está pronto para continuar quando

Um visitante pode entender o que JamZY faz, quem o opera e como solicitar a exclusão. Os detalhes públicos e a configuração de callback referem-se ao mesmo produto.

Escolha o que os clientes podem autorizar

Você solicitará o acesso que sua experiência de agendamento realmente utiliza e deixará claro o propósito de faturamento.

Onde você trabalhará Aplicativo → Casos de Uso

Em Casos de Uso, habilite Login com ShareAI para conexão de conta e Pay with ShareAI para o fluxo financiado pelo cliente que você pretende suportar. Solicite acesso a Monetization Gateway apenas se seu produto gerar uma taxa adicional sobre o uso de IA. Siga o status de aprovação exibido no Console.

Log-in with ShareAI, Pay with ShareAI e Monetization Gateway possuem estados de configuração e aprovação separados.
Log-in with ShareAI, Pay with ShareAI e Monetization Gateway possuem estados de configuração e aprovação separados.
  1. Configure o Login com ShareAI.
  2. Ative o uso financiado pelo cliente.
EscopoPor que você o solicitaria
openidConecte uma conta usando sua identidade com escopo de cliente.
profile / emailSolicite reivindicações de perfil ou e-mail apenas se seu produto precisar delas.
inferenceChame endpoints de inferência de IA suportados quando permitido pela configuração do aplicativo.
monetization_gatewayUse o contrato de faturamento de IA aceito pelo cliente para inferência com sobretaxa.
paymentsCrie e inspecione solicitações de pagamento do cliente. Cada compra ainda precisa de confirmação.

Solicitações de JamZY openid profile inference monetization_gateway. Não solicita payments e não vende um produto por meio do checkout. Habilitar uma funcionalidade no Console não a concede a um token de acesso existente: o cliente deve autorizar os escopos e os termos.

Você está pronto para continuar quando

As funcionalidades, os escopos configurados e a solicitação de autorização concordam. Evite solicitar acessos opcionais que seu aplicativo nunca utiliza ou não pode verificar.

Configure sua integração Web

Você criará um cliente Web para a experiência baseada em navegador JamZY, com o método de autenticação correto.

Onde você trabalhará Configurações OAuth → Web

  1. Abra as configurações OAuth. Escolha Web na grade de plataformas. Você pode configurar um cliente por plataforma: Web, Windows, macOS, Linux, Android e iOS.
  2. Para este exemplo, escolha Aplicativo de navegador / SPA, o cliente público PKCE. Um aplicativo Web de servidor é apropriado apenas quando sua política de implantação o permite e seu backend pode proteger um segredo.
  3. Copie seu próprio ID de cliente Web. Mantenha a plataforma em Teste enquanto você a integra. Nunca copie um ID de uma captura de tela ou reutilize o registro da demonstração compartilhada para um produto diferente.
Configurações OAuth · grade de plataformas Ampliar captura de tela ↗
Um cliente registrado por plataforma. Plataformas não configuradas permanecem opcionais.
Um cliente registrado por plataforma. Plataformas não configuradas permanecem opcionais.
  1. Abra a integração única para Web.
  2. Adicione Android apenas quando seu produto o suportar.
Web · Visão Geral Ampliar captura de tela ↗
Um cliente público para Web usa PKCE e não possui segredo de cliente. O ID do cliente é redigido.
Um cliente público para Web usa PKCE e não possui segredo de cliente. O ID do cliente é redigido.
  1. Copie seu próprio ID de cliente para Web.
  2. Um cliente público não recebe um segredo.

Diferentes plataformas possuem credenciais e regras de callback diferentes. Elas não são produtos separados: assinaturas e gerenciamento de clientes são agregados para o aplicativo. Testadores de aplicativos são compartilhados entre plataformas, com um máximo de cinco lugares, incluindo convites pendentes; o proprietário não consome um lugar de testador.

Você está pronto para continuar quando

Existe exatamente uma plataforma Web. Plataformas nativas que você não configurou não bloqueiam seu lançamento.

Precisa dos detalhes?Registro de plataforma ↗

Traga os clientes de volta ao seu aplicativo

Você retornará os clientes para sua aplicação após a autorização, usando um callback exato que você possui.

Onde você trabalhará Web → Configuração

Em Web → Configuração, registre o callback HTTPS exato que sua aplicação gerencia. Este guia usa https://jamzy.example/oauth/callback como exemplo. Substitua jamzy.example pelo domínio HTTPS onde você implanta sua cópia de JamZY, e use esse mesmo callback na configuração de sua aplicação.

Web · Configuração Ampliar captura de tela ↗
Registre o callback que sua aplicação implantada gerencia.
Registre o callback que sua aplicação implantada gerencia.
  1. Registre o callback que sua aplicação implantada gerencia.

Forneça o nome da tela de consentimento, termos, informações de privacidade e exclusão. Habilite apenas os escopos necessários e, em seguida, salve. Esquema, host, caminho e detalhes de consulta aplicáveis devem corresponder à solicitação de autorização e troca de código. Não use um caractere curinga ou um fragmento de URL.

PlataformaCallback para implementar
WebEndereço HTTPS exato na sua aplicação.
AndroidUm esquema de aplicativo de domínio reverso correspondente ao ID da aplicação, ou um App Link HTTPS verificado com o pacote e a impressão digital de assinatura SHA-256.
iOSUm esquema de aplicativo correspondente, ou um Link Universal HTTPS verificado com o ID do pacote e o prefixo do Apple App ID.
Windows / macOS / LinuxUm callback HTTPS exato permitido, um esquema de aplicação de domínio reverso correspondente, ou um redirecionamento de loopback suportado em 127.0.0.1 / [::1]. A porta de loopback pode variar.

Aplicativos instalados autorizam no navegador do sistema e retornam através do callback registrado. Para links de aplicativos HTTPS reivindicados, publique o arquivo de associação necessário e execute a verificação de associação no Console. Um callback que parece plausível em um formulário não é prova de que seu aplicativo instalado o recebe.

Você está pronto para continuar quando

Abrir o callback através do fluxo de autorização retorna para seu aplicativo. Um código aleatório ou estado incompatível é rejeitado.

Execute sua própria aplicação JamZY

Você terá a interface de agendamento e sua conexão ShareAI funcionando com seus próprios identificadores de aplicação.

Onde você trabalhará Sua aplicação → Configuração de ambiente

JamZY é uma aplicação de agendamento com um assistente de preparação de IA opcional. Seu agendador é uma demonstração apenas no navegador: não há provedor de calendário, entrega de e-mail ou pagamento de agendamento. A autorização ShareAI e a integração da API de IA usam o upstream configurado real.

Baixe o JamZY código fonte de referência. Ele contém o servidor Node, UI do navegador, testes e um README de configuração; sem certificados, segredos, dependências ou sessões. Revise os arquivos antes de executá-los. Coloque o processo Node atrás de um proxy reverso HTTPS que preserve a origem pública.

# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1
# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs

# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjs
Mantenha os ambientes juntos

Crie sua aplicação em console.compartilharai.agora. Use seu ID de cliente de produção com https://auth.shareai.now e https://api.shareai.now/api/v1. O jamzy.example endereço é um placeholder para sua aplicação, não uma demonstração hospedada. Sirva sua própria aplicação via HTTPS para que seu cookie de sessão segura funcione.

JamZY também oferece uma conexão com chave de API para comparação. Este tutorial usa o botão de carteira/OAuth. Uma chave de API não estabelece o acordo OAuth do cliente JamZY e não substitui o fluxo de autorização do cliente.

Você está pronto para continuar quando

O aplicativo carrega via HTTPS. Sua origem pública, callback registrado e ID de cliente correspondem ao seu registro. Nenhum token ou segredo aparece no código fonte da página ou no localStorage.

Conecte seu primeiro cliente

Você permitirá que um cliente escolha sua conta ShareAI e aprove o acesso que seu aplicativo precisa.

Onde você trabalhará JamZY → Pague com sua ShareAI Carteira

A partir de JamZY, selecione Pague com sua ShareAI Carteira. O aplicativo abre a página de autorização ShareAI. O cliente faz login, seleciona uma conta pessoal ou organizacional, verifica o aplicativo e o acesso solicitado, e aceita os termos de assinatura aplicáveis.

  1. JamZY → AutenticaçãoCrie um estado aleatório e um verificador PKCE; envie seu desafio S256 com a solicitação de autorização.
  2. Cliente → AutenticaçãoEscolha a conta pagadora e revise os termos de acesso e cobrança. Cancelar deve deixar JamZY desconectado.
  3. Autenticação → callbackReceba um código único e de curta duração e o estado. Valide o estado contra a mesma sessão.
  4. Backend → tokenTroque esse código com o verificador original e o URI de redirecionamento idêntico. Clientes públicos não enviam segredo do cliente.
  5. Backend → Informações do usuárioUse o token de acesso para ler a identidade autenticada, depois estabeleça a própria sessão segura de JamZY.
Web · Endpoints de produção Ampliar captura de tela ↗
Use estes endereços de produção ShareAI com o ID do cliente do console.shareai.now.
Use estes endereços de produção ShareAI com o ID do cliente do console.shareai.now.
  1. Autorize em auth.shareai.now/oauth/authorize.
  2. Troque códigos e tokens de atualização em auth.shareai.now/oauth/token.
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
  client_id: clientId, response_type: 'code', redirect_uri: callback,
  scope: 'openid profile inference monetization_gateway', state,
  code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.

Identifique o registro local do cliente pela identidade autenticada, com escopo do cliente sub e seu contexto de emissor/cliente. Autorizações pessoais e organizacionais podem selecionar diferentes contas pagadoras. Um ID de cliente não é um ID de usuário global, endereço de e-mail ou ID de banco de dados interno da organização. Não mescle identidades entre plataformas comparando nomes exibidos.

Você está pronto para continuar quando

Cancelar, estado incompatível, código repetido e autorização expirada falham de forma segura. O fluxo normal retorna uma conta autenticada sem expor seus tokens.

Mantenha o cliente conectado com segurança

Você manterá solicitações autorizadas funcionando enquanto os tokens expiram, oferecendo ao cliente uma maneira confiável de desconectar.

Onde você trabalhará Sua aplicação → Manipulação de sessão e token

CredencialPropósitoComo manipulá-la
Código de autorizaçãoTransferência única da página de autorização.Troque uma vez, usando o verificador correspondente e o callback. Não é um token de API.
Token de acessoAutoriza chamadas de API dentro do grant e escopos aceitos.Envie como Authorization: Bearer …. Respeite a expiração e os erros de autorização do endpoint.
Token de atualizaçãoObtém tokens de acesso substitutos sem outro login enquanto o grant permanece válido.Armazene com segurança. Serialize operações de atualização e substitua credenciais rotacionadas de forma atômica.
Token de IDUma afirmação de identidade OpenID Connect para o cliente.Se você usá-lo, valide assinatura, emissor, público, expiração e nonce conforme aplicável. Não o use como um token Bearer inferido.
Segredo do clienteAutentica um cliente de servidor confidencial permitido.Armazene no servidor. É diferente de todos os tokens e nunca é incluído em um cliente público.
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=refresh_token' \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"

Use o retorno expires_in em vez de inventar um tempo de vida. Se a atualização retornar um token de atualização substituto, persista-o com o novo token de acesso como uma única atualização. Permita uma atualização em andamento por sessão para que solicitações simultâneas não reutilizem um token rotacionado. Um grant de atualização inválido ou revogado exige reconexão; não faça loops indefinidamente.

A atualização não pode adicionar um escopo ou aceitar silenciosamente um novo contrato Monetization Gateway. Envie o cliente novamente pelo processo de autorização para novas permissões ou termos. JamZY armazena credenciais apenas na memória do servidor por no máximo uma sessão de demonstração de uma hora, autentica informações do Usuário em vez de confiar em um token de ID não verificado e usa um cookie Seguro, HttpOnly, SameSite. Um serviço de produção precisa de seu próprio design de sessão durável e protegido.

Ao desconectar, revogue as credenciais de atualização/acesso onde aplicável e limpe a sessão do aplicativo. Limpar apenas um cookie do navegador não revoga uma concessão ShareAI ou cancela uma assinatura paga. Evite registrar códigos, tokens, segredos ou conteúdo de prompt pessoal.

Você está pronto para continuar quando

A expiração aciona uma atualização controlada; novos tokens substituem os antigos. A desconexão limpa a sessão do aplicativo e relata qualquer falha de revogação.

Prepare o primeiro compromisso com IA

Você transformará um objetivo de compromisso em uma agenda e perguntas úteis, com uma solicitação explícita de IA financiada pelo cliente.

Onde você trabalhará Modelos Disponíveis → JamZY → Venha preparado

Abra Modelos Disponíveis no aplicativo. Selecione os modelos e provedores que seu produto oferecerá e salve a configuração. Se o catálogo não puder ser carregado, resolva o erro de disponibilidade upstream antes de prosseguir; alterar repetidamente os clientes OAuth não o corrigirá.

Modelos Disponíveis Ampliar captura de tela ↗
Escolha quais modelos e provedores seus clientes podem usar. Resolva qualquer erro no catálogo antes de continuar.
Escolha quais modelos e provedores seus clientes podem usar. Resolva qualquer erro no catálogo antes de continuar.
  1. O catálogo de modelos pertence a este aplicativo.

JamZY carrega seu catálogo apenas após a conexão. Escolha um modelo de texto permitido, insira um objetivo de compromisso curto e selecione Gerar preparação deliberadamente. A conta selecionada precisa de créditos elegíveis e de quaisquer termos de cobrança de IA aceitos necessários. Escolher uma data, revisar um compromisso e salvá-lo não envia uma solicitação de inferência.

curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'

Siga o fluxo de compromisso em JamZY

  1. Em Agendar, escolha um serviço: uma introdução de 15 minutos, planejamento de projeto de 30 minutos ou uma conversa mais aprofundada de 60 minutos.
  2. Escolha um dia e um horário disponível. Os horários usam o fuso horário exibido pelo navegador. A disponibilidade é ilustrativa e compromissos salvos afetam apenas este navegador.
  3. Em Venha preparado, insira um objetivo de exemplo sem detalhes pessoais. Escolha um modelo e, em seguida, selecione Gerar preparação. JamZY envia o serviço selecionado e seu objetivo para ShareAI, renderiza o texto retornado com segurança e deixa a reserva inalterada.
  4. Revise a agenda você mesmo. Selecione Revisar compromisso, verifique seu serviço, dia, horário e duração, e então Confirme o compromisso de demonstração. Esta ação não chama IA nem realiza um pagamento.
  5. Abra Meus compromissos para ver o registro de demonstração salvo. Recarregue para confirmar que ele persiste ou remova-o para tornar o horário disponível novamente. Apenas o serviço, dia, horário e uma referência local aleatória são armazenados; rascunhos de IA, objetivos, tokens e chaves não são salvos com os compromissos.
Revise o serviço, data, horário e duração antes de salvar este compromisso de demonstração apenas no navegador. Ampliar captura de tela ↗
Revise o serviço, data, horário e duração antes de salvar este compromisso de demonstração apenas no navegador.
Revise o serviço, data, horário e duração antes de salvar este compromisso de demonstração apenas no navegador.
  1. Revise a seleção completa antes de confirmar.
  2. Esta ação salva um registro de demonstração; ela não chama IA nem realiza pagamento.
Meus compromissos mostra registros de demonstração locais. Remover um registro torna seu horário ilustrativo disponível novamente. Ampliar captura de tela ↗
Meus compromissos mostra registros de demonstração locais. Remover um registro torna seu horário ilustrativo disponível novamente.
Meus compromissos mostra registros de demonstração locais. Remover um registro torna seu horário ilustrativo disponível novamente.
  1. O registro persiste neste navegador sem detalhes pessoais ou notas de IA.
  2. Remova o compromisso de demonstração e libere seu horário.

Um produto de agendamento real precisa de um armazenamento de reservas no servidor, verificações de disponibilidade, gerenciamento de fuso horário, política de cancelamento e integração de calendário ou notificações. Estes são separados da autorização ShareAI. Mantenha a saída de IA como uma proposta; valide qualquer ação futura de reserva por meio das regras do seu próprio aplicativo.

Use um slug de modelo retornado pelo catálogo permitido. Lide com o contrato de resposta real: JamZY suporta o envelope nativo de ShareAI e estilo OpenAI. message.content envelope e estilo OpenAI. choices[0].message.contentHTTP 200 com uma resposta de erro incompleta ou aninhada não é uma resposta bem-sucedida.

Em uma resposta de limite de gastos ou crédito insuficiente, mostre uma explicação útil e o link de cobrança fornecido ao cliente. Preserve a conta selecionada. Não ultrapasse seu limite, troque o pagador silenciosamente ou tente novamente uma operação cobrada em um loop.

Você está pronto para continuar quando

A geração de preparação retorna uma agenda utilizável e perguntas. A solicitação é atribuída ao cliente e aplicação autorizados, com o modelo selecionado e os termos aceitos. O rascunho de IA não pode agendar ou alterar um compromisso.

Defina seus ganhos opcionais com IA

Você explicará sua taxa adicional de IA em uma oferta de assinatura e publicará os termos que os clientes podem aceitar.

Onde você trabalhará Aplicação → Assinaturas

Solicite acesso a Monetization Gateway por meio dos Casos de Uso do aplicativo, caso ainda não esteja aprovado pela política administrativa aplicável. Complete o questionário e acompanhe seu status. A aprovação habilita a configuração; a permissão do cliente e o consentimento de faturamento permanecem separados.

Assinaturas · Visão geral Ampliar captura de tela ↗
Novos aplicativos começam sem um contrato publicado. Adicione uma oferta antes de publicar seus termos.
Novos aplicativos começam sem um contrato publicado. Adicione uma oferta antes de publicar seus termos.
  1. Crie uma oferta em seu próprio editor.
  1. Assinaturas Abertas. Adicione uma oferta, dê um nome claro e descreva o markup Builder que os clientes pagarão. O ID de assinatura gerado é somente leitura e limitado a este aplicativo; copie-o quando sua integração precisar dele.
  2. Edite cada assinatura em seu próprio editor. Use Estimar para inspecionar o custo de rede e seus ganhos para o modelo selecionado e as suposições de uso. As estimativas são pré-visualizações, não preços garantidos ou termos aceitos.
  3. Revise o rascunho juntos, depois publique a versão do contrato quando seus requisitos forem satisfeitos. A versão publicada descreve o que novos clientes podem aceitar.
  4. Use a visão geral e a distribuição de contratos para ver quantas contas permanecem em cada versão aceita. Um cliente mantém os termos aceitos até que aceite explicitamente uma substituição; publicar uma nova versão não migra silenciosamente os clientes. Mantenha a transição padrão que preserva os contratos aceitos. Se você optar deliberadamente por Exigir consentimento renovado antes de outras ações do aplicativo, o acesso existente pode ser interrompido até que o cliente aprove os novos termos.

Apenas exemplo: um markup 20% Builder em €1.00 do custo de rede elegível adiciona €0.20. No preço Padrão, a taxa de ShareAI 5% aplica-se apenas a esse markup €0.20, antes de qualquer Ingestão de Evento faturável. Use o estimador ao vivo e o contrato aceito para o cálculo real. Uma oferta de assinatura neste fluxo é um acordo de faturamento de IA; a conexão da conta por si só não debita um preço fixo recorrente.

Assinaturas · editor de oferta Ampliar captura de tela ↗
Um rascunho ilustrativo de oferta. Seu ID de assinatura gerado é somente leitura e está vinculado a este aplicativo.
Um rascunho ilustrativo de oferta. Seu ID de assinatura gerado é somente leitura e está vinculado a este aplicativo.
  1. Use um nome de oferta voltado para o cliente.
  2. Defina o AI surcharge para esta oferta.

A tela de consentimento ShareAI é autoritativa para os termos aceitos. O cliente público de JamZY não pode inferir o plano de cobrança aceito a partir das informações do Usuário, então seu painel de conexão não reivindica uma assinatura ativa nem inventa um preço para o agendamento.

Você está pronto para continuar quando

A oferta explica a taxa; o contrato pode ser aceito pelo cliente. Você entende quais clientes permanecem nos termos antigos e por quê.

Comprove que as plataformas incluídas funcionam

Você coletará o endpoint real e as verificações de escopo necessárias para enviar sua aplicação para revisão.

Onde você trabalhará Configurações OAuth → Testadores e Verificação

Abra as configurações OAuth → Testadores e convide até cinco testadores abrangentes da aplicação. Convites pendentes ocupam um lugar, mas não concedem acesso; o destinatário deve aceitar. O acesso do proprietário e o acesso do testador convidado são diferentes do acesso público em produção.

Testadores da aplicação Ampliar captura de tela ↗
Uma única lista de testadores serve para todas as plataformas. Convites pendentes contam para o limite de cinco lugares.
Uma única lista de testadores serve para todas as plataformas. Convites pendentes contam para o limite de cinco lugares.
  1. Cinco lugares são compartilhados por toda a aplicação.
  2. Convide um testador aqui, depois aguarde sua aceitação.
Web · Verificação Ampliar captura de tela ↗
Uma nova integração mostra verificações pendentes até que chamadas reais bem-sucedidas sejam registradas. Este rascunho de referência não passou por revisão.
Uma nova integração mostra verificações pendentes até que chamadas reais bem-sucedidas sejam registradas. Este rascunho de referência não passou por revisão.
  1. O Console registra o sucesso real dos endpoints.
  2. Cada escopo solicitado também deve ser exercido.

Para cada plataforma que você pretende publicar, abra Verificação. Complete chamadas reais bem-sucedidas para os endpoints necessários e cada escopo configurado. Verifique as chaves de descoberta e assinatura; teste autorização/callback, troca de código, atualização, informações autenticadas do Usuário e revogação. Clientes confidenciais também devem testar introspecção aplicável. Links HTTPS reivindicados nativamente precisam de verificação de associação.

Um escopo de perfil/email precisa de suas declarações retornadas reais; use uma conta de teste pessoal onde o email seja obrigatório. Os escopos inference e monetization_gateway precisam de uma solicitação de IA autorizada concluída. Pagamentos precisam de uma chamada de API de pagamento com escopo bem-sucedida. Uma resposta HTTP genérica bem-sucedida, captura de tela do navegador ou checklist manual não substituem as verificações registradas no Console.

Você tem três opções para uma plataforma inacabada: finalize e verifique-a, exclua-a da publicação para que permaneça apenas para proprietário/testador ou remova-a. Não inclua uma plataforma com callbacks ou escopos que você não tenha exercido. Alterações na configuração podem invalidar as verificações, então atualize o status registrado após suas alterações finais.

Você está pronto para continuar quando

Cada plataforma incluída mostra a configuração necessária, verificações de endpoint e escopo como completas. A checklist pessoal do guia é apenas um auxílio de leitura.

Envie seu aplicativo e acompanhe seus clientes

Você saberá o que está pronto para revisão, como funciona a publicação e onde acompanhar o acesso dos clientes posteriormente.

Onde você trabalhará Aplicação → Painel

  1. Retorne ao Painel e resolva cada ação pendente. O envio para revisão deve permanecer indisponível até que a aplicação e todas as plataformas incluídas atendam aos seus requisitos.
  2. Submeta a aplicação para revisão pela ShareAI. Acompanhe a decisão e quaisquer alterações solicitadas no Dashboard e em Atividade & Decisões. Pedidos de apresentação pública e do Portal de Monetização podem ter decisões separadas.
  3. Após a aprovação, publique o aplicativo usando os controles de publicação disponíveis. Confirme que as plataformas incluídas estão prontas para produção; as excluídas permanecem em Testing.
  4. Abra Customers para contas no nível do aplicativo e Subscriptions para distribuição de contratos aceitos. Analytics ajuda você a acompanhar o uso de IA atribuído e os ganhos. Identificadores de clientes permanecem privados no contexto apropriado de cliente/autorização.
Dashboard · prontidão para lançamento Ampliar captura de tela ↗
A revisão permanece bloqueada enquanto o aplicativo e as plataformas incluídas tiverem requisitos pendentes.
A revisão permanece bloqueada enquanto o aplicativo e as plataformas incluídas tiverem requisitos pendentes.
  1. Resolva as ações necessárias antes de enviar para revisão.
A visualização do aplicativo reúne contas conectadas sem exibir IDs internos do banco de dados da organização.
A visualização do aplicativo reúne contas conectadas sem exibir IDs internos do banco de dados da organização.
  1. A gestão de clientes é agregada para o aplicativo.

Experimente todo o fluxo novamente com um cliente elegível após o lançamento: conecte, inspecione a conta e o consentimento, gere um rascunho curto de preparação para o compromisso, atualize com segurança, lide com uma falha de cobrança e, em seguida, desconecte. Verifique a experiência do usuário ao vivo em vez de assumir que um salvamento bem-sucedido prova que funciona.

Quando algo não funciona

Incompatibilidade de callback: compare exatamente o URL registrado e ambos os valores da solicitação. Testador não autorizado: confirme a aceitação do convite e a conta selecionada. Escopo ou contrato ausente: solicite apenas acesso habilitado e reconecte para aceitá-lo. Nenhum modelo: inspecione Modelos Disponíveis e restrições do provedor. Falha ao atualizar: limpe a sessão local com falha e reconecte. Revisão bloqueada: inspecione as verificações da plataforma em vez de criar outro cliente OAuth.

Você está pronto para continuar quando

O aplicativo funciona para o cliente pretendido, as verificações registradas suportam seu estado de publicação, e o cliente pode controlar ou revogar a autorização.

Verificação de organização e acesso ao programa

Selecione a conta pessoal ou organizacional que será proprietária da inscrição no programa antes de aplicar. Organizações podem enviar uma aplicação antes da verificação, mas a aprovação da equipe sozinha não ativa o acesso. Complete a verificação de email da organização e da empresa a partir da checklist de onboarding no Console. Uma organização aprovada permanece Pending verification até que ambas as verificações sejam concluídas. Builder, Provider e programas Creator seguem esta regra.

Ver Monetization Gateway preços · Explorar ShareAI for Startups · Escopos e permissões

Permissões e termos aceitos

Seus Termos & Condições públicos, Política de Privacidade e instruções de exclusão devem corresponder ao aplicativo e permanecer acessíveis sem login. A aceitação do programa ShareAI, a aprovação de Monetization Gateway, a permissão OAuth do cliente e o contrato de cobrança aceito são decisões separadas. A atualização não pode adicionar permissões ou aceitar novos termos comerciais.

O escopo legado surcharge continua aceito para integrações existentes. Novos exemplos utilizam monetization_gateway. Mantenha os campos de fio existentes, como surcharge_bps e surcharge_percentage, inalterados.

Ver Monetization Gateway preços · Explorar ShareAI for Startups · Escopos e permissões

Taxas de Gateway e suporte Startup

Cobranças padrão 5% do markup Builder. Para €2.00 do custo de rede de IA e um markup de 10%, o cliente paga €2.20. ShareAI recebe €0.01 do markup €0.20; o Builder tem €0.19 antes da Ingestão de Eventos.

O primeiro 1,000 pedido de Produção liquidado Monetization Gateway é gratuito a cada mês do calendário (UTC), compartilhado na conta Builder. Pedidos adicionais custam €0.04 por 1,000 antes de descontos elegíveis. Um pedido liquidado cria um evento.

Pay with ShareAI por conta própria, acesso somente inference, chaves de API de conta comum e tráfego de Staging ou teste não geram Ingestão de Eventos Monetization Gateway.

ShareAI for Startups oferece uma cota mensal compartilhada para taxas reais de ShareAI em uma aplicação aprovada. Os níveis atuais de Launch, Growth e Momentum listam €1,000, €5,000 e €10,000 por mês. O mesmo orçamento cobre a taxa percentual de ShareAI sobre o markup de Builder e a ingestão de eventos faturáveis juntos. Não é uma cota de markup bruto, uma cota separada de eventos gratuitos ou inferência de IA gratuita inference. Os primeiros 1,000 eventos gratuitos da conta não consomem essa cota.

As taxas restantes de ingestão de eventos são pagas a partir dos novos ganhos do pedido em Builder, depois dos ganhos de IA disponíveis em Builder e créditos de IA irrestritos. As cobranças de IA do cliente e o produto payments permanecem separados.

ShareAI pode aprovar taxas específicas de aplicação ou suporte de taxas por um período fixo ou até que sejam alteradas. Revise os preços atuais da aplicação e os Programas Especiais no Console para seus termos aprovados, validade e cota consumida. Uma mudança de nível ou substituição de preços não redefine o uso mensal da aplicação.

Launch mantém o Log in com ShareAI como opcional. Growth e Momentum exigem isso; Momentum também exige o selo oficial ShareAI for Startups no rodapé da aplicação. ShareAI verifica o selo semanalmente. Tentativas confirmadas de contornar os requisitos podem levar à despromoção, remoção do Programa Startup ou retirada do Marketplace sob os termos do programa aceitos.

As taxas empresariais são configuradas pela equipe ShareAI para a conta Builder após concordar com uma oferta personalizada. A porcentagem atribuída e a taxa de evento se aplicam a solicitações futuras.

Ver Monetization Gateway preços · Explorar ShareAI for Startups · Escopos e permissões

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI