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
| Chave | Descrição | Obrigatório | Valor Padrão | Tipo | Tamanho Máximo |
|---|---|---|---|---|---|
customer_id | Identificador interno ou e-mail do cliente | Sim | - | String | 250 |
customer_id_type | Tipo de identificador utilizado, sendo:I - Identificador internoE - Email | Não | I | String | 1 |
department_id | Identificador do departamento. | Sim | - | String | 250 |
subject | Título do chamado. | Sim | - | String | 250 |
message | Conteúdo da mensagem de abertura do chamado. Esta mensagem é enviada no formato text/plain (texto puro). | Sim | - | String | - |
category_id | Identificador da categoria. | Não | - | String | 250 |
attachment | Lista 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 | Não | - | Array | - |
custom_field | Campo personalizado para cadastro do chamado. O campo poderá ser obrigatório dependendo da configuração do cadastro do campo personalizado. Exemplo:
| - | - | String | 512 |
priority | Prioridade do chamado. Opções Disponíveis:
| Não | 1 | Int | - |
Retorno
Descrição do retorno em JSON.
| Coluna | Descrição da Coluna | Tipo |
|---|---|---|
error | Informa 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 |
message | Detalhes da operação, caso tenha ocorrido ou não um problema. | String |
success | Retorna 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ódigo | Descrição |
|---|---|
| 200 | Operação realizada com sucesso. |
| 401 | Token ou valores enviados não autorizados para uso. |
| 403 | Recurso não disponível. |
| 404 | Recurso não encontrado. |
ℹ️ - Importante
Este método não realiza o envio de email após a operação.
Disponibilidade
