Pular para conteúdo

Dúvidas frequentes sobre ambientes CSM

Nessa página encontra-se uma lista de perguntas frequentes para integrações e uso da Plataforma Quoti em ambientes CSM.

Possui dúvidas que ainda não estão nesta documentação?

Abra uma Issue neste repositório: Clique aqui para abrir uma Issue

Dúvidas sobre catalogo de serviços

Qual endpoint utilizar para listar as informações do catalogo de Serviço?

Para listar os itens do catálogo de serviços do Quoti, você pode fazer uma solicitação GET para a seguinte URL: GET https://api.quoti.cloud/api/v1/{orgSlug}/resources/service_catalog_item?where[parent]=home. Esta solicitação retornará uma lista dos itens de serviço principais no catálogo.

Se você estiver interessado em encontrar os sub-serviços relacionados a um item específico no catálogo, pode usar o parâmetro where[parent]=<idDoItemPai>. Substitua pelo ID do item pai do qual você deseja recuperar os sub-serviços. Isso retornará uma lista dos sub-serviços associados ao item pai especificado.

Portanto, com essas duas opções, você pode acessar tanto os itens principais quanto os sub-serviços do catálogo de serviços do Quoti, permitindo uma navegação completa e detalhada através dos serviços disponíveis.

Link da documentação na API do Quoti: https://api.quoti.cloud/api-explorer/?orgSlug={orgSlug}#/Service_catalog_item/get_{orgSlug}_resources_service_catalog_item

Informações do Catálogo de Serviço

Como listar as informações do catálogo de serviço? - Endpoint: GET api.quoti.cloud/resources/service_catalog_item/<id> - Descrição: Este endpoint fornece detalhes sobre um item específico do catálogo de serviços, incluindo FAQs e textos descritivos encontrados em pageBody. - Para categorias e formulários relacionados: - Use GET api.csm.quoti.cloud/resources/categories/<categoryId> para listar uma categoria e obter o ID do formulário de perguntas. - Para as perguntas de um formulário específico, utilize GET api.quoti.cloud/resources/forms/<formId>.

Dúvidas a respeito de chamados

Consulta por Chamados de um Usuário Específico

Como fazer uma consulta por chamados vinculados a um usuário específico? - Endpoint: GET api.csm.quoti.cloud/api/v1/{orgSlug}/tickets?where[assignedToUser][0]=<idDoUsuario> - Descrição: Este endpoint permite listar chamados atribuídos a um usuário específico, substituindo <idDoUsuario> pelo ID apropriado do usuário.

Como fazer uma consulta por chamados que são de um tipo especifico?

  • Endpoint: GET api.csm.quoti.cloud/api/v1/{orgSlug}/tickets?where[ticketTypeId]=<idDoTipo>
  • Descrição: Este endpoint permite listar chamados que são de um tipo específico, substituindo <idDoTipo> pelo ID apropriado.

Atualizações em um Chamado Existente

Qual endpoint utilizar para fazer atualizações em um chamado? - Endpoint: PUT api.csm.quoti.cloud/api/v1/{orgSlug}/tickets/<ticketId> - Descrição: Use este endpoint para atualizar as informações de um chamado existente. Substitua <ticketId> pelo ID do chamado que você deseja atualizar.

Consulta de Status de um Chamado Específico

Como consultar o status de um chamado específico? - Endpoint: GET api.csm.quoti.cloud/api/v1/{orgSlug}/tickets/<ticketId> - Descrição: Este endpoint fornece o status atual de um chamado específico. O status é retornado no corpo da resposta da requisição.