Hay muchas maneras de migrar el contenido de un centro de ayuda a otro. Este artículo trata principalmente de cómo usar la API del centro de ayuda para importar contenido mediante programación y ofrece una descripción general del proceso de migración del contenido existente a la nueva base de conocimientos del centro de ayuda y la comunidad. También se puede migrar el contenido usando los siguientes métodos:
- Copiar/pegar: si solo desea migrar unos cuantos artículos, la manera más fácil y rápida es simplemente copiar y pegar el contenido del centro de ayuda anterior en un artículo de Guide nuevo.
- Servicios profesionales: si tiene que hacer migraciones grandes o complicadas, puedecontratar a Zendesk para que le ayudecon la migración.
- Aplicaciones de socios: puede explorar elmarketplace de aplicacionesde Zendesk para buscar aplicaciones de socios comoHelp Desk Migration.
En este artículo se tratan los siguientes temas:
Migrar contenido a la base de conocimientos
El proceso para migrar contenido de un sistema externo al centro de ayuda sigue varios pasos en los que los datos de un paso son necesarios para los pasos subsiguientes.
La planificación es imprescindible. Un aspecto importante es mapear la estructura del contenido heredado con la estructura de tres niveles del centro de ayuda:
Importar los autores como usuarios de Zendesk
Primero, debe importar los autores de todos sus artículos como usuarios de Zendesk con el rol "agente" (un agente en Zendesk no es necesariamente alguien que resuelve tickets; consulteIntroducción a los roles de usuario de Zendesk Support).
Para crear usuarios de Zendesk con la API, consulteCreate User. Asegúrese de establecer el atributorole
en “agente” en cada solicitud POST.
一旦creado联合国usuario correctamente Zendesk 亚博devuelve los detalles del usuario en la respuesta JSON, junto con la nueva ID del usuario:
{ "user": { "id": 9873843, "name": "Roger Wilco", ... } }
Anote la ID de cada usuario porque se necesitarán las ID para establecer el atributoauthor_id
de cada artículo que se cree en el centro de ayuda.
Si piensa usarorganizacionesensegmentos de usuariospara dividir las secciones, tiene que crear las organizacionesantesde crear los usuarios. Entonces podrá asignar la ID de la organización al usuario a la hora de crearlo (consulteCreate Organization). Si los usuarios van a pertenecer a varias organizaciones, utiliceafiliaciones a organizacionespara agregar organizaciones al registro del usuario.
Crear categorías en la base de conocimientos
Las categorías son colecciones de secciones (consulteCreate Category). Una vez creada una categoría, Zendesk devuelve una respuesta JSON con la nueva ID de la categoría:
{ "category": { "id": 37486578, "name": "Super Hero Tricks", "description": "This category contains a collection of Super Hero tricks", "locale": "en-us", "position": 2, ... } }
Anote la ID de cada categoría, porque a la hora de crear secciones más adelante, se necesitarán las ID para asignar secciones a categorías específicas.
Crear segmentos de usuarios (opcional)
Si desea restringir el acceso a ciertas secciones del centro de ayuda, puede asignarsegmentos de usuariosa las secciones (consulteCreate User Segment).
Una vez creado un segmento de usuarios, Zendesk devuelve una respuesta JSON con la nueva ID del segmento de usuarios:
{ "user_segment": { "id": 7284 "name": "VIP agents", "user_type": "staff", "group_ids": [12, ...], "organization_ids": [42, ...], "tags": ["vip"], "created_at": "2017-05-21T20:01:12Z", "updated_at": "2017-05-21T20:01:12Z", "built_in": false } }
Anote la ID de cada segmento de usuarios, porque a la hora de crear secciones más adelante, se necesitará la ID del segmento para asignar restricciones de acceso a las secciones.
Crear secciones en las categorías
Las secciones son colecciones de artículos (consulteCreate Section). Asegúrese de establecercategory_id
yuser_segment_id
(si hay) en cada solicitud POST. Zendesk devuelve una respuesta JSON con la nueva ID de la sección:
{ "section": { "id": 3457836, "name": "Avionics", "description": "This section contains articles on flight instruments", "locale": "en-us", "category_id": 3465, ... } }
Anote la ID de cada sección, porque a la hora de crear artículos más adelante, se necesitarán las ID de sección para asignar artículos a secciones específicas.
Crear artículos en las secciones
Una vez que tenga todas las ID de secciones y las ID de usuarios de los pasos anteriores, podrá crear artículos (consulteCreate Article). Además detitle
ybody
, asegúrese de establecerauthor_id
ysection_id
en cada solicitud POST.
Zendesk devuelve una respuesta JSON como la siguiente:
{ "article": { "id": 37486578, "author_id": 3465, "promoted": false, "position": 42, "comments_disabled": true, "section_id": 98838, ... } }
Cargar archivos adjuntos (si es necesario)
Si un artículo tiene imágenes incorporadas que no residen en un servidor de archivos público, como Amazon S3, cargue las imágenes en el centro de ayuda (consulteCreate Unassociated Attachment). Asegúrese de establecer el parámetroinline
entrue
.
Zendesk devuelve una respuesta JSON con un URL (content_url
) para el archivo adjunto:
{ "article_attachment": { "id": 1428, "article_id": null, "file_name": "icon.jpg", "content_url": "https://company.zendesk.com/hc/article_attachments/1428/icon.jpg", "content_type": "application/image", "size": 58298, "inline": true } }
Utilicecontent_url
para actualizar el URL de la imagen en el HTML del artículo (consulteAssociate Attachments in Bulk to Article).
Importar comentarios de los artículos
Para importar comentarios, se necesita la ID de un autor y la ID del artículo. Tanto los agentes como los usuarios finales pueden ser autores de comentarios (consulteCreate Comment).
Migrar contenido a la comunidad
Para importar contenido en la comunidad deben tomarse en cuenta las mismas consideraciones que al importar contenido en una base de conocimientos. Se debenimportar usuariospara asignar autores a las publicaciones. También es necesario mapear la estructura del contenido de la comunidad heredada con la estructura de dos niveles de la comunidad del centro de ayuda:
Crear segmentos de usuarios (opcional)
如果desea restringir el acceso某些特马,necesitará las ID de los segmentos de usuarios (consulteCreate User Segment). A la hora de crear los temas más adelante, necesitará las ID de los segmentos de usuarios para especificar las restricciones de acceso a los temas.
Importar temas en la comunidad
Si se aplica, asegúrese de estableceruser_segment_id
en la solicitud POST (consulteCreate Topic).
Zendesk devuelve una respuesta JSON con la ID del tema:
{ "topic": { "id": 115000553548, "name": "Help Center-Tricks", ... } }
Anote la ID de cada tema, porque a la hora de crear los temas más adelante, necesitará las ID de los temas para asignar publicaciones a temas específicos.
Importar publicaciones en los temas
Además detitle
ydetails
, asegúrese de establecerauthor_id
ytopic_id
en cada solicitud POST (consulteCreate Post).
A diferencia de los artículos de la base de conocimientos, los autores de las publicaciones de la comunidad pueden ser agentes o usuarios finales.
Al momento de crear una publicación, se suscribe automáticamente al autor a todas las actualizaciones de ese tema, y cada vez que se crea una nueva publicación o se actualiza la actual, se le envía una notificación.
Todas las personas suscritas al mismo tema recibirán una notificación por correo electrónico cuando se cree la publicación. Para evitar abrumar a los suscriptores con notificaciones en caso de importar publicaciones de forma masiva, incluya un parámetronotify_subscribers
con un valor defalse
en sus solicitudes POST.
{ "post": { "id": 35467, "author_id": 89567, "title": "Help!", "details": "My printer is on fire!", "notify_subscribers": false, ... } }
Importar comentarios en las publicaciones
Una vez creadas las publicaciones y obtenidas sus ID, podrá agregar sus comentarios relacionados (consulteCreate Comment).
Solo se puede crear un comentario a la vez. Al momento de crear el comentario de una publicación, se suscribe automáticamente al autor a todas las actualizaciones del tema, y cada vez que se crea una nueva publicación o se actualiza la actual, se le envía una notificación.
Todas las personas suscritas al mismo tema recibirán una notificación por correo electrónico cuando se cree un comentario. Para evitar abrumar a los suscriptores con todas las notificaciones, incluya un parámetronotify_subscribers
con un valor defalse
en sus solicitudes POST.
0 Comentarios
Inicie sesiónpara dejar un comentario.