AI Prosumer
ES

CONSTRUYE CON SHAREAI

Cómo conectar una aplicación a ShareAI Builder, paso a paso

Crea una aplicación de citas que conecte a los clientes con ShareAI, prepare agendas útiles de IA y les dé control sobre su gasto en IA.

La experiencia que construirás

JamZY · Citas
La demostración real de citas de JamZY: elija un servicio y una hora, luego conecte opcionalmente ShareAI para generar la preparación.

Elige una cita. Conecta ShareAI. Llega con un plan.

TU IMPLEMENTACIÓN

Una conexión con el cliente que puedes construir.

Tres entregables concretos: conecta al cliente, prepara su cita y haz que la integración esté lista para verificar.

Obtén la referencia de implementación
01ACCESO DEL CLIENTE

Inicio de sesión y sesiones renovables

Un cliente selecciona su cuenta ShareAI, aprueba tu aplicación y regresa a JamZY.

OAuth + PKCEConsentimiento de cuenta
Puedes verificarlo cuando

Inicia sesión, actualiza la sesión y desconéctate exitosamente.

Construye la conexión con el cliente
02IA PARA CITAS

Un borrador útil de preparación

Convierte un objetivo de cita en una agenda y preguntas mediante una solicitud deliberada de IA.

IA financiada por el clienteAcceso a modelos
Puedes verificarlo cuando

Genera un borrador; guardar una cita no realiza ninguna llamada de IA.

Construye el flujo de preparación
03TÉRMINOS & REVISIÓN

Una configuración que puedes verificar

Explica las tarifas opcionales de IA y recopila las verificaciones de plataforma que necesita tu envío para revisión.

Contratos aceptadosVerificaciones de plataforma
Puedes verificarlo cuando

Cada plataforma incluida y el alcance solicitado tienen verificaciones registradas.

Establece términos y verifica la aplicación

LLEVA ESTO A TU EDITOR

Construye con tu agente.

Copia la guía completa con el objetivo de implementación, los insumos requeridos y las verificaciones de aceptación. Mantén juntos los ejemplos de código, tablas y enlaces de documentación.

Guía completaContexto de implementaciónVerificaciones de aceptación
Más formatos
Ver como Markdown Descargar Markdown

Listo para tu proyecto, en el formato que necesitas.

Actualizado

Ve lo que construirás

Construirás una conexión que tus clientes puedan entender: su cuenta ShareAI, un borrador opcional de preparación de IA y un camino claro de regreso a su cita.

Dónde trabajarás Tu ejemplo terminado

Conecta tu aplicación a ShareAI Builder, desde la inscripción hasta una integración probada lista para revisión. Este tutorial utiliza JamZY, una pequeña aplicación de citas en Node.js, para mostrar cada paso: registrar la app, configurar su plataforma Web, conectar la cuenta ShareAI de un cliente y enviar una solicitud de IA autorizada. Aplica los mismos pasos a tu propio producto.

CapacidadA qué accede el clienteQué demuestra JamZY
Inicia sesión con ShareAIUna conexión de cuenta y la información de identidad que solicita tu app.Una identidad privada del cliente a partir de la información autenticada del Usuario.
Paga con ShareAI · Uso de IAUsando la cuenta personal u organizacional seleccionada por el cliente para inferencias autorizadas.Un borrador de preparación de cita financiado por los créditos elegibles de esa cuenta.
Builder margenLa tarifa adicional por uso de IA en el contrato de aplicación aceptado.Monetización opcional del uso, tras la aprobación y publicación del contrato.
Pagos de productosUna compra particular presentada en un ShareAI proceso de pago separado.Una extensión explicada en el tutorial de pago. La demostración de citas no implementa el proceso de pago.

Ten una cuenta ShareAI, permiso para usar la cuenta personal u organizacional que será propietaria de la app, un callback público HTTPS, un logo y páginas funcionales de privacidad, términos y eliminación de cuentas. Para ejecutar el ejemplo, usa Node.js 22 o más reciente y una dirección HTTPS para tu aplicación.

JamZY · aplicación de referencia para citas Ampliar captura de pantalla ↗
La demostración real de citas de JamZY: elija un servicio y una hora, luego conecte opcionalmente ShareAI para generar la preparación.
La programación local de citas y la preparación de AI financiada por el cliente son acciones separadas. Esta demostración no envía invitaciones de calendario.
  1. Elija el tipo y la duración de la cita.
  2. Seleccione un espacio de demostración disponible.
  3. Conecte ShareAI para usar el asistente de AI opcional.
  4. La AI se ejecuta solo después de esta acción explícita; la reserva por sí sola no llama a ShareAI.
Usa los detalles de tu propia app

Las capturas de pantalla utilizan detalles de aplicaciones de ejemplo. Las direcciones ShareAI en esta guía son direcciones de producción. La generación de preparación realiza una solicitud real de IA y puede gastar créditos; seleccionar o guardar una cita de demostración no lo hace. Las verificaciones se completan mediante sus propias pruebas de integración exitosas.

Estás listo para continuar cuando

Puedes distinguir el inicio de sesión de cuenta, el consumo de IA, el recargo opcional y una compra confirmada del producto. Leer esta guía no requiere una solicitud de pago.

Únete al Programa Builder

Crearás la identidad del Builder que posee tu aplicación y sus relaciones con los clientes.

