Conecta tu cuenta de Square a FlujosChat con acceso de solo lectura. Si es la primera vez, lee antes Conectar tu tienda online.
Antes de empezar
- Ser Propietario o Administrador en FlujosChat.
- Una cuenta en developer.squareup.com para crear la aplicación. Solo se conectan cuentas de producción, no de pruebas (sandbox).
- En FlujosChat: Configuración → Integraciones → E-commerce → Square. No tienes que escribir ninguna tienda: la cuenta sale de la credencial.
Formas de conectar
- App OAuth (recomendado): autorizas en Square.
- Access token de producción: copias un token de tu aplicación. Solo sirve para la cuenta de Square con la que creaste la aplicación.
Los permisos que se piden son de solo lectura: MERCHANT_PROFILE_READ, ORDERS_READ, ITEMS_READ y CUSTOMERS_READ (perfil, pedidos, catálogo y clientes).
App OAuth (recomendado)
Crea la aplicación
En developer.squareup.com, crea una aplicación.
Pon la URL de redirección
Entra en la página OAuth de la aplicación, en producción. En FlujosChat copia la URL del recuadro URL de redirección para tu app: https://api.flujoschat.com/api/v1/integrations/commerce/callback, y pégala como URL de redirección.
Pega el Application ID y el Application secret
Copia de esa misma página el Application ID y el Application secret de producción, pégalos y pulsa Ir a Square y autorizar.
Autoriza en Square
Inicia sesión con tu cuenta de Square y acepta los permisos. Vuelves al panel con la cuenta conectada, con el nombre de tu negocio.
Square da un acceso de 30 días que FlujosChat renueva cuando lo usa, sin que tengas que autorizar otra vez.
Sin crear tu propia aplicación
Access token de producción
Copia el token
En developer.squareup.com abre tu aplicación → Credentials, cambia a «Production» y copia el «Production access token» (empieza por EAAA).
Pégalo en FlujosChat
Elige Access token de producción, pega el token y pulsa Conectar.
Este token da acceso a toda la cuenta de Square con la que creaste la aplicación, no solo de lectura: guárdalo bien. Si no quieres darlo, usa App OAuth.
Por qué no hay cuenta de servicio
Square no tiene credenciales de máquina para leer los datos de un vendedor: siempre hace falta que el vendedor autorice o un token de su propia aplicación.
Probar y desconectar
Con Probar conexión compruebas que sigue funcionando y con Desconectar la quitas de FlujosChat. La autorización sigue en tu cuenta de Square: retírala allí para quitar el acceso del todo. Más detalles en Conectar tu tienda online.
Si algo falla
Errores de Square
- «Square rechazó el token o no tiene el permiso de leer el perfil del vendedor (MERCHANT_PROFILE_READ).»: el token está mal copiado, es de sandbox o le falta ese permiso.
- «Square rechazó la autorización. Vuelve a conectar.»: el Application ID o el secret no son los de producción, o la URL de redirección no coincide con la del panel.
- «La autorización de Square caducó o se revocó. Vuelve a conectar.»: retiraste el permiso en Square. Conecta de nuevo.
- «El token no corresponde a esta cuenta de Square.»: el acceso no es de la cuenta que autorizaste. Vuelve a conectar.
Los errores comunes a todas las plataformas están en Conectar tu tienda online.