Para equipos de soporte SaaS
Conecta tu API de suscripciones de solo lectura para consultar el plan y los puestos disponibles en la conversación. Tu sistema aporta los datos; los cambios quedan en manos de personas autorizadas.
Empezar prueba gratisDatos de ejemplo · ficticios
Cliente
Which plan are we on, and can we add one more seat?
get_subscription() → plan: "Team Demo", seats_used: "4/5", extra_seat: "1 available"Respuesta de la IA
You are on Team Demo with 4 of 5 seats in use. One seat is available. Your administrator can add a teammate; this lookup does not change your subscription.
La consulta solo lee la suscripción. Los cambios quedan en manos de tu equipo o del administrador del cliente.
Consulta de suscripción vinculada a la sesión
get_subscriptionLee el plan, los puestos usados y los puestos adicionales disponibles de la cuenta autenticada.
GET https://api.example.com/accounts/{account_id}/subscriptionAuthorization: Bearer {{SUBSCRIPTION_API_SECRET}}account_id ← server.session.account_id
customer_id ← server.session.customer_idplan ← $.subscription.plan
seats_used ← $.subscription.seats_used
extra_seat ← $.subscription.extra_seatConfiguración de ejemplo para tu API de suscripciones de solo lectura. Sustituye el endpoint y los campos; no representa un conector nativo de facturación.
La identidad de la cuenta y del cliente viene de server.session, no del chat. Tu endpoint debe verificar la pertenencia a la cuenta y el permiso antes de devolver los campos de la suscripción.
Configura get_subscription para devolver plan, seats_used y extra_seat desde tu API de suscripciones. Explica los valores actuales sin suponer derechos de uso ni disponibilidad.
El servidor aporta la identidad de la cuenta y del cliente desde la sesión autenticada. Tu endpoint debe verificar la pertenencia a la cuenta y el permiso antes de devolver la suscripción.
Mapea los campos de plan y puestos que necesita la conversación. Conserva las credenciales en el servidor y excluye datos de pago, información privada de miembros y datos de otras cuentas.
La consulta no añade puestos, invita a compañeros, cambia planes ni cancela suscripciones. Explica el siguiente paso y pasa las solicitudes de cambios a tu equipo o al administrador del cliente.
Una API de solo lectura bajo tu control, credenciales en el servidor y mapeo de los campos de plan y puestos. Configura el endpoint y los controles de acceso; es un ejemplo de configuración, no un conector nativo de facturación.
Un mensaje no demuestra acceso a una cuenta. El servidor usa la identidad de la sesión autenticada, y tu endpoint debe verificar la pertenencia y el permiso para la cuenta consultada.
No. La primera versión solo lee los datos de la suscripción. Un administrador autorizado o tu equipo debe realizar los cambios mediante el proceso de cuenta existente.
No. El plan, el número de puestos y las respuestas son ejemplos ficticios. Las respuestas reales dependen de la API conectada y de los permisos del cliente actual.
Conecta tus conocimientos y API de solo lectura para consultar pedidos, transferencias, facturas y planes en el idioma del cliente.