Actions: conecta el API de Afiliaciones
Los action connectors le permiten a Quick Suite operar sistemas externos con lenguaje natural. Conectaremos el API de Afiliaciones de Auna: un API REST real desplegado para este workshop; para consultar afiliados y gestionar solicitudes sin salir del chat.
💡 Este módulo es el más técnico del workshop. No necesitas entender OAuth a fondo: sigue los pasos y al final verás el valor de negocio; el chat haciendo cosas, no solo respondiendo.
Datos de conexión
| Parámetro | Valor |
|---|---|
| Spec OpenAPI | https://qgv58q2mj4.execute-api.us-east-1.amazonaws.com/v1/openapi.json (o descarga el archivo openapi.json de la sección Descargas) |
| Token URL | https://auna-quick-753779157813.auth.us-east-1.amazoncognito.com/oauth2/token |
| Client ID | gk3o108306jlbbg1cjkson0v9 |
| Client Secret | Lo entrega el instructor en vivo |
| Scope | afiliaciones-api/full |
| Tipo de auth | OAuth 2.0 (client credentials) |
Lab 1: crea el action connector
- En Quick Suite, ve a Integrations / Actions → Add action connector.
- Elige el tipo OpenAPI / Custom API.
- Importa la spec: el asistente pide un archivo .json (no acepta YAML ni URL). Descarga openapi.json y súbelo con Import Schema.
- En autenticación, selecciona OAuth 2.0 → Client credentials y completa Token URL, Client ID, Client Secret y Scope con los valores de la tabla.
- Guarda y espera la validación del connector (check verde).
Lab 2: úsalo desde el chat
Prueba esta secuencia en el chat (o dentro de tu space si asociaste el connector ahí):
Busca al afiliado con código {pide un código al instructor o usa el listado}
Lista 5 afiliados del departamento de LIMA con su plan.
Crea una solicitud de tipo ACTUALIZACION_PLAN para ese afiliado con la descripción
"Cliente solicita evaluar upgrade de plan tras consulta comercial".
Lista las solicitudes pendientes y cambia la que acabas de crear a EN_PROCESO.
Observa cómo el chat traduce tu instrucción a la operación correcta del API (obtenerAfiliado, crearSolicitud, actualizarSolicitud) y te muestra la respuesta.
Troubleshooting
| Síntoma | Causa probable | Solución |
|---|---|---|
401 Unauthorized |
Token URL, credenciales o scope mal configurados | Revisa los 4 valores de auth; el scope es exactamente afiliaciones-api/full |
404 al buscar afiliado |
El código no existe en la muestra | Usa un código del comando "lista 5 afiliados" |
400 al cambiar estado |
Estado inválido | Solo existen: PENDIENTE, EN_PROCESO, RESUELTA, RECHAZADA |
| El chat no invoca el action | Instrucción ambigua | Menciona explícitamente "afiliado" o "solicitud" |
Verificación
- [ ] Connector creado y validado.
- [ ] Consultaste un afiliado desde el chat.
- [ ] Creaste una solicitud y le cambiaste el estado.
Módulo de referencia del workshop original: Actions