Importar desde Help Scout

Actualizado el 20 nov 202619 min de lectura
Español
En esta página

Trae a Deskwoot tus conversaciones, clientes, organizaciones, Saved Replies y tu base de conocimiento de Docs desde Help Scout. Necesitas el App ID y el App Secret de una app que creas en Help Scout, y una clave de la Docs API para tus artículos de Docs. Todo se importa de forma predeterminada, y puedes elegir importar menos. La importación 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 Help Scout.

Qué se importa

  • Las conversaciones llegan con todos sus hilos: los mensajes del cliente, las respuestas de tu equipo, las líneas de chat, las notas privadas y las líneas de actividad de Help Scout (asignada, cerrada, se ejecutó un workflow, etc.), con sus archivos adjuntos e imágenes. Cada una conserva su asunto, sus tags, los valores de sus campos personalizados, sus fechas originales y el compañero o equipo al que estaba asignada. Una llamada que un compañero registró y la nota con la que se reenvió una conversación llegan como notas privadas.
  • Tickets de Deskwoot: si tu espacio de trabajo usa tickets (tu plan los incluye y están activados en Configuración > Tickets), cada conversación importada recibe además un ticket de Deskwoot. El ticket toma el estado, el asunto, el equipo, la asignación y las etiquetas, y lleva el trabajo desde ese momento. La conversación conserva todos sus mensajes, se resuelve como traspaso y muestra una tarjeta privada Ticket #… importado de Help Scout. Una respuesta en el ticket sale a través de esa conversación. Sin tickets, la conversación conserva su estado de Help Scout.
  • Los tags se convierten en etiquetas. Se importan todos los tags de tu cuenta, también uno que ninguna conversación importada lleva (por ejemplo, uno que solo agrega un workflow), para que lo encuentres cuando vuelvas a crear ese workflow.
  • Las valoraciones de satisfacción se convierten en valoraciones CSAT con el comentario del cliente en la conversación que les corresponde: Great pasa a 5, Okay a 3 y Not Good a 1 en la escala de Deskwoot del 1 al 5. Una conversación con varias valoraciones conserva la más reciente.
  • Los clientes se convierten en contactos con todas sus direcciones de correo y números de teléfono, cargo, ubicación, dirección, sitios web, perfiles sociales, usuarios de chat, los valores de tus propiedades de cliente y su foto de perfil. El campo Notes de un cliente pasa a ser la descripción del contacto.
  • Las organizaciones llegan con sus datos y los valores de tus propiedades de organización, y cada contacto conserva su organización.
  • Los users se vinculan con tus compañeros de equipo por su correo, también por los correos adicionales que tienen en Help Scout (más abajo te explicamos cómo). Los equipos se convierten en equipos, con aquellos de sus miembros que ya están en tu espacio de trabajo.
  • Las Saved Replies se convierten en respuestas predefinidas con sus imágenes y archivos. El código corto sale del nombre de la Saved Reply. Una Saved Reply que también tiene un texto de chat trae una segunda respuesta predefinida para él, cuyo código corto termina en _chat. Las Saved Replies de varias bandejas de entrada con el mismo nombre y texto se convierten en una sola respuesta predefinida; con el mismo nombre y otro texto, reciben _2, _3, etc. Si en Deskwoot ya existe una respuesta predefinida con el mismo código corto, la importada se deja fuera, y el Historial de importaciones muestra cuántas se dejaron fuera.
  • Los campos personalizados de tus bandejas de entrada se convierten en atributos de conversación (los campos con el mismo nombre y tipo en varias bandejas de entrada se convierten en uno), las propiedades de cliente en atributos de contacto y las propiedades de organización en atributos de organización.
  • Los workflows activos en Help Scout se convierten en reglas de automatización con el mismo nombre, desactivadas y sin condiciones ni acciones, porque la API de Help Scout no las comparte. Cada regla indica en su descripción de qué workflow y de qué bandeja de entrada de Help Scout viene, para que puedas volver a crearla.
  • Docs: con una clave de la Docs API, cada sitio de Docs se convierte en un centro de ayuda propio, con el nombre del sitio. Las colecciones pasan a ser categorías de primer nivel, con sus categorías debajo. Los artículos publicados siguen publicados y todos los demás llegan como borradores.

Archivos e imágenes

