Consultar Departamentos

Este método permite listar todos os departamentos da sua conta.

Endpoint

MétodoRotaContent-Type
GEThttps://api.tomticket.com/v2.0/department/listform-data

Autenticação

Este endpoint utiliza autenticação Bearer Token.

Authorization: Bearer SEU_TOKEN_AQUI

Caso ainda não possua um Token de Acesso, consulte o artigo Criação do Token de Acesso.

Parâmetros da requisição

Parâmetros da requisição - Consultar Departamentos

CampoTipoObrigatórioTamanho máximoDescrição
show_nested_itemsintegerNão1Se enviado com valor igual a zero (0), retorna a listagem apenas com o nome dos departamentos e seus IDs, sem itens aninhados, como categorias, status, atendentes etc. Valor padrão: 1.

JSON de saída

JSON de saída - Consultar Departamentos

CampoTipoDescrição
errorbooleanInforma se ocorreu um erro na operação.
messagestringDetalhes da operação, caso tenha ocorrido ou não um problema.
successbooleanRetorna true caso a operação tenha sido concluída com sucesso.
sizeintegerTotal de itens encontrados.
dataarrayLista com os departamentos cadastrados.
idstringIdentificador do departamento.
namestringNome do departamento.
categoriesarrayLista as categorias ativas vinculadas ao departamento.
idstringIdentificador da categoria.
namestringNome da categoria.
custom_fieldsarrayLista de campos personalizados usados em chamados.
idstringIdentificador do campo personalizado.
labelstringLabel do campo personalizado.
typeintegerInforma o tipo do campo. Opções disponíveis: 1 - Campo de Texto; 2 - Área de Texto; 3 - Caixa de Opções (Input=Select, ComboBox); 4 - Opções (Input=Radio, Radio Group); 5 - Caixa de Verificação (Checkbox); 6 - Seleção Múltipla (Listbox).
optionsarrayValores disponíveis do campo personalizado.
mandatorybooleanInforma se o preenchimento do campo é obrigatório.
operationarrayLista os tipos de operação em que este campo pode ser utilizado.
openbooleanInforma se o campo pode ser usado para a abertura de chamados.
closebooleanInforma se o campo pode ser usado para o encerramento de chamados.
evaluationbooleanInforma se o campo pode ser usado para a avaliação de chamados.
statusarrayLista os status vinculados ao departamento.
idstringIdentificador do status.
namestringNome do status.
activebooleanInforma se o status está ativo para uso.
operatorsarrayLista os atendentes ativos vinculados ao departamento.
idstringIdentificador do atendente.
namestringNome do atendente.
mail_hashstringHash MD5 do endereço de e-mail do atendente.
general_custom_fieldsarrayLista os campos personalizados vinculados ao departamento quando não há categoria selecionada.
ticketsarrayLista de campos personalizados usados em chamados.
idstringIdentificador do campo personalizado.
labelstringLabel do campo personalizado.
typeintegerInforma o tipo do campo. Opções disponíveis: 1 - Campo de Texto; 2 - Área de Texto; 3 - Caixa de Opções (Input=Select, ComboBox); 4 - Opções (Input=Radio, Radio Group); 5 - Caixa de Verificação (Checkbox); 6 - Seleção Múltipla (Listbox).
optionsarrayValores disponíveis do campo personalizado.
mandatorybooleanInforma se o preenchimento do campo é obrigatório.
operationarrayLista os tipos de operação em que este campo pode ser utilizado.
openbooleanInforma se o campo pode ser usado para a abertura de chamados.
closebooleanInforma se o campo pode ser usado para o encerramento de chamados.
evaluationbooleanInforma se o campo pode ser usado para a avaliação de chamados.
chatsarrayLista de campos personalizados usados em chats.
idstringIdentificador do campo personalizado.
labelstringLabel do campo personalizado.
typeintegerInforma o tipo do campo. Opções disponíveis: 1 - Campo de Texto; 2 - Área de Texto; 3 - Caixa de Opções (Input=Select, ComboBox); 4 - Opções (Input=Radio, Radio Group); 5 - Caixa de Verificação (Checkbox); 6 - Seleção Múltipla (Listbox).
optionsarrayValores disponíveis do campo personalizado.
mandatorybooleanInforma se o preenchimento do campo é obrigatório.
operationarrayLista os tipos de operação em que este campo pode ser utilizado.
openbooleanInforma se o campo pode ser usado para a abertura de chats.
evaluationbooleanInforma se o campo pode ser usado para a avaliação de chats.

Possíveis erros

Status HTTPMensagemQuando ocorre
401Token ou valores enviados não autorizados para uso.Quando o token ou os valores enviados não estão autorizados para uso.
403Recurso não disponível.Quando o recurso não está disponível.
404Recurso não encontrado.Quando o recurso não é encontrado.

Este artigo foi útil?  
Agradecemos sua avaliação.