Buscar um ticket específico no TiFlux pelo número. Retorna informações completas incluindo: status (ID e nome), prioridade (ID e nome), mesa (ID e nome), estágio (ID, nome e emoji indicator), catálogo de serviços (área ID/nome, catálogo ID/nome, item ID/nome), responsável (ID, nome e email), cliente (ID, nome e status), criado por (ID e nome), atualizado por (ID e nome), seguidores, tags, datas (criação, atualização, fechamento), horas trabalhadas, SLA (status detalhado), URLs (interna e externa) e campos personalizados opcionais.

Criar um novo ticket no TiFlux.

Heuristica mesa-first: Quando o usuario referencia um nome sem qualificar a entidade, use desk_name. So use client_name se o usuario disser explicitamente "cliente" ou "empresa". Para pessoa que vai abrir o ticket, use requestor_name ou requestor_email.

Auto-resolve de solicitante: Se requestor_name for fornecido sem requestor_id e sem requestor_email, o MCP tenta encontrar o solicitante ja existente no tenant automaticamente (evita criar solicitante fantasma). Se encontrar mais de um match, retorna lista para escolha. Se nao encontrar, cria com o nome informado.

Atualizar um ticket existente no TiFlux.

Heuristica mesa-first: Quando o usuario referencia um nome sem qualificar a entidade, use desk_name. So use client_id se o usuario disser explicitamente "cliente" ou "empresa". Para pessoa, use responsible_name/responsible_id para atendente atribuido.

Nota: A API v2 nao permite alterar o solicitante (requestor) em um ticket existente via update. Para vincular solicitante, use create_ticket.

Cancelar um ticket específico no TiFlux

Fechar um ticket específico no TiFlux

Lista tickets do TiFlux com filtros. Requer pelo menos um filtro obrigatorio.

Heuristica mesa-first: Quando o usuario referencia um nome sem qualificar a entidade (ex: "tickets do tuitui"), trate o termo como mesa (desk_name) — mesa = equipe e e o filtro mais comum. So use client_name se o usuario disser explicitamente "cliente", "empresa" ou nome corporativo. Para pessoas que abriram o ticket, use requestor_email ou requestor_ids (resolva o ID via search_user). Para o atendente atribuido, use responsible_ids (busque o ID via search_user). Em duvida, pergunte ao usuario.

Criar uma nova resposta (comunicação com cliente) em um ticket específico

Atualizar campos personalizados (entities) de um ticket no TiFlux. Suporta até 50 campos por requisição. Para campos checkbox com múltiplas opções, envie um item por opção com entity_field_id + entity_field_option_id + value: "true"/"false". Use list_entity_field_options para descobrir os IDs de opção.

Buscar arquivos anexados a um ticket específico no TiFlux

Listar o histórico de passagens do ticket pelos estágios da mesa, com duração no expediente, expiração e status do SLA por estágio. Retorna apenas tickets de mesas com SLA ativo (mesas sem SLA retornam lista vazia). Suporta paginação.

Buscar clientes no TiFlux por nome

Buscar usuarios no TiFlux por nome para usar como responsavel em tickets

Buscar estagios de uma mesa no TiFlux para usar em atualizacao de tickets

Buscar itens de catálogo de serviços por termo livre (catálogo, área ou item) ou por nome/filtro dentro de uma mesa específica. Use o parâmetro search para busca server-side por termo aproximado em nome de catálogo, área ou item — retorna listagem com hierarquia completa. Use catalog_item_name para localizar um item específico por nome (busca client-side, colapsa para detalhe único quando há 1 match). Os itens de catálogo representam os tipos de solicitações que podem ser criadas em uma mesa.

Criar uma nova comunicação interna em um ticket específico

Listar comunicações internas existentes em um ticket específico

Obter uma comunicação interna específica com texto completo

Criar um novo apontamento (registro de horas trabalhadas) em um ticket específico. Só funciona em tickets de mesas configuradas com apontamentos sem valorização.

Listar apontamentos (registros de horas trabalhadas) de um ticket específico com filtros opcionais. Quando disponível, inclui informações de valorização (tipo de atendimento, contrato ou serviço avulso, deslocamento, valor cobrado) e geolocalização.

Exibir detalhes de um chat específico pelo id. Retorna card com status, cliente, responsável, departamento, origem, avaliação e datas.

Listar chats na caixa de entrada (chats não assumidos) com filtros opcionais de departamento, cliente, origem e paginação.

Listar chats assumidos pelo usuário autenticado (dono da API key) com filtros opcionais e paginação.

Listar todos os chats em atendimento da organização com filtros opcionais de responsável, status e paginação.

Listar chats arquivados (finalizados ou cancelados) com filtros opcionais. Exibe avaliação do atendimento e status de cancelamento.

Listar mesas (desks) disponiveis no TiFlux para descoberta e exploracao. Use para saber quais mesas existem antes de criar/atualizar tickets ou para inspecionar configuracoes.

Retornar configuracoes completas de uma mesa do TiFlux (SLA, tipo de atendimento, campos obrigatorios, comportamento de tickets, etc). Aceita desk_id (numerico) OU desk_name (nome parcial/fuzzy, usa o mesmo mecanismo de Smart Name Resolution). Se ambos informados, desk_id prevalece.

Listar prioridades configuradas em uma mesa do TiFlux. Use para descobrir os IDs de prioridade antes de criar ou atualizar tickets (ex: "alta prioridade" → priority_id). Aceita desk_id (numerico) OU desk_name (nome parcial/fuzzy). Se ambos informados, desk_id prevalece. O filtro priority_name e feito client-side com fuzzy match apos buscar os registros da API.

Listar catalogos de servicos vinculados a uma mesa do TiFlux. Catalogos sao os "containers" pai — diferentes dos itens de catalogo (use search_catalog_item para itens). Aceita desk_id (numerico) OU desk_name (nome parcial/fuzzy). Se ambos informados, desk_id prevalece. O filtro catalog_name e feito client-side com fuzzy match.

Listar campos personalizados (entities) disponiveis na organizacao TiFlux. Use para descobrir quais grupos de campos personalizados existem, em quais aplicacoes estao habilitados (ticket, client, etc.) e seus IDs — necessarios para usar list_entity_fields.

Listar subcampos (entity_fields) de um campo personalizado (entity) no TiFlux. Retorna nome, tipo (text, single_select, checkbox, date, etc.), obrigatoriedade e indica quais campos possuem opcoes selecionaveis — use list_entity_field_options nesses casos.

Listar opcoes de um subcampo personalizado (entity_field) do tipo single_select ou checkbox no TiFlux. Use para obter os IDs de opcao (entity_field_option_id) necessarios ao preencher campos de multipla escolha via update_ticket_entities.