Integracion Official Gorgias PrestaShop - Documentation

Módulo PrestaShop compatible con 1.7.x - 8.1 versiones

En breve tendremos la nueva release v 2.0.2 compatible con 1.7.x - 9.X versiones

Consulta la última versión y descárgala desde la página de Addons de PrestaShop.

Video tutorial instalación

Que econtrarás en esta guía

Opciones e Instrucciones de Instalación

Nota: Si vas a reinstalar el módulo, haz una copia de seguridad de cualquier macro personalizada en Gorgias, ya que se sobrescribirán.

Nota: Después de instalar el módulo, preste atención a las instrucciones de configuración de Apache/Nginx que proporcionamos debajo de estas opciones de instalación, especialmente si su servidor usa Nginx.

Opción 1: Instalar desde la cuenta de Addons de PrestaShop

Conecta tu tienda a tu cuenta de Addons y descarga el módulo directamente.

Opción 2: Subir desde el Back Office

  1. Ve a Módulos > Gestor de Módulos
  2. Haz clic en "Subir un módulo" arriba a la derecha
  3. Selecciona el archivo .zip
  4. Continúa con la configuración (ver pasos abajo)

Opción 3: Subir por FTP

  1. Extrae los archivos del módulo en tu ordenador
  2. Súbelos a la carpeta /modules en tu servidor
  3. Continúa la configuración desde el back office

Pasos de Instalación:

1) Inicia sesión en el back office de PrestaShop

2) En el menú lateral izquierdo busca la opción Modulos

3) Haz click en el submenu "Module Manager"

4) Busca por Integración oficial de Gorgias - Helpdesk y haga clic en Instalar

  • Busque el módulo "Integración oficial de Gorgias - Helpdesk"
  • Seleccione la opción "Instalar" para cargar e instalar el módulo.

Nota: Si no tiene el componente ZipArchive en el PHP de su servidor web, debe extraer manualmente el archivo "installPack.zip" en la carpeta de administración mediante FTP.

5) Una vez instalado, seleccione la opción para configurar el módulo.

6) Si no tiene instalados los siguientes módulos, deberá hacer clic en el botón "Autorizar y continuar" para que el módulo instale los módulos necesarios de Prestashop:

  • ps_accounts
  • ps_eventbus
  • ps_mbo

7) Accederás al back office donde podrás vincular tu cuenta de PS Addons a la tienda (si aún no lo has hecho):

8) Después de vincular tu cuenta de Prestashop, verás los campos para conectar tu Prestashop con Gorgias. Desde aquí, solo tienes que seleccionar los estados de tu tienda que corresponden a pedidos cancelados y devueltos en los menús desplegables correspondientes. Finalmente, vincula el módulo con tu suscripción a Gorgias añadiendo la URL de tu cuenta de Gorgias en el campo "URL de Gorgias".

Configuracion del servidor Apache/Nginx

Para Apache:

Asegúrate de que esta línea esté presente en tu archivo .htaccess (directorio raíz):

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Si no está presente, añádela manualmente y guarda el archivo.

Para Nginx:

‍Agrega esto a la configuración de tu sitio:

location / {    if ($http_authorization ~ "(.*)") {        set $http_authorization $1;    }}

Conexión con Gorgias

El módulo instala automáticamente la aplicación Gorgias durante la configuración. Para verificar:

  1. Inicia sesión en tu panel de control de Gorgias

  2. Ve a Configuración > Mis aplicaciones

  3. Busca la integración de PrestaShop

Si no aparece en la lista, vuelve al módulo en PrestaShop y haz clic en Conectar.

Qué hace la Integración por ti

Esta aplicación sincroniza los datos de pedidos y usuarios entre tu tienda PrestaShop y tu cuenta de Gorgias. Además, añade macros y variables para automatizar la comunicación con los clientes. Esto significa que, cuando recibes un ticket de un usuario registrado en tu tienda PrestaShop, sus datos y pedidos se mostrarán en la parte derecha del ticket en Gorgias, lo que permite una atención al cliente más rápida y eficiente.

Sincronización inicial

Si es la primera vez que usas tickets con la app instalada y observas que no se sincronizan los datos del usuario ni de los pedidos, probablemente se deba a que ningún evento ha activado una actualización de datos. La solución es sencilla: realiza cualquier acción en el ticket, lo que activará un evento en nuestra app y recuperará los datos del usuario y sus pedidos. Esto solo ocurre con los tickets que ya estaban abiertos antes de instalar la app.

Características e información de tus tickets Gorgias desde Prestashop:

A continuación, se muestra un ejemplo de la información que puede ver en la barra lateral de Gorgias al revisar la comunicación con un cliente específico:

Datos de Pedido y Cliente en Gorgias

  • Importe total del pedido: El valor total de los pedidos realizados por el cliente.
  • Recuento total de pedidos: El número total de pedidos realizados por el cliente.

Debajo de esta información, encontrará una lista de pedidos, que se muestra en azul claro en la imagen. Por ejemplo:

5 (KHWLILZLL) Estos datos se refieren al ID del pedido de PrestaShop (5) y al código de referencia del pedido de PrestaShop (KHWLILZLL).

Botones de Acciones

Para cada pedido, están disponibles la siguiente información y acciones:

- Reembolso: Esta acción iniciará un reembolso (no sincronizado con tu cuenta bancaria) en PrestaShop. Asegúrate de tener esta opción habilitada en tu tienda para que funcione correctamente.

