Compartir a través de

Freshservice (versión preliminar)

Freshservice es una solución de administración de servicios de TI basada en la nube que es fácil de configurar y usar para transformar la experiencia de los empleados en toda la organización.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con aplicaciones freshworks
URL https://www.freshworks.com
Correo Electrónico appsupport-ex@freshworks.com
Metadatos del conector
Publicador Microsoft
Sitio web https://www.freshworks.com/freshservice/lp/home/
Directiva de privacidad https://www.freshworks.com/privacy
Categorías Operaciones de TI

Autenticación

Importante

La autenticación basada en nombre de usuario y contraseña ya no es compatible con FreshService. El conector ahora solo admite un tipo de autenticación: clave de API. Documentos de migración de FreshService API

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Clave de API Tipo de autenticación de clave de API Todas las regiones No se puede compartir
Valor predeterminado [EN DESUSO] Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. Todas las regiones No se puede compartir

Clave de API

Identificador de autenticación: Básico

Aplicable: Todas las regiones

Tipo de autenticación de clave de API

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API cuerda / cadena La clave de API de esta API Cierto
Dirección URL del sitio cuerda / cadena Dirección URL del sitio raíz (ejemplo: https://sample.freshservice.com ) Cierto

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Nombre de usuario cuerda / cadena El nombre de usuario de esta API Cierto
Contraseña securestring La contraseña de esta API Cierto
Dirección URL del sitio cuerda / cadena Dirección URL del sitio raíz (ejemplo: https://sample.freshservice.com ) Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos
Frecuencia de sondeos de desencadenador 1 120 segundos

Acciones

Actualizar un vale (V2)

Actualice un vale (solo se actualizarán los valores especificados).
Actualizar un vale [EN DESUSO]

Actualice un vale (solo se actualizarán los valores especificados).
Agregar una nota a un vale (V2)

Agregue una nota privada o pública a un vale.
Agregar una nota a un vale [EN DESUSO]

Agregue una nota privada o pública a un vale.
Creación de un vale (V2)

Cree un vale.
Crear un vale [EN DESUSO]

Cree un vale.

Actualizar un vale (V2)

Id. de la operación:
UpdateTicketV2

Actualice un vale (solo se actualizarán los valores especificados).

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Identificador de vale que se va a actualizar.
Id. del solicitante
 requester_id integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Asunto
 subject string

Asunto del billete.
Estado
 status string

Estado del vale.
Priority
 priority string

Prioridad del billete (por ejemplo, Bajo, Medio o Alto).
Urgencia
 urgency string

Urgencia del problema (por ejemplo, Bajo, Medio o Alto).
Impacto
 impact string

Impacto del problema (por ejemplo, bajo, medio o alto).
Fuente
 source string

Canal a través del cual se creó el vale.

Devoluciones

Body
CreateUpdateTicket_ResponseV2

Actualizar un vale [EN DESUSO]

Id. de la operación:
UpdateTicket

Actualice un vale (solo se actualizarán los valores especificados).

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Identificador de vale que se va a actualizar.
Id. del solicitante
 requester_id integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Asunto
 subject string

Asunto del billete.
Estado
 status string

Estado del vale.
Priority
 priority string

Prioridad del billete (por ejemplo, Bajo, Medio o Alto).
Urgencia
 urgency string

Urgencia del problema (por ejemplo, Bajo, Medio o Alto).
Impacto
 impact string

Impacto del problema (por ejemplo, bajo, medio o alto).
Fuente
 source string

Canal a través del cual se creó el vale.

Devoluciones

Body
UpdateTicket_Response

Agregar una nota a un vale (V2)

Id. de la operación:
AddNoteV2

Agregue una nota privada o pública a un vale.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Identificador de vale que se va a actualizar.
Nota:
 body True string

Nota que se va a agregar al vale.
Es privado
 private boolean

Establézcalo en true si el mensaje es privado.

Devoluciones

Body
AddNote_ResponseV2

Agregar una nota a un vale [EN DESUSO]

Id. de la operación:
AddNote

Agregue una nota privada o pública a un vale.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Identificador de vale que se va a actualizar.
Nota:
 body True string

Nota que se va a agregar al vale.
Es privado
 private boolean

Establézcalo en true si el mensaje es privado.

Devoluciones

Body
AddNote_Response

Creación de un vale (V2)

Id. de la operación:
CreateTicketV2

Cree un vale.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del solicitante
 requester_id integer

Identificador de usuario del solicitante. Se requiere uno de los identificadores del solicitante, correo electrónico del solicitante y teléfono del solicitante.
Correo electrónico del solicitante
 email string

Correo electrónico del solicitante. Se requiere uno de los identificadores del solicitante, correo electrónico del solicitante y teléfono del solicitante.
Teléfono del solicitante
 phone string

Número de teléfono del solicitante. Se requiere uno de los identificadores del solicitante, correo electrónico del solicitante y teléfono del solicitante.
Nombre del solicitante
 name string

Nombre del solicitante. Este es un campo obligatorio solo si se proporciona el valor del teléfono del solicitante.
Asunto
 subject True string

Asunto del billete.
Estado
 status True string

Estado del vale.
Priority
 priority True string

Prioridad del billete (por ejemplo, Bajo, Medio o Alto).
Description
 description True string

Descripción del vale.
Urgencia
 urgency string

Urgencia del problema (por ejemplo, Bajo, Medio o Alto).
Impacto
 impact string

Impacto del problema (por ejemplo, bajo, medio o alto).
Fuente
 source string

Canal a través del cual se creó el vale.

Devoluciones

Body
CreateUpdateTicket_ResponseV2

Crear un vale [EN DESUSO]

Id. de la operación:
CreateTicket

Cree un vale.

Parámetros

Nombre Clave Requerido Tipo Description
Id. del solicitante
 requester_id True integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Asunto
 subject True string

Asunto del billete.
Estado
 status True string

Estado del vale.
Priority
 priority True string

Prioridad del billete (por ejemplo, Bajo, Medio o Alto).
Description
 description True string

Descripción del vale.
Urgencia
 urgency string

Urgencia del problema (por ejemplo, Bajo, Medio o Alto).
Impacto
 impact string

Impacto del problema (por ejemplo, bajo, medio o alto).
Fuente
 source string

Canal a través del cual se creó el vale.

Devoluciones

Nombre Ruta de acceso Tipo Description
helpdesk_ticket
 item.helpdesk_ticket Ticket_Response

Desencadenadores

Cuando se crea un vale (V2)

Se desencadena cuando se crea un nuevo vale.
Cuando se crea un vale [EN DESUSO]

Se desencadena cuando se crea un nuevo vale.

Cuando se crea un vale (V2)

Id. de la operación:
OnTicketCreatedV2

Se desencadena cuando se crea un nuevo vale.

Devoluciones

Body
ListTicket_ResponseV2

Cuando se crea un vale [EN DESUSO]

Id. de la operación:
OnTicketCreated

Se desencadena cuando se crea un nuevo vale.

Devoluciones

Body
Ticket_Response

Definiciones

Ticket_Response

Nombre Ruta de acceso Tipo Description
Creado en Date-Time
 created_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Está eliminado
 deleted boolean

Establezca como true si el vale se elimina o se papelera. Los vales eliminados no se considerarán en ninguna vista excepto el filtro "eliminado".
Id. de departamento
 department_id_value integer
Id. de vale
 display_id integer

Id. de vale específico de su cuenta.
Due By Date-Time
 due_by date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id. de grupo
 group_id integer

Identificador del grupo al que se asigna el vale.
Id
 id integer

Identificador único del vale.
Impacto
 impact integer

Número que representa el impacto del problema.
Se ha escalado
 isescalated boolean

Se establece en true si se envió una extensión.
ID del propietario
 owner_id string

Identificador del agente al que se asigna el problema.
Priority
 priority integer

Número que representa la prioridad del vale.
Id. del solicitante
 requester_id integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Id. del respondedor
 responder_id integer

Identificador del agente al que se asigna el vale.
Fuente
 source integer

Número que representa el canal a través del cual se creó el vale.
Correo no deseado
 spam boolean

Establezca como true si el vale está marcado como correo no deseado.
Estado
 status integer

Número que representa el estado del vale.
Asunto
 subject string

Asunto del vale.
Tipo de vale
 ticket_type string

Escriba el campo de propiedad tal como se define en los campos de vale.
Para enviar correo electrónico
 to_email string

Dirección de correo electrónico a la que se envió el correo electrónico del vale entrante.
Actualizado en Date-Time
 updated_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Urgencia
 urgency integer

Número que representa la urgencia del problema.
Description
 description string

Descripción del problema.
Descripción HTML
 description_html string

Contenido HTML del vale. Descripción y description_html no deben pasarse juntos.
Nombre del estado
 status_name string

Estado del vale.
Nombre de prioridad
 priority_name string

Prioridad del vale.
Nombre de origen
 source_name string

Canal a través del cual se creó el vale.
Nombre del respondedor
 responder_name string

Nombre del agente al que se asigna el vale.
Para correos electrónicos
 to_emails array of string

Direcciones de correo electrónico a las que se envió el correo electrónico del vale entrante.
Nombre del departamento
 department_name string

Nombre del departamento.
Id. de problema asociado
 assoc_problem_id integer

Identificador del problema asociado al vale.
Id. de cambio asociado
 assoc_change_id integer

Identificador del cambio asociado al problema.
Id. de causa de cambio asociado
 assoc_change_cause_id integer

Identificador del cambio que provoca el vale.
Id. de recurso asociado
 assoc_asset_id integer

Identificador del recurso asociado al vale.
Nombre de urgencia
 urgency_name string

Urgencia del problema.
Nombre del impacto
 impact_name string

Impacto del problema.

CreateUpdateTicket_ResponseV2

Nombre Ruta de acceso Tipo Description
Creado en Date-Time
 ticket.created_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id. de departamento
 ticket.department_id integer
Due By Date-Time
 ticket.due_by date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id. de grupo
 ticket.group_id integer

Identificador del grupo al que se asigna el vale.
Id
 ticket.id integer

Identificador único del vale.
Se ha escalado
 ticket.is_escalated boolean

Se establece en true si se envió una extensión.
Priority
 ticket.priority integer

Número que representa la prioridad del vale.
Id. del solicitante
 ticket.requester_id integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Id. del respondedor
 ticket.responder_id integer

Identificador del agente al que se asigna el vale.
Fuente
 ticket.source integer

Número que representa el canal a través del cual se creó el vale.
Correo no deseado
 ticket.spam boolean

Establezca como true si el vale está marcado como correo no deseado.
Estado
 ticket.status integer

Número que representa el estado del vale.
Asunto
 ticket.subject string

Asunto del vale.
Tipo de vale
 ticket.type string

Escriba el campo de propiedad tal como se define en los campos de vale.
Actualizado en Date-Time
 ticket.updated_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Description
 ticket.description_text string

Descripción del problema.
Descripción HTML
 ticket.description string

Contenido HTML del vale. Descripción y description_html no deben pasarse juntos.
Para correos electrónicos
 ticket.to_emails array of string

Direcciones de correo electrónico a las que se envió el correo electrónico del vale entrante.

ListTicket_ResponseV2

Nombre Ruta de acceso Tipo Description
Creado en Date-Time
 created_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id. de departamento
 department_id integer
Due By Date-Time
 due_by date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id. de grupo
 group_id integer

Identificador del grupo al que se asigna el vale.
Id
 id integer

Identificador único del vale.
Se ha escalado
 is_escalated boolean

Se establece en true si se envió una extensión.
Priority
 priority integer

Número que representa la prioridad del vale.
Id. del solicitante
 requester_id integer

Identificador de usuario del solicitante. En el caso de los contactos existentes, requester_id se pueden pasar en lugar del correo electrónico.
Id. del respondedor
 responder_id integer

Identificador del agente al que se asigna el vale.
Fuente
 source integer

Número que representa el canal a través del cual se creó el vale.
Correo no deseado
 spam boolean

Establezca como true si el vale está marcado como correo no deseado.
Estado
 status integer

Número que representa el estado del vale.
Asunto
 subject string

Asunto del vale.
Tipo de vale
 type string

Escriba el campo de propiedad tal como se define en los campos de vale.
Actualizado en Date-Time
 updated_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Description
 description_text string

Descripción del problema.
Descripción HTML
 description string

Contenido HTML del vale. Descripción y description_html no deben pasarse juntos.
Para correos electrónicos
 to_emails array of string

Direcciones de correo electrónico a las que se envió el correo electrónico del vale entrante.

UpdateTicket_Response

Nombre Ruta de acceso Tipo Description
Está eliminado
 ticket.deleted boolean

Establezca como true si el vale se elimina o se papelera. Los vales eliminados no se considerarán en ninguna vista excepto el filtro "eliminado".
Id. de vale
 ticket.display_id integer

Id. de vale específico de su cuenta.
Asunto
 ticket.subject string

Asunto del vale.
Description
 ticket.description string

Descripción del vale.
Descripción HTML
 ticket.description_html string

Contenido HTML del vale. Descripción y description_html no deben pasarse juntos.
Nombre del estado
 ticket.status_name string

Estado del vale.
Nombre de prioridad
 ticket.priority_name string

Prioridad del vale.
Nombre de origen
 ticket.source_name string

Canal a través del cual se creó el vale.
Nombre del respondedor
 ticket.responder_name string

Nombre del agente al que se asigna el vale.
Para correos electrónicos
 ticket.to_emails array of string

Direcciones de correo electrónico a las que se envió el correo electrónico del vale entrante.
Nombre del departamento
 ticket.department_name string

Nombre del departamento.
Id. de problema asociado
 ticket.assoc_problem_id integer

Identificador del problema asociado al vale.
Id. de cambio asociado
 ticket.assoc_change_id integer

Identificador del cambio asociado al problema.
Id. de causa de cambio asociado
 ticket.assoc_change_cause_id integer

Identificador del cambio que provoca el vale.
Id. de recurso asociado
 ticket.assoc_asset_id integer

Identificador del recurso asociado al vale.
Nombre de urgencia
 ticket.urgency_name string

Urgencia del problema.
Nombre del impacto
 ticket.impact_name string

Impacto del problema.

AddNote_Response

Nombre Ruta de acceso Tipo Description
Creado en Date-Time
 note.created_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Está eliminado
 note.deleted boolean

Establezca como true si el vale se elimina o se papelera. Los vales eliminados no se considerarán en ninguna vista excepto el filtro "eliminado".
Id
 note.id integer

Identificador único de la nota.
Privada
 note.private boolean

Establezca como true si la nota es privada.
Fuente
 note.source integer

Número que representa el canal a través del cual se creó el vale.
Actualizado en Date-Time
 note.updated_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
ID de usuario
 note.user_id integer

User_id del agente que agrega la nota.
Body
 note.body string

Contenido de la nota en texto sin formato.
HTML del cuerpo
 note.body_html string

Contenido de la nota en formato HTML. Debe pasarse el cuerpo o body_html.
attachments
 note.attachments array of string

AddNote_ResponseV2

Nombre Ruta de acceso Tipo Description
Creado en Date-Time
 conversation.created_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
Id
 conversation.id integer

Identificador único de la nota.
Privada
 conversation.private boolean

Establezca como true si la nota es privada.
Actualizado en Date-Time
 conversation.updated_at date-time

aaaa-MM-ddTHH:mm:ss.fffZ
ID de usuario
 conversation.user_id integer

User_id del agente que agrega la nota.
Body
 conversation.body_text string

Contenido de la nota en texto sin formato.
HTML del cuerpo
 conversation.body string

Contenido de la nota en formato HTML. Debe pasarse el cuerpo o body_html.
attachments
 conversation.attachments array of string
Id. de vale
 conversation.ticket_id integer

Identificador único del vale.