Importar desde Gorgias
En esta página
Trae a Deskwoot tus tickets, clientes, macros, tags, campos, reglas y vistas de Gorgias con tu subdominio de Gorgias, tu correo y una clave de API. La importación lee todos los tickets con todos sus mensajes y archivos. Todo se importa de forma predeterminada, y puedes elegir importar menos. Se ejecuta en segundo plano, sigue adelante durante las actualizaciones de Deskwoot y se puede volver a iniciar sin riesgo. No cambia nada en tu cuenta de Gorgias.
Qué se importa
- Los tickets se convierten en conversaciones con todos sus mensajes, notas internas (como notas privadas), archivos adjuntos, estado, prioridad, equipo, agente, tags y los valores de tus campos de ticket. Cada uno conserva sus fechas originales y el canal por el que llegó (correo, chat, teléfono, etc.). Un correo llega como Gorgias lo guarda para leerlo: sin su firma y sin las respuestas anteriores que cita. Los mensajes que envió una regla o un bot de Gorgias aparecen como de tu equipo, sin agente.
- Tickets de Deskwoot: si tu espacio de trabajo usa tickets (vienen con el plan Enterprise y con la prueba gratuita, y un administrador puede desactivarlos en Configuración > Tickets), cada ticket de Gorgias también se convierte en un ticket de Deskwoot junto a su conversación. El ticket toma el estado, la prioridad, el asunto, el equipo, el agente y las etiquetas, y desde ese momento contiene el trabajo. Su conversación se resuelve como traspaso y muestra una tarjeta privada que indica que el ticket se importó desde Gorgias. Sin tickets, la conversación conserva el estado de Gorgias.
- Los tags se convierten en etiquetas con su color y su descripción. Los tags eliminados se quedan fuera.
- Las valoraciones de satisfacción se convierten en valoraciones CSAT con su puntuación y su comentario en la conversación que les corresponde. Las encuestas que el cliente nunca respondió se quedan fuera.
- Los clientes se convierten en contactos con todas sus direcciones de correo y números de teléfono (también los de WhatsApp), su usuario de X, idioma, zona horaria, nota (como nota del contacto), los valores de tus campos de cliente y los datos adicionales que tienen guardados en Gorgias. Sus otros canales, como Instagram o Facebook, también se guardan en el contacto.
- Los equipos llegan con su descripción y con los miembros que ya están en tu espacio de trabajo. Los usuarios (tus agentes de Gorgias) se vinculan con tus compañeros de equipo por su correo (más abajo te explicamos cómo).
- Las macros que no están archivadas se convierten en respuestas predefinidas con su texto de respuesta, sus imágenes y sus archivos adjuntos. Las variables de Gorgias que Deskwoot también tiene pasan a ser las de Deskwoot, por ejemplo
{{ticket.customer.firstname}}pasa a{{contact.first_name}}. El código corto sale del nombre de la macro. Si en Deskwoot ya existe una respuesta predefinida con el mismo código corto, la importada se deja fuera, y la importación en el Historial de importaciones muestra cuántas se dejaron fuera. Lo que una macro hace además de su respuesta (agregar tags, cambiar el estado o la prioridad, asignar un agente o un equipo, agregar una nota interna) se convierte en una macro de Deskwoot con el mismo nombre para todo tu equipo. Una macro con ese nombre que ya está en Deskwoot se queda como está. - Los campos de ticket y los campos de cliente se convierten en atributos personalizados con su tipo y las opciones de una lista desplegable. Los campos archivados también se importan, para que sus valores antiguos lleguen.
- Las reglas que están activas en Gorgias se convierten en reglas de automatización, y llegan desactivadas. Gorgias escribe una regla como código, y Deskwoot no ejecuta ese código: cada regla importada lo conserva y muestra las acciones que realizaba, para que puedas reconstruirla con las condiciones y acciones de Deskwoot. Tal como llega, nunca se cumple.
- Las vistas de tickets activas que creó tu equipo se convierten en filtros guardados del administrador que inició la importación. Se importa todo lo que Deskwoot puede filtrar (estado, posposición, agente, equipo, tags, prioridad, valores de campos, palabras de búsqueda y orden). El resto se deja fuera, así que un filtro puede mostrar más conversaciones que la vista, nunca menos. Una vista cuyo filtro Deskwoot no puede leer en absoluto, como una que solo usa los campos de IA de Gorgias, se deja fuera, porque mostraría todas las conversaciones.
Archivos e imágenes
La importación copia en Deskwoot todos los archivos que Gorgias aloja: los archivos adjuntos y las imágenes de cada mensaje, las imágenes de tus macros y los archivos que tus macros adjuntan, que las respuestas predefinidas ofrecen como archivos que el cliente puede abrir. Nada se queda como un enlace a Gorgias, así que tus archivos siguen funcionando cuando dejes Gorgias. Si tu espacio de trabajo contrató el Análisis antivirus, cada archivo se analiza antes de guardarse.
- Si un archivo no se puede copiar en este momento (Gorgias no responde ni después de varios intentos, o no se puede llegar al antivirus o al almacenamiento de Deskwoot), la importación termina con Importada en parte. Vuelve a iniciar la importación para copiarlo. Cuando no llegan 3 archivos seguidos del mismo servidor, la ejecución se salta los archivos de ese servidor durante 2 minutos y luego vuelve a intentarlo con uno de ellos. Si ese archivo llega, la ejecución sigue con los archivos del servidor. Si no, espera otros 2 minutos. Así, un servidor que no responde no puede frenar toda la importación, y la siguiente ejecución vuelve a intentar con los archivos que se saltó.
- Un archivo que ninguna ejecución puede copiar se deja fuera, y la importación termina de todas formas. Esto incluye un archivo al que no se pudo llegar en 3 ejecuciones, para que un servidor que nunca responde no mantenga tu importación en Importada en parte. Solo cuentan las ejecuciones en las que no se pudo llegar al archivo, no las ejecuciones en las que el antivirus o el almacenamiento no funcionaban. La cuenta vuelve a empezar cuando la última de esas ejecuciones fue hace más de 7 días, y eliminar cualquier importación de tu espacio de trabajo la borra.
- Cada importación del Historial de importaciones muestra estos archivos en Archivos no importados con el motivo, por ejemplo demasiado grande (más de 25 MB), un tipo de archivo que no está permitido, rechazado por el análisis antivirus o ya no disponible en el origen.
- Las imágenes que un mensaje o una macro carga desde otro sitio web, como el tuyo, se quedan como están.
Qué no se importa
- Tu centro de ayuda de Gorgias. Gorgias no tiene una API para él, y su propia ayuda dice que los artículos no se pueden exportar.
- Las organizaciones, porque Gorgias no tiene empresas, y las fotos de perfil, porque los clientes de Gorgias no tienen. Tus compañeros de equipo conservan su perfil de Deskwoot.
- Las macros archivadas, y las partes de una macro para las que una macro de Deskwoot no tiene acción: completar un campo de ticket, acciones HTTP y acciones de tienda.
- Las reglas y vistas desactivadas, las vistas de sistema propias de Gorgias (las carpetas integradas de la bandeja de entrada de Deskwoot las cubren) y las vistas de clientes.
- Los campos de IA de Gorgias y las suposiciones que hace su IA sobre los mensajes (intents). El motivo de contacto se importa como valor de campo.
- Los datos de tienda de un cliente que vienen de Shopify y otras apps. Las integraciones propias de Deskwoot los leen directamente de tu tienda.
- El historial de eventos de un ticket. Gorgias solo lo entrega un ticket a la vez y solo de los últimos 12 meses.
- Las grabaciones y los detalles de las llamadas. Un ticket telefónico llega con sus mensajes.
- El CC y el CCO de los correos.
- Los tickets que están en spam o en la papelera, y los mensajes eliminados. Un ticket que Gorgias combinó con otro ya es parte de ese otro.
- Que Gorgias no haya podido enviar una respuesta: esa respuesta llega como enviada.
Qué queda interno
Deskwoot mantiene privado lo que en Gorgias solo veía tu equipo:
- Las notas internas llegan como notas privadas, y la nota de un cliente se convierte en una nota del contacto. Solo tu equipo las ve.
- La tarjeta de una conversación que indica su ticket de Deskwoot también es privada.
- Los filtros guardados que salen de las vistas de Gorgias pertenecen al administrador que inició la importación.
Antes de empezar
- En Gorgias, abre Settings > REST API como administrador. Haz clic en Create API Key, o copia la clave que ya está ahí. La misma página muestra tu Username, que es tu correo. Solo un administrador o el titular de la cuenta puede crear una clave, y una clave lee con los permisos de la persona que la creó, así que usa la clave de un administrador: así la importación puede leer todas las partes de tu helpdesk.
- Anota tu subdominio de Gorgias:
tu-empresadetu-empresa.gorgias.com. - Gorgias ofrece su REST API en todos sus planes de Helpdesk, así que no necesitas ningún plan de Gorgias en particular para la importación.
- Invita a tus compañeros de equipo a Deskwoot con el mismo correo que usan en Gorgias. También puedes hacerlo más tarde.
- Para que los tickets importados lleguen a una bandeja de entrada, configura primero tus bandejas de entrada de correo, Telegram, WhatsApp o SMS.
Cómo importar
- En Deskwoot, ve a Configuración > Importación y migración. Solo los administradores pueden importar.
- En ¿De dónde vienen tus datos?, elige Gorgias.
- Escribe el Subdominio, el Correo (el Username que Gorgias muestra junto a tu clave) y la Clave de API.
- En ¿Qué se debe importar?, elige lo que se importa. Todo está activado de forma predeterminada. Para importar solo los tickets más recientes, elige un día en Solo tickets creados a partir del.
- En ¿A qué bandeja de entrada deben ir los tickets?, elige una bandeja de entrada para cada tipo de ticket (Correo, Chat, Formularios web y centro de ayuda, Teléfono, WhatsApp, SMS, Todo lo demás), o deja Sin bandeja de entrada. Solo se ofrecen bandejas de entrada de correo, Telegram, WhatsApp y SMS. En tu primera importación de Gorgias, una bandeja de entrada de correo, WhatsApp o SMS que es la única de su tipo en tu espacio de trabajo ya viene elegida.
- Haz clic en Iniciar importación. Deskwoot primero revisa con Gorgias el subdominio, el correo y la clave. Si Gorgias los rechaza, el panel te lo indica y no empieza nada.
Mientras se ejecuta la importación
- La importación se ejecuta en segundo plano, así que puedes cerrar la página. La página de importación muestra el paso en el que va y cuántos registros ya están listos. Después de unos minutos de medición, también muestra la velocidad. En Qué tan rápido va la importación muestra cuántas llamadas a la API por minuto permite tu cuenta de Gorgias y cuántas usa la importación como máximo.
- Gorgias le permite a una clave de API hacer 40 llamadas cada 20 segundos (cada 10 segundos en su plan Enterprise). La importación usa como máximo el 85% de eso, así tus otras apps siguen funcionando. Si aun así se alcanza el límite, la importación espera y luego sigue.
- Las actualizaciones de Deskwoot y los reinicios del servidor no la detienen. Sigue donde se quedó. Si una ejecución falla o se queda atascada 3 veces seguidas sin avanzar, la importación se detiene y te lo indica. Vuelve a iniciarla para continuar.
- Cada espacio de trabajo ejecuta una sola importación a la vez. Inicia la siguiente cuando la actual haya terminado.
- Para detener una importación, haz clic en Cancelar importación en la página de importación y confirma con Cancelar y eliminar. La importación se detiene y se elimina lo que importó hasta ese momento. Una conversación en la que alguien escribió desde entonces conserva esos mensajes nuevos.
- Si Gorgias deja de responder, la importación conserva lo que ya leyó, termina los demás pasos y acaba con Importada en parte y los pasos que se detuvieron antes de tiempo. Vuelve a iniciar la importación para continuar. Si Gorgias ya no acepta la clave, por ejemplo porque alguien la eliminó, la ejecución se detiene: inicia una nueva importación con una clave válida, y se saltará lo que ya está en Deskwoot.
Los tickets y las respuestas de tus agentes
Un ticket asignado a un agente de Gorgias va al compañero de equipo que tiene el mismo correo, y sus respuestas lo muestran como remitente. Con los tickets activados, el ticket de Deskwoot también va a ese compañero. Si esa persona todavía no tiene una cuenta de Deskwoot, el ticket llega sin asignar y sus respuestas muestran su nombre con (importado).
Cuando más tarde se una a tu espacio de trabajo con el mismo correo, Deskwoot le pasa su trabajo automáticamente: se le asignan sus conversaciones importadas sin asignar y pasa a ser el remitente de sus respuestas. Las conversaciones abiertas, pendientes y pospuestas llegan con una sola notificación para todas. Las resueltas se asignan sin aviso. Ningún estado cambia, y tus clientes no ven nada. Una conversación que alguien en Deskwoot ya tuvo a su cargo se queda como está. Los tickets de Deskwoot que creó la importación no se pasan de esta forma: asígnalos a mano.
Las conversaciones importadas se quedan en silencio
Las conversaciones importadas son historial, así que se quedan en silencio hasta que el cliente vuelva a escribir o alguien de tu equipo responda en Deskwoot. Hasta entonces, Deskwoot no le envía nada al cliente desde ellas (ni mensaje de despedida ni encuesta de satisfacción), no pone en marcha ningún reloj de SLA y no las resuelve automáticamente. Las conversaciones importadas nunca cuentan para el límite mensual de conversaciones de tu plan y nunca quedan bloqueadas por él, tampoco después de que el cliente vuelva a escribir. Resolver o reabrir una a mano no activa ningún webhook ni ninguna regla de automatización. A partir del primer mensaje nuevo, la conversación funciona como cualquier otra, salvo que Fynn, el bot de IA, nunca responde en una conversación importada. Los tickets de Deskwoot que creó la importación también son historial.
Bandejas de entrada para tickets importados
- Gorgias anota el canal de cada ticket. La importación pone cada ticket en la bandeja de entrada que elegiste para su tipo, así tu equipo puede responderlo ahí. Chat es el chat en vivo de tu sitio web y de tu app, Formularios web y centro de ayuda abarca los formularios de contacto y tu centro de ayuda de Gorgias, Teléfono abarca las llamadas y los mensajes de voz, y Todo lo demás abarca Facebook, Instagram, X, los tickets creados por la API y todos los demás canales.
- Un ticket solo va a una bandeja de entrada donde Deskwoot puede contactar al cliente: una bandeja de correo necesita su dirección de correo, una bandeja de Telegram su chat de Telegram, y una bandeja de WhatsApp o SMS su número de teléfono. Los demás tickets llegan sin bandeja de entrada.
- Con los tickets activados, la bandeja de entrada va a la conversación, y una respuesta desde el ticket de Deskwoot le llega al cliente por ella (consulta Responder al cliente desde un ticket).
- Cuando vuelves a iniciar la importación, los tickets que importaste antes desde esta cuenta de Gorgias también van a las bandejas de entrada que elijas, si todavía no tienen una. Un ticket que ya tiene bandeja de entrada, o en el que alguien de tu equipo escribió, se queda donde está. La siguiente importación parte de las bandejas de entrada de la última.
- Cada importación del Historial de importaciones muestra las bandejas de entrada que elegiste y cuántos tickets fueron a una de ellas.
Después de la importación
- Un ticket sin bandeja de entrada (porque no elegiste ninguna para su tipo, o porque Deskwoot no puede contactar al cliente ahí) necesita una antes de que respondas: ábrelo y elige una bandeja de entrada en el aviso Esta conversación no tiene bandeja de entrada. Para una bandeja de correo, WhatsApp o SMS, también puedes agregar al contacto la dirección de correo o el número de teléfono que falta y volver a ejecutar la importación.
- Reconstruye las reglas que necesitas. Abre la importación en el Historial de importaciones: en Por hacer, Revisar y activar las reglas te lleva a ellas. Dale a cada una condiciones y acciones de Deskwoot y luego actívala.
- Revisa los filtros guardados y las macros: una vista de Gorgias puede filtrar por más cosas de las que Deskwoot lee, y una acción de macro sin equivalente en Deskwoot se dejó fuera.
Preguntas frecuentes
¿Puedo volver a iniciar la importación?
Sí, no hay ningún riesgo. Una nueva ejecución encuentra lo que ya está en Deskwoot y se lo salta, así que los tickets, contactos, etiquetas y respuestas predefinidas no se duplican. Trae lo que es nuevo o faltaba, por ejemplo después de una ejecución que terminó con Importada en parte. Un ticket que cambió en Gorgias desde entonces recibe sus mensajes nuevos y, mientras nadie de tu equipo haya trabajado en él en Deskwoot, también toma el nuevo estado, asunto, prioridad, equipo y agente (en su ticket de Deskwoot, si tiene uno). Un contacto que creó la importación recibe lo que todavía le falta, y nada de lo que tu equipo ingresó se sobrescribe.
Las respuestas predefinidas y las macros que tu equipo cambió en Deskwoot se quedan como las dejaste. Una regla que reconstruiste también se queda, pero la nueva ejecución ya no encuentra la original y vuelve a traer la versión de Gorgias, desactivada: elimina esa copia si no la necesitas.
Ten en cuenta que las conversaciones, contactos y notas que eliminaste o borraste en Deskwoot desde la última importación vuelven si Gorgias todavía los tiene, y lo mismo pasa con los contactos que combinaste.
La importación terminó con “Importada en parte”. ¿Y ahora qué?
Gorgias dejó de responder durante uno o más pasos, por ejemplo porque su límite de la API siguió agotado durante mucho tiempo. Todo lo que se leyó hasta entonces está en Deskwoot. Vuelve a iniciar la importación: se salta lo que ya está y continúa.
Mis contactos ya están en Deskwoot. ¿La importación los usa?
Sí. Antes de agregar un contacto, la importación busca a esa persona en Deskwoot: primero por el ID de Gorgias y luego por la dirección de correo, esté escrita en mayúsculas o en minúsculas. Sus tickets van entonces al contacto que ya tienes, y su nombre, datos y campos se quedan como están. Para que coincida por ID, dale a cada contacto su ID de Gorgias cuando lo agregues o actualices a través de la API, en el campo externalId: gorgias:, tu subdominio de Gorgias en minúsculas, dos puntos y el ID del cliente en Gorgias, por ejemplo gorgias:acme:4711 para el cliente 4711 en acme.gorgias.com. Si todos tus contactos ya están en Deskwoot, puedes desactivar Contactos: cada ticket va igual a su contacto, y uno que Deskwoot todavía no tiene llega con el ticket.
¿Puedo importar solo una parte de mis datos?
Sí. En ¿Qué se debe importar?, todo está activado de forma predeterminada, y puedes desactivar Tickets, Contactos, Respuestas predefinidas (tus macros, con las macros de Deskwoot que salen de ellas) y Valoraciones de satisfacción. Con un día en Solo tickets creados a partir del, solo se importan los tickets creados ese día o después. Las valoraciones solo se importan con los tickets que valoran, así que esa opción aparece en gris sin los tickets. Los equipos, agentes, tags, campos, reglas y vistas siempre se importan. Si dejas fuera los contactos, cada ticket importado trae de todas formas su propio contacto.
Cada importación del Historial de importaciones muestra en Tu elección lo que no se seleccionó y la fecha de inicio. Para traer el resto más tarde, inicia una importación con todo seleccionado: se salta lo que ya está en Deskwoot y trae lo que quedó fuera.
¿Cómo deshago una importación?
En el Historial de importaciones, haz clic en Eliminar junto a la importación, confirma e introduce tu contraseña. Esto elimina las conversaciones, los tickets de Deskwoot y los contactos que creó, junto con los archivos que copió para ellos. Una conversación en la que alguien escribió desde entonces se queda con esos mensajes nuevos, sin los importados, y un contacto que todavía tiene una conversación también se queda. Los equipos, respuestas predefinidas, macros, etiquetas, atributos personalizados, reglas de automatización, filtros guardados y demás configuración se quedan. La eliminación continúa después de un reinicio, y puedes iniciar una nueva importación cuando termine. Mientras se ejecuta otra importación, no se puede eliminar ninguna importación. Si importaste desde Gorgias más de una vez, elimina las importaciones de la más reciente a la más antigua: mientras exista una importación de Gorgias más reciente, Deskwoot te pide que elimines esa primero.
¿Deskwoot guarda mi clave de API?
Solo mientras se ejecuta la importación, guardada de forma cifrada, para poder continuar después de un reinicio. Se elimina cuando termina la importación.
¿Te resultó útil esta guía?
Sigue leyendo
- Compañeros de IA: cómo trabajan en tu equipoConecta Claude, ChatGPT, Grok Bot o Cursor como compañeros de IA: roles, qué leen, autonomía y temas retenidos, aprobaciones, pausar y detener, y facturación.Leer guía
- Conectar Grok Bot a DeskwootConecta Grok Bot como compañero de IA: la frase para su chat, la página de consentimiento, las preguntas de configuración, el aviso de trabajo nuevo y adónde van tus datos.Leer guía
- Planes y precios: lo que incluye cada plan de DeskwootPrecios, límites y funciones de los planes Hacker, Startup, Business y Enterprise, cómo se cuentan las conversaciones de IA y qué pasa cuando termina una prueba o cambias de plan.Leer guía
Preguntar a Fynn sobre esta guía
Recibe una respuesta corta basada en esta guía y el resto del centro de ayuda.