Dónde trabajarás Consola → Builder Program

  1. Crea o inicia sesión en tu cuenta ShareAI. Elige la cuenta personal u organizacional que será propietaria de JamZY; utiliza la misma cuenta durante toda la configuración.
  2. Abrir Builder Program en la Consola ShareAIElige las actividades de builder que coincidan con tu trabajo. Para esta guía, elige la ruta de la empresa de productos para una aplicación que poseas. Client Work es para servicios entregados a un cliente; una integración conecta una aplicación existente.
  3. Seleccione la cuenta personal u organizacional que será propietaria de la inscripción al programa antes de aplicar. Las organizaciones pueden enviar una solicitud antes de la verificación, pero la aprobación del personal por sí sola no activa el acceso. Complete la verificación del correo electrónico de la organización y de la empresa desde la lista de verificación de incorporación en la Consola. Una organización aprobada permanece Pendiente de verificación hasta que ambos controles estén completos. Builder, Provider y Creator programas siguen esta regla.
  4. Después de la aceptación, abre Builder Program → Product. El conmutador de actor identifica la cuenta que estás editando.
Builder Program · punto de entrada de inscripción Ampliar captura de pantalla ↗
La página de inicio Builder Program presenta la ruta del producto y enlaza con la inscripción en Console.
Comience con la ruta del producto, luego complete la inscripción para la cuenta que será propietaria de JamZY.
  1. Continúe a Console para inscribirse en el Builder Program.
Estás listo para continuar cuando

Builder Program se abre para el propietario previsto y ofrece Nueva aplicación. Una decisión de inscripción, revisión de la aplicación, revisión de información pública y aprobación de Monetization Gateway son pasos separados.

Crea tu aplicación

Darás a JamZY su propio registro de aplicación, para que su identidad, acceso y términos comerciales permanezcan juntos.

Dónde trabajarás Builder Program → Product → Nueva app

  1. En Product, selecciona Nueva app. Ingresa tu sitio web público para completar los detalles iniciales, o elige Escribiré los detalles manualmente.
  2. Sube un logo en formato PNG o JPEG, ingresa JamZY como el nombre y describe el producto en una oración clara. Revisa el sitio web y el correo electrónico de contacto del builder.
  3. Continúa con las preguntas de configuración. Mantén las respuestas veraces: describen cómo se entrega y se paga la aplicación.
Configuración de la aplicación · detalles Ampliar captura de pantalla ↗
Revise el nombre de la aplicación, la introducción, el logotipo y el sitio web público antes de continuar. Los datos de contacto son ilustrativos.
Revise el nombre de la aplicación, la introducción, el logotipo y el sitio web público antes de continuar. Los datos de contacto son ilustrativos.
  1. Dé a la aplicación un nombre claro.
  2. Continúe con las preguntas de incorporación.

Use un sitio web público accesible para el perfil de la aplicación. Un sitio web privado o solo local puede fallar en la validación incluso cuando tu callback de desarrollo está registrado correctamente. La nueva aplicación comienza como un borrador. Puedes continuar editándola sin hacerla pública. Su identificador de aplicación es diferente de un ID de cliente OAuth o un ID de suscripción.

Estás listo para continuar cuando

JamZY aparece bajo Producto para el propietario previsto. No crees una aplicación adicional para cada plataforma de dispositivo.

Describe cómo se entrega tu app

Obtendrás opciones de OAuth que se ajustan a dónde se ejecuta tu aplicación y quién controla sus credenciales.

Dónde trabajarás Nueva aplicación → Configuración de la aplicación

Para un JamZY despliegue que operas tú mismo, elige el modelo de precios que coincida con tu oferta, SaaS, aplicación en la nube alojada por el proveedor, El cliente paga por su propio consumo, y ShareAI para solicitudes de IA. Estas son respuestas de ejemplo, no un requisito para cada producto.

Configuración de la aplicación · despliegue Ampliar captura de pantalla ↗
La respuesta de incorporación determina si un secreto de cliente del servidor está disponible.
La respuesta de incorporación determina si un secreto de cliente del servidor está disponible.
  1. Elija dónde se ejecuta realmente su aplicación.
Dónde se ejecuta la aplicaciónElección de OAuthDónde viven las credenciales
Tu backend alojadoEl cliente del servidor web puede usar un secreto de cliente. PKCE sigue aplicándose.El secreto y los tokens permanecen en tu servidor.
Aplicación de navegador / SPACliente web público con PKCE.Sin secreto de cliente incrustado. Usa un diseño de sesión de navegador o backend apropiado.
Distribución autogestionada o híbridaCliente público con PKCE bajo la política de incorporación.No distribuyas un secreto compartido del proveedor a las instalaciones del cliente.
Windows, macOS, Linux, Android o iOSUn cliente público para cada plataforma habilitada.PKCE y almacenamiento seguro apropiado para la plataforma; sin secreto integrado.

La muestra descargable JamZY utiliza deliberadamente un cliente web público con PKCE, aunque tiene un pequeño backend. El servidor mantiene los tokens fuera del almacenamiento del navegador. Una respuesta alojada por el proveedor permite un cliente del servidor; no te obliga a elegir uno.

