# Etiquetar conversa Acrescenta e tira etiquetas da conversa, sem mexer nas outras. Organizar · Escrita Nome da ferramenta: ``` conversa_etiquetar ``` ## Exemplo de pedido Você escreve para o agente, em linguagem natural: > Coloque a etiqueta orcamento na conversa 1234 e tire a etiqueta novo. ## Permissão - Muda dados na Eloquus. Peça ao agente para mostrar o que vai fazer antes. - Pede o escopo Organizar (`eloquus:organizar`), que você marca na tela da Eloquus ao conectar. - Área da Eloquus: Conversas. - Repetir a mesma chamada é seguro. ## Parâmetros | Nome | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | | `conta` | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. | | `conversaId` | número inteiro | Sim | Número da conversa na Eloquus. Aceita: a partir de 1 | | `adicionar` | lista de texto | Não | Etiquetas a acrescentar. Aceita: até 20 itens | | `remover` | lista de texto | Não | Etiquetas a tirar. Aceita: até 20 itens | | `pedidoId` | texto | Não | Opcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou. Aceita: uuid | ## Limites - 120 chamadas por minuto por conexão e 600 por minuto por conta, somando todos os agentes conectados. ## Detalhes técnicos **Pedido JSON-RPC (tools/call)** Com só os campos obrigatórios e valores de exemplo. ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "conversa_etiquetar", "arguments": { "conta": "nome-da-sua-conta", "conversaId": 123 } } } ``` **Esquema de entrada** ```json { "type": "object", "properties": { "conta": { "type": "string", "description": "A conta da Eloquus (slug). contas_listar mostra as suas." }, "conversaId": { "type": "integer", "minimum": 1, "description": "Número da conversa na Eloquus." }, "adicionar": { "type": "array", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 60 }, "description": "Etiquetas a acrescentar." }, "remover": { "type": "array", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 60 }, "description": "Etiquetas a tirar." }, "pedidoId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "Opcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou." } }, "required": [ "conta", "conversaId" ], "additionalProperties": false } ``` **Esquema da resposta** ```json { "type": "object", "additionalProperties": false, "required": [ "conversaId", "etiquetas", "mudou" ], "properties": { "conversaId": { "type": "integer" }, "etiquetas": { "type": "array", "items": { "type": "string" } }, "mudou": { "type": "boolean" } } } ```