TItiflux
Tickets

Criar ticket

Este método possibilita a criação de um novo ticket.

Os campos priority_id e services_catalogs_item_id dependem diretamente da configuração da mesa:

  • Se a mesa exigir catálogo na abertura do ticket (campo require_service_catalog_open_ticket na mesa for true), o atributo services_catalogs_item_id deve ser preenchido com a id de um item do catálogo de serviço vinculado a esta mesa.

  • Caso seja false, a mesa exige uma prioridade, logo, o campo priority_id deve ser preenchido com o id de uma prioridade que esteja cadastrada na mesa.

post/tickets

Request

  • Base URL
    https://api.tiflux.com/api/v2
  • Auth
    HTTP bearer

Request body multipart/form-data

titlestring required
descriptionstring required
client_idinteger required

ID do cliente em que o ticket será aberto

desk_idinteger required

ID da mesa em que o ticket será aberto

priority_idinteger

ID da prioridade em que o ticket será aberto. Obrigatório apenas se o parâmetro "Selecionar item do catálogo de serviço antes de abrir o ticket" for falso na mesa selecionada

services_catalogs_item_idinteger

ID do item de catálogo de serviços em que o ticket será aberto. Obrigatório apenas se o parâmetro "Selecionar item do catálogo de serviço antes de abrir o ticket" for verdadeiro na mesa selecionada

files[]string[]

Lista com os arquivos que serão anexados no ticket.

Esse parâmetro deve respeitar os seguintes critérios para os anexos serem anexados corretamente:

  • O valor desse parâmetro deve ser uma lista de arquivos
  • É permitido anexar no máximo 10 arquivos por requisição
  • Cada arquivo deve possuir no máx 25 megabytes
status_idinteger

ID do status em que o ticket será aberto. Esse parâmetro não é obrigatório. Pois se ele não for informado, o ticket será criado no status padrão de tickets abertos da mesa selecionada

requestor_idinteger

Ao invés de informar os campos do solicitante um a um (requestor_name, requestor_email, requestor_telephone e etc), você pode apenas passar o id dele aqui nesse parâmetro, que o solicitante será vinculado ao ticket com as informações preenchidas.

O solicitante deve pertencer ao cliente selecionado.

requestor_namestring

Nome do Solicitante

requestor_emailstring

Email do Solicitante

requestor_telephonestring

Telefone do Solicitante

requestor_countrystring

Código de país no formato <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank">ISO 3166-1 alpha-2</a>

Este atributo será utilizado para validar se o número de telefone do solicitante (requestor_telephone), é um número válido em algum outro país

requestor_ramalinteger

Ramal do Solicitante

equipment_idinteger

ID do equipamento que será vinculado ao ticket

equipment_group_idinteger

ID do grupo de equipamentos que será vinculado ao ticket

equipment_user_idinteger

ID do usuário do equipamento que será vinculado ao ticket

stage_idinteger

ID do estágio em que o ticket será aberto. Esse parâmetro não é obrigatório. Pois se ele não for informado, o ticket será criado no estágio pendente da mesa selecionada

responsible_idinteger

ID do responsável que será atribuído ao ticket

ticket_reference_numberinteger

Número do ticket que será referenciado (atribuído como ticket pai) ao ticket criado. Requer a permissão Abrir tickets filhos

followersstring

Email dos seguidores, separados por vírgula

Example request

{
  "title": "Título do ticket",
  "description": "Descrição do ticket",
  "client_id": 21,
  "desk_id": 42,
  "followers": "seguidor1@email.com,seguidor2@email.com"
}

Response

Ticket criado com sucesso

Changes

No recorded changes to this operation across all 21 revisions of this API.