Puedes revisar las respuestas guardadas en Información de la aplicación → Configuración de la aplicación. Los cambios de despliegue pueden eliminar secretos de cliente incompatibles y requerir una verificación repetida. Revisa ese impacto antes de guardar.

Estás listo para continuar cuando

El despliegue guardado describe tu arquitectura real. La opción de secreto de cliente sigue esa respuesta; una opción deshabilitada es una explicación de la política, no una credencial faltante.

¿Necesitas los detalles?Registro de cliente ↗

Presenta tu aplicación claramente

Proporcionarás a los clientes los detalles del producto y las políticas que necesitan antes de decidir conectarse.

Dónde trabajarás Información de la aplicación

Abre Información de la aplicación después del Panel de control. Trabaja en las secciones dedicadas: detalles, configuración de la aplicación, presentación, marca, galería y revisión. Dale al producto una descripción útil, un sitio web preciso y capturas de pantalla claras del flujo de trabajo del cliente.

Información de la aplicación Ampliar captura de pantalla ↗
Dale a tu aplicación su propio nombre, introducción y sitio web público HTTPS.
Dale a tu aplicación su propio nombre, introducción y sitio web público HTTPS.
  1. Desarrolla los detalles, configuración, presentación y marca en sus propias secciones.

Usa la identidad de tu propia aplicación. La marca ShareAI pertenece al botón de integración y material explicativo; no debe reemplazar el logotipo de tu producto. Mantén los enlaces de privacidad, términos y eliminación accesibles sin iniciar sesión.

Guarda los cambios cuando aparezca la acción flotante de guardar. La propuesta de información pública tiene su propia revisión; editar una propuesta aprobada no reemplaza silenciosamente la presentación pública en vivo.

Estás listo para continuar cuando

Un visitante puede entender qué hace JamZY, quién lo opera y cómo solicitar la eliminación. Los detalles públicos y la configuración de devolución de llamada se refieren al mismo producto.

Elige qué pueden autorizar los clientes

Pedirás el acceso que tu experiencia de cita realmente utiliza y aclararás su propósito de facturación.

Dónde trabajarás Aplicación → Casos de Uso

En Casos de Uso, habilite Inicio de sesión con ShareAI para la conexión de cuentas y Pay with ShareAI para el flujo financiado por el cliente que desea admitir. Solicite acceso a Monetization Gateway solo si su producto generará una tarifa adicional por el uso de IA. Siga el estado de aprobación mostrado en la Consola.

Log-in with ShareAI, Pay with ShareAI y Monetization Gateway tienen estados de configuración y aprobación separados.
Log-in with ShareAI, Pay with ShareAI y Monetization Gateway tienen estados de configuración y aprobación separados.
  1. Configurar el inicio de sesión con ShareAI.
  2. Habilitar el uso financiado por el cliente.
AlcancePor qué lo solicitarías
openidConecta una cuenta utilizando su identidad con alcance de cliente.
profile / emailSolicita reclamaciones de perfil o correo electrónico solo si tu producto las necesita.
inferenceLlama a los endpoints de inferencia de IA compatibles cuando lo permita la configuración de la aplicación.
monetization_gatewayUsa el acuerdo de facturación de IA aceptado por el cliente para inferencias con recargo.
paymentsCrea e inspecciona solicitudes de pago del cliente. Cada compra aún necesita confirmación.

Solicitudes de JamZY openid profile inference monetization_gateway. No solicita payments y no vende un producto a través del checkout. Habilitar una capacidad en la Consola no la otorga a un token de acceso existente: el cliente debe autorizar los alcances y términos.

Estás listo para continuar cuando

Las capacidades, los alcances configurados y la solicitud de autorización están de acuerdo. Evita solicitar acceso opcional que tu aplicación nunca utiliza o no puede verificar.

Configura tu integración Web

Crearás un cliente Web para la experiencia basada en navegador JamZY, con el método de autenticación correcto.

Dónde trabajarás Configuración de OAuth → Web

  1. Abre la configuración de OAuth. Elige Web desde la cuadrícula de plataformas. Puedes configurar un cliente por plataforma: Web, Windows, macOS, Linux, Android e iOS.
  2. Para este ejemplo, elige Aplicación de navegador / SPA, el cliente público PKCE. Una aplicación web de servidor es apropiada solo cuando tu política de implementación lo permite y tu backend puede proteger un secreto.
  3. Copia tu propio ID de cliente Web. Mantén la plataforma en Pruebas mientras la integras. Nunca copies un ID de una captura de pantalla ni reutilices el registro compartido de la demo para un producto diferente.
Configuración de OAuth · cuadrícula de plataformas Ampliar captura de pantalla ↗
Un cliente registrado por plataforma. Las plataformas no configuradas permanecen opcionales.
Un cliente registrado por plataforma. Las plataformas no configuradas permanecen opcionales.
  1. Abre la integración única para Web.
  2. Agrega Android solo cuando tu producto lo soporte.
Un cliente público para Web utiliza PKCE y no tiene secreto de cliente. El ID del cliente está redactado.
Un cliente público para Web utiliza PKCE y no tiene secreto de cliente. El ID del cliente está redactado.
  1. Copia tu propio ID de cliente para Web.
  2. Un cliente público no recibe un secreto.

