Integração · Apoio ao cliente
Conecte Claude e ChatGPT ao TOPdesk
Pergunte à sua IA quais incidentes estão abertos para um chamador, para registrar um novo ou para transferir um incidente a outro grupo de operadores. Ela pode pesquisar e ler incidentes com seu rastro de solicitações e ações, criar e atualizar incidentes, registrar tempo, procurar e criar pessoas, e planejar e atualizar atividades operacionais.
Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.
Experimente pedir
“Qual é o status do incidente I 2409 123?”
A IA lê o incidente pelo número com chamador, solicitação, status, operador e datas.
“Quais incidentes abertos [email protected] tem?”
Ela pesquisar incidentes com um filtro no chamador e lista-os com status.
“Registre um incidente para [email protected]: seu laptop não vai iniciar.”
Ela cria o incidente com chamador, descrição breve e solicitação, e pode definir categoria, tipo de chamada e prioridade das suas listas.
O que a sua IA pode fazer
Incidentes
Pesquise incidentes com filtros FIQL, leia-os por ID ou número com solicitações e ações, e crie e atualize incidentes.
Pessoas e operadores
Pesquise, crie e atualize pessoas, e procure operadores, grupos de operadores e filiais.
Planejamento e tempo
Registre tempo em incidentes, e crie, pesquise e atualize atividades operacionais.
“Atribua o incidente I 2409 123 à equipe de rede e adicione uma nota.”
Ela procura o grupo de operadores e atualiza o incidente com o novo grupo e um texto de ação no rastro de progresso.
“Registre 30 minutos nesse incidente.”
Ela registra o tempo gasto no incidente, com notas opcionais.
“Planeje a atualização do servidor como uma atividade operacional na próxima terça-feira.”
Ela cria uma atividade operacional com descrição breve, datas de início e fim planejadas e grupo de operador.
273 ferramentas para TOPdesk
Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.
archive_a_branchVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma ramificação.archive_a_budget_holderVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um detentor de orçamento.archive_a_departmentVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma departamento.archive_a_locationVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma localização.archive_a_person_groupVisível para outras pessoasArquivar um contato (persongroup id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um grupo de pessoas.archive_an_operatorVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um operador.archive_an_operator_groupVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um grupo de operadores.archive_contactVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um incidente por id.archive_contact_archiveVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma ramificação.archive_contact_patch_archive_locationVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma localização.archive_contact_patch_archive_operatorVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um operador.archive_contact_patch_archive_operator_groupVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um grupo de operadores.archive_contact_patch_archive_personVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma pessoa e seu operador vinculado, se houver.archive_contact_put_archive_personVisível para outras pessoasArquivar um contato (id id). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar uma pessoa e seu operador vinculado, se houver.archive_numberVisível para outras pessoasArquivar um número (número número). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquivar um incidente por número.attach_branchAltera dadosAnexar uma ramificação (id id). Resumo da API: Vincular filtros de ramificação a um operador.attach_categoryAltera dadosAnexar uma categoria (id id). Resumo da API: Vincular filtros de categoria a um operador.attach_operatorAltera dadosAnexar um operador (id id). Resumo da API: Vincular filtros de operador a um operador.attach_operatorgroup_to_contactAltera dadosAnexar um grupo de operadores (id id). Resumo da API: Vincular grupos de operadores a um operador.attach_permissiongroup_to_contactElimina dadosAnexar um grupo de permissões (id id). Ação destrutiva; pode exigir aprovação. Resumo da API: Vincular grupos de permissão a um operador.create_a_person_extra_field_b_entryAltera dadosCriar uma nova página. Obrigatório: name. Resumo da API: Criar uma entrada de campo extra B de pessoa.create_addressAltera dadosCriar um novo endereço. Obrigatório: name ou branch. Pesquisar endereços primeiro para evitar duplicatas. Resumo da API: Criar uma localização.create_an_optional_person_drop_down_list_entryAltera dadosAtualizar uma pesquisa existente identificada por searchlist. Resumo da API: Criar uma entrada de lista suspensa opcional de pessoa.create_branchAltera dadosCriar uma nova ramificação. Obrigatório: name. Pesquisar ramificações primeiro para evitar duplicatas. Resumo da API: Criar uma ramificação.create_budgetholderAltera dadosCriar um novo budgetholder. Obrigatório: name. Resumo da API: Criar um detentor de orçamento.create_contactAltera dadosCriar um novo contato. Obrigatório: name. Pesquisar contatos primeiro para evitar duplicatas. Resumo da API: Criar um grupo de pessoa.create_contact_documentAltera dadosCriar um novo documento para um contato. Resumo da API: Carregar um arquivo em um incidente identificado por id.create_contact_document_postAltera dadosCriar um novo documento para um contato. Resumo da API: Carregar um arquivo em um incidente identificado por id para um usuário SSP.create_departmentAltera dadosCriar um novo departamento. Obrigatório: nome. Resumo da API: Criar departamento.create_incidentAltera dadosCriar um incidente. No `body` definir caller (email ou id), briefDescription, request, e opcionalmente category, subcategory, callType, priority, operator/operatorGroup e uma ação inicial.create_incident_postAltera dadosCriar um novo incidente. Pesquisar incidentes primeiro para evitar duplicatas. Resumo da API: Cria um Incidente para um usuário SSP.create_number_documentAltera dadosCriar um novo documento para um número. Resumo da API: Carregar um arquivo em um incidente identificado por número.create_number_document_postAltera dadosCriar um novo documento para um número. Resumo da API: Carregar um arquivo em um incidente identificado por número para um usuário SSP.create_number_timespentAltera dadosCriar um novo timespent para um número. Obrigatório: tempo gasto. Resumo da API: Registrar tempo gasto em um incidente por número.create_operational_activityAltera dadosCriar uma atividade operacional com uma descrição breve, datas de início/fim planejadas, tipo, categoria, operador ou grupo de operadores.create_operatorAltera dadosCriar um novo operador. Obrigatório: body. Pesquisar operadores primeiro para evitar duplicatas. Resumo da API: Criar um operador.create_operatorgroupAltera dadosCriar um novo grupo de operadores. Obrigatório: nome do grupo ou ramo. Pesquisar grupos de operadores primeiro para evitar duplicatas. Resumo da API: Criar um grupo de operadores.create_pageAltera dadosCriar uma nova página. Obrigatório: nome. Resumo da API: Criar uma entrada extra de campo para uma pessoa.create_personAltera dadosCriar uma pessoa. No `body` definir surName, e opcionalmente firstName, email, phoneNumber, jobTitle, branch (por id) e department.create_task_actionAltera dadosCriar uma nova ação para uma tarefa. Resumo da API: Criar uma nova ação para uma atividade operacional.create_task_addressAltera dadosCriar um novo endereço para uma tarefa. Obrigatório: itens. Pesquisar endereços primeiro para evitar duplicatas. Resumo da API: Vincular localizações a uma atividade operacional.create_task_linked_assetAltera dadosCriar um novo ativo vinculado para uma tarefa. Obrigatório: itens. Resumo da API: Vincular ativos a uma atividade operacional.create_task_linked_branchAltera dadosCriar um novo ramo vinculado para uma tarefa. Obrigatório: itens. Resumo da API: Vincular ramos a uma atividade operacional.create_task_time_registrationAltera dadosCriar um novo registro de tempo para uma tarefa. Resumo da API: Registrar tempo para uma atividade operacional.delete_a_branch_attachmentElimina dadosExcluir permanentemente um documento pelo seu ID de documento. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um anexo de ramo.delete_a_departmentElimina dadosExcluir permanentemente um contato pelo seu ID de contato. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um departamento.delete_branchesMovimenta dinheiroExcluir permanentemente um ramo pelo seu ID. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desvincular filtros de ramos de um operador.delete_categoriesMovimenta dinheiroExcluir permanentemente uma categoria pelo seu ID. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desvincular filtros de categorias de um operador.delete_contactElimina dadosExcluir permanentemente um contato pelo seu ID de contato. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um detentor de orçamento.delete_contact_actionElimina dadosExcluir permanentemente uma ação pelo seu ID de ação. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir ação por ID de incidente e ID de ação.delete_contact_documentElimina dadosExcluir permanentemente um documento pelo seu ID de documento. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um arquivo de um incidente identificado por ID.delete_contact_requestElimina dadosExcluir permanentemente uma solicitação pelo seu ID de solicitação. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir solicitação por ID de incidente e ID de solicitação.delete_email_by_idElimina dadosExcluir permanentemente um contato pelo seu ID de contato. Ação destrutiva; pode exigir aprovação. Resumo da API: excluir email por ID.delete_number_actionElimina dadosExcluir permanentemente uma ação pelo seu ID de ação. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir ação por número do incidente e ID de ação.delete_number_documentElimina dadosEliminar permanentemente um documento pelo seu ID de documento. Ação destrutiva; pode exigir aprovação. Resumo da API: Eliminar um arquivo de um incidente identificado pelo número.delete_number_requestElimina dadosEliminar permanentemente uma solicitação pelo seu requestid. Ação destrutiva; pode exigir aprovação. Resumo da API: Eliminar solicitação por número do incidente e ID da solicitação.delete_operatorsMovimenta dinheiroEliminar permanentemente um operador pelo id id. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desvincular filtros de operador de um operador.detach_operatorgroup_to_contactMovimenta dinheiroDesvincular um operatorgroup (id id). Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desvincular grupos de operadores de um operador.detach_permissiongroup_to_contactMovimenta dinheiroDesvincular um permissiongroup (id id). Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desvincular grupos de permissões de um operador.download_an_attachmentBaixar o documento para um documento. Resumo da API: Baixar um anexo.download_an_attachment_for_a_ssp_userBaixar o documento para um documento. Resumo da API: Baixar um anexo para um usuário SSP.download_documentBaixar o documento para um documento. Resumo da API: Baixar um anexo.download_document_downloadBaixar o documento para um documento. Resumo da API: Baixar o arquivo de anexo da atividade operacional.get_a_person_s_contractListar contatos para um contato. Resumo da API: Obter contrato de uma pessoa.get_a_person_s_private_detailsListar contatos para um contato. Resumo da API: Obter detalhes privados de uma pessoa.get_an_operator_by_idObter uma consulta por lookup id. Resumo da API: Obter um operador pelo id.get_an_operator_group_by_idObter uma consulta por lookup id. Resumo da API: Obter um grupo de operadores pelo id.get_avatar_of_person_by_idObter um contato por contact id. Resumo da API: Obter avatar de pessoa pelo id.get_contact_2Obter um contato por contact id. Resumo da API: Obter detalhes de email pelo id para incidentes, alterações e atividades de alteração.get_contact_actionObter uma ação para um contato por actionid. Resumo da API: Obter ações do incidente por ID do incidente e ID da ação.get_contact_action_getObter uma ação para um contato por actionid. Resumo da API: Obter ações do incidente por ID do incidente e ID da ação para usuários SSP.get_contact_countObter um contato. Resumo da API: Obter o número total de pessoas para usuário SSP. Conta apenas as pessoas marcadas como chamadores (solicitantes) e ativas (não arquivadas).get_contact_getObter um contato por contact id. Resumo da API: Retorna um incidente para um usuário SSP.get_contact_get_person_by_id_for_requesterObter um contato por contact id. Resumo da API: Obter pessoa pelo id para usuário SSP. Retorna apenas a pessoa quando marcada como chamador (solicitante) e ativa (não arquivada).get_contact_imageObter uma imagem para um contato por nome de arquivo. Resumo da API: Recuperar uma imagem de um incidente identificado pelo id.get_contact_image_getObter uma imagem para um contato por nome de arquivo. Resumo da API: Recuperar uma imagem de um incidente identificado pelo id para um usuário SSP.get_contact_requestObter um pedido de contato pelo requestid. Resumo da API: Obter o pedido do incidente pelo ID do incidente e pelo ID do pedido.get_contact_request_getObter um pedido de contato pelo requestid. Resumo da API: Obter o pedido do incidente pelo ID do incidente e pelo ID do pedido para usuários SSP.get_current_operatorObter a conta de operador na qual a ligação está logada.get_details_of_branch_by_idObter um contato pelo contact id. Resumo da API: Obter detalhes da sucursal pelo id.get_details_of_location_by_idObter um contato pelo contact id. Resumo da API: Obter detalhes da localização pelo id.get_details_of_supplier_contact_by_idObter um contato de fornecedor pelo supplier contact id. Resumo da API: Obter detalhes do contato de fornecedor pelo id.get_free_field_searchlistObter uma searchlist para um campo livre pela searchlist. Resumo da API: Obter lista de valores opcionais de menus suspensos.get_incidentObter um incidente pelo seu ID (`contact_id` é o UUID do incidente), com chamador, solicitação, status, operador e datas.get_incident_by_numberObter um incidente pelo seu número (ex. "I 2409 123").get_list_of_branch_filtersPesquisar sucursais. Use isso para encontrar sucursais existentes antes de criar uma nova. Resumo da API: Obter lista de filtros de sucursais.get_list_of_branches_for_ssp_userPesquisar sucursais por query. Use isso para encontrar sucursais existentes antes de criar uma nova. Os resultados são paginados. Resumo da API: Obter lista de sucursais para usuário SSP.get_list_of_call_types_for_ssp_usersListar tipos de chamada. Resumo da API: Obter lista de tipos de chamada para usuários SSP.get_list_of_categoriesListar categorias. Resumo da API: Obter lista de categorias.get_list_of_locations_for_ssp_userPesquisar endereços por query ou campos. Use isso para encontrar endereços existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de localizações para usuário SSP.get_list_of_operator_filtersPesquisar operadores. Use isso para encontrar operadores existentes antes de criar um novo. Resumo da API: Obter lista de filtros de operadores.get_list_of_optional_drop_down_values_for_branchesObter uma searchlist para um campo livre pela searchlist. Resumo da API: Obter lista de valores opcionais de menus suspensos para sucursais.get_list_of_optional_drop_down_values_for_locationsObter uma searchlist para um campo livre pela searchlist. Resumo da API: Obter lista de valores opcionais de menus suspensos para localizações.get_list_of_optional_drop_down_values_for_operatorsObter uma searchlist para um campo livre pela searchlist. Resumo da API: Obter lista de valores opcionais de menus suspensos para operadores.get_list_of_optional_drop_down_values_for_personsObter uma searchlist para um campo livre pela searchlist. Resumo da API: Obter lista de valores opcionais de menus suspensos para pessoas.get_list_of_room_statusesListar status. Resumo da API: Obter lista de status de sala.get_list_of_subcategoriesListar subcategorias. Resumo da API: Obter lista de subcategorias.get_list_of_supplier_contactsPesquisar contatos por query. Use isso para encontrar contatos existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de contatos de fornecedor.get_logged_in_personListar contatos. Resumo da API: Obter pessoa logada.get_lookupObter uma lookup pelo lookup id. Resumo da API: Obter um chamador pelo id.get_lookup_get_branch_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de ramo.get_lookup_get_location_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de localização.get_lookup_get_operator_group_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de grupo de operador.get_lookup_get_operator_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de operador.get_lookup_get_person_group_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de grupo de pessoas.get_lookup_get_person_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de pessoa.get_lookup_get_supplier_lookup_entryObter um único elemento de consulta pelo ID de consulta. Resumo da API: Retorna um par de ID e nome de fornecedor.get_number_actionObter uma ação para um número pelo actionid. Resumo da API: Obter ações de incidente pelo número do incidente e ID da ação.get_number_action_getObter uma ação para um número pelo actionid. Resumo da API: Obter ações de incidente pelo número do incidente e ID da ação para usuários SSP.get_number_getObter um número pelo seu número. Resumo da API: Retorna um incidente para um usuário SSP.get_number_imageObter uma imagem para um número pelo nome do arquivo. Resumo da API: Recuperar uma imagem de um incidente identificado pelo número do incidente.get_number_image_getObter uma imagem para um número pelo nome do arquivo. Resumo da API: Recuperar uma imagem de um incidente identificado pelo número do incidente para usuários SSP.get_number_requestObter uma solicitação para um número pelo requestid. Resumo da API: Obter a solicitação de incidente pelo número do incidente e ID da solicitação.get_number_request_getObter uma solicitação para um número pelo requestid. Resumo da API: Obter a solicitação de incidente pelo número do incidente e ID da solicitação para usuários SSP.get_operational_activityObter uma única atividade operacional por `task_identifier` (ID ou número).get_operational_seriesObter uma série operacional pelo identificador de série operacional. Resumo da API: Obter série operacional por ID.get_operatorObter um operador pelo ID de operador. Resumo da API: Obter o avatar do operador pelo ID.get_operator_by_idObter um contato pelo ID de contato. Resumo da API: Obter operador pelo ID.get_operator_get_operator_avatar_for_requesterObter um operador pelo ID de operador. Resumo da API: Obter o avatar do operador pelo ID para usuário SSP.get_operator_group_by_idObter um contato pelo ID de contato. Resumo da API: Obter grupo de operadores por ID.get_personObter uma pessoa pelo ID (`contact_id` é o UUID da pessoa).get_person_group_by_id_v2Obter um contato pelo ID de contato. Resumo da API: Obter grupo de pessoas por ID (v2).get_pictureObter uma imagem pelo ID de imagem. Os resultados são paginados. Resumo da API: Obter uma Imagem como fluxo binário.get_progresstrailObter um progresstrail pelo ID. Resumo da API: Obter o contador de entradas do trilho de progresso do incidente pelo ID do incidente.get_progresstrail_2Obter um progresstrail pelo número. Resumo da API: Obter o contador de entradas do trilho de progresso do incidente pelo número do incidente para usuários SSP.get_progresstrail_countObter um progresstrail pelo número. Resumo da API: Obter o contador de entradas do trilho de progresso do incidente pelo número do incidente.get_progresstrail_getObter um único progresstrail pelo ID. Resumo da API: Contagem de entradas do progresso do incidente pelo ID para usuários SSP.get_service_windowObter uma consulta única pelo ID de consulta. Resumo da API: Obter janela de serviço.get_settings_for_operational_activitiesListar configurações. Resumo da API: Obter configurações para atividades operacionais.get_supplierObter um único fornecedor pelo ID do fornecedor. Resumo da API: Detalhes do fornecedor pelo ID.get_task_messageObter uma mensagem para uma tarefa pelo ID de mensagem. Resumo da API: Recupera um e-mail de uma atividade operacional pelo ID.get_the_branch_filters_of_an_operatorPesquisar ramificações. Use isso para encontrar ramificações existentes antes de criar uma nova. Resumo da API: Obter filtros de ramificação de um operador.get_the_category_filters_of_an_operatorPesquisar categorias. Use isso para encontrar categorias existentes antes de criar uma nova. Resumo da API: Obter filtros de categoria de um operador.get_the_id_of_the_current_operatorListar contactos. Resumo da API: Obter o ID do operador atual.get_the_list_of_attachments_of_a_branchListar documentos para um contacto. Resumo da API: Obter a lista de anexos de uma ramificação.get_the_operator_filters_of_an_operatorPesquisar operadores. Use isso para encontrar operadores existentes antes de criar um novo. Resumo da API: Obter filtros de operador de um operador.get_timeregistrationObter um único timeregistration pelo ID do timeregistration. Resumo da API: Retornar um timeregistration pelo ID.get_total_number_of_personsObter um único contacto. Resumo da API: Obter o número total de pessoas.list_archiving_reasonsListar motivos de arquivamento. Resumo da API: Obter lista de motivos para arquivamento.list_budgetholdersListar detentores de orçamento. Filtros opcionais: ID de link externo ou tipo de link externo. Resumo da API: Obter lista de detentores de orçamento.list_building_levelsListar níveis de edifício. Resumo da API: Obter lista de níveis de edifício.list_building_zonesListar zonas de edifício. Resumo da API: Obter lista de zonas de edifício.list_call_typesListar tipos de chamada de incidente (ex: pergunta, queixa, perturbação).list_categoriesListar categorias de incidente.list_ceiling_coveringsListar revestimentos de teto. Resumo da API: Obter lista de revestimentos de teto.list_closure_codesListar códigos de encerramento. Resumo da API: Obter lista de códigos de encerramento.list_contact_actions_getListar ações para um contacto. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Os resultados são paginados. Resumo da API: Obter ações de incidente pelo ID de incidente para usuários SSP.list_contact_avatarsListar avatares para um contacto. Resumo da API: Obter o avatar de uma pessoa.list_contact_documentsListar documentos para um contacto. Filtros opcionais: non api attachment urls. Os resultados são paginados. Resumo da API: Obter anexos de incidente pelo ID de incidente.list_contact_documents_getListar documentos para um contacto. Filtros opcionais: non api attachment urls. Os resultados são paginados. Resumo da API: Obter anexos de incidente pelo ID de incidente para um usuário SSP.list_contact_imagesListar imagens de um contacto. Resumo da API: Obter uma lista de imagens para um incidente identificado por id.list_contact_images_getListar imagens de um contacto. Resumo da API: Obter uma lista de imagens para um incidente identificado por id, para um utilizador SSP.list_contact_operatorsListar operadores de um contacto. Resumo da API: Obter os operadores de um grupo de operadores.list_contact_permissiongroupsListar grupos de permissões de um contacto. Resumo da API: Obter os grupos de permissão de um operador.list_contact_progresstrailsListar trilhas de progresso de um contacto. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados paginados. Resumo da API: Obter a trilha de progresso do incidente pelo id do incidente.list_contact_progresstrails_getListar trilhas de progresso de um contacto. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados paginados. Resumo da API: Obter a trilha de progresso do incidente pelo id do incidente para utilizadores SSP.list_contact_requests_getListar pedidos de um contacto. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados paginados. Resumo da API: Obter os pedidos do incidente pelo id do incidente para utilizadores SSP.list_contact_timespentsListar tempos gastos de um contacto. Resumo da API: Registar o tempo gasto num incidente por id.list_contacts_getListar contactos. Resumo da API: Login - como uma pessoa.list_countriesListar países. Resumo da API: Obter lista de países.list_deescalation_reasonsListar motivos de desescalada. Resumo da API: Obter lista de motivos para desescalada.list_departmentsListar departamentos. Filtros opcionais: id do link externo ou tipo de link externo. Resumo da API: Obter lista de departamentos.list_designationsListar designações. Resumo da API: Obter lista de designações de sucursal.list_durationsListar durações. Resumo da API: Obter lista de durações.list_energy_performancesListar desempenhos energéticos. Resumo da API: Obter lista de desempenhos energéticos.list_entry_typesListar tipos de entrada. Resumo da API: Obter lista de tipos de entrada.list_environmental_impactsListar impactos ambientais. Resumo da API: Obter lista de impactos ambientais.list_escalation_reasonsListar motivos de escalada. Resumo da API: Obter lista de motivos para escalada.list_floor_coveringsListar revestimentos de chão. Resumo da API: Obter lista de revestimentos de chão.list_functional_usesListar usos funcionais. Resumo da API: Obter lista de usos funcionais.list_glass_materialsListar materiais de vidro. Resumo da API: Obter lista de materiais de vidro.list_impactsListar impactos. Resumo da API: Obter lista de impactos.list_incident_actionsListar as ações (entradas do progresso) de um incidente por `id_id` (UUID do incidente).list_incident_requestsListar os textos dos pedidos de um incidente por `id_id` (UUID do incidente).list_languagesListar línguas. Resumo da API: Obter lista de línguas.list_number_actionsListar ações para um número. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados paginados. Resumo da API: Obter ações do incidente pelo número do incidente.list_number_actions_getList actions for a number. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados são paginados. Resumo da API: Obter ações de incidente pelo número do incidente para usuários SSP.list_number_documentsList documents for a number. Filtros opcionais: non api attachment urls. Resultados são paginados. Resumo da API: Obter anexos de incidente pelo número do incidente.list_number_documents_getList documents for a number. Filtros opcionais: non api attachment urls. Resultados são paginados. Resumo da API: Obter anexos de incidente pelo número do incidente para um usuário SSP.list_number_imagesList images for a number. Resumo da API: Obter uma lista de imagens para um incidente identificado pelo número.list_number_images_getList images for a number. Resumo da API: Obter uma lista de imagens para um incidente identificado pelo número para um usuário SSP.list_number_progresstrailsList progresstrails for a number. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados são paginados. Resumo da API: Obter rastro de progresso do incidente pelo número do incidente.list_number_progresstrails_getList progresstrails for a number. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados são paginados. Resumo da API: Obter rastro de progresso do incidente pelo número do incidente para usuários SSP.list_number_requestsList requests for a number. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados são paginados. Resumo da API: Obter solicitações de incidente pelo número do incidente.list_number_requests_getList requests for a number. Filtros opcionais: inlineimages, force images as data ou non api attachment urls. Resultados são paginados. Resumo da API: Obter solicitações de incidente pelo número do incidente para usuários SSP.list_number_timespentsList timespents for a number. Resumo da API: Recuperar tempo gasto em um incidente pelo número.list_operator_groupsListar grupos de operadores, opcionalmente filtrados com uma FIQL `query`.list_operatorsListar operadores, opcionalmente filtrados com uma FIQL `query`, para encontrar um ID de operador para atribuir incidentes.list_operators_2List operators. Resumo da API: Login - (Depreciado) Faça login como operador.list_pagesList pages. Filtros opcionais: external link id ou external link type. Resumo da API: Obter a lista de entradas de campo extra não arquivadas para pessoa A.list_pages_get_person_extra_field_b_entriesList pages. Filtros opcionais: external link id ou external link type. Resumo da API: Obter a lista de entradas de campo extra não arquivadas para pessoa B.list_permissiongroupsList permissiongroups. Resumo da API: Obter lista de grupos de permissão.list_prioritiesList incident priorities.list_processing_statusesListar estados de processamento de incidentes.list_product_versionsList product versions. Resumo da API: Obter versão do TOPdesk.list_propertiesList properties. Resumo da API: Obter lista de imóveis listados.list_reasons_for_anomaliesList reasons for anomalies. Resumo da API: Lista razões não arquivadas para anomalias em atividades.list_reasons_for_skippingsList reasons for skippings. Resumo da API: Lista razões não arquivadas para pular em atividades.list_servicesListar serviços. Resumo da API: Obter lista de serviços.list_settingsListar configurações. Resumo da API: Obter configurações do operador logado.list_slasListar SLAs. Filtros opcionais: incidente, contrato, pessoa, serviço, ramo ou detentor de orçamento. Resultados são paginados. Resumo da API: Obter lista de serviços de SLA.list_statuses_getListar estados. Resumo da API: Listar estados não arquivados para atividades.list_subcategoriesListar subcategorias de incidente e a categoria a que cada uma pertence.list_task_actionsListar ações para uma tarefa. Resumo da API: Recuperar a lista de ações de uma atividade operacional.list_task_documentsListar documentos para uma tarefa. Resumo da API: Recuperar a lista de anexos de uma atividade operacional.list_task_linked_objectsListar objetos vinculados para uma tarefa. Resumo da API: Recuperar a lista de objetos vinculados de uma atividade operacional.list_task_messagesListar mensagens para uma tarefa. Resumo da API: Recuperar a lista de emails de uma atividade operacional.list_task_requestsListar pedidos para uma tarefa. Resumo da API: Recuperar a lista de pedidos de uma atividade operacional.list_task_time_registrationsListar registos de tempo para uma tarefa. Resumo da API: Recuperar a lista de registos de tempo de uma atividade operacional.list_timespent_reasonsListar motivos de tempo gasto. Resumo da API: Obter lista de motivos de tempo gasto.list_typesListar tipos. Resumo da API: Obter lista de tipos de localização.list_urgenciesListar urgências. Resumo da API: Obter lista de urgências.list_wall_coveringsListar revestimentos de parede. Resumo da API: Obter lista de revestimentos de parede.log_incident_timeAltera dadosRegistrar tempo gasto em um incidente (`id_id` é o UUID do incidente): `time_spent` minutos, com notas opcionais, operador e motivo.restore_contactAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um incidente por id.restore_contact_patch_unarchive_branchAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um ramo.restore_contact_patch_unarchive_locationAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar uma localização.restore_contact_patch_unarchive_operatorAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um operador e a pessoa vinculada, se houver.restore_contact_patch_unarchive_operator_groupAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um grupo de operadores.restore_contact_patch_unarchive_personAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar uma pessoa.restore_contact_post_unarchive_person_groupAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um grupo de pessoas.restore_contact_put_unarchive_locationAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar uma localização.restore_contact_put_unarchive_operatorAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um operador e a pessoa vinculada, se houver.restore_contact_put_unarchive_operator_groupAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um grupo de operadores.restore_contact_put_unarchive_personAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar uma pessoa.restore_contact_unarchiveAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um ramo.restore_contact_unarchive_budget_holderAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um detentor de orçamento.restore_contact_unarchive_departmentAltera dadosDesarquivar um contacto (id id). Resumo da API: Desarquivar um departamento.restore_numberAltera dadosDesarquivar um número (number number). Resumo da API: Desarquivar um incidente por número.search_addressesPesquise endereços por consulta ou campos. Utilize para encontrar endereços existentes antes de criar um novo. Resultados são paginação. Resumo da API: Obter lista de localizações.search_addresses_lookupPesquise endereços por nome, arquivados ou todos. Use para encontrar endereços existentes antes de criar um novo. Resultados são paginação. Resumo da API: Retorna pares de id e nome de localização.search_branchesPesquise sucursais (sítios), opcionalmente com FIQL `query`; necessário para criar pessoas e incidentes.search_branches_lookupPesquise sucursais por nome, arquivadas ou todas. Use para encontrar sucursais existentes antes de criar uma nova. Resultados são paginação. Resumo da API: Retorna pares de id e nome de sucursal.search_callersPesquise chamadores por nome, arquivados, todos ou início de página. Use para encontrar chamadores existentes antes de criar um novo. Resultados são paginação. Resumo da API: Obter lista de chamadores.search_categoriesPesquise categorias. Use para encontrar categorias existentes antes de criar uma nova. Resumo da API: Obter lista de filtros de categoria.search_categories_2Pesquise categorias por consulta ou ordenação. Use para encontrar categorias existentes antes de criar uma nova. Resumo da API: Lista categorias e subcategorias para usuário SSP.search_categories_getPesquise categorias por consulta ou ordenação. Use para encontrar categorias existentes antes de criar uma nova. Resumo da API: Lista categorias e subcategorias.search_contact_operatorgroupsPesquise grupos de operadores para um contato por consulta. Use para encontrar grupos de operadores existentes antes de criar um novo. Resumo da API: Obter grupos de operadores de um operador.search_contactsPesquise contatos por início de página, ordenação ou consulta. Use para encontrar contatos existentes antes de criar um novo. Resultados são paginação. Resumo da API: Obter lista de grupos de pessoas (v2).search_contacts_get_person_groups_of_person_by_idPesquise contatos para um contato por início de página, ordenação ou consulta. Use para encontrar contatos existentes antes de criar um novo. Resultados são paginação. Resumo da API: Obter lista de grupos de pessoa de uma pessoa pelo id (v2).search_contacts_get_person_lookup_listPesquise contatos por nome, arquivados, é chamador ou todos. Use para encontrar contatos existentes antes de criar um novo. Resultados são paginação. Resumo da API: Retorna pares de id e nome de pessoa.search_contacts_get_personsof_persongroup_by_idPesquise contatos para um contato por início de página, ordenação ou consulta. Use para encontrar contatos existentes antes de criar um novo. Resultados são paginação. Resumo da API: Obter lista de pessoas de um grupo de pessoa pelo id (v2).search_contacts_lookupPesquise contatos por nome, arquivados ou todos. Use para encontrar contatos existentes antes de criar um novo. Resultados são paginação. Resumo da API: Retorna pares de id e nome de grupo de pessoa.search_contacts_retrieve_persons_for_requesterPesquise contactos por página inicial, ordem ou consulta. Utilize para encontrar contactos existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de pessoas para utilizador SSP. Apenas retorna pessoas marcadas como chamadores (solicitantes) e ativas (não arquivadas).search_groupingsPesquise agrupamentos por consulta ou ordem. Utilize para encontrar agrupamentos existentes antes de criar um novo. Resumo da API: Obter lista de agrupamentos para atividades operacionais.search_incidentsPesquise incidentes com FIQL `query` (ex: status==firstLine;caller.dynamicName=="Jane*"), com `sort`, `page_start` e `limit`. Utilize para encontrar IDs de incidente.search_incidents_getPesquise incidentes por página inicial, ordem, consulta, formato de data ou todos. Utilize para encontrar incidentes existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Retorna uma lista de incidentes para utilizadores SSP.search_operational_activitiesPesquise atividades operacionais (tarefas planeadas) com FIQL `query`, ordenação e paginação.search_operatorgroupsPesquise grupos operacionais por nome, arquivado, todos, página inicial ou função. Utilize para encontrar grupos operacionais existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de grupos operacionais.search_operatorgroups_lookupPesquise grupos operacionais por nome, arquivado, todos, função ou ID operacional. Utilize para encontrar grupos operacionais existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Retorna pares de ID e nome do grupo operacional.search_operatorsPesquise operadores por nome, arquivado, todos ou página inicial. Utilize para encontrar operadores existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de operadores.search_operators_lookupPesquise operadores por nome, arquivado, todos, função, ID do grupo operacional ou inclua princípios de serviço. Utilize para encontrar operadores existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Retorna pares de ID e nome do operador.search_personsPesquisar pessoas (chamadores) com uma FIQL `query`, como email=="[email protected]", com ordenação e paginação.search_schemasPesquise esquemas por consulta ou ordem. Utilize para encontrar esquemas existentes antes de criar um novo. Resumo da API: Obter lista de esquemas para atividades operacionais.search_searchesPesquise buscas por consulta, índice ou início. Utilize para encontrar buscas existentes antes de criar uma nova. Resumo da API: Pesquisar via a REST-API.search_service_windowsPesquise janelas de serviço por nome ou arquivado. Utilize para encontrar janelas de serviço existentes antes de criar uma nova. Os resultados são paginados. Resumo da API: Obter lista de janelas de serviço.search_suppliersPesquise fornecedores por consulta. Utilize para encontrar fornecedores existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de fornecedores.search_suppliers_lookupPesquise fornecedores por nome, arquivados ou todos. Use isto para encontrar fornecedores existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Retorna pares de ID e nome do fornecedor.search_timeregistrationsPesquise registos de tempo por página inicial, ordem ou consulta. Use isto para encontrar registos de tempo existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Obter lista de registos de tempo. Por defeito, apenas registros para incidentes das 1ª e 2ª linha são retornados.search_typesPesquise tipos por consulta. Use isto para encontrar tipos existentes antes de criar um novo. Resumo da API: Obter lista de tipos para atividades operacionais.update_a_person_group_by_idAltera dadosAtualize um grupo de contactos existente identificado pelo ID de contacto. Apenas os campos que passa são alterados. Resumo da API: Atualizar um grupo de pessoas por ID.update_a_person_s_private_detailsVisível para outras pessoasAtualize um contacto existente identificado pelo ID de pessoa. Apenas os campos que passa são alterados. Tem efeitos visíveis fora deste sistema. Resumo da API: Atualizar detalhes privados de uma pessoa.update_contact_deescalatesVisível para outras pessoasAtualize uma desescalada existente identificada pelo ID. Tem efeitos visíveis fora deste sistema. Resumo da API: Desescalar um incidente por ID.update_contact_escalatesVisível para outras pessoasAtualize uma escalada existente identificada pelo ID. Tem efeitos visíveis fora deste sistema. Resumo da API: Escalar um incidente por ID.update_contactsVisível para outras pessoasAtualize um contacto existente identificado pelo ID de pessoa. Apenas os campos que passa são alterados. Tem efeitos visíveis fora deste sistema. Resumo da API: Atualizar o contrato de uma pessoa.update_free_field_searchlistAltera dadosAtualize uma lista de pesquisa existente identificada por searchlist. Resumo da API: Criar uma entrada opcional numa lista de descer do operador.update_incidentAltera dadosAtualize um incidente pelo ID (`contact_id` é o UUID do incidente). Em `body`, defina campos como status, operador, prioridade, categoria, fechado/completado ou adicione um texto `action` ao rastro de progresso.update_numberAltera dadosAtualize um número existente identificado pelo número. Apenas os campos que passa são alterados. Resumo da API: Atualiza um Incidente.update_number_deescalatesVisível para outras pessoasAtualize uma desescalada existente identificada pelo número. Tem efeitos visíveis fora deste sistema. Resumo da API: Desescalar um incidente por número.update_number_escalatesVisível para outras pessoasAtualize uma escalada existente identificada pelo número. Tem efeitos visíveis fora deste sistema. Resumo da API: Escalar um incidente por número.update_operational_activityAltera dadosAtualize uma atividade operacional por `task_identifier`: status, datas, operador, resolvido/pulado e outros campos.update_personAltera dadosAtualize uma pessoa pelo ID (`contact_id`). Em `body`, passe apenas os campos a alterar.update_task_requestAltera dadosAtualizar um pedido existente identificado pelo ID do pedido. Resumo da API: Atualiza um pedido de uma atividade operacional.
Configure em três passos
- 1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha TOPdesk na lista de aplicações.
- 2
Cole a sua chave
Digite seu endereço do TOPdesk sem https:// (por exemplo acme.topdesk.net), um nome de login de operador e um token de aplicação. No TOPdesk abra o menu Operador (canto superior direito) > Minhas Configurações e escolha Adicionar no bloco Tokens de Aplicação, nomeie-o, pressione Criar e copie o token. Ele é mostrado apenas uma vez. O operador precisa permissões da API.
- 3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
- Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
- Cole a sua ligação no campo URL do servidor MCP remoto.
- Ative-o no menu + de uma conversa.
Perguntas
O que a IA pode fazer no TOPdesk?
A IA pode pesquisar e ler incidentes, suas solicitações e ações, pessoas, operadores, grupos de operadores, filiais e atividades operacionais, além de listas de categorias, tipos de chamada, prioridades e status. Ela pode criar e atualizar incidentes, pessoas e atividades operacionais, e registrar tempo em incidentes.
A IA vê meu token de aplicação do TOPdesk?
Não. Suas credenciais do TOPdesk estão criptografadas em repouso e nunca são mostradas à IA. Após salvar, elas não aparecem novamente, nem mesmo para você. A IA vê apenas os resultados das ferramentas que chama.
Posso controlar o que a IA é autorizada a fazer?
Sim. Você escolhe quais ferramentas estão ativadas, podendo iniciar em modo de leitura somente. Criar ou alterar incidentes e pessoas pode exigir sua aprovação antes da execução. Cada chamada de ferramenta é registrada.
Funciona com o ChatGPT?
Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.
Qual é o custo?
O PipMCP tem um plano gratuito sem cartão de crédito. Os planos pagos cobram por tarefa concluída. Você também precisa de uma conta própria do TOPdesk.
De quem a IA trabalha como?
A IA atua como o operador cujo nome de login e token de aplicação você inseriu, podendo fazer tudo que aquele operador é autorizado a fazer. O operador precisa de permissões da API no TOPdesk. Você pode pedir à IA para mostrar em qual operador ela está logada.
Deixe a sua IA trabalhar em TOPdesk ainda hoje.
Comece gratuitamente. A sua chave permanece encriptada e é você quem decide o que a IA pode fazer.
Ligar TOPdesk gratuitamenteO PipMCP não tem qualquer afiliação com TOPdesk. Os nomes dos produtos são marcas comerciais dos respetivos titulares.






