create_ticket
Create tickets in TiFlux with automatic requester matching. Specify title, description, desk, client, and priority to open a new support ticket.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Título do ticket | |
| description | Yes | Descrição do ticket. Aceita Markdown (negrito, listas, cabeçalhos, código) — o MCP converte automaticamente para HTML antes de enviar à API. | |
| client_id | No | ID do cliente/empresa (opcional - usa TIFLUX_DEFAULT_CLIENT_ID se não informado) | |
| client_name | No | Nome do cliente (empresa contratante) para busca automática (alternativa ao client_id). Use **apenas** quando o usuario disser explicitamente "cliente" ou "empresa". Para pessoa fisica, use requestor_name. | |
| desk_id | No | ID da mesa (opcional - usa TIFLUX_DEFAULT_DESK_ID se não informado) | |
| desk_name | No | Nome da mesa/equipe para busca automática (alternativa ao desk_id). Aceita nomes parciais (ex: "cansados" resolve para "Dev - Cansados"). **Prefira este campo quando o usuario der um nome sem qualificar a entidade.** | |
| priority_id | No | ID da prioridade (opcional - usa TIFLUX_DEFAULT_PRIORITY_ID se não informado) | |
| services_catalogs_item_id | No | ID do item de catálogo (opcional - usa TIFLUX_DEFAULT_CATALOG_ITEM_ID se não informado) | |
| catalog_item_name | No | Nome do item de catálogo para busca automática (alternativa ao services_catalogs_item_id, requer desk_id ou desk_name) | |
| status_id | No | ID do status (opcional) | |
| requestor_id | No | ID do solicitante (pessoa fisica que abre o ticket). Use quando ja tem o ID do solicitante existente no tenant. O solicitante deve pertencer ao cliente selecionado. | |
| requestor_name | No | Nome do solicitante (pessoa fisica). O MCP tenta resolver automaticamente para requestor_id se o solicitante ja existir no tenant (evita criar solicitante fantasma). Se preferir nao resolver automaticamente, passe requestor_id diretamente. | |
| requestor_email | No | Email do solicitante. Use quando voce ja tem o email exato — o MCP nao tentara resolver para requestor_id (o email e identificador suficiente). | |
| requestor_telephone | No | Telefone do solicitante (opcional) | |
| responsible_id | No | ID do responsável (opcional) | |
| responsible_name | No | Nome do responsável para busca automática (alternativa ao responsible_id) | |
| followers | No | Emails dos seguidores separados por vírgula (opcional) | |
| parent_ticket_number | No | Número do ticket pai. O ticket criado será vinculado como filho deste ticket. |