Las diferentes plataformas tienen diferentes credenciales y reglas de callback. No son productos separados: las suscripciones y la gestión de clientes se agregan para la aplicación. Los evaluadores de la aplicación se comparten entre plataformas, con un máximo de cinco lugares incluyendo invitaciones pendientes; el propietario no consume un lugar de evaluador.

Estás listo para continuar cuando

Existe exactamente una plataforma Web. Las plataformas nativas que no has configurado no bloquean tu lanzamiento.

¿Necesitas los detalles?Registro de plataforma ↗

Devuelve a los clientes a tu app

Devolverás a los clientes a tu aplicación después de la autorización, utilizando un callback exacto que posees.

Dónde trabajarás Web → Configuración

En Web → Configuración, registra el callback HTTPS exacto que maneja tu aplicación. Esta guía utiliza https://jamzy.example/oauth/callback como ejemplo. Reemplaza jamzy.example con el dominio HTTPS donde despliegas tu copia de JamZY, y usa ese mismo callback en la configuración de tu aplicación.

Web · Configuración Ampliar captura de pantalla ↗
Registra el callback que maneja tu aplicación implementada.
Registra el callback que maneja tu aplicación implementada.
  1. Registra el callback que maneja tu aplicación implementada.

Proporciona el nombre de la pantalla de consentimiento, los términos, la información de privacidad y eliminación. Habilita solo los alcances que necesitas, luego guarda. El esquema, host, ruta y detalles de consulta aplicables deben coincidir con la solicitud de autorización y el intercambio de código. No utilices un comodín ni un fragmento de URL.

PlataformaCallback para implementar
WebDirección HTTPS exacta en su aplicación.
AndroidUn esquema de aplicación de dominio inverso que coincida con el ID de la aplicación, o un App Link HTTPS verificado con el paquete y la huella digital de firma SHA-256.
iOSUn esquema de aplicación coincidente, o un Universal Link HTTPS verificado con el ID del paquete y el prefijo del Apple App ID.
Windows / macOS / LinuxUn callback HTTPS exacto permitido, un esquema de aplicación de dominio inverso coincidente, o un redireccionamiento loopback compatible en 127.0.0.1 / [::1]. El puerto loopback puede variar.

Las aplicaciones instaladas autorizan en el navegador del sistema y regresan a través del callback registrado. Para los App Links HTTPS reclamados, publique el archivo de asociación requerido y ejecute la verificación de asociación en la Consola. Un callback que parece plausible en un formulario no es prueba de que su aplicación instalada lo reciba.

Estás listo para continuar cuando

Abrir el callback a través del flujo de autorización regresa a su aplicación. Un código aleatorio o un estado no coincidente será rechazado.

Ejecuta tu propia JamZY aplicación

Tendrá la interfaz de citas y su conexión ShareAI ejecutándose con los identificadores de su propia aplicación.

Dónde trabajarás Su aplicación → Configuración del entorno

JamZY es una aplicación de citas con un asistente de preparación de IA opcional. Su programador es una demostración solo en navegador: no hay proveedor de calendario, entrega de correo electrónico ni pago de citas. La autorización ShareAI y la integración de la API de IA utilizan el upstream configurado real.

Descargue el fuente de referencia JamZY. Contiene el servidor Node, la interfaz de usuario del navegador, pruebas y un README de configuración; no incluye certificados, secretos, dependencias ni sesiones. Revise los archivos antes de ejecutarlos. Coloque el proceso Node detrás de un proxy inverso HTTPS que preserve el origen público.

# .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
Mantenga los entornos juntos

Cree su aplicación en consola.compartirai.ahora. Use su ID de cliente de producción con https://auth.shareai.now y https://api.shareai.now/api/v1. La jamzy.example dirección es un marcador de posición para su aplicación, no una demostración alojada. Sirva su propia aplicación a través de HTTPS para que su cookie de sesión segura funcione.

JamZY también ofrece una conexión con clave de API para comparación. Este tutorial utiliza el botón de billetera/OAuth. Una clave de API no establece el acuerdo OAuth del cliente JamZY y no reemplaza el flujo de autorización del cliente.

Estás listo para continuar cuando

La aplicación se carga a través de HTTPS. Su origen público, callback registrado e ID de cliente coinciden con su registro. Ningún token o secreto aparece en el código fuente de la página o en localStorage.

Conecta a tu primer cliente

Permitirá que un cliente elija su cuenta ShareAI y apruebe el acceso que su aplicación necesita.

Dónde trabajarás JamZY → Pagar con su billetera ShareAI

Desde JamZY, seleccione Pagar con su billetera ShareAI. La aplicación abre la página de autorización ShareAI. El cliente inicia sesión, selecciona una cuenta personal u organizacional, verifica la aplicación y el acceso solicitado, y acepta los términos de suscripción aplicables.

  1. JamZY → AutenticaciónCree un estado aleatorio y un verificador PKCE; envíe su desafío S256 con la solicitud de autorización.
  2. Cliente → AutenticaciónElija la cuenta de pago y revise los términos de acceso y facturación. Cancelar debe dejar JamZY desconectado.
  3. Autenticación → callbackReciba un código único de corta duración y el estado. Valide el estado contra la misma sesión.
  4. Backend → tokenIntercambie ese código con el verificador original y el URI de redirección idéntico. Los clientes públicos no envían un secreto de cliente.
  5. Backend → Información del usuarioUse el token de acceso para leer la identidad autenticada, luego establezca la sesión segura propia de JamZY.
