# Mudar status da atividade Leva a atividade para um status (pelo id, pelo nome ou pela categoria: concluida conclui, cancelada cancela, a_fazer reabre), com o resultado opcional. Vale sobre a versão atual; o status em que ela já está não muda nada. Organizar · Escrita · Depende do plano: Atividades Nome da ferramenta: ``` atividades_mudar_status ``` ## Exemplo de pedido Você escreve para o agente, em linguagem natural: > Marque como concluída a atividade de enviar a proposta, com o resultado proposta enviada. ## 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: Atividades. - Depende do plano: a conta precisa ter Atividades. - 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. | | `id` | texto | Sim | O id da atividade (de atividades_listar). Aceita: formato ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ | | `status` | texto | Não | O status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela). Aceita: de 1 a 80 caracteres | | `categoria` | texto | Não | A categoria do status. Aceita: a_fazer, em_andamento, concluida, cancelada | | `resultado` | texto | Não | O resultado (por exemplo "contrato assinado"). Aceita: até 1000 caracteres | | `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": "atividades_mudar_status", "arguments": { "conta": "nome-da-sua-conta", "id": "texto" } } } ``` **Esquema de entrada** ```json { "type": "object", "properties": { "conta": { "type": "string", "description": "A conta da Eloquus (slug). contas_listar mostra as suas." }, "id": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "O id da atividade (de atividades_listar)." }, "status": { "type": "string", "minLength": 1, "maxLength": 80, "description": "O status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela)." }, "categoria": { "type": "string", "enum": [ "a_fazer", "em_andamento", "concluida", "cancelada" ], "description": "A categoria do status." }, "resultado": { "type": "string", "maxLength": 1000, "description": "O resultado (por exemplo \"contrato assinado\")." }, "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", "id" ], "additionalProperties": false } ``` **Esquema da resposta** ```json { "type": "object", "additionalProperties": false, "properties": { "atividade": { "type": "object", "additionalProperties": {}, "description": "A atividade: id, versao, titulo, tipoId, natureza, statusId, categoria, prazo (venceEm), lembrete, responsavel, setor, vínculos, checklist, resultado, origem, autor e datas. Conversa de outra caixa vem sem trecho, com conversaDeOutraCaixa: true." }, "mudou": { "type": "boolean", "description": "false quando já estava nesse status." } }, "required": [ "atividade", "mudou" ] } ```