---
fuente: manual
titulo: "Conectar VTEX"
url: /ayuda/conectar-vtex
canonica: https://www.flujoschat.com/ayuda/conectar-vtex
seccion: "Tiendas online"
descripcion: "Paso a paso para conectar tu tienda de VTEX a FlujosChat con claves de API (appKey y appToken) de solo lectura: qué permisos dar al rol, dónde está el nombre de cuenta y errores frecuentes."
audiencia: "Propietario y administradores"
---

# Conectar VTEX

Conecta tu cuenta de VTEX a FlujosChat con acceso de solo lectura. Si es la primera vez, lee antes [Conectar tu tienda online](/ayuda/conectar-tienda-online).

## Antes de empezar {#antes}

- Ser **Propietario o Administrador** en FlujosChat.
- El **nombre de cuenta** de VTEX: lo ves en la dirección de tu admin, `<cuenta>.myvtex.com`.
- Permiso en VTEX para crear claves de API y asignarles un rol.
- En FlujosChat: **Configuración → Integraciones → E-commerce → VTEX**.

## Formas de conectar {#modos}

Solo una: **Claves de API (appKey + appToken)**. No caducan.

## Claves de API {#token}

1. **Genera la clave**

   En tu admin de VTEX: **Account Settings → API Keys → Generate Key**.

2. **Dale un rol de solo lectura**

   Asígnale un rol con estos permisos:

   - «List Orders» y «View order».
   - Lectura de catálogo.
   - «Read only documents» (Master Data).

3. **Pega las claves**

   En FlujosChat escribe el nombre de cuenta, pega el **App key** (empieza por `vtexappkey-`) y el **App token**, y pulsa **Conectar**. VTEX solo enseña el app token una vez.

## Por qué no hay App OAuth ni cuenta de servicio {#faltan}

- El inicio de sesión con OAuth de VTEX sirve para identificar personas, no da acceso a los pedidos ni al catálogo.
- Las claves de API ya son credenciales de máquina: no hace falta otra forma.

## Probar y desconectar {#despues}

Con **Probar conexión** compruebas que sigue funcionando y con **Desconectar** la quitas de FlujosChat. La clave sigue en VTEX: bórrala allí para retirar el acceso del todo. Más detalles en [Conectar tu tienda online](/ayuda/conectar-tienda-online).

## Si algo falla {#problemas}

### Errores de VTEX

- **«Escribe el nombre de cuenta de VTEX…»**: escribe solo el nombre, sin `.myvtex.com` (también se acepta la dirección completa).
- **«VTEX rechazó las claves o no tienen el permiso "List Orders". Revisa el rol de la clave.»**: añade «List Orders» al rol de la clave.
- **«VTEX no encontró la cuenta o la tienda. Revisa la dirección o el identificador.»**: el nombre de cuenta está mal escrito.

Los errores comunes a todas las plataformas están en [Conectar tu tienda online](/ayuda/conectar-tienda-online).