Web · Endpoints de producción Ampliar captura de pantalla ↗
Usa estas direcciones de producción ShareAI con el ID de cliente desde console.shareai.now.
Usa estas direcciones de producción ShareAI con el ID de cliente desde console.shareai.now.
  1. Autoriza en auth.shareai.now/oauth/authorize.
  2. Intercambia códigos y tokens de actualización en 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 el registro local del cliente por la autenticación, con el contexto del emisor/cliente. sub Las autorizaciones personales y de organización pueden seleccionar diferentes cuentas de pago. Un ID de cliente no es un ID de usuario global, dirección de correo electrónico ni ID de base de datos interna de la organización. No combine identidades entre plataformas comparando nombres visibles.

Estás listo para continuar cuando

Cancelar, estado no coincidente, código repetido y autorización caducada fallan de manera segura. El flujo normal devuelve una cuenta autenticada sin exponer sus tokens.

Mantén al cliente conectado de forma segura

Mantendrá las solicitudes autorizadas funcionando mientras los tokens expiran, proporcionando al cliente una forma confiable de desconectarse.

Dónde trabajarás Su aplicación → Manejo de sesión y tokens

CredencialPropósitoCómo manejarlo
Código de autorizaciónTransferencia única desde la página de autorización.Intercambie una vez, utilizando el verificador correspondiente y el callback. No es un token de API.
Token de accesoAutoriza llamadas API dentro del alcance y concesión aceptados.Envíe como Authorization: Bearer …. Respete la expiración y los errores de autorización del endpoint.
Token de actualizaciónObtiene tokens de acceso de reemplazo sin otro inicio de sesión mientras la concesión sigue siendo válida.Almacene de forma segura. Serialice las operaciones de actualización y reemplace atómicamente las credenciales rotadas.
Token de IDUna afirmación de identidad OpenID Connect para el cliente.Si lo utiliza, valide la firma, el emisor, la audiencia, la expiración y el nonce según corresponda. No lo use como un token Bearer inferido.
Secreto de clienteAutentica un cliente servidor confidencial permitido.Almacene en el servidor. Es diferente de todos los tokens y nunca se incluye en un 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 el expires_in devuelto en lugar de inventar una duración. Si la actualización devuelve un token de actualización de reemplazo, persista con el nuevo token de acceso como una sola actualización. Permita una actualización en vuelo por sesión para que las solicitudes concurrentes no reutilicen un token rotado. Una concesión de actualización inválida o revocada requiere reconexión; no haga bucles indefinidamente.

La actualización no puede agregar un alcance ni aceptar silenciosamente un nuevo contrato de Monetization Gateway. Envíe al cliente nuevamente a través de la autorización para obtener nuevos permisos o términos. JamZY almacena credenciales solo en la memoria del servidor durante un máximo de una sesión de demostración de una hora, autentica la información del usuario en lugar de confiar en un token de ID no verificado y utiliza una cookie Secure, HttpOnly, SameSite. Un servicio de producción necesita su propio diseño de sesión duradero y protegido.

Al desconectar, revoque las credenciales de actualización/acceso donde sea aplicable y limpie la sesión de la aplicación. Limpiar solo una cookie del navegador no revoca una concesión de ShareAI ni cancela una suscripción paga. Evite registrar códigos, tokens, secretos o contenido personal de solicitud.

Estás listo para continuar cuando

La expiración desencadena una actualización controlada; los nuevos tokens reemplazan a los antiguos. La desconexión limpia la sesión de la aplicación e informa cualquier fallo de revocación.

Prepara la primera cita con IA

Convertirás un objetivo de cita en una agenda y preguntas útiles, con una solicitud explícita de IA financiada por el cliente.

Dónde trabajarás Modelos disponibles → JamZY → Ven preparado

Abre Modelos disponibles en la aplicación. Selecciona los modelos y proveedores que tu producto ofrecerá y guarda la configuración. Si el catálogo no se puede cargar, resuelve el error de disponibilidad aguas arriba antes de continuar; cambiar repetidamente los clientes OAuth no lo reparará.

Elija qué modelos y proveedores pueden usar sus clientes. Resuelva cualquier error del catálogo antes de continuar.
Elija qué modelos y proveedores pueden usar sus clientes. Resuelva cualquier error del catálogo antes de continuar.
  1. El catálogo de modelos pertenece a esta aplicación.

JamZY carga su catálogo solo después de la conexión. Elige un modelo de texto permitido, ingresa un objetivo breve de cita y selecciona Generar preparación deliberadamente. La cuenta seleccionada necesita créditos elegibles y cualquier término de facturación de IA requerido y aceptado. Elegir una fecha, revisar una cita y guardarla no envía una solicitud de inferencia.

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}'

