Criar Chamado

Este método permite criar um novo chamado.


Endpoint

https://api.tomticket.com/v2.0/ticket/new


Método HTTP

POST


Content Type

form-data


Autenticação

Authorization: Bearer {SEU-TOKEN-AQUI}


Parâmetros de Requisição

ChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximo
customer_idIdentificador interno ou e-mail do clienteSim-String250
customer_id_typeTipo de identificador utilizado, sendo:

I - Identificador interno
E - Email
NãoIString1
department_idIdentificador do departamento.Sim-String250
subjectTítulo do chamado.Sim-String250
messageConteúdo da mensagem de abertura do chamado. Esta mensagem é enviada no formato text/plain (texto puro).
Sim-String-
category_idIdentificador da categoria.Não-String250
attachmentLista com todos os anexos do tipo FILES. O tamanho máximo da requisição (com anexos) tem um limite de 25 Megabyte e uma quantidade limitada a 25 anexos.

Eles devem ser enviados da seguinte forma:

Anexo 01: attachment[0] = FILE
Anexo 02: attachment[1] = FILE
Anexo 03: attachment[2] = FILE
Não-Array-
custom_fieldCampo personalizado para cadastro do chamado.

O campo poderá ser obrigatório dependendo da configuração do cadastro do campo personalizado.

Exemplo:

  • custom_field[ID-DO-CAMPO-01]: Valor Campo 01
  • custom_field[ID-DO-CAMPO-02]: Valor Campo 02
  • custom_field[ID-DO-CAMPO-N]: Valor Campo N

--String512
priorityPrioridade do chamado.

Opções Disponíveis:
  • 1 - Baixa
  • 2 - Normal
  • 3 - Alta
  • 4 - Urgente
Não1Int-

Retorno

Descrição do retorno em JSON.

ColunaDescrição da ColunaTipo
errorInforma se ocorreu um erro na operação. Se o retorno for false, então significa que a operação ocorreu com sucesso e não ocorreram problemas. Caso o retorno seja true, ocorreu um erro e será necessário verificar o campo mensagem para identificar o problema.Boolean
messageDetalhes da operação, caso tenha ocorrido ou não um problema.String
successRetorna true caso a operação tenha sido concluída com sucesso.Boolean

Código de Retorno

Descrição do código HTTP de retorno.

CódigoDescrição
200Operação realizada com sucesso.
401Token ou valores enviados não autorizados para uso.
403Recurso não disponível.
404Recurso não encontrado.

ℹ️ - Importante

Este método não realiza o envio de email após a operação.


Disponibilidade

Recurso Premium Recurso Enterprise


Was this article helpful?  
We appreciate your review.