-ReStock: Similar a la acción anterior, procesa un reembolso y, si el estado del pedido en PrestaShop lo permite, reabastecerá los artículos, devolviéndolos al inventario. Debido a limitaciones técnicas, es posible que esta acción no restaure el inventario en algunos casos, y Gorgias mostrará un mensaje como este:

- Cancelar: Esta opción cancela pedidos en tu tienda PrestaShop.‍

Notificación: Debido a la limitación de la API de PrestaShop, la actualización del estado del pedido solo funcionará:
- Si el pedido ya se envió, la acción disponible será devolver el producto.
- Si el pedido ya se pagó pero aún no se envió, la acción disponible será un reembolso estándar.
- En todos los demás casos, la acción disponible será cancelar el producto.

Información general del pedido:

  • ID del pedido
  • Fecha del pedido
  • Estado del pedido
    - Tienda donde se recibió el pedido (útil si tiene más de una tienda conectada a su cuenta de Gorgias)
    - Importe total del pedido
    - ID del cliente en PrestaShop
    - Nombre del cliente
    - Correo electrónico del cliente
    - Indicación de si el cliente está registrado o es un invitado
    - Número de transportista o referencia para el seguimiento (esta información la proporciona PrestaShop por defecto y no refleja las integraciones con soluciones de terceros).

- Información de la dirección de envío y facturación

- Información de la dirección de facturación

- Productos y cantidades incluidos en el orden

Uso de Macros:

El módulo genera automáticamente macros en tu cuenta de Gorgias para facilitar las respuestas.

Para encontrarlas:

  • Ve a Settings > Macros
  • Busca las macros con el prefijo PrestaShop

Para obtener más información sobre cómo usar macros en Gorgias, puede visitar su documentación oficial aquí (https://docs.gorgias.com/en-US/articles/macros-18381).

Nota: Si personalizas estas macros, haz una copia antes de reinstalar el módulo para no perder los cambios.

Para encontrar las macros que hemos generado, ve a tu Panel de Control de Gorgias. En el menú desplegable superior, selecciona la opción "Configuración". Luego, en el menú de la derecha, selecciona "Macros". Esto mostrará una lista de las macros disponibles en tu cuenta. Las relacionadas con los pedidos de PrestaShop se identifican con el prefijo "Prestashop" en su nombre.
Para más información sobre cómo gestionar tus tickets en Gorgias, puedes consultar su documentación oficial:
‍
‍https://www.gorgias.com/product/helpdesk

Notas Importantes:

Limitación de la suscripción a Gorgias:

  • Su uso estará sujeto a las limitaciones de su suscripción a Gorgias, incluyendo la cantidad de tickets que puede abrir mensualmente y los costos asociados.
  • Si no encuentra la aplicación instalada en su panel de Gorgias, regrese a su módulo de Prestashop y haga clic de nuevo en el botón "Conectar".

Solución de Problemas y Reinstalación

Problemas con la sincronización de la aplicación:

  • Vaya a Mis aplicaciones en Gorgias
  • Seleccione la aplicación de PrestaShop y haga clic en Desconectar/li>
  • Vaya a App Store > Integraciones HTTP > Administrar y haga clic en Eliminar integración HTTP
  • Vuelva a PrestaShop y haga clic en Conectar de nuevo

Reinstalación del Módulo:

  • Reinstalar borrará y recreará las macros
  • Siempre haz una copia de seguridad de tus macros personalizadas antes de reinstalar

Preguntas Frecuentes

1¿Cómo instalo la APP de Gorgias manualmente?
No es necesario. Instala el módulo de PrestaShop y este se encargará de crear la APP automáticamente.
2¿Qué pasa si elimino la APP desde Gorgias?
Vuelve al módulo de PrestaShop y haz clic en Conectar. La APP se reinstalará.
3¿Se eliminan mis macros personalizadas al reinstalar?
Sí. Haz una copia de seguridad antes de reinstalar
4¿Puedo transferir el módulo a otra tienda o dominio?
No. Cada licencia está vinculada a un dominio específico.
5¿Qué pasa si supero el límite de tickets de mi plan Gorgias?
Contacta directamente con Gorgias para actualizar tu plan.
6La opción de reembolso no funciona. ¿Por qué?
Activa la opción de devoluciones desde Atención al cliente > Devoluciones de mercancía en PrestaShop.

Versión 2.0.2 - Novedades

Integración del Chat de Gorgias

Ahora puedes integrar el widget de chat de Gorgias directamente en tu tienda PrestaShop.

¿Cómo hacerlo?

  • Copia el script de instalación desde tu cuenta de Gorgias.
  • Pega el código en el campo Chat Script dentro del módulo.
  • Haz clic en el botón Conectar para completar la integración.

Una vez conectado, el chat aparecerá automáticamente para los clientes en tu tienda.

¿Dónde encontrar el script en Gorgias?

  • En tu panel de Gorgias, ve al menú lateral: Settings > Channels > Chat
  • En la sección Manual Installation, elige la opción Any other website.
  • Copia el código del paso 3 y pégalo en el módulo de PrestaShop.

Autenticación HTTP para Tiendas Protegidas por contraseña

Si tu tienda está protegida por autenticación básica (usuario y contraseña), ahora puedes probar el widget de PrestaShop dentro de los tickets de Gorgias de forma segura.

Solo debes:

  • Ingresar el nombre de usuario y contraseña en los campos correspondientes del módulo.
  • Hacer clic en Conectar para validar el acceso..

Esta funcionalidad te permitirá visualizar el widget incluso si tu sitio no está públicamente accesible.

Esta autenticacion HTTP un práctica común para proteger los entornos de desarrollo.