Sigue el flujo de citas en JamZY

  1. En Programar, elige un servicio: una introducción de 15 minutos, planificación de proyecto de 30 minutos o una conversación más profunda de 60 minutos.
  2. Elige un día y una hora disponible. Las horas usan la zona horaria mostrada por el navegador. La disponibilidad es ilustrativa y las citas guardadas afectan solo a este navegador.
  3. En Ven preparado, ingresa un objetivo de ejemplo sin detalles personales. Elige un modelo, luego selecciona Generar preparación. JamZY envía el servicio seleccionado y tu objetivo a ShareAI, renderiza el texto devuelto de manera segura y deja la reserva sin cambios.
  4. Revisa la agenda tú mismo. Selecciona Revisar cita, verifica su servicio, día, hora y duración, luego Confirma cita de demostración. Esta acción no llama a la IA ni realiza un pago.
  5. Abre Mis citas para ver el registro de demostración guardado. Recarga para confirmar que persiste, o elimínalo para hacer que el espacio esté disponible nuevamente. Solo se almacenan el servicio, día, hora y una referencia local aleatoria; los borradores de IA, objetivos, tokens y claves no se guardan con las citas.
Revise el servicio, la fecha, la hora y la duración antes de guardar esta cita de demostración solo en el navegador. Ampliar captura de pantalla ↗
Revise el servicio, la fecha, la hora y la duración antes de guardar esta cita de demostración solo en el navegador.
Revise el servicio, la fecha, la hora y la duración antes de guardar esta cita de demostración solo en el navegador.
  1. Revise la selección completa antes de confirmar.
  2. Esta acción guarda un registro de demostración; no llama a AI ni realiza pagos.
Mis citas muestra registros de demostraciones locales. Eliminar un registro hace que su espacio ilustrativo esté disponible nuevamente. Ampliar captura de pantalla ↗
Mis citas muestra registros de demostraciones locales. Eliminar un registro hace que su espacio ilustrativo esté disponible nuevamente.
Mis citas muestra registros de demostraciones locales. Eliminar un registro hace que su espacio ilustrativo esté disponible nuevamente.
  1. El registro persiste en este navegador sin detalles personales ni notas de AI.
  2. Elimine la cita de demostración y libere su espacio.

Un producto de programación real necesita un almacén de reservas del lado del servidor, verificaciones de disponibilidad, manejo de zonas horarias, política de cancelación e integración de calendario o notificaciones. Estos son independientes de la autorización de ShareAI. Mantén la salida de IA como una propuesta; valida cualquier acción futura de reserva a través de las reglas de tu propia aplicación.

Utilice un slug de modelo devuelto por el catálogo permitido. Maneje el contrato de respuesta real: JamZY admite el nativo de ShareAI. message.content sobre y estilo OpenAI choices[0].message.content. HTTP 200 con una respuesta de error incompleta o anidada no es una respuesta exitosa.

En una respuesta de límite de gasto o crédito insuficiente, muestre una explicación útil y el enlace de facturación del cliente proporcionado. Preserve la cuenta seleccionada. No omita su límite, cambie el pagador silenciosamente ni reintente una operación cargada en un bucle.

Estás listo para continuar cuando

La generación de preparación devuelve una agenda y preguntas utilizables. La solicitud se atribuye al cliente y aplicación autorizados, con el modelo seleccionado y los términos aceptados. El borrador de IA no puede reservar ni cambiar una cita.

Establece tus ingresos opcionales de IA

Explicará su tarifa adicional de IA en una oferta de suscripción y publicará los términos que los clientes pueden aceptar.

Dónde trabajarás Aplicación → Suscripciones

Solicite acceso a Monetization Gateway a través de los Casos de Uso de la aplicación si aún no está aprobado por la política administrativa aplicable. Complete el cuestionario y siga su estado. La aprobación habilita la configuración; el permiso del cliente y el consentimiento de facturación permanecen separados.

Suscripciones · Resumen Ampliar captura de pantalla ↗
Las nuevas aplicaciones comienzan sin un contrato publicado. Agregue una oferta antes de publicar sus términos.
Las nuevas aplicaciones comienzan sin un contrato publicado. Agregue una oferta antes de publicar sus términos.
  1. Cree una oferta en su propio editor.
  1. Abra Suscripciones. Agregue una oferta, asígnele un nombre claro y describa el margen de Builder que los clientes pagarán. El ID de suscripción generado es de solo lectura y está limitado a esta aplicación; cópielo cuando su integración lo necesite.
  2. Edite cada suscripción en su propio editor. Use Estimar para inspeccionar el costo de red y sus ganancias para el modelo seleccionado y las suposiciones de uso. Las estimaciones son vistas previas, no precios garantizados ni términos aceptados.
  3. Revise el borrador juntos, luego publique la versión del contrato cuando se cumplan sus requisitos. La versión publicada describe lo que los nuevos clientes pueden aceptar.
  4. Utilice el resumen y la distribución de contratos para ver cuántas cuentas permanecen en cada versión aceptada. Un cliente mantiene los términos aceptados hasta que explícitamente acepte un reemplazo; publicar una nueva versión no los migra silenciosamente. Mantenga la transición predeterminada que preserva los contratos aceptados. Si elige deliberadamente Requerir consentimiento renovado antes de más acciones de la aplicación, el acceso existente puede interrumpirse hasta que el cliente apruebe los nuevos términos.

Solo ejemplo: un margen de 20% Builder en €1.00 del costo de red elegible agrega €0.20. En precios estándar, la tarifa de ShareAI de 5% se aplica solo a ese margen de €0.20, antes de cualquier Ingestión de Eventos facturable. Utilice el estimador en vivo y el contrato aceptado para el cálculo real. Una oferta de suscripción en este flujo es un acuerdo de facturación de IA; la conexión de cuenta por sí sola no debita un precio recurrente fijo.

