Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

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.

OrganizarEscritaDepende 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

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
idtextoSimO 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}$
statustextoNãoO status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela).
Aceita: de 1 a 80 caracteres
categoriatextoNãoA categoria do status.
Aceita: a_fazer, em_andamento, concluida, cancelada
resultadotextoNãoO resultado (por exemplo "contrato assinado").
Aceita: até 1000 caracteres
pedidoIdtextoNãoOpcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou.
Aceita: uuid

Limites

Detalhes técnicos

Pedido JSON-RPC (tools/call)

Com só os campos obrigatórios e valores de exemplo.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "atividades_mudar_status",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "id": "texto"
    }
  }
}
Esquema de entrada
{
  "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
{
  "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"
  ]
}