La importación copia en Deskwoot todos los archivos que Help Scout aloja: archivos adjuntos de las conversaciones, imágenes pegadas en mensajes y notas, imágenes y enlaces a archivos en los artículos de Docs y en las Saved Replies, y las fotos de perfil que subiste para tus clientes. Nada se queda como un enlace a Help Scout, así que tus archivos siguen funcionando cuando dejes Help Scout. Si tu espacio de trabajo contrató el Análisis antivirus, cada archivo se analiza antes de guardarse.

  • Los enlaces entre las páginas de tu sitio de Docs, y los enlaces a ellas en Saved Replies y conversaciones, apuntan a la página correspondiente de tu centro de ayuda en Deskwoot, también cuando esa página es un borrador o es de Solo el equipo. Tus clientes pueden abrir esa página en cuanto la publiques para ellos. Sin la base de conocimiento (sin clave de la Docs API, o con Base de conocimiento desactivada), estos enlaces siguen apuntando a tu sitio de Docs.
  • Una foto de perfil que Help Scout muestra desde otro servicio, como Gravatar o una red social, se deja fuera: la importación nunca se la pide a esos servicios. Lo mismo pasa con las imágenes de relleno que Help Scout dibuja para los clientes sin foto.
  • Un archivo adjunto que bloqueó el propio análisis antivirus de Help Scout se deja fuera.
  • Si un archivo no se puede copiar en este momento (Help Scout 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.
  • El Historial de importaciones muestra estos archivos en Archivos no importados con el motivo, por ejemplo demasiado grande (más de 25 MB, o más de 2 MB en las fotos de perfil), un tipo de archivo que no está permitido, rechazado por un análisis antivirus o ya no disponible en Help Scout.
  • Las imágenes que un mensaje o un artículo carga desde otro sitio web, como el tuyo, se quedan como están.

Qué no se importa

Algunas cosas no las entrega la API de Help Scout, y para otras Deskwoot no tiene lugar:

  • Las condiciones y acciones de un workflow (ver arriba). Los workflows inactivos se quedan fuera.
  • Las carpetas y vistas (Mine, Assigned, Closed y las vistas que creó tu equipo), así que no llegan filtros guardados.
  • Los borradores, las respuestas retenidas para revisión, y las conversaciones en spam y eliminadas.
  • Una prioridad, porque Help Scout no tiene, y una posposición: Help Scout mantiene activa una conversación pospuesta, así que llega como abierta.
  • Las direcciones en Para, CC y CCO de las conversaciones y respuestas, para que responder a todos en una conversación antigua nunca les escriba. La nota con la que se reenvió una conversación llega sin la dirección a la que se envió.
  • El vínculo entre una conversación reenviada y la que abrió el reenvío: llegan las dos, cada una con sus propios mensajes, pero sin vincularse entre sí.
  • El canal de mensajería (WhatsApp, SMS, Messenger, Instagram) por el que llegó una conversación. Help Scout la lista como conversación de correo, de chat o de teléfono, y llega así.
  • Los mensajes sueltos de un chat de Beacon que ya terminó: Help Scout guarda su transcripción como un solo mensaje, y llega como un solo mensaje.
  • De Docs: los artículos relacionados, las palabras clave, las redirecciones, el logo y los colores del sitio, y el borrador sin publicar de un artículo publicado (llega su texto publicado). Un artículo que está en varias categorías va a la primera de ellas. Una categoría vacía, como la categoría Uncategorized que tiene cada colección, solo llega cuando contiene un artículo.
  • Los logos y colores de marca de las organizaciones, y las fotos de los users y los equipos.
  • Los números de conversación de Help Scout. Deskwoot numera las conversaciones en el orden en que Help Scout las lista, de la más reciente a la más antigua.

Qué queda interno

Deskwoot mantiene privado todo lo que tu sitio de Docs no mostraba a todo el mundo:

  • Una colección privada se convierte en una categoría de Solo el equipo, junto con todas las categorías que contiene. Una categoría que no es pública también pasa a ser de Solo el equipo.
  • Todas las categorías de un sitio de Docs que no tiene sitio público, está desactivado o usa Restricted Docs (solo visitantes aprobados, planes Plus y Pro) pasan a ser de Solo el equipo.

Las categorías de Solo el equipo y sus artículos solo los ve tu equipo en el panel. Nunca aparecen en el centro de ayuda público, en el mapa del sitio, en el widget de chat ni para Fynn, el bot de IA.

Antes de empezar

  1. Revisa tu plan de Help Scout. La importación lee a través de la API de Help Scout, que incluyen todos los planes de pago y la prueba. El plan Free de Help Scout no tiene API, así que la importación necesita un plan de pago o una prueba.
  2. En Help Scout, haz clic en tu avatar y abre Your Profile > My Apps. Hazlo como propietario de la cuenta, para que la importación vea todas las bandejas de entrada. Haz clic en Create App, escribe cualquier nombre (por ejemplo, “Deskwoot Migration”) y cualquier URL de redirección (por ejemplo, https://deskwoot.com), y guarda. Copia el App ID y el App Secret.
  3. Para tus artículos de Docs, copia también la clave en Your Profile > Security & Access > Docs API.
  4. Invita a tus compañeros de equipo a Deskwoot con el mismo correo que usan en Help Scout. También puedes hacerlo más tarde.

Cómo importar

  1. En Deskwoot, ve a Configuración > Importación y migración. Solo los administradores pueden importar.
  2. Elige Help Scout.
  3. Escribe el App ID y el App Secret, y la Clave de la Docs API si quieres tus artículos de Docs. Sin la clave, tus artículos de Docs no se importan. Deskwoot comprueba las claves con Help Scout al iniciar y te avisa si Help Scout las rechaza.
  4. En ¿Qué se debe importar?, elige lo que se importa. Todo está activado de forma predeterminada. Para importar solo las conversaciones más recientes, elige un día en Solo conversaciones creadas a partir del.
  5. En ¿A qué bandeja de entrada deben ir las conversaciones?, elige una bandeja de entrada para cada tipo de conversación, o deja Sin bandeja de entrada. Solo se ofrecen bandejas de entrada de correo, Telegram, WhatsApp y SMS, así que configúralas primero.
  6. Haz clic en Iniciar importación.

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. Además muestra cuántas llamadas a la API por minuto permite tu cuenta de Help Scout y cuántas usa la importación como máximo.
  • Help Scout le da a cada cuenta un número de llamadas a la API por minuto, según su plan, y cuenta juntas las llamadas de todas tus apps e integraciones. La importación usa como máximo el 85% de ese límite, así tus otras apps siguen funcionando mientras se ejecuta. Cuando 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 Help Scout deja de responder o rechaza una lista, 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. Una lista que tu plan de Help Scout no tiene (los equipos y los campos personalizados de las bandejas de entrada vienen con Plus y Pro) se salta sin aviso.

Las conversaciones y respuestas de tus compañeros

Una conversación asignada a un user de Help Scout va al compañero de equipo que tiene el mismo correo, y sus respuestas y notas lo muestran como remitente. Con los tickets activados, el ticket de Deskwoot también va a ese compañero. Una conversación asignada a un equipo de Help Scout va al equipo de Deskwoot con ese nombre. Si el user todavía no tiene una cuenta de Deskwoot, la conversación 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.

Bandejas de entrada para conversaciones importadas

  • Help Scout anota si cada conversación es un correo, un chat o una llamada, y si llegó por un formulario de contacto de Beacon o de Docs. La importación pone cada conversación en la bandeja de entrada que elegiste para su tipo (Correo, Chat, Formularios web y centro de ayuda o Teléfono), así tu equipo puede responderla ahí. Help Scout lista también las conversaciones de WhatsApp, SMS y Messenger como uno de estos tipos, así que las filas WhatsApp, SMS y Todo lo demás no reciben conversaciones de Help Scout.
  • Una conversación 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. Las demás conversaciones llegan sin bandeja de entrada.
  • Cuando vuelves a iniciar la importación, las conversaciones que importaste antes también van a las bandejas de entrada que elijas, si todavía no tienen una. Una conversación que ya tiene bandeja de entrada, o en la que alguien de tu equipo escribió, se queda donde está. La siguiente importación parte de las bandejas de entrada de la última.
  • Un ticket de Deskwoot no tiene bandeja de entrada propia: sus respuestas salen a través de su conversación, así que esa conversación necesita una.
  • El Historial de importaciones muestra las bandejas de entrada que elegiste y cuántas conversaciones fueron a una de ellas.

Después de la importación

  • Una conversación 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: ábrela y elige una bandeja de entrada en el aviso Esta conversación no tiene bandeja de entrada. El Historial de importaciones muestra en Por hacer cuántas hay.
  • Vuelve a crear tus workflows: agrega las condiciones y acciones a cada regla importada y luego activa las que quieras. El Historial de importaciones te lleva a ellas con Revisar y activar las reglas.
  • Revisa los artículos y las categorías de tu nuevo centro de ayuda y publica los que tus clientes deben ver.

Preguntas frecuentes

¿Qué plan de Help Scout necesito?

Un plan de pago o una prueba: el plan Free de Help Scout no tiene acceso a la API. Los equipos, los campos personalizados de las bandejas de entrada y Restricted Docs solo existen en Help Scout en Plus y Pro. En Standard, las valoraciones llevan la fecha de la respuesta que valoran, porque los informes de Help Scout, que dan la hora de cada valoración, solo forman parte de Plus y Pro.

¿Puedo importar solo una parte de mis datos?

Sí. En ¿Qué se debe importar?, todo está activado de forma predeterminada, y puedes desactivar Conversaciones, Contactos y organizaciones, Base de conocimiento, Respuestas predefinidas y Valoraciones de satisfacción. Con un día en Solo conversaciones creadas a partir del, solo se importan las conversaciones creadas ese día o después, y solo las valoraciones dadas desde ese día. Las valoraciones solo se importan con las conversaciones que valoran, así que esa opción aparece en gris sin las conversaciones. Los tags también llegan con las conversaciones. Los users, los equipos, los workflows y los campos de conversaciones y contactos siempre se importan. Si dejas fuera los contactos, cada conversación importada trae de todas formas su propio contacto.

El Historial de importaciones muestra debajo de cada importació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.

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 por cada una de sus direcciones de correo, esté escrita en mayúsculas o en minúsculas. Sus conversaciones van entonces al contacto que ya tienes, y su nombre, datos y campos se quedan como están. Si todos tus contactos ya están en Deskwoot, puedes desactivar Contactos y organizaciones: cada conversación va igual a su contacto, y uno que Deskwoot todavía no tiene llega con la conversación.

¿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 las conversaciones, los contactos y los artículos no se duplican. Trae lo que es nuevo o faltaba, por ejemplo después de una ejecución que terminó con Importada en parte. En una conversación que importó antes, agrega los mensajes y tags nuevos, y toma un nuevo estado, asunto, asignación o equipo, siempre que nadie haya trabajado en esa conversación en Deskwoot. Los valores de campos que cambiaron en Help Scout y los tags que se quitaron ahí no se toman.

Si combinaste dos conversaciones en Help Scout después de una importación anterior, una nueva ejecución trae los mensajes movidos a la conversación que Help Scout conservó, y la combinada se queda en Deskwoot tal como se importó.

Los artículos del centro de ayuda que tu equipo editó en Deskwoot conservan su texto nuevo, y una nueva ejecución nunca publica un artículo que despublicaste o pasaste a Solo el equipo. Si Help Scout hizo privada una colección o una categoría desde entonces, una nueva ejecución también la pasa a Solo el equipo en Deskwoot. Si Help Scout despublicó un artículo desde entonces, una nueva ejecución también lo despublica en Deskwoot, pero solo si tu equipo no lo editó.

Ten en cuenta que las conversaciones, contactos y notas que eliminaste o borraste en Deskwoot desde la última importación vuelven si Help Scout todavía los tiene, y lo mismo pasa con los contactos que combinaste.

La importación terminó con “Importada en parte”. ¿Y ahora qué?

Help Scout 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.

¿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 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, etiquetas, campos, reglas de automatización, artículos del centro de ayuda 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 Help Scout más de una vez, elimina las importaciones de la más reciente a la más antigua: mientras exista una importación de Help Scout más reciente, Deskwoot te pide que elimines esa primero.

¿Te resultó útil esta guía?

Sigue leyendo

Preguntar a Fynn sobre esta guía

Recibe una respuesta corta basada en esta guía y el resto del centro de ayuda.

¿Aún necesitas ayuda?

Fynn responde en el chat con estas guías, y ahí también puedes hablar con el equipo.