Suscripciones · editor de ofertas Ampliar captura de pantalla ↗
Un borrador ilustrativo de oferta. Su ID de suscripción generado es de solo lectura y está limitado a esta aplicación.
Un borrador ilustrativo de oferta. Su ID de suscripción generado es de solo lectura y está limitado a esta aplicación.
  1. Use un nombre de oferta orientado al cliente.
  2. Configure el AI surcharge para esta oferta.

La pantalla de consentimiento ShareAI es autoritativa para los términos aceptados. El cliente público de JamZY no puede inferir el plan de facturación aceptado a partir de la información del Usuario, por lo que su panel de conexión no reclama una suscripción activa ni inventa un precio para la cita.

Estás listo para continuar cuando

La oferta explica la tarifa; el contrato puede ser aceptado por el cliente. Comprendes qué clientes permanecen en términos anteriores y por qué.

Demuestra que las plataformas incluidas funcionan

Recopilarás el endpoint real y las verificaciones de alcance necesarias para enviar tu aplicación para revisión.

Dónde trabajarás Configuración de OAuth → Probadores y Verificación

Abrir configuración de OAuth → Probadores e invitar hasta cinco probadores a nivel de aplicación. Las invitaciones pendientes consumen un lugar pero no otorgan acceso; el destinatario debe aceptar. El acceso del propietario y el acceso del probador invitado son diferentes del acceso público en producción.

Probadores de la aplicación Ampliar captura de pantalla ↗
Una única lista de probadores sirve para todas las plataformas. Las invitaciones pendientes cuentan para el límite de cinco lugares.
Una única lista de probadores sirve para todas las plataformas. Las invitaciones pendientes cuentan para el límite de cinco lugares.
  1. Cinco lugares son compartidos por toda la aplicación.
  2. Invita a un probador aquí, luego espera su aceptación.
Web · Verificación Ampliar captura de pantalla ↗
Una nueva integración muestra verificaciones pendientes hasta que se registren llamadas exitosas reales. Este borrador de referencia no ha pasado revisión.
Una nueva integración muestra verificaciones pendientes hasta que se registren llamadas exitosas reales. Este borrador de referencia no ha pasado revisión.
  1. La Consola registra el éxito real de los endpoints.
  2. Cada alcance solicitado también debe ser ejercido.

Para cada plataforma que planeas publicar, abre Verificación. Completa llamadas exitosas reales para los endpoints requeridos y cada alcance configurado. Verifica claves de descubrimiento y firma; prueba autorización/retroceso, intercambio de código, actualización, información autenticada del Usuario y revocación. Los clientes confidenciales también deben probar la introspección aplicable. Los enlaces HTTPS nativos reclamados necesitan verificación de asociación.

Un perfil/alcance de correo electrónico necesita sus declaraciones reales devueltas; use una cuenta de prueba personal donde se requiera el correo electrónico. Los alcances inference y monetization_gateway necesitan una solicitud de IA autorizada completada. Los pagos requieren una llamada API de pago con alcance exitoso. Una respuesta HTTP genérica exitosa, captura de pantalla del navegador o lista de verificación manual no reemplaza los registros de verificación de la Consola.

Tienes tres opciones para una plataforma incompleta: terminarla y verificarla, excluirla de la publicación para que permanezca solo para el propietario/probador, o eliminarla. No incluyas una plataforma con retrocesos o alcances que no hayas ejercido. Los cambios de configuración pueden invalidar las verificaciones, así que actualiza el estado registrado después de tus cambios finales.

Estás listo para continuar cuando

Cada plataforma incluida muestra la configuración requerida, las verificaciones de endpoint y alcance como completas. La lista de verificación personal de la guía es solo una ayuda de lectura.

Envía tu app y sigue a sus clientes

Sabrás qué está listo para revisión, cómo funciona la publicación y dónde seguir el acceso de los clientes después.

Dónde trabajarás Aplicación → Panel de control

  1. Regresa al Panel de control y resuelve cada acción pendiente. La presentación para revisión debe permanecer no disponible hasta que la aplicación y todas las plataformas incluidas cumplan con sus requisitos.
  2. Envía la solicitud para la revisión de ShareAI. Sigue la decisión y cualquier cambio solicitado en el Panel de Control y Actividad & Decisiones. Las solicitudes de presentación pública y del Portal de Monetización pueden tener decisiones separadas.
  3. Después de la aprobación, publique la aplicación utilizando los controles de publicación disponibles. Confirme que las plataformas incluidas están listas para producción; las excluidas permanecen en Pruebas.
  4. Abra Clientes para cuentas a nivel de aplicación y Suscripciones para la distribución de contratos aceptados. Analytics le ayuda a seguir el uso de IA atribuido y las ganancias. Los identificadores de clientes permanecen privados en el contexto adecuado de cliente/autorización.
Dashboard · preparación para el lanzamiento Ampliar captura de pantalla ↗
La revisión permanece bloqueada mientras la aplicación y las plataformas incluidas tengan requisitos pendientes.
La revisión permanece bloqueada mientras la aplicación y las plataformas incluidas tengan requisitos pendientes.
  1. Resuelva las acciones requeridas antes de enviar para revisión.
