Ferramentas · Suporte
Ferramentas MCP do módulo Suporte (coworking): abrir chamado com fotos, listar a fila e os meus chamados, triar, atribuir, resolver, nota interna, cancelar, reabrir, fotos e prazos, mais a configuração de quem responde e do prazo por categoria.
O módulo Suporte pelo assistente: o residente abre e acompanha chamados (com fotos), a equipe faz a triagem da fila, responde, escreve notas internas e resolve, e o administrador configura quem responde e os prazos. Os papéis são os da tela: o assistente nunca faz mais do que a pessoa conectada faria.
Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo na hora, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.
Em resumo
| Ferramenta | O que faz | Papel mínimo | Tipo |
|---|---|---|---|
get_support_space_settings | Como o espaço funciona: limites, prazos e, para a equipe, quem responde | Qualquer | Só consulta |
get_support_overview | A fila em números | Moderador ou financeiro | Só consulta |
list_support_tickets | Toda a fila, com filtros e prazos | Moderador ou financeiro | Só consulta |
list_my_support_tickets | Os seus chamados | Qualquer | Só consulta |
get_support_ticket | Um chamado com a conversa e as fotos | Qualquer (o residente lê os seus) | Só consulta |
get_support_resource_open_count | Quantos chamados abertos um item tem | Qualquer | Só consulta |
create_support_ticket | Abre um chamado, com fotos | Qualquer | Altera |
update_support_ticket | Triagem: status, prioridade, categoria, responsável, local | Moderador ou financeiro, e responder a categoria | Altera |
add_support_comment | Comenta, ou escreve uma nota interna | Qualquer (a nota, só quem responde) | Altera |
cancel_support_ticket | Cancela um chamado | Qualquer (o residente, o seu) | Pede confirmação |
reopen_support_ticket | Reabre um chamado | Qualquer (o residente, o seu resolvido) | Altera |
add_support_photo | Anexa uma foto | Qualquer | Altera |
replace_support_photo | Troca uma foto por outra | Qualquer | Altera |
remove_support_photo | Remove uma foto | Qualquer | Pede confirmação |
delete_support_comment | Apaga uma mensagem da conversa | Administrador | Pede confirmação |
delete_support_ticket | Apaga um chamado e as fotos | Administrador | Pede confirmação |
Por papel, o proprietário e o administrador veem as 16; o moderador e o financeiro, 14; o membro, 11. A equipe é o proprietário, o administrador, o moderador e o financeiro, mas quem responde (triar, atribuir, responder, anotar) é só quem está na seleção da categoria; fora dela, a API recusa com um 403 traduzido e o assistente conta isso. Ver Quem responde.
O espaço se cria com create_space e module: "support"; update_space muda só o que você mandar.
A configuração do espaço
O argumento support de create_space e update_space aceita (o que você manda se junta ao que já existe):
| Campo | Tipo | Descrição |
|---|---|---|
allow_urgent_flag | verdadeiro ou falso | O residente pode marcar "é urgente" (vira prioridade alta). Padrão: sim |
max_open_per_member | 0 a 1000 | Chamados abertos por residente; 0 = sem limite. Padrão: 10 |
location_hint | texto até 200 | A dica do campo "Local" |
default_assignee_id | id ou null | Quem recebe os chamados novos |
responders | objeto | Quem responde: tags (nomes de tag), group_ids, profile_ids e by_category (a seleção de cada categoria, que substitui a do espaço). Owner e admin sempre respondem; sem seleção, a equipe toda responde |
sla.enabled | verdadeiro ou falso | Liga os prazos. Padrão: sim |
sla.business_hours | {days, start, end} | Dias da semana (0 = domingo a 6 = sábado) e horário HH:MM, no fuso da comunidade. Padrão: seg a sex, 09:00 a 18:00. Sem feriados |
sla.categories | por categoria | first_response e resolution, cada um com value (inteiro) e unit (hours ou days). Padrão: 4 horas e 1 dia |
As categorias são FACILITIES, CLEANING, EQUIPMENT, INTERNET, ACCESS, BILLING e OTHER; os tipos, MAINTENANCE e REQUEST; os status, OPEN, IN_PROGRESS, WAITING_REQUESTER, RESOLVED e CANCELED; as prioridades, LOW, NORMAL, HIGH e URGENT.
get_support_space_settings
Só consulta
Como o espaço funciona. allowUrgentFlag, maxOpenPerMember, locationHint, hasBookings (se resource_id pode ser usado) e sla. A equipe recebe também responders, defaultAssigneeId e canAnswerCategories (as categorias que você responde); o residente nunca recebe responders. Papel: qualquer com acesso ao espaço.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
space | id ou link | Sim | O espaço Suporte (list_spaces) |
get_support_overview
Só consulta
A fila em números: open, inProgress, waitingRequester, unassigned, mine, overdue (prazo vencido, relógio rodando) e total. Sem space, soma todos os espaços de Suporte. Papel: moderador ou financeiro.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
space | id ou link | Não |
Peça assim: "Como está a fila de chamados?"
list_support_tickets
Só consulta
Toda a fila, pela atividade mais recente ou pela prioridade. Com prazos ligados, cada chamado traz sla (firstResponseDueAt, resolveDueAt, paused, e as datas legíveis no fuso da comunidade) e, para a equipe, sla.overdue. Cada item diz o que você pode fazer (canAnswer, canAssign...). O residente usa list_my_support_tickets. Papel: moderador ou financeiro.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
space | id ou link | Não | |
kind, status, priority, category | valores acima | Não | Um valor de cada |
assignee_profile_id | id | Não | Chamados desse responsável |
unassigned | verdadeiro ou falso | Não | Sem responsável |
mine | verdadeiro ou falso | Não | Atribuídos a você |
overdue | verdadeiro ou falso | Não | Prazo vencido e relógio rodando (Aguardando resposta não conta) |
due_today | verdadeiro ou falso | Não | O próximo prazo cai hoje; só em espaços com prazos |
requester_profile_id | id | Não | Chamados dessa pessoa |
resource_id | id | Não | Chamados desse item das Reservas |
q | texto | Não | Número, #42 ou parte do título |
sort | activity ou priority | Não | |
page, limit | números | Não | Paginação (até 100) |
Peça assim: "Quais chamados estão atrasados ou vencem hoje?"
list_my_support_tickets
Só consulta
Os chamados que você abriu, do mais recente ao mais antigo. Papel: qualquer com acesso ao espaço.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
space | id ou link | Não | |
kind, status, priority, category | valores acima | Não | |
resource_id | id | Não | |
q | texto | Não | |
page, limit | números | Não |
get_support_ticket
Só consulta
Um chamado com a linha do tempo: mensagens, histórico de mudanças, as notas internas (só para a equipe) e as fotos como links de curta duração. O residente lê os seus; a equipe lê todos, também fora da seleção de quem responde. Outro chamado: 404. Papel: qualquer.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | De list_support_tickets ou list_my_support_tickets |
get_support_resource_open_count
Só consulta
O aviso de duplicado. Só o número de chamados abertos de uma sala, mesa ou equipamento das Reservas, sem título nem autor, para avisar antes de abrir mais um. Papel: qualquer.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
resource_id | id | Sim | De list_booking_resources |
create_support_ticket
Altera
Abrir um chamado, com fotos. A equipe é avisada pela fila de e-mails. Quem responde a categoria pode ainda definir a priority e abrir em nome de um residente (requester_profile_id): o residente recebe um e-mail, então o assistente mostra antes quem vai recebê-lo. Acima do limite de chamados abertos do espaço, 409; acima de 10 aberturas por hora, 429. Repetir a chamada com o mesmo client_request_id devolve o mesmo chamado. Papel: qualquer com acesso ao espaço.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
space | id ou link | Sim | O espaço Suporte |
kind | MAINTENANCE ou REQUEST | Sim | |
category | categoria | Sim | |
title | texto | Sim | Até 140 caracteres |
description | texto | Sim | Até 10000 |
resource_id | id | Não | Sala, mesa ou equipamento (list_booking_resources) |
location_text | texto | Não | Até 120 caracteres; vale sem item |
urgent | verdadeiro ou falso | Não | Vira prioridade alta, se o espaço permitir |
priority | prioridade | Não | Só quem responde |
requester_profile_id | id | Não | Só quem responde: abre em nome desse residente |
photos | lista | Não | Até 5, cada uma com image_url ou image_base64 (+ image_type) |
client_request_id | texto | Não | Evita duplicar num toque repetido |
Peça assim: "Abra um chamado de manutenção: o projetor da Sala 3 não liga, aqui está a foto."
update_support_ticket
Altera
A triagem. Só quem responde a categoria do chamado; fora dela, 403 traduzido. Mande só o que muda. message acompanha RESOLVED ou WAITING_REQUESTER como resposta pública, e o residente recebe e-mail; atribuir avisa o responsável. RESOLVED e CANCELED só voltam a OPEN. URGENT só se define aqui. Cada mudança entra na conversa. Papel: moderador ou financeiro, e responder a categoria.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
status | status | Não | |
priority | prioridade | Não | |
kind, category | valores | Não | A categoria só muda para uma que você também responde |
assignee_profile_id | id ou null | Não | Precisa responder a categoria; null tira o responsável |
resource_id | id ou null | Não | O item das Reservas |
location_text | texto ou null | Não | |
title | texto | Não | |
message | texto | Não | Junto com RESOLVED ou WAITING_REQUESTER |
Peça assim: "Atribua o chamado #42 ao Pedro e resolva dizendo que trocamos a lâmpada."
add_support_comment
Altera
Comentar, com fotos. O residente comenta nos seus (em Aguardando resposta volta a Em andamento; em um Resolvido, reabre); quem responde também, e o residente recebe e-mail (duas respostas em 10 minutos geram um e-mail só). Com internal: true é uma nota interna: só quem responde pode, o residente nunca a vê, e não envia e-mail. Comentário não se edita. Papel: qualquer (a nota, só quem responde).
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
body | texto | Sim | Até 10000 caracteres |
internal | verdadeiro ou falso | Não | Nota interna |
photos | lista | Não | Até 5, como em create_support_ticket |
Peça assim: "No chamado #42, anote por dentro que o técnico vem na quinta."
cancel_support_ticket
Pede confirmação
Cancelar um chamado aberto. Vira Cancelado; nada é apagado. O residente cancela o seu enquanto não está resolvido; quem responde a categoria também (um duplicado, por exemplo). Resolvido ou já cancelado: 400. Papel: qualquer, nos limites acima.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim |
Devolve: na primeira chamada, o resumo (número, título, status, residente) e o código de confirmação.
reopen_support_ticket
Altera
Reabrir. O residente reabre o seu Resolvido, e a equipe é avisada; quem responde reabre também o Cancelado. Outro status: 400. O prazo de resolução começa de novo. Papel: qualquer, nos limites acima.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim |
add_support_photo
Altera
Anexar uma foto (JPEG, PNG ou WebP, até 20 MB), guardada em privado: só o residente e a equipe a abrem. Até 20 por chamado (409 acima). O residente no seu; quem responde em qualquer um. Papel: qualquer.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
image_url ou image_base64 | link ou texto | Sim | A imagem; image_base64 vai com image_type |
replace_support_photo
Altera
Trocar uma foto. A nova é anexada primeiro; depois a antiga é removida e o arquivo apagado. O residente troca as fotos da abertura e dos seus comentários; quem responde, qualquer uma. Papel: qualquer.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
photo_id | id | Sim | De get_support_ticket |
image_url ou image_base64 | link ou texto | Sim | A imagem nova |
remove_support_photo
Pede confirmação
Remover uma foto (o arquivo é apagado de vez). Quem responde remove qualquer uma; o residente, as da abertura e as dos seus comentários. Papel: qualquer, nos limites acima.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
photo_id | id | Sim | De get_support_ticket |
Devolve: na primeira chamada, o resumo e o código de confirmação.
delete_support_comment
Pede confirmação
Apagar uma mensagem da conversa, com as fotos dela. As linhas do histórico não se apagam. Papel: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim | |
comment_id | id | Sim | De get_support_ticket |
delete_support_ticket
Pede confirmação
Apagar um chamado e as fotos dele; nada é anonimizado nem guardado. Para encerrar um chamado de verdade use update_support_ticket (Resolvido) ou cancel_support_ticket. Papel: administrador.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ticket_id | id | Sim |
Devolve: na primeira chamada, o resumo (número, título, status, residente, fotos) e o código de confirmação.