Crear un esquema de plataforma para Zendesk
Antes de crear una conexión de origen de Zendesk, también debe asegurarse de crear primero un esquema de Platform para utilizarlo en el origen. Consulte el tutorial de creación de un esquema de Platform para ver los pasos detallados sobre cómo crear un esquema.
Para obtener instrucciones adicionales sobre el esquema Zendesk necesario para Zendesk Search API, consulte la sección límites a continuación.
Conectar su cuenta de Zendesk
En la interfaz de usuario de Platform, seleccione Sources en la barra de navegación izquierda para acceder al área de trabajo Sources. La pantalla Catálogo muestra una variedad de orígenes con los que puede crear una cuenta.
Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.
En la categoría Éxito del cliente, seleccione Zendesk y después Agregar datos.
Aparecerá la página Conectar cuenta de Zendesk. En esta página, puede usar credenciales nuevas o existentes.
Cuenta existente
Para usar una cuenta existente, selecciona la cuenta de Zendesk con la que deseas crear un nuevo flujo de datos y luego selecciona Siguiente para continuar.
Nueva cuenta
Si va a crear una cuenta nueva, seleccione Cuenta nueva y, a continuación, proporcione un nombre, una descripción opcional y sus credenciales. Cuando termine, seleccione Conectarse al origen y deje pasar un tiempo para que se establezca la nueva conexión.
Seleccionar datos
Una vez autenticado el origen, la página se actualiza a un árbol de esquema interactivo que le permite explorar e inspeccionar la jerarquía de los datos. Seleccione Siguiente para continuar.
Pasos siguientes
Al seguir este tutorial, se ha autenticado y creado una conexión de origen entre su cuenta de Zendesk y Platform. Ahora puede continuar con el siguiente tutorial y crear un flujo de datos para llevar los datos de éxito de los clientes a la plataforma.
Recursos adicionales
Las secciones siguientes proporcionan recursos adicionales a los que puede hacer referencia al usar el origen Zendesk.
Validación
A continuación se describen los pasos que puede seguir para comprobar que ha conectado correctamente el origen de Zendesk y que los perfiles de Zendesk se están ingiriendo en Platform.
En la interfaz de usuario de Platform, seleccione Conjuntos de datos en el panel de navegación izquierdo para acceder al área de trabajo de Conjuntos de datos. La pantalla Actividad de conjunto de datos muestra los detalles de las ejecuciones.
A continuación, seleccione el ID de ejecución del flujo de datos que desea ver para ver detalles específicos sobre esa ejecución del flujo de datos.
Finalmente, seleccione Previsualizar conjunto de datos para mostrar los datos ingeridos.
También puede comprobar los datos de Platform con los datos de la página Zendesk > Customers.
Esquema de Zendesk
La tabla siguiente enumera las asignaciones compatibles que deben configurarse para Zendesk.
Fuente | Tipo |
---|---|
results.active | Booleano |
results.alias | Cadena |
results.created_at | Cadena |
results.custom_role_id | Entero |
results.default_group_id | Entero |
results.details | Cadena |
results.email | Cadena |
results.external_id | Entero |
results.iana_time_zone | Cadena |
results.id | Entero |
results.last_login_at | Cadena |
results.locale | Cadena |
results.locale_id | Entero |
results.moderator | Booleano |
results.name | Cadena |
results.notes | Cadena |
results.only_private_comments | Booleano |
results.organization_id | Entero |
results.phone | Cadena |
results.photo | Cadena |
results.report_csv | Booleano |
results.restricted_agent | Booleano |
results.result_type | Cadena |
results.role | Cadena |
results.role_type | Entero |
results.shared | Booleano |
results.shared_agent | Booleano |
results.shared_phone_number | Booleano |
results.signature | Cadena |
results.suspended | Booleano |
results.ticket_restriction | Cadena |
results.time_zone | Cadena |
results.two_factor_auth_enabled | Booleano |
results.updated_at | Cadena |
results.url | Cadena |
results.verified | Booleano |
Límites
-
La API de búsqueda de Zendesk > Exportar resultados de búsqueda devuelve un máximo de 1000 registros por página.
- El valor del parámetro
filter[type]
está establecido enuser
y, por lo tanto, la conexión de Zendesk solo devuelve usuarios. - El parámetro
page[size]
administra el número de resultados por página. El valor se ha establecido en100
. Esto se hace para reducir el impacto de las restricciones de reducción de velocidad establecidas por Zendesk. - Ver límites y paginación.
- También puede hacer referencia a Paginación mediante listas usando paginación de cursor.
- El valor del parámetro