La vista de la aplicación reúne cuentas conectadas sin mostrar los IDs internos de la base de datos de la organización.
La vista de la aplicación reúne cuentas conectadas sin mostrar los IDs internos de la base de datos de la organización.
  1. La gestión de clientes se agrega para la aplicación.

Pruebe todo el flujo nuevamente con un cliente elegible después del lanzamiento: conecte, inspeccione la cuenta y el consentimiento, genere un borrador corto de preparación de cita, actualice de manera segura, maneje un fallo de facturación, luego desconecte. Verifique la experiencia del usuario en vivo en lugar de asumir que un guardado exitoso prueba que funciona.

Cuando algo no funciona

Desajuste de Callback: compare la URL registrada y ambos valores de solicitud exactamente. Probador no autorizado: confirme la aceptación de la invitación y la cuenta seleccionada. Falta de alcance o contrato: solicite solo acceso habilitado y vuelva a conectar para aceptarlo. Sin modelos: inspeccione Modelos Disponibles y restricciones del proveedor. Error de actualización: borre la sesión local fallida y vuelva a conectar. Revisión bloqueada: inspeccione las verificaciones de la plataforma en lugar de crear otro cliente OAuth.

Estás listo para continuar cuando

La aplicación funciona para el cliente previsto, las verificaciones registradas respaldan su estado de publicación, y el cliente puede controlar o revocar la autorización.

Verificación de organización y acceso al programa

Seleccione la cuenta personal u organizacional que será propietaria de la inscripción al programa antes de aplicar. Las organizaciones pueden enviar una solicitud antes de la verificación, pero la aprobación del personal por sí sola no activa el acceso. Complete la verificación del correo electrónico de la organización y de la empresa desde la lista de verificación de incorporación en la Consola. Una organización aprobada permanece Pendiente de verificación hasta que ambos controles estén completos. Builder, Provider y Creator programas siguen esta regla.

Ver precios de Monetization Gateway · Explora ShareAI for Startups · Alcances y permisos

Permisos y términos aceptados

Sus Términos y Condiciones públicos, Política de Privacidad e instrucciones de eliminación deben coincidir con la aplicación y permanecer accesibles sin iniciar sesión. La aceptación del programa ShareAI, la aprobación de Monetization Gateway, el permiso OAuth del cliente y el contrato de facturación aceptado son decisiones separadas. La actualización no puede agregar permisos ni aceptar nuevos términos comerciales.

El alcance heredado surcharge sigue siendo aceptado para integraciones existentes. Los nuevos ejemplos usan monetization_gateway. Mantenga los campos de transferencia existentes como surcharge_bps y surcharge_percentage sin cambios.

Ver precios de Monetization Gateway · Explora ShareAI for Startups · Alcances y permisos

Tarifas de Gateway y soporte para Startups

Cargos estándar 5% del margen Builder. Para €2.00 del costo de red de IA y un margen 10%, el cliente paga €2.20. ShareAI recibe €0.01 del margen €0.20; el Builder tiene €0.19 antes de la Ingesta de Eventos.

Los primeros 1,000 pedidos de Producción liquidados Monetization Gateway son gratuitos cada mes calendario (UTC), compartidos en la cuenta Builder. Los pedidos adicionales cuestan €0.04 por 1,000 antes de aplicar los descuentos elegibles. Un pedido liquidado crea un evento.

Pay with ShareAI por sí solo, acceso solo a inference, claves API de cuentas ordinarias y tráfico de Staging o pruebas no incurren en la tarifa de Ingestión de Eventos Monetization Gateway.

ShareAI for Startups ofrece una asignación mensual compartida para las tarifas reales de ShareAI en una aplicación aprobada. Los niveles actuales de Launch, Growth y Momentum enumeran €1,000, €5,000 y €10,000 por mes. El mismo presupuesto cubre la tarifa porcentual de ShareAI sobre el margen de Builder y la Ingestión de Eventos facturable juntos. No es una asignación de margen bruto, una cuota de eventos gratuitos separada ni una inference de IA gratuita. Los primeros 1,000 eventos gratuitos de la cuenta no lo consumen.

Las tarifas restantes de Ingestión de Eventos se pagan con las nuevas ganancias de la solicitud en Builder, luego con las ganancias de IA disponibles en Builder y los créditos de IA no restringidos. Los cargos de IA del cliente y el producto payments permanecen separados.

ShareAI puede aprobar tarifas específicas de la aplicación o soporte de tarifas por un período fijo o hasta que se modifique. Revise los precios actuales de la aplicación y los Programas Especiales en la Consola para conocer sus términos aprobados, validez y asignación consumida. Un cambio de nivel o una anulación de precios no restablece el uso mensual de la aplicación.

Launch mantiene el inicio de sesión con ShareAI como opcional. Growth y Momentum lo requieren; Momentum también requiere la insignia oficial ShareAI for Startups en el pie de página de la aplicación. ShareAI verifica la insignia semanalmente. Los intentos confirmados de eludir los requisitos pueden llevar a la degradación, la eliminación del Programa Startup o la retirada del Marketplace bajo los términos aceptados del programa.

Las tarifas empresariales son configuradas por el equipo ShareAI para la cuenta Builder después de acordar una oferta personalizada. El porcentaje asignado y la tarifa por evento se aplican a solicitudes futuras.

Ver precios de Monetization Gateway · Explora ShareAI for Startups · Alcances y permisos

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI